Lernprogramm: Einbetten von Power BI-Inhalten mithilfe eines Beispieleinbettungsbeispiels für Ihre Kundenanwendung

GILT FÜR: Die App besitzt die Daten Der Benutzer besitzt die Daten

Mit Embedded Analytics und Power BI Embedded (dem Azure-Angebot) können Sie Power BI-Inhalte wie Berichte, Dashboards und Kacheln in Ihre Anwendung einbetten.

In diesem Tutorial lernen Sie Folgendes:

Benutzerinnen und Benutzer müssen sich weder bei Power BI anmelden noch über eine Power BI-Lizenz verfügen, um Ihre Anwendung verwenden zu können.

Wenn Sie ein unabhängiger Softwareanbieter oder Entwickler sind, der Anwendungen für Dritte erstellen möchte, sollten Sie zum Einbetten der Power BI-Inhalte die Methode Einbetten für Ihre Kunden verwenden.

Spezifikationen für Codebeispiele

Dieses Tutorial enthält Anweisungen zum Konfigurieren einer Beispielanwendung zum Einbetten für Ihre Kunden in einem der folgenden Frameworks:

• .NET Framework
• .NET Core
• Java
• Node JS
• Python

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 eigener Microsoft Entra-Mandant

  • Zum Authentifizieren der App bei Power BI benötigen Sie eine der folgenden Lizenzen:

    • Serviceprinzipal: Ein Microsoft Entra Serviceprinzipalobjekt, mit dem Microsoft Entra ID Ihre App authentifizieren kann.

    • Power BI Pro-Lizenz: Dies ist Ihr Hauptbenutzerkonto, das Ihre App zum Authentifizieren bei Power BI verwendet.

    • Power BI PPU-Lizenz (Premium Per User): Dies ist Ihr Hauptbenutzerkonto, das Ihre App zum Authentifizieren bei Power BI verwendet.

    Hinweis

    Für den Wechsel in die Produktionsphase benötigen Sie eine Kapazität.

• Codeabhängigkeiten

Methode

Gehen Sie wie folgt vor, um die Beispielanwendung embed for your customers zu erstellen:

1. Wählen Sie die Authentifizierungsmethode aus.

2. Registrieren einer Microsoft Entra-App.

3. Erstellen Sie einen Power BI-Arbeitsbereich.

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

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

6. API-Zugriff des Dienstprinzipals

7. Aktivieren Sie den Arbeitsbereichszugriff.

8. Betten Sie die Inhalte ein.

Schritt 1: Auswählen der Authentifizierungsmethode

Ihre eingebettete Lösung variiert je nach der ausgewählten Authentifizierungsmethode. Daher ist es wichtig, dass Sie die Unterschiede zwischen den Authentifizierungsmethoden kennen, damit Sie entscheiden können, welche für Ihre Lösung am besten geeignet ist.

In der folgenden Tabelle werden einige entscheidende Unterschiede zwischen den Authentifizierungsmethoden per Dienstprinzipal und Hauptbenutzerkonto beschrieben.

Schritt 2: Registrieren einer Microsoft Entra-App

Wenn Sie die Anwendung bei Microsoft Entra ID registrieren, haben Sie folgende Möglichkeiten:

Befolgen Sie die Anweisungen unter Registrieren Ihrer Anwendung, um Ihre Anwendung bei Microsoft Entra ID zu registrieren.

Schritt 3: Erstellen eines Power BI-Arbeitsbereichs

Microsoft Fabric speichert Ihre Berichte, Dashboards und Kacheln in einem Arbeitsbereich. Um diese Elemente einzubetten, müssen Sie sie erstellen und in einen Arbeitsbereich hochladen.

Gehen Sie folgendermaßen vor, um einen Arbeitsbereich zu erstellen:

1. Melden Sie sich bei Fabric an.
2. Wählen Sie Arbeitsbereiche aus.
3. Wählen Sie +Neuer Arbeitsbereich aus.
4. Benennen Sie Ihren Arbeitsbereich und wählen Sie Übernehmen aus.

Schritt 4: 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. Oder Sie können einen Beispielbericht in Ihren Arbeitsbereich hochladen.

Führen Sie die folgenden Schritte aus, um einen Beispielbericht (nicht mit Direct Lake aktiviert) herunterzuladen und in Ihrem Arbeitsbereich zu veröffentlichen:

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

2. Wählen Sie "Code" und dann " ZIP herunterladen" aus.

   

3. Extrahieren Sie die heruntergeladene ZIP-Datei, und navigieren Sie zum Ordner "Beispielberichte" .

4. Wählen Sie den Bericht aus, den Sie einbetten möchten, und veröffentlichen Sie ihn im Arbeitsbereich.

Schritt 5: Abrufen der Werte für den Einbettungsparameter

Zum Einbetten von Inhalten müssen Sie bestimmte Parameterwerte abrufen. In der folgenden Tabelle sind die erforderlichen Werte aufgeführt. Es wird angegeben, ob sie für die Authentifizierungsmethode mit Dienstprinzipal, die Methode mit Hauptbenutzer oder beide gelten.

Vergewissern Sie sich vor dem Einbetten von Inhalten, dass alle im Folgenden aufgeführten Werte vorhanden sind. Einige Werte können je nach verwendeter Authentifizierungsmethode variieren.

