Einbetten von Power BI-Dashboards, -Berichten und -KachelnEmbed your Power BI dashboards, reports and tiles

Erfahren Sie mehr zu den Schritten, die Sie durchführen müssen, um Inhalte von Power BI in Ihre Anwendung einzubetten.Learn about the steps you need to take to embed Power BI content within your application.

Microsoft hat Power BI Premium vorgestellt, ein neues kapazitätsbasiertes Lizenzierungsmodell, das die Flexibilität der Benutzer beim Zugriff, der Freigabe und dem Verteilen von Inhalten erhöht.Microsoft announced Power BI Premium, a new capacity-based licensing model that increases flexibility for how users access, share and distribute content. Das Angebot bietet zusätzliche Skalierbarkeit und Leistung für den Power BI-Dienst.The offering also delivers additional scalability and performance to the Power BI service. Außerdem wurde Power BI Embedded vorgestellt, mit dem Sie Kapazität in Microsoft Azure erstellen können.Power BI Embedded was also announced that allows for creating capacity within Microsoft Azure. Power BI Embedded ist auf Ihre Anwendung und Ihre Kunden ausgerichtet.Power BI Embedded is focused on your application and your customers.

In diesem Artikel wird erläutert, wie Sie Ihre Inhalte von Power BI sowohl für Ihre Organisation als auch für Ihre Kunden einbetten.This article will look at embedding your Power BI content for both your organization and your customers. Die Schritte sind für beide Szenarien ähnlich.The steps are similar between the two scenarios. Es wird darauf hingewiesen, wenn ein Schritt nur für das Einbetten für Ihre Kunden gilt.Callouts will be made when a step is specific to embedding for your customer.

Sie müssen in Ihrer Anwendung die folgenden Schritte ausführen, um dies zu ermöglichen.There are a few steps you have to do with your application to make this possible. Hier werden die erforderlichen Schritte durchgegangen, damit Sie eingebettete Inhalte mit Ihrer Anwendung verwenden können.We will go through the steps needed to allow you to create and use embedded content within your application.

Hinweis

Die APIs von Power BI verweisen weiterhin in Gruppen auf Arbeitsbereiche.The Power BI APIs still refer to app workspaces as groups. Alle Verweise auf Gruppen bedeuten, dass Sie mit App-Arbeitsbereichen arbeiten.Any references to groups mean that you are working with app workspaces.

Schritt 1: Richten Sie Ihre Entwicklungsumgebung für eingebettete Analysen einStep 1: Setup your embedded analytics development environment

Bevor Sie mit dem Einbetten von Dashboards und Berichten in Ihre Anwendung beginnen, müssen Sie sicherstellen, dass Ihre Umgebung das Einbetten erlaubt.Before you start embedding dashboards and reports into your application, you need to make sure your environment is setup to allow for embedding. Im Rahmen des Setups müssen Sie folgende Aktionen ausführen.As part of the setup, you will need to do the following.

Hinweis

Für die Entwicklung der Anwendung ist keine Power BI-Kapazität erforderlich.Power BI capacity is not required for development of your application. Die Entwickler der Anwendung müssen über eine Power BI Pro-Lizenz verfügen.The developers of the application will need to have a Power BI Pro license.

Azure Active Directory-MandantAzure Active Directory tenant

Sie benötigen einen Azure Active Directory-Mandanten (Azure AD), um Elemente aus Power BI einzubetten.You will need an Azure Active Directory (Azure AD) tenant in order to embed items from Power BI. Dieser Mandant muss mindestens einen Benutzer von Power BI Pro haben.This tenant must have at least one Power BI Pro user. Sie müssen außerdem eine Azure AD-App im Mandanten festlegen.You will also need to define an Azure AD app within the tenant. Sie können einen vorhandenen Azure AD-Mandanten verwenden oder einen neuen Mandanten erstellen, den Sie nur zum Einbetten verwenden.You can make use of an existing Azure AD tenant or create a new one specifically for embedding purposes.

