Einbetten mit Power BIEmbedding with Power BI

Power BI bietet APIs zum Einbetten von Dashboards und Berichten in Anwendungen.Power BI offers APIs for embedding your dashboards and reports into applications. Die Power BI-APIs bieten einen einheitlichen Satz von Funktionen und Zugriff auf die neuesten Power BI-Funktionen (z.B. Dashboards, Gateways und App-Arbeitsbereiche) beim Einbetten von Inhalten.The Power BI APIs offer a consistent set of capabilities and access to the latest Power BI features – such as dashboards, gateways and app workspaces – when embedding content.

Eine einzige APIA single API

Beim Einbetten von Power BI-Inhalten gibt es hauptsächlich zwei Szenarien.There are two main scenarios when embedding Power BI content. Das Einbetten für Benutzer in Ihrer Organisation (die Lizenzen für Power BI haben) und das Einbetten für Benutzer und Kunden, ohne dass diese über Power BI-Lizenzen verfügen müssen.Embedding for users in your organization (who have licenses for Power BI) and embedding for your users and customers without requiring them to have Power BI licenses. Die Power BI-REST-API ermöglicht beide Szenarien.The Power BI REST API allows for both scenarios.

Für Kunden und Benutzer ohne Power BI-Lizenzen können Sie Dashboards und Berichte in Ihre benutzerdefinierte Anwendung einbetten und dabei für Ihre Organisation und Ihre Kunden die gleiche API verwenden.For customers and users without Power BI licenses, you can embed dashboards and reports into your custom application, using the same API to either service your organization or your customers. Die Kunden sehen so die Daten, die von der Anwendung verwaltet werden.Your customers see the data that is managed by the application. Und für Power BI-Benutzer in Ihrer Organisation besteht zusätzlich die Möglichkeit, eigene Daten direkt in Power BI oder im Kontext der eingebetteten Anwendung anzuzeigen.And for Power BI users in your organization, they'll have the additional options to view their own data directly in Power BI or in the context of the embedded application. Sie können alle Funktionen der JavaScript- und REST-APIs für das Einbetten nutzen.You can take full advantage of the JavaScript and REST APIs for your embedding needs.

Ein Beispiel für die Funktionsweise der Einbettung finden Sie im JavaScript-Einbettungsbeispiel.To view a sample of how embedding works, see the JavaScript embed sample.

Einbetten für Ihre OrganisationEmbedding for your organization

Das Einbetten für Ihre Organisation ermöglicht Ihnen das Erweitern des Power BI-Diensts.Embedding for your organization allows you to extend the Power BI service. Dafür ist erforderlich, dass sich die Benutzer Ihrer Anwendung beim Power BI-Dienst anmelden, wenn sie ihre Inhalte anzeigen möchten.This requires that users of your application sign into the Power BI service when they want to view their content. Nachdem sich ein Benutzer in Ihrer Organisation angemeldet hat, besitzt er nur Zugriff auf Dashboards und Berichte, deren Eigentümer er ist oder die für ihn im Power BI-Dienst freigegeben wurden.Once someone in your organization signs in, they will only have access to dashboards and reports that they own or that have been shared with them in the Power BI service.

Beispiele für das Einbetten in Ihre Organisation umfassen interne Webanwendungen, das SharePoint Online-Webpart und die Microsoft Teams-Integration.Examples of embedding for your organization include internal web application, the SharePoint Online web part and Microsoft Teams integration.

Informationen zum Einbetten für Ihre Organisation finden Sie in den folgenden Artikeln:For embedding for your organization, see the following:

Self-Service-Funktionen, wie Bearbeiten, Speichern und mehr, stehen bei der Einbettung für Power BI-Benutzer über die JavaScript-API zur Verfügung.Self-service capabilities, such as edit, save and more, are available through the JavaScript API when embedding for Power BI users.

Einbetten für Ihre KundenEmbedding for your customers

