Tutorial: Einbetten von Power BI-Inhalten mit der Beispielanwendung Embed For Your Organization
Mit Embedded Analytics in Power BI können Sie Power BI-Inhalte wie Berichte, Dashboards und Kacheln in Ihre Anwendung einbetten.
In diesem Tutorial lernen Sie Folgendes:
- Einrichten der eingebetteten Umgebung.
- Konfigurieren einer Embed For Your Organization-Beispielanwendung (Einbettung für Ihre Organisation, wird auch als user owns data (Benutzer ist Dateneigner) bezeichnet)
Benutzer müssen sich bei Power BI anmelden, um Ihre Anwendung verwenden zu können.
Die Lösung „Für Ihre Organisation einbetten“ wird in der Regel von Unternehmen und großen Organisationen verwendet und ist für interne Benutzer gedacht.
Wichtig
Wenn Sie Inhalte für eine nationale/regionale Cloud einbetten, sind die ersten Schritte dieses Tutorials anders. Weitere Informationen finden Sie unter Inhalte für nationale/regionale Clouds einbetten.
Spezifikationen für Codebeispiele
Dieses Tutorial enthält Anweisungen zum Konfigurieren einer Embed For Your Organization-Beispielanwendung in einer der folgenden Sprachen:
- .NET Framework
- .NET Core
- React TypeScript
Hinweis
Die Beispiele für .NET Core und das .NET Framework ermöglichen es Endbenutzern, Power BI-Dashboards, Berichte oder Kacheln anzuzeigen, wenn sie Zugriff auf den Power BI-Dienst haben. Das React TypeScript-Beispiel ermöglicht es Ihnen, nur einen Bericht einzubetten, auf den Ihr Endbenutzer im Power BI-Dienst bereits Zugriff hat.
Die folgenden Browser werden von den Codebeispielen unterstützt:
- Microsoft Edge
- Google Chrome
- Mozilla Firefox
Voraussetzungen
Vergewissern Sie sich vor Beginn dieses Tutorials, dass die folgenden Power BI- und Codeabhängigkeiten vorhanden sind:
Power BI-Abhängigkeiten
Ihr/e eigene/r Microsoft Entra-Mandant*in.
Eine der folgenden Lizenzen:
Hinweis
Für eine Verwendung in Produktionsumgebungen benötigen Sie eine der folgenden Konfigurationen:
- Alle Benutzer mit Pro-Lizenzen
- Alle Benutzer mit PPU-Lizenzen
- Eine SKU, die einer F64-SKU oder höher entspricht. Diese Konfiguration ermöglicht es, dass alle Benutzer über kostenlose Lizenzen verfügen.
Codeabhängigkeiten
.NET Core 3.1 SDK (oder höher)
Eine integrierte Entwicklungsumgebung (IDE). Es wird empfohlen, eine der folgenden IDEs zu verwenden:
Methode
Gehen Sie wie folgt vor, um eine Embed For Your Organization-Beispielanwendung zu erstellen:
Schritt 1: Registrieren einer Microsoft Entra-App
Wenn Sie die Anwendung bei Microsoft Entra ID registrieren, können Sie eine Identität für Ihre App erstellen.
Befolgen Sie die Anweisungen unter Registrieren Ihrer Anwendung, um Ihre Anwendung bei Microsoft Entra ID zu registrieren.
Schritt 2: Erstellen eines Power BI-Arbeitsbereichs
Bei Power BI werden Berichte, Dashboards und Kacheln in einem Arbeitsbereich verwaltet. Wenn Sie diese Elemente einbetten möchten, müssen Sie sie erstellen und in einen Arbeitsbereich hochladen.
Tipp
Wenn bereits ein Arbeitsbereich vorhanden ist, können Sie diesen Schritt überspringen.
Gehen Sie folgendermaßen vor, um einen Arbeitsbereich zu erstellen:
Melden Sie sich bei Power BI an.
Wählen Sie Arbeitsbereich aus.
Wählen Sie Arbeitsbereich erstellen aus.
Geben Sie dem Arbeitsbereich einen Namen, und wählen Sie Speichern aus.
Schritt 3: Erstellen und Veröffentlichen eines Power BI-Berichts
Im nächsten Schritt erstellen Sie einen Bericht und laden ihn in den Arbeitsbereich hoch. Mit Power BI Desktop können Sie Ihren eigenen Bericht erstellen und anschließend im Arbeitsbereich veröffentlichen. Sie können aber auch einen Beispielbericht in den Arbeitsbereich hochladen.
Tipp
Wenn bereits ein Arbeitsbereich mit einem Bericht vorhanden ist, können Sie diesen Schritt überspringen.
Führen Sie die folgenden Schritte aus, um einen Beispielbericht herunterzuladen und im Arbeitsbereich zu veröffentlichen:
Öffnen Sie den GitHub-Ordner mit Power BI Desktop-Beispielen.
Wählen Sie Code und dann Download ZIP (ZIP herunterladen) aus.
Extrahieren Sie die heruntergeladene ZIP-Datei, und navigieren Sie zum Ordner Samples Reports (Beispielberichte).
Wählen Sie den Bericht aus, den Sie einbetten möchten, und veröffentlichen Sie ihn im Arbeitsbereich.
Schritt 4: Abrufen der Werte für den Einbettungsparameter
Zum Einbetten von Inhalten müssen Sie bestimmte Parameterwerte abrufen. Die Parameterwerte hängen von der Sprache der Beispielanwendung ab, die Sie verwenden möchten. In der Tabelle unten erfahren Sie, welche Parameterwerte für die verschiedenen Beispiele erforderlich sind.
Parameter | .NET Core | .NET Framework | React TypeScript |
---|---|---|---|
Client-ID | ![]() |
![]() |
![]() |
Geheimer Clientschlüssel | ![]() |
![]() |
![]() |
Arbeitsbereichs-ID | ![]() |
![]() |
![]() |
Berichts-ID | ![]() |
![]() |
![]() |
Client-ID
Tipp
Gilt für: .NET Core
.NET Framework
React TypeScript
Gehen Sie wie folgt vor, um den eindeutigen Bezeichner der Client-ID (auch als Anwendungs-ID bezeichnet) abzurufen:
Melden Sie sich bei Microsoft Azure an.
Suchen Sie nach App-Registrierungen, und wählen Sie den Link App-Registrierungen aus.
Wählen Sie die Microsoft Entra-App aus, die Sie zum Einbetten Ihrer Power BI-Inhalte verwenden.
Kopieren Sie im Abschnitt Übersicht den eindeutigen Bezeichner Anwendungs-ID (Client) .
Geheimer Clientschlüssel
Tipp
Gilt für: .NET Core
.NET Framework
React TypeScript
Gehen Sie wie folgt vor, um den geheimen Clientschlüssel abzurufen:
Melden Sie sich bei Microsoft Azure an.
Suchen Sie nach App-Registrierungen, und wählen Sie den Link App-Registrierungen aus.
Wählen Sie die Microsoft Entra-App aus, die Sie zum Einbetten Ihrer Power BI-Inhalte verwenden.
Wählen Sie unter Verwalten die Option Zertifikate und Geheimnisse aus.
Wählen Sie unter Geheime Clientschlüssel die Option Neuer geheimer Clientschlüssel.
Geben Sie im Popupfenster Geheimen Clientschlüssel hinzufügen eine Beschreibung für den geheimen Anwendungsschlüssel ein, wählen Sie für den geheimen Anwendungsschlüssel ein Ablaufdatum aus, und klicken Sie auf Hinzufügen.
Kopieren Sie im Abschnitt Geheime Clientschlüssel die Zeichenfolge in der Spalte Wert des neu erstellten geheimen Anwendungsschlüssels. Der Wert des geheimen Clientschlüssels ist die Client-ID.
Hinweis
Stellen Sie sicher, dass Sie den Wert des geheimen Clientschlüssels kopieren, wenn er zum ersten Mal angezeigt wird. Wenn Sie diese Seite verlassen, wird der geheime Clientschlüssel ausgeblendet, und Sie können den Wert nicht mehr abrufen.
Arbeitsbereichs-ID
Tipp
Gilt für: .NET Core
.NET Framework
React TypeScript
Gehen Sie wie folgt vor, um den eindeutigen Bezeichner der Arbeitsbereichs-ID abzurufen:
Melden Sie sich beim Power BI-Dienst an.
Öffnen Sie den Bericht, den Sie einbetten möchten.
Kopieren Sie den eindeutigen Bezeichner aus der URL. Der eindeutige Bezeichner ist die Zahl zwischen /groups/ und /reports/ .
Berichts-ID
Tipp
Gilt für: .NET Core
.NET Framework
ReactTypeScript
Gehen Sie wie folgt vor, um den eindeutigen Bezeichner der Berichts-ID abzurufen:
Melden Sie sich beim Power BI-Dienst an.
Öffnen Sie den Bericht, den Sie einbetten möchten.
Kopieren Sie den eindeutigen Bezeichner aus der URL. Der eindeutige Bezeichner ist die Zahl zwischen /reports/ und /ReportSection/ .
Schritt 5: Einbetten der Inhalte
Mit der eingebetteten Power BI-Beispielanwendung können Sie eine Power BI-App Embed For Your Organization erstellen.
Gehen Sie wie folgt vor, um die Beispielanwendung Embed For Your Organization zu ändern und den Power BI-Bericht einzubetten.
Öffnen Sie den Ordner Beispiele für Power BI für Entwickler.
Wählen Sie Code und dann Download ZIP (ZIP herunterladen) aus.
Extrahieren Sie die heruntergeladene ZIP-Datei, und navigieren Sie zum Ordner PowerBI-Developer-Samples-master.
Öffnen Sie einen der folgenden Ordner, je nachdem welche Sprache für Ihre Anwendung verwendet werden soll:
- .NET Core
- .NET Framework
- React-TS
Hinweis
Die Beispielanwendungen zum Einbetten für Ihre Organisation unterstützen nur die oben aufgeführten Frameworks. Die Beispielanwendungen für Java, Node.js und Python unterstützen nur die Lösung Embed For Your Customers (Einbettung für Ihre Kunden).
Konfigurieren Ihrer Microsoft Entra-App
Melden Sie sich beim Azure-Portal an.
Wählen Sie App-Registrierungen aus. Wenn diese Option nicht angezeigt wird, suchen Sie danach.
Öffnen Sie die Microsoft Entra-Anwendung, die Sie in Schritt 1: Registrieren einer Microsoft Entra-App erstellt haben.
Wählen Sie im Menü Verwalten die Option Authentifizierung.
Öffnen Sie unter Plattformkonfigurationen Ihre Webplattform, und fügen Sie im Abschnitt Umleitungs-URIs
https://localhost:5000/signin-oidc
hinzu.Hinweis
Wenn Sie über keine Webplattform verfügen, klicken Sie auf Plattform hinzufügen, und klicken Sie im Fenster Plattformen konfigurieren auf Web.
Speichern Sie die Änderungen.
Konfigurieren der Beispiel-App für Einbettungen
Öffnen Sie den Ordner Embed For Your Organization (Einbettung für Ihre Organisation).
Öffnen Sie die Embed For Your Organization-Beispielanwendung mit einer der folgenden Methoden:
Wenn Sie Visual Studio verwenden, öffnen Sie die Datei UserOwnsData.sln.
Wenn Sie Visual Studio Code verwenden, öffnen Sie den Ordner UserOwnsData.
Öffnen Sie die Datei appsettings.json, und geben Sie die folgenden Parameterwerte ein:
ClientId
: Verwenden Sie den GUID der Client-ID.ClientSecret
: Verwenden Sie das Clientgeheimnis.
Ausführen der Beispiel-App
Führen Sie das Projekt aus, indem Sie die entsprechende Option auswählen:
Wenn Sie Visual Studio verwenden, wählen Sie IIS Express (Wiedergabe) aus.
Wenn Sie Visual Studio-Code verwenden, wählen Sie Ausführen > Debugging starten.
Melden Sie sich bei der Beispielanwendung für die Einbettung an.
Hinweis
Bei Ihrer ersten Anmeldung werden Sie aufgefordert, der App Berechtigungen für Microsoft Entra zu gewähren.
Wenn die Beispielanwendung für die Einbettung geladen wird, wählen Sie den Power BI-Inhalt aus, den Sie einbetten möchten, und wählen Sie dann Einbetten aus.
Entwickeln Ihrer Anwendung
Nachdem Sie die Beispielanwendung Einbetten für Ihre Kunden konfiguriert und ausgeführt haben, können Sie mit der Entwicklung der eigenen Anwendung beginnen.
Aktualisieren von Benutzerberechtigungen
Benutzer benötigen eine entsprechende Berechtigung, um auf den Power BI-Ordner zugreifen zu können, in dem sich der Bericht befindet. Wenn Sie einem Benutzer die Zugriffsberechtigung für einen Ordner erteilen, wird die Änderung in der Regel erst wirksam, nachdem sich der Benutzer beim Power BI-Portal angemeldet hat. Damit die neuen Berechtigungen sofort wirksam werden, rufen Sie im Embedded-Szenario beim Start explizit die REST-API „RefreshUser Permissions“ auf. Durch diesen API-Aufruf werden die Berechtigungen aktualisiert und Autorisierungsfehler für Benutzer mit neu erteilten Berechtigungen vermieden.