Sie müssen das zu verwendende Mandantensetup bestimmen, wenn Sie für Ihre Kunden einbetten.You will need to determine what tenant setup to use if you are embedding for your customers.

  • Verwenden Sie Ihren vorhandenen, unternehmensbezogenen Power BI-Mandanten?Use your existing corporate Power BI tenant?
  • Verwenden Sie einen separaten Mandanten für Ihre Anwendung?Use a separate tenant for your application?
  • Verwenden Sie einen separaten Mandanten pro Kunde?Use a separate tenant for each customer?

Wenn Sie keinen bereits vorhandenen Mandanten verwenden möchten, können Sie einen neuen Mandanten für Ihre Anwendung oder einen Mandanten pro Kunde erstellen. Weitere Informationen hierzu finden Sie unter Erstellen eines Azure Active Directory-Mandanten und Einrichten eines Azure Active Directory-Mandanten.If you do not want to use an existing tenant, you can decide to create a new tenant for your application, or one for each customer, see Create an Azure Active Directory tenant or How to get an Azure Active Directory tenant.

Erstellen Sie ein Benutzerkonto für Power BI ProCreate a Power BI Pro user account

Sie benötigen nur ein einzelnes Power BI Pro-Konto zum Einbetten von Inhalt.You only need a single Power BI Pro account to embed content. Vielleicht möchten Sie aber verschiedene Benutzer haben, die bestimmten Zugriff auf Elemente haben.However, you may want to have a few different users that have specific access to items. Dies ist ein Überblick über mögliche Benutzer für Ihren Mandanten.Here is a look at possible users to consider within your tenant.

Die folgenden Konten müssen in Ihrem Mandanten vorhanden sein und über eine Lizenz für Power BI Pro verfügen.The following accounts will need to exist within your tenant and have a Power BI Pro license assigned to them. Zum Arbeiten mit App-Arbeitsbereichen in Power BI ist eine Power BI Pro-Lizenz erforderlich.A Power BI Pro license is required to work with app workspaces within Power BI.

Ein Administrator für den Mandanten/die OrganisationAn organization/tenant admin user

Es wird empfohlen, als Konto für die Anwendung nicht den globalen Administrator des Mandanten/der Organisation zu verwenden, wenn das Einbetten für Ihre Kunden erfolgt.It is recommended that your organization/tenant Global Admin user should not be used as account your application uses if embedding for your customers. So wird der Zugriff des Anwendungskontos innerhalb Ihres Mandanten minimiert.This is to minimize access that the application account has within your tenant. Der Administratorbenutzer sollte nach Möglichkeit Administrator aller App-Arbeitsbereiche sein, die zum Zweck des Einbettens erstellt wurden.It is recommended that the admin user be an admin of all app workspaces created for the purpose of embedding.

Konten für Analysten, die Inhalte erstellenAccounts for analysts that will create content

Möglicherweise sind mehrere Benutzer vorhanden, die Inhalte für Power BI erstellen.You may have multiple users that create content for Power BI. Sie benötigen ein Power BI Pro-Konto für jeden Analysten, der Inhalt in Power BI erstellt und bereitstellt.You will need a Power BI Pro account for each analyst that is creating and deploying content to Power BI.

Ein Hauptbenutzerkonto der Anwendung zum Einbetten für Ihre KundenAn application master user account for embedding for your customers

Das Hauptkonto ist das Konto, das von der Anwendung beim Einbetten von Inhalten für Ihre Kunden verwendet wird.The master account is the account your application will use when embedding content for your customers. Dies ist in der Regel ein Szenario für ISV-Anwendungen.The scenario is typically for ISV applications. Das Hauptkonto ist das einzige Konto, das in der Anwendung tatsächlich benötigt wird.The master account is really the only required account you need within your organization. Es kann auch als Administrator- und Analytikerkonto verwendet werden, dies wird allerdings nicht empfohlen.It can also be used as the admin and analyst account, but it is not recommended. Das Back-End Ihrer Anwendung speichert die Anmeldeinformationen für dieses Konto und ruft damit ein Azure AD-Authentifizierungstoken für die Verwendung mit Power BI REST-APIs ab.Your application's backend will store the credentials for this account and use it for acquiring an Azure AD auth token for use with the Power BI APIs. Dieses Konto dient zum Generieren eines für die Kunden zu verwendenden Einbettungstokens für die Anwendung.This account will be used to generate an embed token for the application to use for your customers.

