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:

• Einrichten der eingebetteten Umgebung.
• Konfigurieren der Beispielanwendung Einbetten für Ihre Kunden (auch als App Owns Data bezeichnet).

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.

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 der Beispielanwendung Einbetten für Ihre Kunden in einer 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/e eigene/r Microsoft Entra-Mandant*in.

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

    • Dienstprinzipal: Ein Microsoft Entra Dienstprinzipalobjekt, 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

.NET Core

• .NET Core 3.1 SDK (oder höher)

• Eine integrierte Entwicklungsumgebung (IDE). Es wird empfohlen, eine der folgenden Umgebungen zu verwenden:

  • Visual Studio

  • Visual Studio Code

.NET Framework

• .NET Framework 4.8

• Visual Studio

Java

• JDK (oder JRE)

• Eclipse-IDE: Vergewissern Sie sich, dass Eclipse for Java EE Developers (Enterprise Edition) vorhanden ist.

• Apache Tomcat Binary Distributions

Node JS

• Node.js

• Eine integrierte Entwicklungsumgebung (IDE). Es wird empfohlen, eine der folgenden Umgebungen zu verwenden:

  • Visual Studio

  • Visual Studio Code

Python

• Python 3 (oder höher)

  Hinweis

  • Wenn Sie Python zum ersten Mal installieren, wählen Sie die Option Add Python to PATH (Python zu PATH hinzufügen) aus, um der Variablen PATH die Installation hinzuzufügen.
  • Wenn Python bereits installiert ist, vergewissern Sie sich, dass die Variable PATH den Installationspfad enthält. Weitere Informationen finden Sie in der Python-Dokumentation Excursus: Setting environment variables (Festlegen von Umgebungsvariablen) (dieser Link bezieht sich auf Python 3).

• Eine integrierte Entwicklungsumgebung (IDE). Es wird empfohlen, eine der folgenden Umgebungen zu verwenden:

  • Visual Studio

  • Visual Studio Code

Methode

Gehen Sie wie folgt vor, um die Beispielanwendung Einbetten für Ihre Kunden 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.

Aspekt	Dienstprinzipal	Hauptbenutzer
Mechanismus	Mit dem Dienstprinzipalobjekt der Microsoft Entra-App kann die App über Microsoft Entra ID mit der eingebetteten Lösung bei Power BI authentifiziert werden.	Für die Authentifizierung bei Power BI werden von der Microsoft Entra-App die Anmeldeinformationen (Benutzername und Kennwort) eines Power BI-Benutzers verwendet.
Sicherheit	Dienstprinzipal ist die empfohlene Autorisierungsmethode für Microsoft Entra ID. Wenn Sie einen Dienstprinzipal verwenden, können Sie sich entweder mit einem Anwendungsgeheimnis oder einem Zertifikat authentifizieren. In diesem Tutorial wird nur die Verwendung des Dienstprinzipals mit einem Anwendungsgeheimnis beschrieben. Informationen zum Einbetten mit Dienstprinzipal und Zertifikat finden Sie im Artikel Einbetten von Power BI-Inhalten mit Dienstprinzipal und Zertifikat.	Diese Authentifizierungsmethode ist nicht so sicher wie ein Dienstprinzipal. Sie müssen bei den Anmeldeinformationen (Benutzername und Kennwort) des Hauptbenutzers achtgeben. Machen Sie sie z. B. nicht in Ihrer eingebetteten Anwendung verfügbar, und ändern Sie das Kennwort regelmäßig.
Delegierte Microsoft Entra-ID-Berechtigungen	Nicht erforderlich.	Der Hauptbenutzer oder ein Administrator muss die Einwilligung erteilen, dass die App Zugriff auf Berechtigungen der Power BI-REST-API (auch als Bereiche bezeichnet) hat. Beispiel: Report.ReadWrite.All.
Zugriff auf den Power BI-Dienst	Auf den Power BI-Dienst können Sie nicht mit einem Dienstprinzipal zugreifen.	Verwenden Sie für den Zugriff auf den Power BI-Dienst die Anmeldeinformationen des Hauptbenutzers.
Lizenz	Setzt keine Pro-Lizenz voraus. Sie können Inhalte aus einem Arbeitsbereich verwenden, bei dem Sie Mitglied oder Administrator sind.	Erfordert eine Power BI Pro or Premium pro Benutzer (PPU)-Lizenz.

