PBI Documentation

24 mars 2025 · Greg Philps

Quel contenu doit figurer dans un Document de Conception - Rapports

Quelles caractéristiques des rapports doivent être décrites dans un Document de Conception ?

De nombreux projets de reporting Power BI comportent plusieurs fichiers, et, de ce fait, la conception sera probablement dispersée, ce qui peut rendre difficile l’obtention d’une vue d’ensemble (surtout lorsque plusieurs développeurs sont impliqués). Le document de conception offre un guichet unique et peut améliorer à la fois la clarté et la cohérence de la conception (sans oublier qu’il réduit du même coup les reprises de travail).

Les rapports du projet ne partageront pas seulement, dans l’idéal, un thème et un modèle de données commun ; il existe probablement d’autres éléments communs également (par ex. thème, navigation, etc.). Les éléments propres à un rapport individuel (par ex. filtres, visuels, etc.) sont décrits séparément ci-dessous.

Éléments communs

Décrivez les caractéristiques de conception qui seront communes à tous les rapports du projet.

Thème

Décrivez le fichier de thème utilisé dans les rapports, y compris la taille de page, les couleurs, les polices, les tailles de police, etc.

ID Élément Description Notes
T-1 Page Bureau :
Taille du canevas - 1600 par 900
Arrière-plan du canevas - gris clair (#F0F0F0)
Papier peint - aucun
Cartes de filtre - couleurs par défaut

Mobile :
s.o.
pixels, largeur par hauteur
T-2 Couleurs, Principales Nuances de bleu
#8BC7F7
#46B3F3
#009FEF
#008CEE
#0078ED
#0050EB
#0641C8
#0B31A5
Basé sur le thème « Storm »
inclus avec Power BI Desktop
T-3 Couleurs, Sentiment Vert-jaune-rouge (c.-à-d. « feu tricolore »)
Négatif - rouge (#E81123)
Positif - vert (#3BB44A)
Neutre - jaune (#F2C811)
T-4 Polices Titres de visuels - Segoe UI Semibold, 12 pt, noir (#000000)
Sous-titres de visuels - Segoe UI, 10 pt, gris foncé (#969696)
Étiquettes d’axe - Segoe UI, 8 pt, noir
Titres d’axe - aucun (désactivé ; plutôt inclus dans le titre du visuel)
Étiquettes de données - Segoe UI, 8 pt, noir
Valeurs d’appel - Segoe UI Semibold, 18 pt, noir
T-5 Visuels Marge intérieure (pixels) - 4/4/4/4
Coins arrondis (visuels) - 8 pixels
Coins arrondis (cartes, boutons) - 4 pixels
Couleur d’arrière-plan - blanc (#FFFFFF)
Ombre - aucune
Lueur - aucune
T-6 Divers Titres de visuels - désactivés
Icônes - désactivées
Lignes de grille - gris clair (#E3E3E3)
Infobulles - Modernes
Pages - Une seule visible, toutes les autres masquées

Filtres

Décrivez les filtres qui seront appliqués à chaque rapport :

  • N’inclure que les clients actifs (c.-à-d. ceux ayant des factures actives)
  • N’inclure que les factures actives (c.-à-d. celles qui ne sont pas supprimées)
  • N’inclure que les factures de l’année civile en cours et des deux années précédentes

Voici un exemple :

09 - Image - Filter Pane

Les filtres propres à chaque rapport devraient être listés dans leurs sections respectives ci-dessous.

La navigation devrait être évidente (et explicite d’elle-même) et ne devrait nécessiter aucune instruction pour le public.

Une surcouche d’information peut également être ajoutée pour fournir une identification et une illustration supplémentaires de l’utilisation des éléments de navigation. De nombreux outils de conception peuvent être utilisés à cet effet.

Voici une procédure rapide :

  • S’assurer que le rapport Power BI est terminé
  • Prendre une capture d’écran de la page finale du rapport Power BI
  • Modifier l’image de capture d’écran dans un outil de conception
  • Superposer un rectangle plein écran (sans bordure, partiellement transparent)
    • L’image de capture d’écran du rapport Power BI se trouve maintenant en arrière-plan
  • Ajouter des rappels visuels pour les fonctionnalités de navigation souhaitées
  • Masquer ou supprimer l’image d’arrière-plan
  • Enregistrer l’image (en tant qu’image)
  • Ajouter l’image au fichier Power BI Desktop (l’étendre au plein écran)
  • Ajouter 2 signets (panneau ouvert, panneau fermé)
  • Ajouter un bouton d’information pour activer le signet « panneau ouvert »
  • Modifier l’action de l’image pour activer le signet « panneau fermé »

Guy in a Cube a publié une vidéo en 2021 illustrant ce processus :

https://www.youtube.com/watch?v=yYr_SlG8bpw

L’expérience actuelle du public avec la navigation employée dans les rapports Power BI opérationnels de votre organisation devrait constituer la méthode de navigation par défaut, et ne devrait être modifiée que si le(s) public(s) du (des) rapport(s) le demande(nt) expressément.

Une App Power BI devrait être la première option pour la navigation multi-rapports ; les rapports individuels peuvent alors être conçus sans système de navigation (c.-à-d. uniquement des pages), l’App fournissant la navigation hiérarchique par défaut sans aucun code.

Si une navigation autonome est utilisée dans chaque rapport, disposez les éléments sous forme de barre supérieure ou de barre latérale (ou les deux) et concevez-les avec un « rebond » (changements subtils lors du survol et de la sélection [par ex. taille de police, couleur de police, couleur d’arrière-plan, soulignement, etc.]) afin que les utilisateurs sachent intuitivement où ils se trouvent et comment naviguer. Décrivez tous les éléments, y compris [ID], nom (catégorie et sous-catégorie), et conception (normal, survol, sélectionné).

Voici un exemple :

ID Nom (Catégorie / Sous-catégorie) Conception / Sélectionné / Non sélectionné / Survol
N-1 Factures CONCEPTION :
* Type=bouton
* Forme=quelconque, avec bordure=désactivée
* Action=navigation de page (sous-catégorie 1)

PAR DÉFAUT (sélectionné) :
* Police=Segoe UI, blanc, 10 pt
* Arrière-plan=bleu foncé
* Navigation=page, Invoices-All

PAR DÉFAUT (non sélectionné) :
* Police=Segoe UI, gris moyen, 10 pt
* Arrière-plan=bleu moyen
* Navigation=page, Invoices-All

SURVOL :
* Police=Segoe UI, gris foncé, 11 pt
* Arrière-plan=gris moyen
* Navigation=page, Invoices-All
N-2 Factures / Toutes (identique à N-1 ci-dessus)
N-3 Factures / En cours (identique à N-1 ci-dessus, mais avec une navigation de page ajustée et
les valeurs par défaut sélectionné/non sélectionné inversées)
N-4 Factures / À venir (identique à N-1 ci-dessus, mais avec une navigation de page ajustée et
les valeurs par défaut sélectionné/non sélectionné inversées)
N-5 Factures / Historique (identique à N-1 ci-dessus, mais avec une navigation de page ajustée et
les valeurs par défaut sélectionné/non sélectionné inversées)

REMARQUE : Le drill-through n’est pas de la navigation et devrait plutôt être décrit dans chaque rapport spécifique.

En-tête de page

Décrivez tous les éléments qui seront présents dans l’en-tête de chaque page.

Voici un exemple :

Chaque page du rapport comportera les éléments d’en-tête suivants :

  • Titre du rapport
  • Menu de navigation horizontal à 2 niveaux (niveau 1 = catégorie [au-dessus], niveau 2 = sous-catégorie, ou page [en dessous])
    • Factures
      • Toutes
      • En cours
      • À venir
      • Historique
    • Clients
      • Niveau
      • Palier
      • Pays
    • Autre
      • Adresses
      • Problèmes connus
  • Sélecteur de langue
    • FR/EN
  • Date de dernier rafraîchissement des données (à partir du jeu de données commun utilisé par le rapport)
    • Remarque : cela reflétera la dernière date/heure à laquelle le jeu de données a été rafraîchi par le Service Power BI, et n’indique pas la date/heure à laquelle les données ont été extraites pour la dernière fois des systèmes sources

Pied de page

Décrivez tous les éléments qui seront présents dans le pied de page de chaque page.

Voici un exemple :

Chaque page du rapport comportera les éléments de pied de page suivants :

  • Ligne – Séparateur (gris)
  • Image – Logo (à gauche)
  • Zone de texte - Sélections de filtres (au milieu)
  • Zone de texte (ou Carte) – ID / Version / Date de version du rapport (à droite)
  • Zone de texte (ou Carte) – ID / Version / Date de version du jeu de données (à droite)

Sélecteurs (Slicers)

Les sélecteurs devraient utiliser les mêmes caractéristiques de conception et ne devraient nécessiter aucune instruction pour le public.

Décrivez les sélecteurs qui seront inclus sur toutes les pages du rapport.

Voici un exemple :

ID Sélecteur Caractéristiques de conception / Données / Notes
s.o. Général Titre=Segoe UI Semibold, 10 pt
Valeurs=Segoe UI, 8 pt
Style=liste déroulante
Sélection=multi-sélection ; CTRL désactivé ; Tout sélectionner désactivé
Icônes d’en-tête=désactivées
Zone de recherche=activée
S-1 Année fiscale Données=Dates[Fiscal Year]
Notes=zone de recherche indisponible car donnée numérique
S-2 Trimestre fiscal Données=Dates[Fiscal Quarter]
Notes=zone de recherche indisponible car donnée numérique
S-3 Plage de dates Type=entre
Curseur=activé, réactif désactivé
Données=Dates[Date]
S-4 Province Type=texte
Données=Countries[Province]
S-5 Ville Type=texte
Données=Countries[City]

Éléments spécifiques

Décrivez les caractéristiques de conception qui seront utilisées dans chaque rapport spécifique du projet (par ex. filtres [en plus de ceux déjà appliqués aux données communes], pages, sélecteurs, visuels, etc.).

Voici quelques descriptions :

Modèle sémantique (spécifique)

Décrivez la conception de chaque modèle sémantique spécifique dans chaque rapport spécifique, y compris toutes les tables de faits, les tables de dimensions (de recherche), et les tables de support.

Attribuez un [ID] à chaque relation et décrivez-la intégralement, y compris les champs/colonnes qui seront utilisés pour lier les tables, la cardinalité, et le sens de chaque relation.

(Remarque : il s’agit de l’intention de conception, et non de l’implémentation ; les fonctions DAX INFO seront utilisées dans les annexes [un prochain numéro] pour extraire les relations réelles du modèle développé.)

Voici un exemple :

ID De (table[colonne]) Vers (table[colonne]) Cardinalité / Sens
CR-1 Dates[Date] Invoices[Date] C=un-à-plusieurs
D=unique
CR-2 Customers[Customer ID] Invoices[Customer ID] C=un-à-plusieurs
D=unique

Incluez une image de chaque modèle de données spécifique dans chaque rapport spécifique et disposez les tables pour plus de clarté (par ex. conception en cascade, avec les tables de dimensions (de recherche) en haut, les tables de faits au milieu, les tables de support en bas à gauche, et les tables de mesures en haut à droite, etc.)

09 - Image - Data Model - Light Mode

AR01 – Toutes les factures

Ce rapport présente des informations de synthèse et des KPI sur l’ensemble des factures, et comprend les éléments suivants :

Filtres :

  • aucun

Sélecteurs :

  • Hiérarchie année fiscale et trimestre fiscal
  • Hiérarchie province et ville
  • Clients

KPI :

  • Nombre de clients
  • Nombre de factures
  • Montant total des factures
  • Montant total des factures en souffrance
  • Date de facture la plus ancienne
  • Date de facture la plus récente

Jauges :

  • Montant des factures payées par rapport aux montants totaux des factures
  • Montant des factures en souffrance par rapport aux montants totaux des factures

Graphiques à barres horizontales :

  • Montants totaux des factures par province
  • Montants totaux des factures par mode de paiement

AR02 – Factures en cours

Ce rapport présente des informations détaillées sur les factures impayées (avec échéancier), et comprend les éléments suivants :

Filtres :

  • Invoices[Status] != PAID
  • Invoices[Status] IN { ISSUED, OVERDUE }

Sélecteurs :

  • Année fiscale
  • Trimestre fiscal
  • Province
  • Ville
  • Clients
  • Mode de paiement, Centre de fonds, Centre de coûts, Type de matériel

KPI :

  • Montant total des factures
  • Montant total des factures payées
  • Montant total des factures en souffrance

Matrice :

  • Clients en lignes
  • Groupes d’échéancier des factures en colonnes

Table :

  • Colonnes pour le groupe d’échéancier des factures, le montant des factures en souffrance par groupe, le pourcentage du montant des factures en souffrance par rapport au total par groupe (pourcentage avec barres de données)
  • Graphique à barres horizontales :
    • Factures en souffrance par client

AR03 – Factures à venir

Ce rapport présente des informations détaillées sur les factures en cours de traitement et futures, et comprend les éléments suivants :

Filtres :

  • Invoices[Status] IN { SCHEDULED, DRAFT, IN PROGRESS, APPROVED }

Sélecteurs :

  • Année fiscale
  • Trimestre fiscal
  • Province
  • Ville
  • Clients

KPI :

  • Montant total des factures
  • Montant total des factures payées
  • Montant total des factures en souffrance

Table :

  • Détail des factures, avec colonnes pour le client, l’ID de commande/projet, le numéro de facture (provisoire), le montant (prévu), la date de facture (planifiée)

AR04 – Factures historiques

Ce rapport présente des informations détaillées sur les factures payées, et comprend les éléments suivants :

Filtres :

  • Invoices[Status] = PAID

Sélecteurs :

  • Année fiscale
  • Trimestre fiscal
  • Province
  • Ville
  • Clients

Cartes géographiques :

  • Montant des factures par ville
  • Montant des factures en souffrance par ville

Ressources

Publications LinkedIn

Les publications LinkedIn couvrant le document de conception sont listées ci-dessous :
1. Généralités et Périmètre
2. Flux de travail, Problèmes, et Règles métier
3. Données
4. Rapports

Exemples

Des fragments de documents d’exemple couvrant des sections spécifiques sont disponibles dans le dépôt GitHub :

1. Document de Conception - Fragment d’Exemple 01 - Généralités et Périmètre
2. Document de Conception - Fragment d’Exemple 02 - Flux de travail, Problèmes, et Règles métier
3. Document de Conception - Fragment d’Exemple 03 - Données
4. Document de Conception - Fragment d’Exemple 04 - Rapports

Voir la source (anglais) sur GitHub