Beim Masterkonto handelt es sich um das Konto eines regulären Benutzers mit einer Power BI Pro-Lizenz, die Sie für die Anwendung verwenden.The master account is just a regular user with a Power BI Pro license that you use with your application. Das Konto muss ein Administrator des App-Arbeitsbereichs sein, der für das Einbetten verwendet wird.The account must be an admin of the app workspace that is being used for embedding.

App-Registrierung und BerechtigungenApp registration and permissions

Sie müssen Ihre Anwendung bei Azure AD registrieren, um REST-API-Aufrufe ausführen zu können.You will need to register your application with Azure AD in order to make REST API calls. Weitere Informationen finden Sie unter Registrieren einer Azure AD-App zum Einbetten von Power BI-Inhalten.For more information, see Register an Azure AD app to embed Power BI content.

Erstellen von App-ArbeitsbereichenCreate app workspaces

Wenn Sie Dashboards und Berichte für Ihre Kunden einbetten, müssen sich die Dashboards und Berichte in einem App-Arbeitsbereich befinden.If you are embedding dashboards and reports for your customers, those dashboards and reports have to be placed within an app workspace. Das oben genannte Hauptkonto muss ein Administrator des App-Arbeitsbereichs sein.The master account, that was mentioned above, must be an admin of the app workspace.

  1. Erstellen Sie zunächst den Arbeitsbereich.Start by creating the workspace. Wählen Sie Arbeitsbereiche > App-Arbeitsbereich erstellen aus.Select Workspaces > Create app workspace.

    App-Arbeitsbereich erstellen

    Hier legen Sie Inhalte ab, die Sie gemeinsam mit Kollegen bearbeiten.This will be the place to put content that you and your colleagues collaborate on.

  2. Benennen Sie den Arbeitsbereich.Give the workspace a name. Wenn die entsprechende Arbeitsbereichs-ID nicht verfügbar ist, geben Sie eine eindeutige ID ein.If the corresponding Workspace ID isn't available, edit it to come up with a unique ID.

    Diese wird der Name der App sein.This will be the name of the app, too.

    Benennen des Arbeitsbereichs

  3. Sie können einige Optionen festlegen.You have a few options to set. Wenn Sie Öffentlich auswählen, können die Inhalte des Arbeitsbereichs von jedem Benutzer in der Organisation angezeigt werden.If you choose Public, anyone in your organization can see what’s in the workspace. Privat bedeutet hingegen, dass die Inhalte des Arbeitsbereichs nur von dessen Mitgliedern angezeigt werden können.Private, on the other hand, means only members of the workspace can see its contents.

    Festlegen als „Privat“ oder „Öffentlich“

    Sie können die Einstellung „Öffentlich“ bzw. „Privat“ einer Gruppe nach deren Erstellung nicht mehr ändern.You can't change the Public/Private setting after you've created the group.

  4. Sie können auch auswählen, ob Mitglieder Inhalte bearbeiten können oder schreibgeschützten Zugriff haben.You can also choose if members can edit or have view-only access.

    Festlegen als bearbeitbar oder schreibgeschützt

    Fügen Sie Personen dem App-Arbeitsbereich nur hinzu, damit sie Inhalte bearbeiten können.Only add people to the app workspace so they can edit the content. Wenn das Mitglied den Inhalt nur anzeigen kann, fügen Sie es nicht dem Arbeitsbereich hinzu.If they're only going to view the content, don't add them to the workspace. Sie können das Mitglied berücksichtigen, wenn Sie die App veröffentlichen.You can include them when you publish the app.

  5. Fügen Sie E-Mail-Adressen von Personen hinzu, die Zugriff auf den Arbeitsbereich haben sollen, und wählen Sie Hinzufügen aus.Add email addresses of people you want to have access to the workspace, and select Add. Sie können keine Gruppenaliase, sondern nur einzelne Personen hinzufügen.You can’t add group aliases, just individuals.

  6. Legen Sie für jede Person fest, ob sie Mitglied oder Administrator ist.Decide whether each person is a member or an admin.

    Festlegen von Mitglied oder Administrator für Personen

    Administratoren können den Arbeitsbereich selbst bearbeiten und weitere Mitglieder hinzufügen.Admins can edit the workspace itself, including adding other members. Mitglieder können den Inhalt des Arbeitsbereichs bearbeiten, es sei denn, sie haben schreibgeschützten Zugriff.Members can edit the content in the workspace, unless they have view-only access. Sowohl Administratoren als auch Mitglieder können die App veröffentlichen.Both admins and members can publish the app.

  7. Wählen Sie Speichern.Select Save.

