Anslut till Power BI från PowerAppsConnect to Power BI from PowerApps

Power BI

Power BI är en uppsättning verktyg för företagsanalys för att analysera och dela information.Power BI is a suite of business analytics tools to analyze data and share insights. Övervaka din verksamhet och få snabba svar med omfattande instrumentpaneler, tillgängliga på alla typer av enheter.Monitor your business and get answers quickly with rich dashboards available on every device. I din app kan du kontrollera status för de data-aviseringar som du har ställt in i Power BI-tjänsten.In your app, you can check the status of the data alerts that you have set up in the Power BI service. Mer information om data-aviseringar i Power BI finns i dokumentationssidan.For more information on data alerts in Power BI, head to the documentation page.

Det här avsnittet beskriver hur du använder Power BI-anslutningen i en app och visar en lista över tillgängliga funktioner.This topic shows you how to use the Power BI connection in an app, and lists the available functions.

Det här behöver du för att komma igångWhat you need to get started

Använd Power BI-anslutningen i din appUse the Power BI connection in your app

Visa en lista över de aviseringar som du har konfigurerat i Power BI-tjänstenList the alerts that you've set up in the Power BI service

  1. Välj GalleriInfoga-menyn och lägg till någon av textgallerierna.On the Insert menu, select Gallery, and add any of the Text galleries.
  2. För att visa aviseringar för den aktuella användaren ange du dess objekt-egenskap i galleriet enligt följande formel:To show the current user's alerts, set the Items property of the gallery to the following formula:

    PowerBI.GetAlerts()

Galleriet uppdateras med listan över aviseringar.The gallery will update with the list of alerts. För varje avisering får du aviseringsnamn, aviseringens ID-nummer och ID för den grupps arbetsyta där aviseringen har konfigurerats.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 behöver aviserings-ID för att få mer information om aviseringen.You will need the alert ID to get further information about the alert.

Visa status för en aviseringView the status of an alert

För att visa status för aviseringen anropar du funktionen CheckAlertStatus med det aviserings-ID du fick vid ovanstående steg.To view the status of the alert, call the CheckAlertStatus function with the alert ID obtained from the step above.

Aviserings-ID kan skickas antingen som en teckensträng (t.ex. "1234") eller som en referens till ett galleriavsnitt som fyllts via GetAlerts()-anropet (t.ex. 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)

För att fortsätta lägg till en etikett och ange därefter dess textegenskap enligt en av dessa 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 uppdateras med aktuell status för aviseringen.The label will update with the current status of the alert.

Visa tillgängliga funktionerView the available functions

Den här anslutningen innehåller följande funktioner:This connection includes the following functions:

FunktionsnamnFunction Name BeskrivningDescription
GetAlertsGetAlerts Visa en lista över de aviseringar som du har konfigurerat i Power BI-tjänstenList the alerts that you have set up in the Power BI service
CheckAlertStatusCheckAlertStatus Kontrollera status för en viss aviseringCheck the status of a particular alert

GetAlertsGetAlerts

Visa en lista över de aviseringar som du har konfigurerat i Power BI-tjänsten.List the alerts that you have set up in the Power BI service.

IndataegenskaperInput properties

Inga.None.

UtdataegenskaperOutput properties

Egenskapens namnProperty Name DatatypData Type KrävsRequired BeskrivningDescription
värdevalue matrisarray NejNo En matris över de data-aviseringar som du har konfigurerat i Power BI-tjänsten.An array of the data alerts that you have set up in the Power BI service. Varje element i matrisen innehåller:Each element in the array will include:
  • alertTitle: aviseringens titelalertTitle: the title of the alert
  • alertId: aviseringens IDalertId: the ID of the alert
  • groupId: ID för den grupp som aviseringen skapades igroupId: the ID of the group that the alert was created in

CheckAlertStatusCheckAlertStatus

Kontrollera status för en avisering.Check the status of an alert.

Obs: begäranden till den här slutpunkten kommer att begränsas på basis av per avisering om den anropas för ofta.Note: requests to this endpoint will be throttled on a per-alert basis if called too frequently.

IndataegenskaperInput properties

Egenskapens namnProperty Name DatatypData Type KrävsRequired BeskrivningDescription
alertIdalertId heltalinteger JaYes Aviseringens ID, som det returneras av GetAlertsThe ID of the alert, as returned by GetAlerts

UtdataegenskaperOutput properties

Egenskapens namnProperty Name DatatypData Type KrävsRequired BeskrivningDescription
tileValuetileValue nummernumber NejNo Ikonens värde då aviseringen utlöstesThe value of the tile when the alert was triggered
tileUrltileUrl strängstring NejNo URL för den ikon som har aviseringenURL for the tile that has the alert
alertTitlealertTitle strängstring NejNo Aviseringens namnName of the alert
isAlertTriggeredisAlertTriggered boolesktboolean NejNo Anger om en avisering är utlöst för närvarandeWhether the alert is currently triggered
alertThresholdalertThreshold nummernumber NejNo Det tröskelvärde där larmet utlösesThe threshold at which the alarm is triggered

Se alla tillgängliga anslutningar.See all the available connections.
Lär dig hur du lägger till anslutningar i dina appar.Learn how to add connections to your apps.