Freigeben über

Einbetten eines Berichts

  • Artikel

Trinkgeld

Versuchen Sie, einen Bericht einzubetten oder mit unseren Client-APIs im Abschnitt Erkunden sie unsere APIs Abschnitt des Power BI Embedded Analytics Playground.

In diesem Artikel werden die Schritte zum Einbetten eines Power BI-Berichts in Ihre Anwendung behandelt. Erfahren Sie mehr über Berichte in Berichten in Power BI.

So betten Sie einen Bericht ein

Wenn Sie Power BI-Inhalte in eine App einbetten, verwenden Sie ein Konfigurationsobjekt, um den Inhalt zu definieren, den Sie einbetten, und um die Einstellungen des Inhalts anzugeben. Anschließend übergeben Sie dieses Objekt an die API. Weitere Informationen finden Sie unter Konfigurieren von Berichtseinstellungen.

Einbetten eines vorhandenen Berichts

Wenn Sie einen bereits vorhandenen Bericht einbetten, verwenden Sie ein Konfigurationsobjekt vom Typ IReportLoadConfiguration.

interface IReportLoadConfiguration {
    accessToken: string;
    bookmark?: models.IApplyBookmarkRequest;
    contrastMode?: models.ContrastMode;
    datasetBinding?: models.IDatasetBinding;
    embedUrl?: string;
    filters?: models.ReportLevelFilters[];
    id: string;
    pageName?: string;
    permissions?: models.Permissions;
    settings?: models.IEmbedSettings;
    slicers?: models.ISlicer[];
    theme?: models.IReportTheme;
    tokenType?: models.TokenType;
    type: string;
    viewMode?: models.ViewMode;
}

Diese Schnittstelle enthält die folgenden Eigenschaften:

  • accessToken – Das Token, mit dem Sie Zugriff auf die Power BI-Daten erhalten, die Sie einbetten. Weitere Informationen zu Zugriffstoken finden Sie unter Grundlegendes zu den verschiedenen Einbettungslösungen.

  • datasetBinding – Das Dataset, das das vom eingebetteten Bericht verwendete Datenschema definiert. Weitere Informationen zu Datasets finden Sie unter Dynamische Bindung an einen Bericht.

  • embedUrl – Die URL des Berichts, den Sie einbetten. Diese URL wird zur Quelle des HTML-iframe Elements, das den eingebetteten Bericht enthält. Insbesondere weist die API die URL dem src Attribut des iframezu. Sie können eine Berichts-API- verwenden, um diese URL abzurufen. Zwei Beispiele sind:

  • id – Die ID des Power BI-Berichts, den Sie einbetten.

  • permissions – Vorgänge, die Sie Benutzern für den eingebetteten Bericht gewähren. Diese Werte sind verfügbar:

    • Read – Benutzer können den Bericht anzeigen.
    • ReadWrite – Benutzer können den Bericht anzeigen, bearbeiten und speichern.
    • Copy – Benutzer können eine Kopie des Berichts mithilfe von "Speichern unter" speichern.
    • Create – Benutzer können einen neuen Bericht erstellen.
    • All – Benutzer können eine Kopie des Berichts erstellen, anzeigen, bearbeiten, speichern und speichern.

  • tokenType – Die Art des Tokens, das Ihnen Zugriff auf die Power BI-Daten ermöglicht, die Sie einbetten.

    • Verwenden Sie models.TokenType.Aad, wenn Sie ihre Organisation einbetten (der Benutzer besitzt die Daten).
    • Verwenden Sie models.TokenType.Embed, wenn Sie ihre Kunden einbetten (die App besitzt die Daten).

    Weitere Informationen finden Sie unter Grundlegendes zu den verschiedenen Einbettungslösungen.

  • type – Die Art der Inhalte, die Sie einbetten. Verwenden Sie 'report' für einen Power BI-Bericht.

Die IReportLoadConfiguration Schnittstelle enthält auch andere Eigenschaften. Informationen zu diesen Eigenschaften finden Sie unter Konfigurieren von Berichtseinstellungen:

  • bookmark
  • contrastMode
  • filters
  • pageName
  • settings
  • slicers
  • theme
  • viewMode

Einbetten eines neuen Berichts

Wenn Sie einen neuen Bericht einbetten, den Sie aus einem Dataset erstellen, verwenden Sie ein Konfigurationsobjekt vom Typ IReportCreateConfiguration.

interface IReportCreateConfiguration {
    accessToken: string;
    datasetId: string;
    embedUrl?: string;
    settings?: models.IEmbedSettings;
    theme?: IReportTheme;
    tokenType?: models.TokenType;
    type: string;
}

Die Eigenschaften in dieser Schnittstelle ähneln den Eigenschaften in der IReportLoadConfiguration-Schnittstelle, mit den folgenden Ausnahmen:

  • datasetId – Die ID des Datasets, das das vom neuen Bericht verwendete Datenschema definiert.

  • embedUrl – Die URL des Datasets, das das vom neuen Bericht verwendete Datenschema definiert. Diese URL wird zur Quelle des HTML-iframe Elements, das den eingebetteten Bericht enthält. Insbesondere weist die API die URL dem src Attribut des iframezu. Sie können eine Datasets-API- verwenden, um diese URL abzurufen. Zwei Beispiele sind:

Informationen zum Bearbeiten und Erstellen von Berichten finden Sie unter Erstellen, Bearbeiten und Speichern eines eingebetteten Berichts.

Beispiel

Das folgende Beispiel zeigt, wie sie einen Bericht einbetten:

// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
    accessToken: anAccessToken,
    embedUrl: anEmbedUrl,
    id: aReportId,
    permissions: somePermissions,
    tokenType: aTokenType,
    type: 'report'
};
 
// Get a reference to the HTML element that contains the embedded report.
let embedContainer = $('#embedContainer')[0];
 
// Embed the report.
let report = powerbi.embed(embedContainer, embedConfiguration);

Verwandte Inhalte