Der Arbeitsbereich wird in Power BI erstellt und geöffnet.Power BI creates the workspace and opens it. Er wird in der Liste der Arbeitsbereiche angezeigt, deren Mitglied Sie sind.It appears in the list of workspaces you’re a member of. Da Sie Administrator sind, können Sie die Auslassungspunkte (...) auswählen, um zurückzukehren, und Änderungen vornehmen, neue Mitglieder hinzufügen oder deren Berechtigungen ändern.Because you’re an admin, you can select the ellipsis (…) to go back and make changes to it, adding new members or changing their permissions.

Bearbeiten des Arbeitsbereichs

Erstellen und Hochladen von BerichtenCreate and upload your reports

Sie können Ihre Berichte und Datasets mit Power BI Desktop erstellen und diese Berichte dann in einem App-Arbeitsbereich veröffentlichen.You can create your reports and datasets using Power BI Desktop and then publish those reports to an app workspace. Der Endbenutzer, der die Berichte veröffentlicht, muss über eine Power BI Pro-Lizenz verfügen, damit er einen App-Arbeitsbereich veröffentlichen kann.The end user publishing the reports need to have a Power BI Pro license in order to publish to an app workspace.

Schritt 2: Einbetten der InhalteStep 2: Embed your content

In Ihrer Anwendung müssen Sie sich bei Power BI authentifizieren.Within your application, you will need to authenticate with Power BI. Wenn Sie Inhalte für Ihre Kunden einbetten, speichern Sie die Anmeldeinformationen für das Hauptkonto in der Anwendung.If you are embedding content for your customers, you will store the credentials for the master account within your application. Weitere Informationen finden Sie unter Authentifizieren von Benutzern und Abrufen eines Azure AD-Zugriffstokens für die Power BI-App.For more information, see Authenticate users and get an Azure AD access token for your Power BI app.

Verwenden Sie in der Anwendung nach der Authentifizierung die Power BI-REST-APIs und JavaScript-APIs, um Dashboards und Berichte in die Anwendung einzubetten.Once authenticated, within your application, use the Power BI REST APIs and JavaScript APIs to embed dashboards and reports into your application.

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

Informationen zum Einbetten für Ihre Kunden, das i.d.R. für ISVs erfolgt, finden Sie in dem folgenden Artikel:For embeding with your customers, which is typical for ISVs, see the following:

Beim Einbetten für Ihre Kunden ist ein Einbettungstoken erforderlich.When embedding for your customers, an embed token is required. Weitere Informationen finden Sie unter GenerateToken.To learn more see, GenerateToken.

Schritt 3: Heraufstufen Ihrer Lösung zur ProduktionStep 3: Promote your solution to production

Für den Wechsel zur Produktion sind einige zusätzliche Schritte erforderlich.Moving to production requires a few extra steps.

Einbetten für Ihre OrganisationEmbedding for your organization

Wenn Sie für Ihre Organisation einbetten, müssen Sie den Benutzern lediglich mitteilen, wie sie zu der Anwendung gelangen.If you are embedding for your organization, you only need to let people know how to get to your application.