Parameter	Dienstprinzipal	Hauptbenutzer
Client-ID
Arbeitsbereichs-ID
Berichts-ID
Geheimer Clientschlüssel
Mandanten-ID		Nur für Node JS erforderlich
Power BI-Benutzername
Power BI-Kennwort

Kunden-ID

Führen Sie die folgenden Schritte aus, um die Client-ID-GUID (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 (GUID) Anwendungs-(Client)-ID.

Arbeitsbereichs-ID

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 GUID ist die Zahl zwischen /groups/ und /reports/.

   

Alternativ können Sie die Arbeitsbereichs-ID auch in den Einstellungen des Verwaltungsportals finden, indem Sie neben dem Arbeitsbereichsnamen Details auswählen.

Berichts-ID

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

   

Geheimer Clientschlüssel

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.

Mandanten-ID

Gehen Sie wie folgt vor, um den eindeutigen Bezeichner der Mandanten-ID 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 Verzeichnis-ID (Mandant).

Benutzername und Kennwort für Power BI

Rufen Sie den Benutzernamen und das Kennwort des Power BI-Benutzers ab, den Sie als Hauptbenutzer verwenden. Dabei handelt es sich um denselben Benutzer, den Sie zum Erstellen eines Arbeitsbereichs und zum Hochladen eines Berichts im Power BI-Dienst verwendet haben.

Schritt 6: API-Zugriff des Dienstprinzipals

Damit eine Microsoft Entra-App auf die Power BI-Inhalte und -APIs zugreifen kann, muss ein*e Power BI-Administrator*in den Dienstprinzipalzugriff im Power BI-Verwaltungsportal aktivieren. Wenn Sie nicht der Administrator Ihres Mandanten sind, bitten Sie den Administrator des Mandanten, die Mandanteneinstellungen zu aktivieren.

1. Wählen Sie in Power BI-DienstEinstellungen>Einstellungen>Verwaltungsportal aus.

   

2. Wählen Sie Mandanteneinstellungen aus, und scrollen Sie nach unten zum Abschnitt Entwicklereinstellungen.

3. Erweitern Sie die Erlaubnis für Dienstprinzipale, Fabric-APIs zu verwenden, und aktivieren Sie diese Option.

   

Schritt 7: Aktivieren des Arbeitsbereichszugriffs

Fügen Sie dem Arbeitsbereich den/die Dienstprinzipal*in oder Hauptbenutzer*in als Mitglied oder Administrator*in hinzu, um Microsoft Entra-App-Zugriffsobjekte wie Berichte, Dashboards und semantische Modelle im Power BI-Dienst zu aktivieren.

1. Melden Sie sich bei Fabric an.

2. Scrollen Sie zum Arbeitsbereich, für den Sie den Zugriff aktivieren möchten, und wählen Sie "Zugriff verwalten" aus.

   

3. Je nachdem, welche Authentifizierungsmethode Sie verwendeten, kopieren Sie im Bereich Zugriff den Dienstprinzipal oder den Hauptbenutzer in das Textfeld E-Mail-Adresse eingeben.

   Hinweis

   Wenn Sie einen Dienstprinzipal verwenden, hat dieser den Namen, den Sie Ihrer Microsoft Entra-App gegeben haben.

4. Wählen Sie Hinzufügen aus.

Schritt 8: Einbetten der Inhalte

Mit der eingebetteten Power BI-Beispielanwendung können Sie die Power BI-App embed for your customers erstellen.

Gehen Sie wie folgt vor, um die Beispielanwendung embed for your customers 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 " ZIP herunterladen" aus.

   

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

4. Öffnen Sie einen der folgenden Ordner, je nachdem, welche Sprache für Ihre App verwendet werden soll:

   • .NET Core
   • .NET Framework
   • Java
   • Node JS
   • Python

   Hinweis

   Von den Beispielanwendungen embed for your customers werden nur die oben genannten Frameworks unterstützt. Von der Beispielanwendung React wird nur die Lösung Einbetten für Ihre Organisation unterstützt.

5. Öffnen Sie den Ordner Einbetten für Ihre Kunden.

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.

Testen Sie den Analysen-Playground von Power BI Embedded, um mit der Entwicklung zu beginnen und über alle neuen Power BI Embedded-Features und -Updates auf dem Laufenden zu bleiben.

Wenn Sie bereit sind, informieren Sie sich über die Anforderungen unter In die Produktionsphase wechseln. Zudem benötigen Sie eine Kapazität und sollten den Artikel Kapazitätsplanung lesen, um zu entscheiden, welche SKU für Ihre Anforderungen am besten geeignet ist.

Überlegungen und Einschränkungen

Die folgenden Einschränkungen gelten für den Direct Lake-Modus:

• Erfordert ein V2-Einbettungstoken.
• Wenn Sie einen Dienstprinzipal verwenden, benötigen Sie eine Verbindung mit fester Identität (ohne SSO).
• Das Festlegen eines Dienstprinzipals als Authentifizierungsmethode für eine Verbindung mit fester Identität ist derzeit die einzige Option, die durch Automatisierung unterstützt wird. Andere Methoden werden manuell über das Portal unterstützt.

Zugehöriger Inhalt

• Übergang in die Produktion
• Embed for your organization (Einbetten für Ihre Organisation)
• Paginierte Berichte einbetten

Weitere Fragen? Fragen an die Power BI-Community