Schritt 2: Registrieren einer Microsoft Entra-App

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

• Einrichten einer Identität für die App
• Zulassen, dass die App auf die Power BI-REST-APIs zugreifen kann
• Bei Verwendung eines Hauptbenutzers: Angeben der Power BI-REST-Berechtigungen der App

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

Hinweis

Vor dem Registrieren der Anwendung müssen Sie entscheiden, welche Authentifizierungsmethode verwendet werden soll: Dienstprinzipal oder Hauptbenutzer.

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.

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 Fabric an.

2. Wählen Sie Arbeitsbereiche aus.

3. Wählen Sie +Neuer Arbeitsbereich aus.

4. Geben Sie dem Arbeitsbereich einen Namen, und wählen Sie Speichern 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. 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.

   

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 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, und es ist jeweils angegeben, ob die Werte für die Authentifizierungsmethode per Dienstprinzipal und/oder die Authentifizierungsmethode per Hauptbenutzerkonto verwendet wird.

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
Tenant ID		Nur für Node JS erforderlich
Power BI-Benutzername
Power BI-Kennwort

Client-ID

Tipp

Gilt für: Hauptbenutzer des Dienstprinzipals

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

Arbeitsbereichs-ID

Tipp

Gilt für: Hauptbenutzer des Dienstprinzipals

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

   

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

Berichts-ID

Tipp

Gilt für: Hauptbenutzer des Dienstprinzipals

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

Tipp

Gilt für: Hauptbenutzer des Dienstprinzipals

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.

Mandanten-ID

Tipp

Gilt für: Hauptbenutzer des Dienstprinzipals

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

Tipp

Gilt für: Hauptbenutzer des Dienstprinzipals

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

Tipp

Gilt für: Hauptbenutzer des Dienstprinzipals

Dieser Schritt ist nur relevant, wenn Sie die Authentifizierungsmethode Dienstprinzipal verwenden. Wenn Sie einen Hauptbenutzer verwenden, überspringen Sie diesen Schritt und fahren mit Schritt 7: Aktivieren des Arbeitsbereichszugriffs fort.

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 Dienstprinzipalen die Verwendung von Fabric-APIs gestatten, und aktivieren Sie diese Option.

   

Hinweis

Wenn Sie einen Dienstprinzipalverwenden, sollten Sie dessen Zugriff auf die Mandanteneinstellungen mit einer Sicherheitsgruppebegrenzen. Weitere Informationen zu diesem Feature finden Sie in den folgenden Abschnitten des Artikels zum Dienstprinzipal:

• Erstellen einer Microsoft Entra-Sicherheitsgruppe
• Aktivieren Sie die Administratoreinstellungen für den Power BI-Dienst

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 eine/n Dienstprinzipal*in verwenden, hat dieser den Namen, den Sie Ihrer Azure AD-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 Einbetten für Ihre Kunden erstellen.

Gehen Sie wie folgt vor, um die Beispielanwendung Einbetten für Ihre Kunden 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.

   

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 Einbetten für Ihre Kunden 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.

.NET Core

6. Öffnen Sie die Beispielanwendung „Einbetten für Ihre Kunden“ mit einer der folgenden Methoden:

   • Wenn Sie Visual Studio verwenden, öffnen Sie die Datei AppOwnsData.sln.

   • Wenn Sie Visual Studio Code verwenden, öffnen Sie den Ordner AppOwnsData.

7. Öffnen Sie appsettings.json.