Benutzer mit Free-Tarif können Inhalte verwenden, die aus einem App-Arbeitsbereich (einer Gruppe) eingebettet wurden, wenn dieser Arbeitsbereich über ausreichende Kapazität verfügt.Free users can consume content that is embedded from an app workspace (group), if that workspace is backed by capacity. Der Benutzer mit Free-Tarif muss als Mitglied des App-Arbeitsbereichs (der Gruppe) aufgelistet sein, andernfalls wird der Fehler 401 zur fehlenden Autorisierung ausgegeben.List the Free user as a member of app workspace (group), otherwise you receive a 401 unauthorized error. In der folgenden Tabelle sind die in Office 365 verfügbaren Power BI Premium-SKUs aufgeführt.The following table lists the available Power BI Premium SKUs available within Office 365.

KapazitätsknotenCapacity Node Gesamtzahl der KerneTotal cores
(Back-End + Front-End)(Backend + frontend)
Back-End-KerneBackend Cores Front-End-KerneFrontend Cores Grenzwerte für DirectQuery/LiveverbindungDirectQuery/live connection limits Höchstzahl an Seitenladevorgängen zu SpitzenzeitenMax page renders at peak hour
EM3EM3 4 V-Kerne4 v-cores 2 Kerne, 10 GB RAM2 cores, 10GB RAM 2 Kerne2 cores 601–1.200601-1,200
P1P1 8 V-Kerne8 v-cores 4 Kerne, 25 GB RAM4 cores, 25GB RAM 4 Kerne4 cores 30 pro Sekunde30 per second 1.201–2.4001,201-2,400
P2P2 16 V-Kerne16 v-cores 8 Kerne, 50 GB RAM8 cores, 50GB RAM 8 Kerne8 cores 60 pro Sekunde60 per second 2.401–4.8002,401-4,800
P3P3 32 V-Kerne32 v-cores 16 Kerne, 100 GB RAM16 cores, 100GB RAM 16 Kerne16 cores 120 pro Sekunde120 per second 4.801–96004,801-9600

Hinweis

Sie müssen in ihrem Mandanten ein globaler oder Abrechnungsadministrator sein, um Power BI Premium erwerben zu können.You must be a Global or Billing Admin, within your tenant, in order to purchase Power BI Premium. Informationen zum Erwerb von Power BI Premium finden Sie unter How to purchase Power BI Premium (Erwerben von Power BI Premium).For information on how to purchase Power BI Premium, see How to purchase Power BI Premium.

Einbetten für Ihre KundenEmbedding for your customers

Wenn Sie für Ihre Kunden einbetten, führen Sie folgende Aktionen aus.If you are embedding for your customers, do the following.

  • Wenn Sie einen separaten Mandanten für die Entwicklung verwenden, müssen Sie sicherstellen, dass Ihre App-Arbeitsbereiche, zusammen mit Dashboards und Berichten, in der Produktionsumgebung verfügbar sind.If you are using a separate tenant for development, then you must make sure your app workspaces, along with dashboards and reports, are available in your production environment. Sie müssen die Anwendung in Azure AD für Ihren Produktionsmandanten erstellen und die entsprechenden App-Berechtigungen zuweisen, wie in Schritt 1 angegeben.Make sure that you create the application in Azure AD for your production tenant and assign the proper app permissions as indicated in Step 1.
  • Erwerben Sie eine Kapazität, die Ihren Anforderungen entspricht.Purchase a capacity that fits your needs. Mit folgender Tabelle können Sie bestimmen, welche SKU für Power BI Embedded-Kapazitäten Sie benötigen.You can use the table below to understand which Power BI Embedded capacity SKU you may need. Weitere Informationen finden Sie im Whitepaper zum Planen von eingebetteten Analysekapazitäten.For more details, see Embedded analytics capacity planning whitepaper. Sie können das Produkt im Microsoft Azure-Portal erwerben.When you are ready to purchase, you can do so within the Microsoft Azure portal. Weitere Informationen zum Erstellen von Power BI Embedded-Kapazität finden Sie unter Create Power BI Embedded capacity in the Azure portal (Erstellen von Power BI Embedded-Kapazität im Azure-Portal, in englischer Sprache).For details on how to create Power BI Embedded capacity, see Create Power BI Embedded capacity in the Azure portal.