Das Einbetten für Ihre Kunden bietet die Möglichkeit, Dashboards und Berichte für Benutzer einzubetten, die nicht über ein Konto für Power BI verfügen.Embedding for your customers provides the ability to embed dashboards and reports to users who don't have an account for Power BI. Ihre Kunden brauchen gar nichts über Power BI zu wissen.Your customers don't need to know anything about Power BI. Es wird mindestens ein Power BI Pro-Konto benötigt, um eine eingebettete Anwendung zu erstellen.At least one Power BI Pro account is needed to create an embedded application. Das Power BI Pro-Konto fungiert als Masterkonto für Ihre Anwendung.The Power BI Pro account acts as a master account for your application. Stellen Sie es sich als eine Art Proxykonto vor.Think of this as a proxy account. Mit dem Power BI Pro-Konto können Sie außerdem Einbettungstoken generieren, die Zugriff auf die Dashboards und Berichte im Power BI-Dienst bieten, die von Ihrer Anwendung verwaltet werden bzw. die diese besitzt.The Power BI Pro account also allows you to generate embed tokens that provide access to dashboards and reports within the Power BI service that are owned/managed by your application.

Ein Beispiel für das Einbetten für Ihre Kunden ist eine ISV-Anwendung, die an andere Unternehmen verkauft wird.An example of embedding for your customers is an ISV application being sold to other companies.

Flussdiagramm des Einbettens für Ihre Kunden

Zum Einbetten von Dashboards, Berichten und Kacheln verwenden Sie die gleichen APIs, die Sie zum Einbetten für Ihre Organisation verwenden.To embed dashboards, reports and tiles, you would use the same APIs that you would use for embedding for your organization.

Wichtig

Beim Einbetten besteht zwar eine Abhängigkeit vom Power BI-Dienst, für Ihre Kunden besteht aber keine Abhängigkeit von Power BI.While embedding has a dependency on the Power BI service, there is not a dependency on Power BI for your customers. Sie müssen sich nicht für Power BI registrieren, um die eingebetteten Inhalte in der Anwendung anzuzeigen.They do not need to sign up for Power BI to view the embedded content in your application.

Wenn Sie bereit sind, in eine Produktionsumgebung zu wechseln, muss der Arbeitsbereich Ihrer App einer Kapazität zugeordnet werden.When you are ready to move to production, your app workspace must be assigned to a capacity. Power BI Embedded in Microsoft Azure bietet Kapazität, die von Ihren Anwendungen genutzt werden kann.Power BI Embedded, within Microsoft Azure, offers capacity to use with your applications.

Details zur Einbettung finden Sie unter Einbetten von Power BI-Dashboards, -Berichten und -Kacheln.For details on how to embed, see How to embed your Power BI dashboards, reports and tiles.

Wenn Sie bereits den Dienst Power BI-Arbeitsbereichssammlungen in Azure verwendet haben, finden Sie unter Migrieren von Inhalten aus Power BI Embedded-Arbeitsbereichssammlungen zu Power BI Informationen zum Migrieren Ihrer Inhalte.If you were using the Power BI Workspace Collections service within Azure, see Migrate content from the Power BI Workspace Collections Azure service for information on how to migrate your content over.

Nächste SchritteNext steps

Einbetten von Power BI-Dashboards, -Berichten und -KachelnHow to embed your Power BI dashboards, reports and tiles
Migrieren von Inhalten aus Power BI Embedded-Arbeitsbereichsammlungen zu Power BIHow to migrate Power BI Embedded workspace collection content to Power BI
Power BI Premium – BeschreibungPower BI Premium - what is it?
JavaScript-API-Git-RepositoryJavaScript API Git repo
Power BI-C#-Git-RepositoryPower BI C# Git repo
JavaScript-EinbettungsbeispielJavaScript embed sample
Whitepaper zur Kapazitätsplanung der eingebetteten AnalyseEmbedded analytics capacity planning whitepaper
Power BI Premium-WhitepaperPower BI Premium whitepaper

Weitere Fragen?More questions? Stellen Sie Ihre Frage in der Power BI-Community.Try asking the Power BI Community