Dashboard einbetten

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

Tipp

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

Einbetten eines Dashboards

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.

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, 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 ".

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

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

  • pageView - Das Format, das die API für das eingebettete Dashboard verwendet. Dies können unter anderem folgende sein:

    • fitToWidth: Die Breite des eingebetteten Dashboards stimmt mit der Breite des div-Elements überein, 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 das Einbetten für Ihre Organisation (Benutzer besitzen Daten).
    • Verwenden Sie models.TokenType.Embed das Einbetten für Ihre Kunden (App besitzt Daten).

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

  • type - Die Art von Inhalten, die Sie einbetten. Wird für ein Dashboard verwendet '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 einen pageView Wert actualSize verwenden, wenn Sie ein Dashboard einbetten:

    • 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. Standardmäßig ist dieser Hintergrund weiß, aber Sie können ihn so konfigurieren, dass er transparent ist. In diesem Fall ist die div Formatierung des Elements im nicht verwendeten Bereich sichtbar.

Nächste Schritte