Einbetten einer Dashboardkachel

Tipp

Versuchen Sie, eine Dashboardkachel einzubetten oder mit unseren Client-APIs im Abschnitt "Erkunden" des Power BI Embedded Analytics-Playgrounds zu experimentieren.

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

Einbetten einer Dashboardkachel

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.

Wenn Sie eine Dashboardkachel einbetten, verwenden Sie ein Konfigurationsobjekt vom Typ ITileLoadConfiguration:

interface ITileLoadConfiguration {
    accessToken: string;
    dashboardId: string;
    embedUrl: string;
    id: string;
    tokenType?: models.TokenType;
    type: string;
}

Diese Schnittstelle enthält die folgenden Eigenschaften:

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

• dashboardId - Die ID des Dashboards, die die Kachel enthält, die Sie einbetten. Sie können eine Dashboards-API verwenden, um diese ID abzurufen. Zwei Beispiele:

  • Dashboards – Dashboard in Gruppe abrufen
  • Dashboards – Abrufen von Dashboards in Der Gruppe

• embedUrl - Die URL der Dashboardkachel, die Sie einbetten. Diese URL wird die Quelle des HTML-Elements iframe , das die eingebettete Dashboardkachel 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:

  • Dashboards – Kachel in Gruppe abrufen
  • Dashboards – Abrufen von Kacheln in Gruppe

• id - Die ID der Dashboardkachel, die Sie einbetten. Sie können eine Dashboards-API verwenden, um diese ID abzurufen. Zwei Beispiele:

  • Dashboards – Kachel in Gruppe abrufen
  • Dashboards – Abrufen von Kacheln in Gruppe

• tokenType - Die Art von Token, das Ihnen Zugriff auf die Power BI-Daten bietet, die Sie einbetten.

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

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

• type - Die Art von Inhalten, die Sie einbetten. Verwenden Sie 'tile' eine Dashboardkachel.

Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie eine einzelne Dashboardkachel einbetten:

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

Nächste Schritte

Einbetten eines Berichts

Einbetten eines Berichts

Dashboard einbetten

Verwenden von Bootstrap für bessere Leistung