Einbetten einer Dashboardkachel
Trinkgeld
Versuchen Sie, eine Dashboardkachel einzubetten oder mit unseren Client-APIs im abschnitt Erkunden Sie unsere APIs Abschnitt des Power BI Embedded Analytics Playground.
In diesem Artikel werden die Schritte zum Einbetten einer Dashboardkachel in Ihre Anwendung behandelt. Erfahren Sie mehr über Dashboardkacheln in Einführung in Dashboard-Kacheln für Power BI-Designer.
So betten Sie eine Dashboardkachel 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.
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, 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.dashboardId– Die ID des Dashboards, das die kachel enthält, die Sie einbetten. Sie können eine Dashboards-API- verwenden, um diese ID abzurufen. Zwei Beispiele sind:embedUrl– Die URL der Dashboardkachel, die Sie einbetten. Diese URL wird zur Quelle des HTML-iframeElements, das die eingebettete Dashboardkachel enthält. Insbesondere weist die API die URL demsrcAttribut desiframezu. Sie können eine Dashboards-API- verwenden, um diese URL abzurufen. Zwei Beispiele sind:- Dashboards – Kachel in Gruppen- abrufen
- Dashboards – Kacheln in Gruppen- abrufen
id– Die ID der Dashboardkachel, die Sie einbetten. Sie können eine Dashboards-API- verwenden, um diese ID abzurufen. Zwei Beispiele sind:- Dashboards – Kachel in Gruppen- abrufen
- Dashboards – Kacheln in Gruppen- abrufen
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.
- Verwenden Sie
type– Die Art der Inhalte, die Sie einbetten. Verwenden Sie'tile'für eine Dashboardkachel.
Beispiel
Das folgende Beispiel zeigt, 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);