Übernehmen der Entwicklungsmethodik zum Einbetten von Power BI-Inhalten
Die folgenden Schritte skizzieren die allgemeine Methodik, die Entwickler*innen befolgen sollten, um Power BI-Inhalte programmatisch in eine neue oder bestehende Anwendung einzubinden.
- Vorbereiten der Power BI-Inhalte auf die Einbettung
- Erstellen einer Microsoft Entra ID App-Registrierung.
- Entwickeln Sie den App-Einbettungscode.
- Verbessern Sie das Benutzererlebnis mithilfe der Client-API-Funktionen.
Zunächst müssen Sie Power BI-Inhalte zum Einbetten bereithalten. Die Vorbereitung von Inhalten umfasst das Erstellen von Power BI-Arbeitsbereichen und das Veröffentlichen von Inhalten in diesen Arbeitsbereichen. Sie können Inhalte auf herkömmliche Weise erstellen und verwalten, indem Sie Power BI Desktop und den Power BI-Dienst verwenden. Der Prozess der Vorbereitung von Power BI-Inhalten für die Einbettung wird in der nächsten Lerneinheit beschrieben.
Anschließend müssen Sie eine App-Registrierung in Microsoft Entra erstellen. Durch die App-Registrierung weiß Microsoft Entra, wie es Token ausstellen kann, die den Zugriff auf Dienste und Ressourcen ermöglichen. Je nach der einbettenden Identität Ihrer App können weitere Microsoft Entra-Einstellungen erforderlich sein.
Hinweis
Informationen zum Einbetten von Identitäten und das Einrichten der App-Sicherheit finden Sie im Modul Einrichten von Berechtigungen zum Einbetten von Power BI-Inhalten.
Als nächstes entwickeln oder erweitern Sie Ihre App-Lösung mit Einbettungscode. Bei diesem Prozess werden bestimmte NuGet-Pakete importiert. Die NuGet-Pakete helfen bei den serverseitigen Anforderungen zur Authentifizierung mit Microsoft Entra ID, zur Erzeugung von Token und zur Erkennung von Power BI-Inhalten. Die eigentliche Einbettung von Power BI-Inhalten erfolgt auf der Clientseite. Ein Client-API-Vorgang bettet ein bestimmtes Power BI-Inhaltselement in ein div-Element ein.
Hinweis
Informationen zum Entwickeln von Einbettungslogik finden Sie im Modul Einbetten von Power BI-Inhalten.
Die Client-APIs können viel mehr als nur Power BI-Inhalte einbetten. Sie unterstützen viele Vorgänge, damit Sie Inhalte problemlos integrieren und verbessern können. Umfasst Folgendes:
- Programmgesteuerte Interaktion – Ihre App kann z. B. neue Filter auf einen eingebetteten Bericht anwenden.
- Abonnierende Ereignisse – Diagrammelemente, z. B. ein Säulendiagrammvisual, Menüerweiterungen und Schaltflächen, können Ereignisse auslösen, auf die Ihre App reagieren kann. Wenn der Benutzer der App z. B. eine Schaltfläche in einem Power BI-Bericht auswählt, kann Ihre App ein Dialogfenster öffnen, um Daten einzugeben und in die App-Datenbank zurückzuschreiben.
- Dynamische Berichtslayouts – Beispielsweise kann der Benutzer Ihrer App zwischen Berichten mit hellem oder dunklem Design wählen.
- Lesezeicheninteraktion – Ihre App kann vorhandene Berichtslesezeichen übernehmen oder persönliche Lesezeichen erstellen (und beibehalten).
- Erstellen von Berichtsvisuals – Ihre App kann es Benutzern ermöglichen, Berichtsvisuals zu erstellen oder vorhandene Berichtsvisuals zu personalisieren.
Hinweis
Um mehr über die Power BI-Client-APIs zu erfahren, arbeiten Sie das Modul Integrieren von Inhalten mit den Power BI Client-APIs durch.