Opret forbindelse til Power BI fra PowerAppsConnect to Power BI from PowerApps

Power BI

Power BI er en pakke med virksomhedsanalyseværktøjer til at analysere data og dele viden.Power BI is a suite of business analytics tools to analyze data and share insights. Overvåg din virksomhed og få svar hurtigt med omfattende dashboards, der er tilgængelige på alle enheder.Monitor your business and get answers quickly with rich dashboards available on every device. Du kan kontrollere status for de databeskeder, du har oprettet i Power BI-tjenesten, i din app.In your app, you can check the status of the data alerts that you have set up in the Power BI service. Du kan få flere oplysninger om databeskeder i Power BI på siden med dokumentation.For more information on data alerts in Power BI, head to the documentation page.

I dette emne gennemgås, hvordan du bruger Power BI-forbindelsen i en app og får vist de tilgængelige funktioner.This topic shows you how to use the Power BI connection in an app, and lists the available functions.

Det skal du bruge for at komme i gangWhat you need to get started

Brug af Power BI-forbindelsen i din appUse the Power BI connection in your app

Få vist de beskeder, du har angivet i Power BI-tjenestenList the alerts that you've set up in the Power BI service

  1. Vælg Galleri i menuen Indsæt, og tilføj et af tekstgallerierne.On the Insert menu, select Gallery, and add any of the Text galleries.
  2. Du får vist den aktuelle brugers beskeder ved at angive galleriets egenskab Items til følgende formel:To show the current user's alerts, set the Items property of the gallery to the following formula:

    PowerBI.GetAlerts()

Galleriet opdateres med listen over beskeder.The gallery will update with the list of alerts. For hver besked modtager du beskedens navn, id-nummer og id for det gruppearbejdsområde, som beskeden blev konfigureret i.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. Du skal bruge besked-id'et til at få yderligere oplysninger om beskeden.You will need the alert ID to get further information about the alert.

Få vist status for en beskedView the status of an alert

Du kan få vist status for beskeden ved at kalde funktionen CheckAlertStatus med besked-id'et fra det ovenstående trin.To view the status of the alert, call the CheckAlertStatus function with the alert ID obtained from the step above.

Besked-id'et kan enten sendes som en konstantstreng (f.eks. "1234") eller som en reference til en gallerisektion, der er udfyldt ved hjælp af GetAlerts()-opkald (f.eks. 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)

Du fortsætter ved at tilføje en etiket og derefter angive dens egenskab Text til en af disse formler: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

Etiketten opdateres med den aktuelle status for beskeden.The label will update with the current status of the alert.

Få vist de tilgængelige funktionerView the available functions

Denne forbindelse indeholder følgende funktioner:This connection includes the following functions:

Funktionens navnFunction Name BeskrivelseDescription
GetAlertsGetAlerts Få vist de beskeder, du har angivet i Power BI-tjenesten.List the alerts that you have set up in the Power BI service
CheckAlertStatusCheckAlertStatus Kontrollér status for en bestemt besked.Check the status of a particular alert

GetAlertsGetAlerts

Få vist de beskeder, du har angivet i Power BI-tjenesten.List the alerts that you have set up in the Power BI service.

InputegenskaberInput properties

IngenNone.

OutputegenskaberOutput properties

Navn på egenskabProperty Name DatatypeData Type PåkrævetRequired BeskrivelseDescription
valuevalue matrixarray NejNo En matrix over de databeskeder, som du har angivet i Power BI-tjenesten.An array of the data alerts that you have set up in the Power BI service. Hvert element i matricen omfatter:Each element in the array will include:
  • alertTitle: Titlen på beskeden.alertTitle: the title of the alert
  • alertId: Beskedens id.alertId: the ID of the alert
  • groupId: Id for den gruppe, som beskeden blev oprettet i.groupId: the ID of the group that the alert was created in

CheckAlertStatusCheckAlertStatus

Kontrollér status for en besked.Check the status of an alert.

Bemærk! Anmodninger til dette slutpunkt begrænses pr. besked, hvis det kaldes for ofte.Note: requests to this endpoint will be throttled on a per-alert basis if called too frequently.

InputegenskaberInput properties

Navn på egenskabProperty Name DatatypeData Type PåkrævetRequired BeskrivelseDescription
alertIdalertId heltalinteger JaYes Id'et for beskeden, som returneres af GetAlerts.The ID of the alert, as returned by GetAlerts

OutputegenskaberOutput properties

Navn på egenskabProperty Name DatatypeData Type PåkrævetRequired BeskrivelseDescription
tileValuetileValue talnumber NejNo Værdien af feltet, da beskeden blev udløst.The value of the tile when the alert was triggered
tileUrltileUrl strengstring NejNo Webadressen for det felt, der har beskeden.URL for the tile that has the alert
alertTitlealertTitle strengstring NejNo Navnet på beskeden.Name of the alert
isAlertTriggeredisAlertTriggered booleskboolean NejNo Angiver, om beskeden udløses i øjeblikket.Whether the alert is currently triggered
alertThresholdalertThreshold talnumber NejNo Den tærskel, hvor beskeden udløses.The threshold at which the alarm is triggered

Se alle de tilgængelige forbindelser.See all the available connections.
Få mere at vide om, hvordan du føjer forbindelser til dine apps.Learn how to add connections to your apps.