Guides pratiques
Exécuter et planifier des tests de rapports Power BI, examiner les changements visuels, régler les seuils et les notifications, gérer les membres.
Exécuter un package de tests
Sélectionnez Exécuter maintenant sur la page du package, ou Exécuter à côté du package sur la page de sa suite. L’exécution est mise en file d’attente et démarre dès qu’un processus d’exécution est libre ; les exécutions de packages différents s’effectuent en parallèle. Suivez-la sous En cours dans la vue d’ensemble ou sous En cours dans Exécutions.
Planifier un package de tests
- 1Ouvrez Planifications et sélectionnez Nouvelle planification, ou Ajouter une planification sur la page du package.
- 2Choisissez le package de tests, quotidien ou hebdomadaire, et l’heure en UTC.
- 3Ajouter la planification. L’interrupteur à côté la met en pause et la reprend.
Examiner une modification visuelle
Lorsqu’une page diffère de sa référence, sa vérification visuelle est Modifiée et l’exécution la liste comme une modification à examiner. Les modifications seules ne font pas échouer une exécution.
- 1Ouvrez l’exécution et choisissez le résultat modifié.
- 2Comparez les captures d’écran sous Examen visuel.
- 3Approuver comme nouvelle référence si la modification est attendue : les exécutions suivantes comparent avec la nouvelle capture d’écran. Conserver la référence s’il ne l’est pas : l’ancienne capture d’écran reste, et vous voudrez peut-être Créer un ticket.
Modifier les pages et les vérifications
Sur la page du package, Modifier ouvre l’assistant avec les pages et les vérifications actuelles ; Enregistrer les modifications les remplace, tandis que la suite, les planifications et l’historique des exécutions restent. Pour ignorer une vérification sur une seule page, désactivez-la dans le tableau de la page du package et enregistrez.
Déplacer ou supprimer un package de tests
Déplacer, sur la page du package, le place dans une autre suite. Supprimer supprime le package et ses planifications ; ses exécutions restent dans l’historique avec leurs preuves. La suppression d’une suite déplace ses packages vers la Suite d’essai.
Suivre un problème comme un ticket
Sur la page d’une exécution, sélectionnez Créer un ticket sur le résultat. Le titre et la gravité sont renseignés à partir de la vérification ; modifiez-les si nécessaire et créez le ticket. Retrouvez-le sous Tickets, et résolvez-le une fois le rapport corrigé.
Ajouter la connexion de l’organisation
Les administrateurs et les propriétaires peuvent ajouter un principal de service avec lequel chaque membre peut enregistrer des packages, et qui lit l’inventaire Power BI :
- 1Dans Microsoft Entra ID, inscrivez une application et créez un secret client. N’y ajoutez pas d’autorisations d’API Power BI : le principal de service tire son accès des paramètres Power BI ci-dessous.
- 2Dans le portail d’administration Power BI, sous Paramètres du tenant, activez Les principaux de service peuvent utiliser les API Fabric. Pour l’API Scanner (voir Inventaire Power BI), activez aussi Les principaux de service peuvent accéder aux API d’administration en lecture seule ; ce paramètre ne s’applique qu’aux groupes de sécurité : ajoutez donc l’application à un groupe de sécurité et choisissez ce groupe. L’application des paramètres peut prendre jusqu’à 15 minutes.
- 3Ajoutez l’application, ou un groupe de sécurité dont elle fait partie, à chaque espace de travail à tester (dans Power BI, Gérer l’accès, en tant que Membre ou Administrateur). Elle ne voit que ces espaces de travail, jamais le Mon espace de travail de quelqu’un.
- 4Dans Paramètres › Organisation, saisissez l’ID du tenant, l’ID client et le Secret client et choisissez le Cloud. Pour les rapports avec sécurité au niveau des lignes, saisissez le Nom d’utilisateur effectif sous lequel les afficher.
- 5Enregistrez. La connexion est vérifiée auprès de Microsoft avant d’être stockée, et la page indique combien d’espaces de travail elle voit, ou ce qu’il faut changer lorsqu’elle n’en voit aucun ; le secret est chiffré et n’est plus jamais affiché. Après l’avoir ajoutée à d’autres espaces de travail, sélectionnez Vérifier à nouveau.
Placez les espaces de travail à tester sur une capacité Premium ou Fabric (un essai Fabric suffit). Dans les autres espaces de travail, Power BI n’autorise un principal de service à afficher des rapports qu’un nombre limité de fois, pour le développement, et les marque This is a free trial version, y compris sur les captures d’écran. Les rapports d’exemple de Microsoft installés depuis Learn ne peuvent pas du tout être lus par un principal de service : chargez-les sous forme de fichiers .pbix.
Être averti à la fin des exécutions
Les administrateurs ouvrent Paramètres › Notifications, saisissent une URL du webhook, choisissent les résultats à envoyer (En échec, Modifiée, Avertissement, Réussie) et activent les notifications. Envoyer un test envoie tout de suite un message de test, Supprimer le webhook oublie l’adresse et désactive les notifications. Envois récents montre ce qui a été envoyé, et pourquoi une exécution a été ignorée.
Chaque message est un JSON avec un event (run-finished, powerbi-reconnect-required ou test) et une ligne text que les outils de messagerie affichent telle quelle. Une exécution terminée nomme aussi son package et sa suite, son résultat, les vérifications qui ont échoué, donné un avertissement ou changé, et renvoie à l’exécution.
L’enregistrement d’une URL de webhook affiche une seule fois son secret de signature. Chaque requête porte X-Power-BI-Lab-Timestamp (secondes Unix) et X-Power-BI-Lab-Signature : v1= suivi du HMAC-SHA256 hexadécimal, calculé avec le secret, de l’horodatage, d’un point et du corps brut. Votre point de terminaison calcule la même valeur, la compare, et refuse les horodatages vieux de plus de quelques minutes. L’enregistrement d’une autre URL remplace le secret.
Le webhook doit se trouver à une adresse publique : les adresses d’un réseau privé ou du serveur lui-même sont refusées, et les redirections ne sont pas suivies. Un webhook occupé, en échec ou qui ne répond pas en 10 secondes est essayé jusqu’à trois fois.
Modifier les seuils des vérifications
Dans Paramètres › Organisation, sous Seuils des vérifications, les administrateurs définissent :
- Rendu et ancienneté des données
- Quand une vérification réussie devient un avertissement : une page dont le rendu prend plus de 30 secondes, ou des données de plus de 24 heures, par défaut.
- La capture d’écran correspond jusqu’à
- La part de pixels dont une capture d’écran peut différer de sa référence tout en lui correspondant, 0,1 % par défaut. Power BI ne dessine jamais deux fois une page exactement de la même façon : les différences plus petites sont du bruit ; avec 0, toute différence est une modification.
- Capture d’écran instable et échecs fréquents
- La part des dernières exécutions d’une page à partir de laquelle Tendances signale sa capture d’écran comme instable (30 %) ou la page comme échouant souvent (20 %).
Gérer les membres et les rôles
Dans Paramètres › Membres, changez le rôle d’un membre ou retirez-le. Les sessions d’un membre retiré prennent fin et une nouvelle connexion ne le rétablit pas ; vous pouvez le restaurer depuis la même liste. Les administrateurs gèrent les membres et les lecteurs ; les propriétaires gèrent aussi les administrateurs et les propriétaires. Une organisation conserve toujours un propriétaire. Pour faire venir une personne d’une autre organisation Microsoft, saisissez son adresse e-mail et un rôle sous Invitations et envoyez-lui le lien : il n’est affiché qu’une fois, et seule la personne dont le compte Microsoft porte cette adresse e-mail peut l’utiliser, une seule fois. Révoquer désactive un lien qui n’a pas été utilisé.
Télécharger les preuves d’une exécution
Télécharger les preuves, sur la page d’une exécution, enregistre un fichier JSON avec l’exécution, l’empreinte du package exécuté, chaque étape avec ses preuves, le journal et les liens vers ses captures d’écran.