Freigeben über

Grundlegendes zu den verschiedenen Einbettungslösungen

  • Artikel

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 einbettende Power BI-Analyse kann entweder Daten darstellen, die Ihre -App über Ihr eigenes Power BI-Konto, oder Daten, die der Benutzer über ihre Power BI-Konten besitzt,.

Anwendungsszenarien

Es gibt zwei verschiedene Szenarien zum Einbetten eines Power BI-Berichts in eine Anwendung.

  • Embed for your organization (auch bekannt als Benutzer besitzt Daten): Mit der Anwendung können Sie Daten, Berichte, Dashboards und Kacheln integrieren, auf die Benutzer in Ihrer Organisation zugreifen können, wenn sie sich mit ihren eigenen Power BI-Konten anmelden. In dieser Art von Anwendung besitzen die Benutzer die Daten, die Sie einbetten.
  • Embed for your customers (auch bekannt als App owns data): The application presents the data, reports, dashboards, or tiles that you uploaded to your own Power BI account. In 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 anwendungsszenario, das Sie verwenden, bestimmt, wie Sie ein Zugriffstoken abrufen, mit dem Sie auf Daten zugreifen und Inhalte in Ihre Anwendung einbetten können.

Der Inhaltstyp, den Sie einbetten, wird durch den Wert desembedUrl-Parameters angegeben. Rufen Sie die entsprechende Power BI-REST-API auf, um eine Einbettungs-URL für einen bestimmten Inhaltstyp abzurufen. Rufen Sie beispielsweise Abrufen von Berichten 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 jede 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 im embedConfigurationtokenType auf TokenType.Aadfest.

// 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 Embed Token für die Berichte, Dashboards oder Kacheln, die Sie einbetten möchten, indem Sie die Power BI REST-API Embed Tokenaufrufen. Nachdem Sie ein Einbettungstokenhaben, verwenden Sie den folgenden Code, um den Bericht einzubetten:

Legen Sie im embedConfigurationtokenType auf TokenType.Embedfest.

// 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);

Verwandte Inhalte