8. Geben Sie je nach Authentifizierungsmethode die folgenden Parameterwerte ein:

   Parameter	Dienstprinzipal	Hauptbenutzer
   AuthenticationMode	ServicePrincipal	MasterUser
   ClientId	Die Client-ID Ihrer Microsoft Entra-App	Die Client-ID Ihrer Microsoft Entra-App
   TenantId	Ihre Microsoft Entra-Mandant*inen-ID	–
   PbiUsername	–	Den Benutzernamen des Hauptbenutzers finden Sie unter Benutzername und Kennwort für Power BI.
   PbiPassword	–	Das Kennwort des Hauptbenutzers finden Sie unter Benutzername und Kennwort für Power BI.
   ClientSecret	Der geheime Clientschlüssel Ihrer Microsoft Entra-App	N/V
   WorkspaceId	Die ID des Arbeitsbereichs mit dem eingebetteten Bericht finden Sie unter Arbeitsbereichs-ID.	Die ID des Arbeitsbereichs mit dem eingebetteten Bericht finden Sie unter Arbeitsbereichs-ID.
   ReportId	Die ID des Berichts, den Sie einbetten, finden Sie unter Berichts-ID.	Die ID des Berichts, den Sie einbetten, finden Sie unter Berichts-ID.

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

.NET Framework

6. Wenn Sie Visual Studio verwenden, öffnen Sie die Datei AppOwnsData.sln.

7. Öffnen Sie die Datei Web.config.

8. Geben Sie je nach Authentifizierungsmethode die folgenden Parameterwerte ein:

   Parameter	Dienstprinzipal	Hauptbenutzer
   authenticationType	ServicePrincipal	MasterUser
   applicationId	Die Client-ID Ihrer Microsoft Entra-App	Die Client-ID Ihrer Microsoft Entra-App
   workspaceId	Die ID des Arbeitsbereichs mit dem eingebetteten Bericht finden Sie unter Arbeitsbereichs-ID.	Die ID des Arbeitsbereichs mit dem eingebetteten Bericht finden Sie unter Arbeitsbereichs-ID.
   reportId	Die ID des Berichts, den Sie einbetten, finden Sie unter Berichts-ID.	Die ID des Berichts, den Sie einbetten, finden Sie unter Berichts-ID.
   pbiUsername	–	Den Benutzernamen des Hauptbenutzers finden Sie unter Benutzername und Kennwort für Power BI.
   pbiPassword	–	Das Kennwort des Hauptbenutzers finden Sie unter Benutzername und Kennwort für Power BI.
   applicationSecret	Der geheime Clientschlüssel Ihrer Microsoft Entra-App	N/V
   tenant	Ihre Microsoft Entra-Mandant*inen-ID	N/V

9. Führen Sie das Projekt aus, indem Sie IIS Express (Wiedergabe) auswählen.

Java

6. Öffnen Sie Eclipse, und befolgen Sie die im Folgenden beschriebenen Anweisungen.

   Hinweis

   Die Anweisungen für die Beispielanwendung „Einbetten für Ihre Kunden“ für Java finden Sie unter Eclipse IDE for Java EE Developers (Enterprise Edition). Wenn Sie eine andere Anwendung verwenden, müssen Sie diese selbst einrichten.

7. Fügen Sie Eclipse den Tomcat-Server hinzu:

   a. Wählen Sie Fenster>Ansicht anzeigen>Server aus.

   b. Wählen Sie auf der Registerkarte „Server“ No servers are available. Click this link to create new server. (Keine Server verfügbar. Klicken Sie auf diesen Link, um einen neuen Server zu erstellen.) aus.

   c. Klappen Sie im Fenster Define a New Server (Neuen Server definieren) Apache auf, und wählen Sie den Tomcat-Server aus, der auf Ihrem Computer ausgeführt wird. Beispiel: Tomcat v9.0 Server.

   d. Wählen Sie Weiter aus.

   e. Wählen Sie im Fenster Tomcat Server (Tomcat-Server) Durchsuchen aus, und navigieren Sie zu dem Ordner, der den Tomcat-Server enthält.

   f. Wählen Sie im Fenster Tomcat Server (Tomcat-Server) Installed JREs (Installierte JREs) aus.

   g. Wählen Sie im Fenster Installed JREs (Installierte JREs) die verfügbare JRE aus, und klicken Sie auf Anwenden und schließen.

   h. Wählen Sie im Fenster Tomcat Server (Tomcat-Server) Fertig stellen aus. Der Tomcat-Server wird auf der Registerkarte Server angezeigt.

