Zunächst müssen Sie wissen, dass es zwei Modi zum Einbetten von Power BI gibt – user owns data
und app owns data
. Im ersten Modus authentifiziert sich der Benutzer beim Einbetten mit seinem eigenen Power BI Pro-Konto, d. h. jeder Ihrer Benutzer benötigt eine Power BI Pro-Lizenz. Bei letzterem benötigen Sie nur einen „Master Account“, der zur Authentifizierung verwendet wird. Die Unterschiede in der Implementierung sind nicht enorm, daher beschreibe ich app owns data
.
Sie müssen Folgendes tun:
-
Registrieren Sie eine Anwendung – gehen Sie zu dev.powerbi.com/apps und registrieren Sie eine native Anwendung. Wählen Sie aus, welche Berechtigungen erteilt werden sollen (wenn Sie sich nicht sicher sind, erteilen Sie für Ihre ersten Tests einfach alle). Kopieren Sie die Anleitung – dies ist die App-ID, auch bekannt als Client-ID.
-
Der nächste Schritt besteht darin, sich bei Ihrer Anwendung zu authentifizieren und ein Zugriffstoken zu erhalten. Verwenden Sie Azure Active Directory Authentication Library ( ADAL) Rufen Sie dazu einige der
acquireToken
auf Methoden vonAuthenticationContext
Klasse. -
Verwenden Sie dieses Zugriffstoken, um die Power BI-REST-API aufzurufen und die
embedUrl
abzurufen des Elements, das Sie einbetten möchten, z. Bericht . -
Verwenden Sie Power BI JavaScript-Client um dieses Element tatsächlich einzubetten. Sie müssen eine Einbettungskonfigurationsklasse initialisieren und Informationen über Elementtyp (Bericht, Dashboard, Kachel), wo es zu finden ist (embedUrl), Authentifizierung (Zugriffstoken), einige andere Konfigurationsoptionen (Filterbereich ein- oder ausblenden, Navigation usw.), anzuwendende Filter und weitergeben demnächst. Falls Sie das oben erworbene Zugriffstoken verwenden, legen Sie
tokenType
festAAD
sein . Dieses Token hat viele Privilegien, daher sollten Sie aus SicherheitsgründenEmbed
verwenden stattdessen Token. Verwenden Sie in diesem Fall das Zugriffstoken, um die REST-API erneut aufzurufen (z. B. Berichte generierenTokenInGroup ). -
Rufen Sie
powerbi.embed
auf -Methode des JavaScript-Clients die eingebettete Konfiguration übergeben, um dieses Power BI-Element in Ihrer App zu visualisieren.
Hier sind einige Ressourcen, die Sie lesen sollten:
- Tutorial:Embed Power BI-Inhalte in eine Anwendung für Ihre Kunden
- Anleitung:Einbetten von Power BI-Inhalten in eine Anwendung für Ihre Organisation
- Einbettungsgrundlagen
- Power BI Embedded Playground
- PowerBI-Entwicklerbeispiele