Se connecter à Power BI à partir de PowerAppsConnect to Power BI from PowerApps

Power BI

Power BI est une suite d’outils d’analyse marketing qui permettent d’analyser les données et de partager des informations.Power BI is a suite of business analytics tools to analyze data and share insights. Surveillez votre entreprise et obtenez des réponses rapidement avec des tableaux de bord complets disponibles sur chaque appareil.Monitor your business and get answers quickly with rich dashboards available on every device. Dans votre application, vous pouvez vérifier l’état des alertes de données que vous avez configurées dans le service Power BI.In your app, you can check the status of the data alerts that you have set up in the Power BI service. Pour plus d’informations sur les alertes de données dans Power BI, voir la page de documentation.For more information on data alerts in Power BI, head to the documentation page.

Cette rubrique montre comment utiliser la connexion Power BI dans une application et répertorie les fonctions disponibles.This topic shows you how to use the Power BI connection in an app, and lists the available functions.

Ce dont vous avez besoin pour commencerWhat you need to get started

Utiliser la connexion Power BI dans votre applicationUse the Power BI connection in your app

Répertorier les alertes que vous avez configurées dans le service Power BIList the alerts that you've set up in the Power BI service

  1. Dans le menu Insérer, sélectionnez Galerie, puis ajoutez une des galeries de texte.On the Insert menu, select Gallery, and add any of the Text galleries.
  2. Pour afficher les alertes de l’utilisateur actuel, affectez la propriété Items de la galerie sur la formule suivante :To show the current user's alerts, set the Items property of the gallery to the following formula:

    PowerBI.GetAlerts()

La galerie met à jour la liste des alertes.The gallery will update with the list of alerts. Pour chaque alerte, vous recevez son nom et son ID, ainsi que l’ID de l’espace de travail de groupe dans lequel l’alerte a été configurée.For each alert, you will receive the alert name, the ID number of the alert, and the ID of the group workspace in which the alert was configured. Vous avez besoin de l’ID d’alerte pour obtenir davantage d’informations sur l’alerte.You will need the alert ID to get further information about the alert.

Afficher l’état d’une alerteView the status of an alert

Pour afficher l’état de l’alerte, appelez la fonction CheckAlertStatus avec l’ID d’alerte obtenu à l’étape précédente.To view the status of the alert, call the CheckAlertStatus function with the alert ID obtained from the step above.

L’ID d’alerte peut être transmis sous forme de chaîne littérale (par exemple « 1234 ») ou comme référence à une section de la galerie remplie à l’aide de l’appel GetAlerts() (par exemple, Gallery1.Selected.alertId)The alert ID can be passed in either as a literal string (e.g. "1234") or as a reference to a gallery section populated using the GetAlerts() call (e.g. Gallery1.Selected.alertId)

Pour continuer, ajoutez une étiquette, puis définissez sa propriété Text sur une des formules suivantes :To proceed, add a label, and then set its Text property to one of these formulas:

  • PowerBI.CheckAlertStatus( /* alert ID that you received from GetAlert */ ).alertTitle
  • PowerBI.CheckAlertStatus( /* alert ID that you received from GetAlert */ ).currentTileValue
  • PowerBI.CheckAlertStatus( /* alert ID that you received from GetAlert */ ).alertThreshold
  • PowerBI.CheckAlertStatus( /* alert ID that you received from GetAlert */ ).isAlertTriggered

L’étiquette se met à jour avec l’état actuel de l’alerte.The label will update with the current status of the alert.

Afficher les fonctions disponiblesView the available functions

Cette connexion comprend les fonctions suivantes :This connection includes the following functions:

Nom de la fonctionFunction Name DescriptionDescription
GetAlertsGetAlerts Répertorie les alertes que vous avez configurées dans le service Power BIList the alerts that you have set up in the Power BI service
CheckAlertStatusCheckAlertStatus Vérifie le statut d’une alerte spécifiqueCheck the status of a particular alert

GetAlertsGetAlerts

Répertoriez les alertes que vous avez configurées dans le service Power BI.List the alerts that you have set up in the Power BI service.

Propriétés d’entréeInput properties

Aucune.None.

Propriétés de sortieOutput properties

Nom de la propriétéProperty Name Type de donnéesData Type ObligatoireRequired DescriptionDescription
valuevalue tableauarray NonNo Tableau des alertes de données que vous avez configurées dans le service Power BI.An array of the data alerts that you have set up in the Power BI service. Chaque élément du tableau inclut ce qui suit :Each element in the array will include:
  • alertTitle : titre de l’alertealertTitle: the title of the alert
  • alertId : ID de l’alertealertId: the ID of the alert
  • groupId : ID du groupe dans lequel l’alerte a été crééegroupId: the ID of the group that the alert was created in

CheckAlertStatusCheckAlertStatus

Vérifiez l’état d’une alerte.Check the status of an alert.

Remarque : les demandes envoyées à ce point de terminaison sont limitées en fonction de chaque alerte en cas d’appels trop fréquents.Note: requests to this endpoint will be throttled on a per-alert basis if called too frequently.

Propriétés d’entréeInput properties

Nom de la propriétéProperty Name Type de donnéesData Type ObligatoireRequired DescriptionDescription
alertIdalertId entierinteger OuiYes ID de l’alerte, tel que renvoyé par GetAlertsThe ID of the alert, as returned by GetAlerts

Propriétés de sortieOutput properties

Nom de la propriétéProperty Name Type de donnéesData Type ObligatoireRequired DescriptionDescription
tileValuetileValue nombrenumber NonNo Valeur de la vignette lorsque l’alerte a été déclenchéeThe value of the tile when the alert was triggered
tileUrltileUrl chaînestring NonNo URL de la vignette qui a l’alerteURL for the tile that has the alert
alertTitlealertTitle chaînestring NonNo Nom de l’alerteName of the alert
isAlertTriggeredisAlertTriggered valeur booléenneboolean NonNo Si l’alerte est actuellement déclenchéeWhether the alert is currently triggered
alertThresholdalertThreshold nombrenumber NonNo Seuil auquel l’alarme est déclenchéeThe threshold at which the alarm is triggered

Consultez toutes les connexions disponibles.See all the available connections.
Découvrez comment ajouter des connexions dans vos applications.Learn how to add connections to your apps.