8. Öffnen Sie das Projekt in Eclipse:

   Wichtig

   Wenn der Pfadname zu lang ist, tritt bei Eclipse möglicherweise ein Fehler auf. Achten Sie zur Vermeidung dieses Problems darauf, dass der Ordner der Beispielanwendung nicht zu tief in der Ordnerstruktur Ihres Computers geschachtelt ist.

   a. Wählen Sie Datei und dann Open Projects from File System (Projekte über Dateisystem öffnen) aus.

   b. Wählen Sie im Fenster Import Projects form File System or Archive (Projekte aus Dateisystem oder Archiv importieren) Directory (Verzeichnis) aus, und öffnen Sie den Ordner AppOwnsData.

   c. Wählen Sie Fertig stellenaus.

9. Fügen Sie dem Projekt den Tomcat-Server hinzu:

   a. Klicken Sie im Bereich Paket-Explorer mit der rechten Maustaste auf AppOwnsData, und wählen Sie Eigenschaften aus.

   b. Wählen Sie im Fenster Eigenschaften von AppOwnsData die Option Targeted Runtimes (Ziellaufzeiten) und dann Apache Tomcat aus. In dieser Auswahl ist die Version von Apache Tomcat enthalten, die Sie verwenden, z. B. Apache Tomcat v9.0.

   c. Wählen Sie Anwenden und schließen aus.

10. Geben Sie die erforderlichen Parameter ein.

    a. Erweitern Sie im Paket-Explorer das Projekt AppOwnsData.

    b. Erweitern Sie Java-Ressourcen.

    c. Erweitern Sie src.

    d. Erweitern Sie com.embedsample.appoensdata.config.

    e. Öffnen Sie Config.java.

    f. Geben Sie je nach Authentifizierungsmethode die folgenden Parameterwerte ein:

    Parameter	Dienstprinzipal	Hauptbenutzer
    authenticationType	ServicePrincipal	MasterUser
    workspaceId	Die ID des Arbeitsbereichs mit dem eingebetteten Bericht finden Sie unter Arbeitsbereichs-ID.	Die ID des Arbeitsbereichs mit dem eingebetteten Bericht finden Sie unter Arbeitsbereichs-ID.
    reportId	Die ID des Berichts, den Sie einbetten, finden Sie unter Berichts-ID.	Die ID des Berichts, den Sie einbetten, finden Sie unter Berichts-ID.
    clientId	Die Client-ID Ihrer Microsoft Entra-App	Die Client-ID Ihrer Microsoft Entra-App
    pbiUsername	N/V	Den Benutzernamen des Hauptbenutzers finden Sie unter Benutzername und Kennwort für Power BI.
    pbiPassword	–	Das Kennwort des Hauptbenutzers finden Sie unter Benutzername und Kennwort für Power BI.
    tenantId	Ihre Microsoft Entra-Mandant*inen-ID	N/V
    appSecret	Der geheime Clientschlüssel Ihrer Microsoft Entra-App	N/V

11. Ausführen des Projekts

    a. Klicken Sie im Paket-Explorer mit der rechten Maustaste auf AppOwnesData.

    b. Wählen Sie Ausführen als>Auf Server ausführen.

    c. Wählen Sie im Fenster Auf Server ausführenWählen Sie einen vorhandenen Server aus und dann Tomcat-Server aus.

    d. Wählen Sie Fertig stellen aus.

Node JS

6. Öffnen Sie den Ordner App Owns Data mit der gewünschten IDE. Es wird empfohlen, eine der folgenden Komponenten zu verwenden:

   • Visual Studio

   • Visual Studio Code

7. Öffnen Sie ein Terminal, und installieren Sie die erforderlichen Abhängigkeiten, indem Sie npm install ausführen.

8. Erweitern Sie den Ordner Config, und öffnen Sie config.json.

