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-Elementsiframe
, das das eingebettete Dashboard enthält. Insbesondere weist die API die URL demsrc
Attribut desiframe
. 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 desdiv
-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 ".
- Verwenden Sie
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 einenpageView
WertactualSize
verwenden, wenn Sie ein Dashboard einbetten:- Wenn das Dashboard breiter als das
div
Element ist, verwendet die API die Breite desdiv
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 diediv
Formatierung des Elements im nicht verwendeten Bereich sichtbar.
- Wenn das Dashboard breiter als das