Einbetten eines Berichts

Tipp

Versuchen Sie, einen Bericht einzubetten oder mit unseren Client-APIs im Abschnitt "Erkunden unserer APIs" des Power BI Embedded Analytics Playground zu experimentieren.

In diesem Artikel werden die Schritte zum Einbetten eines Power BI-Berichts in Ihre Anwendung behandelt. Weitere Informationen zu Berichten in Berichten in Power BI.

Einbetten eines Berichts

Wenn Sie Power BI-Inhalte in eine App einbetten, verwenden Sie ein Konfigurationsobjekt, um den Inhalt zu definieren, den Sie einbetten und die Einstellungen des Inhalts angeben möchten. 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 folgende Eigenschaften:

• accessToken - Das Token, das Ihnen Zugriff auf die Power BI-Daten ermöglicht, die Sie einbetten. Weitere Informationen zu Zugriffstoken finden Sie unter "Grundlegendes zu den verschiedenen Einbettungslösungen ".

• datasetBinding - Das Dataset, das das Datenschema definiert, das der eingebettete Bericht verwendet. Weitere Informationen zu Datasets finden Sie dynamisch in einem Bericht .

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

  • Berichte – Bericht in Gruppe abrufen
  • Berichte – Abrufen von Berichten in Gruppe

• 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 von Inhalten, die Sie einbetten. Wird für einen Power BI-Bericht verwendet 'report' .

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 Datenschema definiert, das der neue Bericht verwendet.

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

  • Datasets – Dataset in Gruppe abrufen
  • Datasets – Abrufen von Datasets in Gruppe

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

Nächste Schritte

Visuelles Einbetten eines Berichts

Einbetten eines paginierten Berichts

Konfigurieren von Berichteinstellungen

Erstellen, Bearbeiten und Speichern eines Berichts

Verwenden von Bootstrap für eine bessere Leistung