9. Geben Sie je nach Authentifizierungsmethode die folgenden Parameterwerte ein:

   Parameter	Dienstprinzipal	Hauptbenutzer
   authenticationMode	ServicePrincipal	MasterUser
   clientId	Die Client-ID Ihrer Microsoft Entra-App	Die Client-ID Ihrer Microsoft Entra-App
   workspaceId	Die ID des Arbeitsbereichs mit dem eingebetteten Bericht finden Sie unter Arbeitsbereichs-ID.	Die ID des Arbeitsbereichs mit dem eingebetteten Bericht finden Sie unter Arbeitsbereichs-ID.
   reportId	Die ID des Berichts, den Sie einbetten, finden Sie unter Berichts-ID.	Die ID des Berichts, den Sie einbetten, finden Sie unter Berichts-ID.
   pbiUsername	–	Den Benutzernamen des Hauptbenutzers finden Sie unter Benutzername und Kennwort für Power BI.
   pbiPassword	–	Das Kennwort des Hauptbenutzers finden Sie unter Benutzername und Kennwort für Power BI.
   clientSecret	Der geheime Clientschlüssel Ihrer Microsoft Entra-App	N/V
   tenantId	Ihre Microsoft Entra-Mandant*inen-ID	Ihre Microsoft Entra-Mandant*inen-ID

10. Gehen Sie wie folgt vor, um das Projekt auszuführen:

    a. Führen Sie im IDE-Terminal npm start aus.

    b. Öffnen Sie im Browser eine neue Registerkarte, und navigieren Sie zu http://localhost:5300.

Python

6. Öffnen Sie PowerShell oder eine Eingabeaufforderung.

7. Nachdem Sie sich vergewissert haben, dass Sie sich im Python-Ordner>Einbetten für Ihre Kunden befinden und dass sich die Datei requirements.txt im Ordner befindet, führen Sie pip3 install -r requirements.txt aus.

8. Öffnen Sie den Ordner App Owns Data mit der gewünschten IDE. Es wird empfohlen, eine der folgenden Umgebungen zu verwenden:

   • Visual Studio

   • Visual Studio Code

9. Öffnen Sie config.py.

10. Geben Sie je nach Authentifizierungsmethode die folgenden Parameterwerte ein:

    Parameter	Dienstprinzipal	Hauptbenutzer
    AUTHENTICATION_MODE	ServicePrincipal	MasterUser
    WORKSPACE_ID	Die ID des Arbeitsbereichs mit dem eingebetteten Bericht finden Sie unter Arbeitsbereichs-ID.	Die ID des Arbeitsbereichs mit dem eingebetteten Bericht finden Sie unter Arbeitsbereichs-ID.
    REPORT_ID	Die ID des Berichts, den Sie einbetten, finden Sie unter Berichts-ID.	Die ID des Berichts, den Sie einbetten, finden Sie unter Berichts-ID.
    TENANT_ID	Ihre Microsoft Entra-Mandant*inen-ID	N/V
    CLIENT_ID	Die Client-ID Ihrer Microsoft Entra-App	Die Client-ID Ihrer Microsoft Entra-App
    CLIENT_SECRET	Der geheime Clientschlüssel Ihrer Microsoft Entra-App	–
    POWER_BI_USER	–	Den Benutzernamen des Hauptbenutzers finden Sie unter Benutzername und Kennwort für Power BI.
    POWER_BI_PASS	–	Das Kennwort des Hauptbenutzers finden Sie unter Benutzername und Kennwort für Power BI.

11. Speichern Sie die Datei .

12. Führen Sie die folgenden Schritte aus, um das Projekt auszuführen:

    a. Navigieren Sie in PowerShell oder über die Eingabeaufforderung zum Python-Ordner>Einbetten für Ihre Kunden>AppOwnesData, und führen Sie flask run aus.

    b. Öffnen Sie im Browser eine neue Registerkarte, und navigieren Sie zu http://localhost:5000.

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.

Wichtig

Wenn Sie kostenlose Testtoken für die Entwicklung verwendet haben, müssen Sie für die Produktion Kapazitäten erwerben. Bis zum Erwerb einer Kapazität wird das Banner der kostenlosen Testversion weiterhin oben im eingebetteten Bericht angezeigt.

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