Einbetten eines Berichts
Tipp
Versuchen Sie, einen Bericht einzubetten oder mit unseren Client-APIs im Abschnitt "Erkunden unserer APIs" des Power BI Embedded Analytics Playground zu experimentieren.
In diesem Artikel werden die Schritte zum Einbetten eines Power BI-Berichts in Ihre Anwendung behandelt. Weitere Informationen zu Berichten in Berichten in Power BI.
Einbetten eines Berichts
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. Weitere Informationen finden Sie unter Konfigurieren von Berichtseinstellungen .
Einbetten eines vorhandenen Berichts
Wenn Sie einen bereits vorhandenen Bericht einbetten, verwenden Sie ein Konfigurationsobjekt vom Typ IReportLoadConfiguration.
interface IReportLoadConfiguration {
accessToken: string;
bookmark?: models.IApplyBookmarkRequest;
contrastMode?: models.ContrastMode;
datasetBinding?: models.IDatasetBinding;
embedUrl?: string;
filters?: models.ReportLevelFilters[];
id: string;
pageName?: string;
permissions?: models.Permissions;
settings?: models.IEmbedSettings;
slicers?: models.ISlicer[];
theme?: models.IReportTheme;
tokenType?: models.TokenType;
type: string;
viewMode?: models.ViewMode;
}
Diese Schnittstelle enthält folgende 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 ".datasetBinding
- Das Dataset, das das Datenschema definiert, das der eingebettete Bericht verwendet. Weitere Informationen zu Datasets finden Sie dynamisch in einem Bericht .embedUrl
- Die URL des Berichts, den Sie einbetten. Diese URL wird zur Quelle des HTML-Elementsiframe
, das den eingebetteten Bericht enthält. Insbesondere weist die API die URL demsrc
Attribut desiframe
. Sie können eine Berichts-API verwenden, um diese URL abzurufen. Zwei Beispiele:id
– Die ID des Power BI-Berichts, den Sie einbetten.permissions
- Vorgänge, die Sie Benutzern für den eingebetteten Bericht gewähren. Diese Werte sind verfügbar:Read
– Benutzer können den Bericht anzeigen.ReadWrite
– Benutzer können den Bericht anzeigen, bearbeiten und speichern.Copy
– Benutzer können eine Kopie des Berichts mithilfe von "Speichern unter" speichern.Create
– Benutzer können einen neuen Bericht erstellen.All
– Benutzer können eine Kopie des Berichts erstellen, anzeigen, bearbeiten, speichern und speichern.
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 von Inhalten, die Sie einbetten. Wird für einen Power BI-Bericht verwendet'report'
.
Die IReportLoadConfiguration
Schnittstelle enthält auch andere Eigenschaften. Informationen zu diesen Eigenschaften finden Sie unter Konfigurieren von Berichtseinstellungen :
bookmark
contrastMode
filters
pageName
settings
slicers
theme
viewMode
Einbetten eines neuen Berichts
Wenn Sie einen neuen Bericht einbetten, den Sie aus einem Dataset erstellen, verwenden Sie ein Konfigurationsobjekt vom Typ IReportCreateConfiguration
.
interface IReportCreateConfiguration {
accessToken: string;
datasetId: string;
embedUrl?: string;
settings?: models.IEmbedSettings;
theme?: IReportTheme;
tokenType?: models.TokenType;
type: string;
}
Die Eigenschaften in dieser Schnittstelle ähneln den Eigenschaften in der IReportLoadConfiguration
Schnittstelle mit den folgenden Ausnahmen:
datasetId
– Die ID des Datasets, das das Datenschema definiert, das der neue Bericht verwendet.embedUrl
- Die URL des Datasets, das das Datenschema definiert, das der neue Bericht verwendet. Diese URL wird zur Quelle des HTML-Elementsiframe
, das den eingebetteten Bericht enthält. Insbesondere weist die API die URL demsrc
Attribut desiframe
. Sie können eine Datasets-API verwenden, um diese URL abzurufen. Zwei Beispiele:
Informationen zum Bearbeiten und Erstellen von Berichten finden Sie unter Erstellen, Bearbeiten und Speichern eines eingebetteten Berichts .
Beispiel
Das folgende Beispiel zeigt, wie Sie einen Bericht einbetten:
// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
accessToken: anAccessToken,
embedUrl: anEmbedUrl,
id: aReportId,
permissions: somePermissions,
tokenType: aTokenType,
type: 'report'
};
// Get a reference to the HTML element that contains the embedded report.
let embedContainer = $('#embedContainer')[0];
// Embed the report.
let report = powerbi.embed(embedContainer, embedConfiguration);