Freigeben über


Einbetten eines Dashboards

In diesem Artikel werden die Schritte zum Einbetten eines Dashboards in Ihre Anwendung behandelt. Erfahren Sie mehr über Dashboards in Einführung in Dashboards für Power BI-Designer.

Trinkgeld

Versuchen Sie, ein Dashboard einzubetten oder mit unseren Client-APIs im abschnitt Erkunden Sie unsere APIs Abschnitt des Power BI Embedded Analytics Playground.

So betten Sie ein Dashboard 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.

Verwenden Sie beim Einbetten eines Dashboards ein Konfigurationsobjekt vom Typ IDashboardLoadConfiguration:

interface IDashboardLoadConfiguration {
    accessToken: string;
    embedUrl?: string;
    id: string;
    pageView?: models.PageView 
    tokenType?: models.TokenType;
    type: string;
}

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.

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

  • id – Die ID des Dashboards, das Sie einbetten. Verwenden Sie eine Dashboards-API-, um diese ID abzurufen. Zum Beispiel:

  • pageView – Das Format, das die API für das eingebettete Dashboard verwendet. Zu den Möglichkeiten gehören:

    • fitToWidth – Die Breite des eingebetteten Dashboards entspricht der Breite des div Elements, das das Dashboard enthält.
    • oneColumn – Das eingebettete Dashboard wird in einer Spalte angezeigt.
    • actualSize – Die API zeigt das eingebettete Dashboard in voller Größe an.
  • tokenType – Die Art des Tokens, das Ihnen Zugriff auf die Power BI-Daten ermöglicht, die Sie einbetten.

    • Verwenden Sie models.TokenType.Aad zum Einbetten für Ihre Organisation (Benutzer besitzt Daten).
    • Verwenden Sie models.TokenType.Embed, um Kunden einzubetten (App besitzt Daten).

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

  • type – Die Art der Inhalte, die Sie einbetten. Verwenden Sie 'dashboard' für ein Dashboard.

Beispiel

Das folgende Beispiel zeigt, wie Sie ein einzelnes Dashboard einbetten:

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

Überlegungen und Einschränkungen

  • Das Einbetten von Dashboards in EM-SKUs wird nicht unterstützt.

  • Wenn Sie Inhalte einbetten, zeigt Ihre App den Inhalt in einem div-Element an. Wenn Sie beim Einbetten eines Dashboards einen pageView Wert von actualSize verwenden:

    • Wenn das Dashboard breiter als das div-Element ist, verwendet die API die Breite des div Elements als Breite des eingebetteten Dashboards.
    • Wenn das Dashboard schmaler als das div-Element ist, füllt die API den nicht verwendeten Platz mit dem eingebetteten Hintergrund aus. Standardmäßig ist dieser Hintergrund weiß, aber Sie können ihn so konfigurieren, dass er transparent ist. In diesem Fall ist die Formatierung des div Elements im nicht verwendeten Bereich sichtbar.