Grundlegendes zu den verschiedenen Einbettungslösungen
Durch das Einbetten von Power BI-Elementen (z. B. Berichte, Dashboards und Q&A) in Ihre Anwendung können Sie beeindruckende, vollständig interaktive Analysen integrieren, ohne Ihre eigenen Datenvisualisierungen und -steuerelemente von Grund auf neu erstellen zu müssen. Die von Ihnen eingebetteten Power BI-Analysen können entweder Daten, die Ihre App besitzt, über Ihr eigenes Power BI-Konto oder daten, die der Benutzer über seine Power BI-Konten besitzt, darstellen.
Anwendungsszenarien
Es gibt zwei verschiedene Szenarien zum Einbetten eines Power BI-Berichts in eine Anwendung.
- Einbetten für Ihre organization (auch als Benutzerbesitz von Daten bezeichnet): Mit der Anwendung können Sie Daten, Berichte, Dashboards und Kacheln integrieren, auf die Benutzer in Ihrem organization zugreifen können, wenn sie sich mit ihren eigenen Power BI-Konten anmelden. In diesem Anwendungstyp besitzen die Benutzer die einbettenten Daten.
- Einbetten für Ihre Kunden (auch als App-Besitzer von Daten bezeichnet): Die Anwendung stellt die Daten, Berichte, Dashboards oder Kacheln dar, die Sie in Ihr eigenes Power BI-Konto hochgeladen haben. Bei dieser Art von Anwendung verwenden Sie Ihr eigenes Konto, sodass Ihre Anwendung die Daten für Ihre Kunden besitzt. Ihre Kunden benötigen kein eigenes Power BI-Konto.
Das von Ihnen verwendete Anwendungsszenario bestimmt, wie Sie ein Zugriffstoken abrufen, mit dem Sie auf Daten zugreifen und Inhalte in Ihre Anwendung einbetten können.
Der Von Ihnen eingebettete Inhaltstyp wird durch den Wert desembedUrl Parameters angegeben. Um eine Einbettungs-URL für einen bestimmten Inhaltstyp abzurufen, rufen Sie die entsprechende Power BI-REST-API auf. Rufen Sie beispielsweise Berichte abrufen auf, um die Einbettungs-URL zum Einbetten eines Berichts abzurufen.
In den folgenden Abschnitten wird gezeigt, wie Sie ein Zugriffstoken abrufen und einen Bericht für jedes dieser Anwendungsszenarien einbetten.
Einbetten für Ihre Organisation
In diesem Szenario melden sich Benutzer Ihrer Anwendung mit ihren Power BI-Konten an. Dadurch erhalten Sie das Zugriffstoken für den Zugriff auf ihre Daten und das Einbetten ihrer Berichte, Dashboards und Kacheln.
Legen Sie in auf embedConfigurationfestTokenType.AadtokenType.
// Get models so you can use the TokenType enum.
let models = window['powerbi-client'].models;
let embedConfiguration = {
type: 'report',
id: '5dac7a4a-4452-46b3-99f6-a25915e0fe55',
embedUrl: 'https://app.powerbi.com/reportEmbed',
tokenType: models.TokenType.Aad,
accessToken: 'e4...rf'
};
let reportContainer = $('#reportContainer')[0];
let report = powerbi.embed(reportContainer, embedConfiguration);
Einbetten für Ihre Kunden
In diesem Szenario erstellen Sie eine dedizierte Identität, die Zugriff auf alle Power BI-Elemente hat. Anschließend generieren Sie ein Einbettungstoken für die Berichte, Dashboards oder Kacheln, die Sie einbetten möchten, indem Sie das Power BI-REST-API-Einbettungstoken aufrufen. Nachdem Sie über ein Einbettungstoken verfügen, verwenden Sie den folgenden Code, um den Bericht einzubetten:
Legen Sie in auf embedConfigurationfestTokenType.EmbedtokenType.
// Get models so you can use the TokenType enum.
let models = window['powerbi-client'].models;
let embedConfiguration = {
type: 'report',
id: '5dac7a4a-4452-46b3-99f6-a25915e0fe55',
embedUrl: 'https://app.powerbi.com/reportEmbed',
tokenType: models.TokenType.Embed,
accessToken: 'h4...rf'
};
let reportContainer = $('#reportContainer')[0];
let report = powerbi.embed(reportContainer, embedConfiguration);