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:


Methode

Gehen Sie wie folgt vor, um eine Embed For Your Organization-Beispielanwendung zu erstellen:

  1. Registrieren einer Microsoft Entra-App.

  2. Erstellen Sie einen Power BI-Arbeitsbereich.

  3. Erstellen Sie einen Power BI-Bericht, und veröffentlichen Sie ihn.

  4. Rufen Sie die Werte für den Einbettungsparameter ab.

  5. Betten Sie die Inhalte ein.

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:

  1. Melden Sie sich bei Power BI an.

  2. Wählen Sie Arbeitsbereich aus.

  3. Wählen Sie Arbeitsbereich erstellen aus.

  4. 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:

  1. Öffnen Sie den GitHub-Ordner mit Power BI Desktop-Beispielen.

  2. Wählen Sie Code und dann Download ZIP (ZIP herunterladen) aus.

    A screenshot showing the ZIP download option in the Power B I desktop samples GitHub

  3. Extrahieren Sie die heruntergeladene ZIP-Datei, und navigieren Sie zum Ordner Samples Reports (Beispielberichte).

  4. 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:

  1. Melden Sie sich bei Microsoft Azure an.

  2. Suchen Sie nach App-Registrierungen, und wählen Sie den Link App-Registrierungen aus.

  3. Wählen Sie die Microsoft Entra-App aus, die Sie zum Einbetten Ihrer Power BI-Inhalte verwenden.

  4. 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:

  1. Melden Sie sich bei Microsoft Azure an.

  2. Suchen Sie nach App-Registrierungen, und wählen Sie den Link App-Registrierungen aus.

  3. Wählen Sie die Microsoft Entra-App aus, die Sie zum Einbetten Ihrer Power BI-Inhalte verwenden.

  4. Wählen Sie unter Verwalten die Option Zertifikate und Geheimnisse aus.

  5. Wählen Sie unter Geheime Clientschlüssel die Option Neuer geheimer Clientschlüssel.

  6. 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.

  7. 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:

  1. Melden Sie sich beim Power BI-Dienst an.

  2. Öffnen Sie den Bericht, den Sie einbetten möchten.

  3. Kopieren Sie den eindeutigen Bezeichner aus der URL. Der eindeutige Bezeichner ist die Zahl zwischen /groups/ und /reports/ .

    A screenshot showing workspace ID GUID in the Power B I service U R L

Berichts-ID

Tipp

Gilt für: .NET Core .NET Framework ReactTypeScript

Gehen Sie wie folgt vor, um den eindeutigen Bezeichner der Berichts-ID abzurufen:

  1. Melden Sie sich beim Power BI-Dienst an.

  2. Öffnen Sie den Bericht, den Sie einbetten möchten.

  3. Kopieren Sie den eindeutigen Bezeichner aus der URL. Der eindeutige Bezeichner ist die Zahl zwischen /reports/ und /ReportSection/ .

    A screenshot showing report ID GUID in the Power B I service U R L

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.

  1. Öffnen Sie den Ordner Beispiele für Power BI für Entwickler.

  2. Wählen Sie Code und dann Download ZIP (ZIP herunterladen) aus.

    A screenshot showing the ZIP download option in the Power B I developer samples GitHub

  3. Extrahieren Sie die heruntergeladene ZIP-Datei, und navigieren Sie zum Ordner PowerBI-Developer-Samples-master.

  1. Ö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

  1. Melden Sie sich beim Azure-Portal an.

  2. Wählen Sie App-Registrierungen aus. Wenn diese Option nicht angezeigt wird, suchen Sie danach.

  3. Öffnen Sie die Microsoft Entra-Anwendung, die Sie in Schritt 1: Registrieren einer Microsoft Entra-App erstellt haben.

  4. Wählen Sie im Menü Verwalten die Option Authentifizierung.

  1. Öffnen Sie unter Plattformkonfigurationen Ihre Webplattform, und fügen Sie im Abschnitt Umleitungs-URIshttps://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.

  2. Speichern Sie die Änderungen.

Screenshot of the Azure portal window, which shows the app authentication configurations and the web redirect URI for the .NET core app sample.

Konfigurieren der Beispiel-App für Einbettungen

  1. Öffnen Sie den Ordner Embed For Your Organization (Einbettung für Ihre Organisation).

  2. Öffnen Sie die Embed For Your Organization-Beispielanwendung mit einer der folgenden Methoden:

  3. Öffnen Sie die Datei appsettings.json, und geben Sie die folgenden Parameterwerte ein:

Ausführen der Beispiel-App

  1. 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.

  1. 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.

  2. 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.

    Screenshot showing the Power BI embedding sample app.

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.