Wichtig

Da Einbettungstokens nur für das Testen von Bereitstellungen vorgesehen sind, ist die Anzahl von Einbettungstokens limitiert, die ein Power BI-Hauptkonto generieren kann.Because embed tokens are intended for development testing only, the number of embed tokens a Power BI master account can generate is limited. Es muss eine Kapazität erworben werden, um Einbettungsszenarios für die Produktion verwenden zu können.A capacity must be purchased for production embedding scenarios. Wenn eine Kapazität erworben wird, gibt es keine Einschränkungen bei der Generierung von Einbettungstokens.There is no limit to embed token generation when a capacity is purchased.

KapazitätsknotenCapacity Node Gesamtzahl der KerneTotal cores
(Back-End + Front-End)(Backend + frontend)
Back-End-KerneBackend Cores Front-End-KerneFrontend Cores Grenzwerte für DirectQuery/LiveverbindungDirectQuery/live connection limits Höchstzahl an Seitenladevorgängen zu SpitzenzeitenMax page renders at peak hour
A1A1 1 V-Kern1 v-cores 1/2 Kern, 3 GB RAM.5 cores, 3GB RAM 1/2 Kern.5 cores 5 pro Sekunde5 per second 1–3001-300
A2A2 2 V-Kerne2 v-cores 1 Kern, 5 GB RAM1 core, 5GB RAM 1 Kern1 core 10 pro Sekunde10 per second 301–600301-600
A3A3 4 V-Kerne4 v-cores 2 Kerne, 10 GB RAM2 cores, 10GB RAM 2 Kerne2 cores 15 pro Sekunde15 per second 601–1.200601-1,200
A4A4 8 V-Kerne8 v-cores 4 Kerne, 25 GB RAM4 cores, 25GB RAM 4 Kerne4 cores 30 pro Sekunde30 per second 1.201–2.4001,201-2,400
A5A5 16 V-Kerne16 v-cores 8 Kerne, 50 GB RAM8 cores, 50GB RAM 8 Kerne8 cores 60 pro Sekunde60 per second 2.401–4.8002,401-4,800
A6A6 32 V-Kerne32 v-cores 16 Kerne, 100 GB RAM16 cores, 100GB RAM 16 Kerne16 cores 120 pro Sekunde120 per second 4.801–96004,801-9600
  • Bearbeiten Sie den App-Arbeitsbereich, und weisen Sie diesen unter „Erweitert“ einer Kapazität zu.Edit the app workspace and assign it to a capacity under advanced.

    Zuweisen des App-Arbeitsbereichs zur Kapazität

  • Stellen Sie die aktualisierte Anwendung für die Produktion bereit, und beginnen Sie mit dem Einbetten von Power BI-Dashboards und -Berichten.Deploy your updated application to production and begin embedding Power BI dashboards and reports.

AdministratoreinstellungenAdmin settings

Globale Administratoren oder Power BI-Dienstadministratoren können die Möglichkeit der Verwendung der REST-APIs für einen Mandanten aktivieren oder deaktivieren.Global Admins, or Power BI service administrators, can turn the ability to use the REST APIs, on or off for a tenant. Power BI-Administratoren können diese Einstellung für die gesamte Organisation oder für einzelne Sicherheitsgruppen festlegen.Power BI admins can set this setting for the entire organization, or for individual security groups. In der Standardeinstellung ist sie für die gesamte Organisation aktiviert.It is enabled for the entire organization by default. Dieser Vorgang wird über das Power BI-Verwaltungsportal ausgeführt.This is done through the Power BI admin portal.

Nächste SchritteNext steps

Einbetten mit Power BIEmbedding with Power BI
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?
How to purchase Power BI Premium (Erwerben von Power BI Premium)How to purchase Power BI Premium
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