Herstellen einer Verbindung mit Power BI aus PowerAppsConnect to Power BI from PowerApps

Power BI

Power BI ist eine Suite von Business Analytics-Tools zum Analysieren von Daten und Teilen von Erkenntnissen.Power BI is a suite of business analytics tools to analyze data and share insights. Mit funktionsreichen Dashboards auf jedem Gerät behalten Sie die Kontrolle über Ihr Geschäft und erhalten schnell Antworten.Monitor your business and get answers quickly with rich dashboards available on every device. Sie können in Ihrer App den Status der Datenwarnungen überprüfen, die Sie im Power BI-Dienst eingerichtet haben.In your app, you can check the status of the data alerts that you have set up in the Power BI service. Weitere Informationen zu Datenwarnungen in Power BI finden Sie auf der Dokumentationsseite.For more information on data alerts in Power BI, head to the documentation page.

In diesem Thema wird gezeigt, wie Sie die Power BI-Verbindung in einer App verwenden, und die verfügbaren Funktionen werden aufgelistet.This topic shows you how to use the Power BI connection in an app, and lists the available functions.

Das benötigen Sie, um anzufangenWhat you need to get started

Verwenden der Power BI-Verbindung in der AppUse the Power BI connection in your app

Auflisten der Warnungen, die Sie im Power BI-Dienst eingerichtet habenList the alerts that you've set up in the Power BI service

  1. Wählen Sie im Menü Insert (Einfügen) die Option Katalog aus, und fügen Sie eine der Text galleries (Textkataloge) hinzu.On the Insert menu, select Gallery, and add any of the Text galleries.
  2. Um die Warnungen des aktuellen Benutzers anzuzeigen, legen Sie die Items-Eigenschaft des Katalogs auf die folgende Formel fest:To show the current user's alerts, set the Items property of the gallery to the following formula:

    PowerBI.GetAlerts()

Der Katalog wird mit der Liste der Warnungen aktualisiert.The gallery will update with the list of alerts. Für jede Warnung erhalten Sie den Namen der Warnung, die ID der Warnung und die ID des Gruppenarbeitsbereichs, in dem die Warnung konfiguriert wurde.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. Sie benötigen die Warnungs-ID, um weitere Informationen zur Warnung zu erhalten.You will need the alert ID to get further information about the alert.

Anzeigen des Status einer WarnungView the status of an alert

Um den Status der Warnung anzuzeigen, rufen Sie die CheckAlertStatus-Funktion mit der Warnungs-ID auf, die Sie im obigen Schritt erhalten haben.To view the status of the alert, call the CheckAlertStatus function with the alert ID obtained from the step above.

Die Warnungs-ID kann entweder als Literalzeichenfolge (z. B. „1234“) oder als Verweis auf einen durch den Aufruf von GetAlerts() aufgefüllten Katalogabschnitt (z. B. Gallery1.Selected.alertId) übergeben werden.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)

Um den Vorgang fortzusetzen, fügen Sie eine Bezeichnung hinzu, und legen Sie dessen Text-Eigenschaft auf eine der folgenden Formeln fest: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

Die Bezeichnung wird mit dem aktuellen Status der Warnung aktualisiert.The label will update with the current status of the alert.

Anzeigen der verfügbaren FunktionenView the available functions

Diese Verbindung umfasst die folgenden Funktionen:This connection includes the following functions:

FunktionsnameFunction Name BeschreibungDescription
GetAlertsGetAlerts Listet die Warnungen auf, die Sie im Power BI-Dienst eingerichtet haben.List the alerts that you have set up in the Power BI service
CheckAlertStatusCheckAlertStatus Überprüft den Status einer bestimmten Warnung.Check the status of a particular alert

GetAlertsGetAlerts

Auflisten der Warnungen, die Sie im Power BI-Dienst eingerichtet haben.List the alerts that you have set up in the Power BI service.

EingabeeigenschaftenInput properties

KeineNone.

AusgabeeigenschaftenOutput properties

EigenschaftsnameProperty Name DatentypData Type ErforderlichRequired BeschreibungDescription
valuevalue Arrayarray NeinNo Ein Array der Datenwarnungen, die Sie im Power BI-Dienst eingerichtet haben.An array of the data alerts that you have set up in the Power BI service. Jedes Element im Array enthält:Each element in the array will include:
  • alertTitle: der Titel der WarnungalertTitle: the title of the alert
  • alertId: die ID der WarnungalertId: the ID of the alert
  • groupId: die ID der Gruppe, in der die Warnung erstellt wurdegroupId: the ID of the group that the alert was created in

CheckAlertStatusCheckAlertStatus

Überprüfen des Status einer Warnung.Check the status of an alert.

Hinweis: Anforderungen an diesen Endpunkt werden pro Warnung gedrosselt, wenn die Funktion zu häufig aufgerufen wird.Note: requests to this endpoint will be throttled on a per-alert basis if called too frequently.

EingabeeigenschaftenInput properties

EigenschaftsnameProperty Name DatentypData Type ErforderlichRequired BeschreibungDescription
alertIdalertId Ganze Zahlinteger JaYes Die von GetAlerts zurückgegebene ID der WarnungThe ID of the alert, as returned by GetAlerts

AusgabeeigenschaftenOutput properties

EigenschaftsnameProperty Name DatentypData Type ErforderlichRequired BeschreibungDescription
tileValuetileValue Zahlnumber NeinNo Der Wert der Kachel, als die Warnung ausgelöst wurdeThe value of the tile when the alert was triggered
tileUrltileUrl Zeichenfolgestring NeinNo Die URL für die Kachel, die die Warnung aufweistURL for the tile that has the alert
alertTitlealertTitle Zeichenfolgestring NeinNo Der Name der WarnungName of the alert
isAlertTriggeredisAlertTriggered Booleschboolean NeinNo Gibt an, ob die Warnung derzeit ausgelöst istWhether the alert is currently triggered
alertThresholdalertThreshold Zahlnumber NeinNo Der Schwellenwert, ab dem die Warnung ausgelöst wirdThe threshold at which the alarm is triggered

Alle verfügbaren Verbindungen.See all the available connections.
Erfahren Sie, wie Sie Ihren Apps Verbindungen hinzufügen.Learn how to add connections to your apps.