Erfahren Sie mehr zu den Schritten, die Sie durchführen müssen, um Inhalte von Power BI in Ihre Anwendung einzubetten.

Microsoft hat vor Kurzem 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. Das Angebot bietet zusätzliche Skalierbarkeit und Leistung für den Power BI-Dienst.

Mit der Einführung von Power BI Premium werden Power BI Embedded und der Power BI-Dienst zusammengeführt, um die Einbettung von Power BI-Inhalten in Apps zu optimieren. Dies bedeutet, dass Ihnen eine API-Oberfläche, ein einheitlicher Satz von Funktionen und Zugriff auf die neuesten Power BI-Funktionen (z.B. Dashboards, Gateways und App-Arbeitsbereiche) zur Verfügung stehen, wenn Sie Inhalte einbetten. In Zukunft können Sie mit Power BI Desktop beginnen und zu einer Bereitstellung mit Power BI Premium wechseln. Dies wird im zweiten Quartal 2017 allgemein verfügbar sein.

In diesem Artikel wird erläutert, wie Sie Ihre Inhalte von Power BI sowohl für Benutzer als auch Nicht-Benutzer von Power BI einbetten. Die Schritte sind für beides ähnlich. Es wird darauf hingewiesen, wenn ein Schritt nur für das Einbetten für Benutzer gilt, die kein Power BI verwenden.

Sie müssen in Ihrer Anwendung die folgenden Schritte ausführen, um dies zu ermöglichen. Hier werden die erforderlichen Schritte durchgegangen, damit Sie eingebettete Inhalte mit Ihrer Anwendung verwenden können.

Hinweis:

Die APIs von Power BI verweisen weiterhin in Gruppen auf Arbeitsbereiche. Alle Verweise auf Gruppen bedeuten, dass Sie mit App-Arbeitsbereichen arbeiten.

Schritt 1: Richten Sie Ihre Entwicklungsumgebung für eingebettete Analysen ein

Bevor Sie mit dem Einbetten von Dashboards und Berichten in Ihre Anwendung beginnen, müssen Sie sicherstellen, dass Ihre Umgebung das Einbetten erlaubt. Im Rahmen des Setups müssen Sie folgende Aktionen ausführen.

Hinweis:

Power BI Premium ist nicht für die Entwicklung der Anwendung erforderlich. Die Entwickler der Anwendung müssen über eine Power BI Pro-Lizenz verfügen.

Azure Active Directory-Mandant

Sie benötigen einen Azure Active Directory-Mandanten (Azure AD), um Elemente aus Power BI einzubetten. Dieser Mandant muss mindestens einen Benutzer von Power BI Pro haben. Sie müssen außerdem eine Azure AD-App im Mandanten festlegen. Sie können einen vorhandenen Azure AD-Mandanten verwenden oder einen neuen Mandanten erstellen, den Sie nur zum Einbetten verwenden.

Sie müssen bestimmen, welches Mandantensetup Sie verwenden möchten.

  • Verwenden Sie Ihren vorhandenen, unternehmensbezogenen Power BI-Mandanten?
  • Verwenden Sie einen separaten Mandanten für Ihre Anwendung?
  • Verwenden Sie einen separaten Mandanten pro Kunde?

Wenn Sie sich dazu entscheiden, einen neuen Mandanten für Ihre Anwendung zu erstellen, oder einen Mandanten pro Kunde, finden Sie weitere Informationen unter Erstellen eines Azure Active Directory-Mandanten und Einrichten eines Azure Active Directory-Mandanten.

Hinweis:

Es wird empfohlen, einen neuen Azure AD-Mandanten zu erstellen, wenn Sie für Benutzer einbetten, die kein Power BI verwenden.

Erstellen Sie ein Benutzerkonto für Power BI Pro

Sie benötigen nur ein einzelnes Power BI Pro-Konto zum Einbetten von Inhalt. Vielleicht möchten Sie aber verschiedene Benutzer haben, die bestimmten Zugriff auf Elemente haben. Dies ist ein Überblick über mögliche Benutzer für Ihren Mandanten.

Die folgenden Konten müssen in Ihrem Mandanten vorhanden sein und über eine Lizenz für Power BI Pro verfügen.

Hinweis:

Diese Konten benötigen Power BI Pro-Lizenzen, um App-Arbeitsbereiche nutzen zu können.

Ein Administrator für den Mandanten/die Organisation

Es wird empfohlen, dass der globale Administrator für die Organisation/den Mandanten nicht als das Konto verwendet wird, das die Anwendung nutzt. So wird der Zugriff des Anwendungskontos innerhalb Ihrer Organisation minimiert. Dieser Administrator sollte Administratorbenutzer aller App-Arbeitsbereiche sein, die zum Einbetten erstellt werden.

Konten für Analysten, die Inhalte erstellen

Möglicherweise sind mehrere Benutzer vorhanden, die Inhalte für Power BI erstellen. Sie benötigen ein Power BI Pro-Konto für jeden Analysten, der Inhalt in Power BI erstellt und bereitstellt.

Das Masterbenutzerkonto einer Anwendung für Benutzer, die kein Power BI verwenden

Dies ist das Konto, das die Anwendung verwendet, wenn Sie Inhalte für Benutzer einbetten, die kein Power BI verwenden. Dies ist eigentlich das einzige erforderliche Konto, das Sie in Ihrer Organisation benötigen. Es kann auch als Administrator- und Analytikerkonto verwendet werden, dies wird allerdings nicht empfohlen. 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. Dieses Konto wird verwendet, um ein Einbettungstoken für die Anwendung für Benutzer zu generieren, die kein Power BI verwenden.

Dieses Konto muss ein Administrator des App-Arbeitsbereichs sein, der zum Einbetten verwendet wird.

App-Registrierung und Berechtigungen

Sie müssen eine Anwendung in Azure AD registrieren und Berechtigungen für diese Anwendung für das Einbetten von Inhalten von Power BI zuweisen. Sie sollten die App mit dem Masterkonto registrieren, das Sie im vorherigen Schritt erstellt haben.

Registrieren einer Anwendung

Sie müssen die Anwendung zunächst in Azure AD registrieren. Obwohl Sie dir im Azure AD-Portal machen können, haben wir eine Website erstellt, auf der Sie die App schnell registrieren können. Je nachdem, für wen Sie Inhalte einbetten, müssen Sie unterschiedliche Elemente für Ihre Anwendung auswählen. Wenn Sie für Benutzer einbetten, die kein Power BI verwenden, muss der Typ der App Nativ sein.

Einbetten für Anwendungstyp
Power BI-Benutzer Serverseitige Web-App oder native App
Benutzer, die kein Power BI verwenden Native App

Schritte zum Registrieren von Anwendungen finden Sie unter Register an application (Registrieren einer Anwendung).

Anwenden von Berechtigungen für die Anwendung

Wichtig:

Dieser Abschnitt gilt nur für Anwendungen, die Inhalt für Benutzer einbetten, die kein Power BI verwenden.

Sie müssen neben den Einstellungen auf der App-Registrierungsseite zusätzliche Berechtigungen für die Anwendung aktivieren. Dies ist über das Azure AD-Portal oder programmgesteuert möglich.

Sie sollten diese Schritte mit einem Mandanten-/Organisationsadministrator durchführen. Dies ist z.B. ein Benutzer mit der Rolle „globaler Administrator“.

Über das Azure AD-Portal
  1. Navigieren Sie zum Blatt für die App-Registrierung im Azure-Portal, und wählen Sie die App aus, die Sie für die Einbettung verwenden.

  2. Wählen Sie unter API-Zugriff die Option Erforderliche Berechtigungen aus.

  3. Wählen Sie Windows Azure Active Directory aus, und stellen Sie sicher, dass Hiermit greifen Sie als angemeldeter Benutzer auf das Verzeichnis zu ausgewählt ist. Wählen Sie Speichern.

  4. Wählen Sie unter Erforderliche Berechtigungen die Option Power BI-Dienst (Power BI) aus.

    Hinweis:

    Wenn Sie die App direkt im Azure AD-Portal erstellen, ist der Power BI-Dienst (Power BI) möglicherweise nicht vorhanden. Wenn dies der Fall ist, wählen Sie + Add (+ Hinzufügen) und dann 1 Select an API (API auswählen). Klicken Sie auf Power BI Service (Power BI-Dienst) in der API-Liste, und klicken Sie dann auf Select (Auswählen). Sie können dann mit Schritt 5 fortfahren.

  5. Wählen Sie alle Berechtigungen unter Delegierte Berechtigungen aus. Sie müssen sie einzeln auswählen, um die Auswahl zu speichern. Wählen Sie Speichern aus, wenn Sie fertig sind.

  6. Wählen Sie unter Erforderliche Berechtigungen die Option Berechtigungen erteilen aus.

    So werden der App Berechtigungen für alle Benutzer im Mandanten/der Organisation zugewiesen. Wenn Sie dies nicht möchten, müssen Sie sich mindestens einmal interaktiv mit Ihrer App-ID in Azure AD anmelden.

    Hinweis:

    Um die Berechtigung für alle Benutzer im Mandanten zu gewähren, muss dieser Vorgang von einem Konto in der Rolle „globaler Administrator“ erstellt werden. Andernfalls wird die Berechtigung nur dem Benutzer erteilt, der den Schritt ausgeführt hat.

Programmgesteuertes Anwenden von Berechtigungen
  1. Sie müssen die vorhandenen Dienstprinzipale (Benutzer) in Ihrem Mandanten abrufen. Informationen hierzu finden Sie im Artikel zu Get servicePrincipal.

    Hinweis:

    Sie können die API Get servicePrincipal ohne {id} aufrufen. So werden alle Dienstprinzipale innerhalb des Mandanten abgerufen.

  2. Suchen Sie nach einem Dienstprinzipal mit Ihrer App-Client-ID als appId-Eigenschaft.

  3. Erstellen Sie einen neuen Serviceplan, wenn für Ihre App keiner vorhanden ist.

    Post https://graph.microsoft.com/beta/servicePrincipals
    Authorization: Bearer ey..qw
    Content-Type: application/json
    {
    "accountEnabled" : true,
    "appId" : "{App_Client_ID}",
    "displayName" : "{App_DisplayName}"
    }
    
  4. Weisen Sie der PowerBI-API App-Berechtigungen zu.

    Post https://graph.microsoft.com/beta/OAuth2PermissionGrants
    Authorization: Bearer ey..qw
    Content-Type: application/json
    { 
    "clientId":"{Service_Plan_ID}",
    "consentType":"AllPrincipals",
    "resourceId":"c78b2585-1df6-41de-95f7-dc5aeb7dc98e",
    "scope":"Dataset.ReadWrite.All Dashboard.Read.All Report.Read.All Group.Read Group.Read.All Content.Create Metadata.View_Any Dataset.Read.All Data.Alter_Any",
    "expiryTime":"2018-03-29T14:35:32.4943409+03:00",
    "startTime":"2017-03-29T14:35:32.4933413+03:00"
    }
    
  5. Weisen Sie AAD App-Berechtigungen zu.

    Post https://graph.microsoft.com/beta/OAuth2PermissionGrants
    Authorization: Bearer ey..qw
    Content-Type: application/json
    { 
    "clientId":"{Service_Plan_ID}",
    "consentType":"AllPrincipals",
    "resourceId":"61e57743-d5cf-41ba-bd1a-2b381390a3f1",
    "scope":"User.Read Directory.AccessAsUser.All",
    "expiryTime":"2018-03-29T14:35:32.4943409+03:00",
    "startTime":"2017-03-29T14:35:32.4933413+03:00"
    }
    

Erstellen von App-Arbeitsbereichen

Wenn Sie Dashboards und Berichte für nicht Benutzer einbetten, die kein Power BI verwenden, müssen diese Dashboards und Berichte in einem App-Arbeitsbereich platziert werden. Informationen zum Erstellen eines App-Arbeitsbereichs finden Sie unter Create and distribute an app in Power BI (Erstellen und Verteilen eine App in Power BI).

Wichtig:

Das Masterkonto, das schon weiter oben erwähnt wurde, muss ein Administrator des App-Arbeitsbereichs sein.

Erstellen und Hochladen von Berichten

Sie können Ihre Berichte und Datasets mit Power BI Desktop erstellen und diese Berichte dann in einem App-Arbeitsbereich veröffentlichen. Der Endbenutzer, der die Berichte veröffentlicht, muss über eine Power BI Pro-Lizenz verfügen, damit er einen App-Arbeitsbereich veröffentlichen kann.

Schritt 2: Einbetten der Inhalte

In Ihrer Anwendung müssen Sie sich bei Power BI authentifizieren. Wenn Sie Inhalte für Benutzer einbetten, die kein Power BI verwenden, müssen Sie die Anmeldeinformationen des Masterkontos innerhalb der Anwendung speichern.

Verwenden Sie die Power BI- und JavaScript-APIs zum Einbetten von Dashboards und Berichten in Ihrer Anwendung. Weitere Informationen:

Wenn Sie für Benutzer einbetten, die kein Power BI verwenden, ist ein Einbettungstoken erforderlich. Weitere Informationen finden Sie unter GenerateToken.

Schritt 3: Heraufstufen Ihrer Lösung zur Produktion

Wenn Sie in die Produktionsphase wechseln möchten, müssen Sie die folgenden Schritte ausführen.

Power BI-Benutzer

Wenn Sie für Power BI-Benutzer einbetten, müssen Sie diese nur darüber informieren, wie sie Ihre Anwendung finden können.

Benutzer, die kein Power BI verwenden

Wenn Sie für Benutzer einbetten, die kein Power BI verwenden, sollten Sie folgende Aktionen ausführen.

  • Obwohl Sie den Produktionsmandanten Ihrer Organisation verwenden können, wird empfohlen, dass Sie eine neue eingebettete Analyseumgebung für die Produktion erstellen. Weitere Informationen finden Sie oben in Schritt 1.

  • 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. Sie müssen zudem sicherstellen, dass Sie die Anwendung in Azure AD für Ihren Produktionsmandanten erstellt haben, und dass Sie die entsprechenden App-Berechtigungen zugewiesen haben, wie in Schritt 1 angegeben.

  • Erwerben Sie eine Kapazität, die Ihren Anforderungen entspricht. Mit folgender Tabelle können Sie bestimmen, welche SKU für Premium-Kapazitäten Sie benötigten. Weitere Informationen finden Sie im Whitepaper zum Planen von eingebetteten Analysekapazitäten. Sie können das Produkt im Administrationscenter von Office 365 erwerben.

Kapazitätsknoten Gesamtzahl der Kerne
(Back-End + Front-End)
Back-End-Kerne Front-End-Kerne Grenzwerte für DirectQuery/Liveverbindung Höchstzahl an Seitenladevorgängen zu Spitzenzeiten Verfügbarkeit
EM1 1 V-Kern 1/2 Kern, 3 GB RAM 1/2 Kern 1–300 Juli 2017
EM2 2 V-Kerne 1 Kern, 5 GB RAM 1 Kern 301–600 Juli 2017
EM3 4 V-Kerne 2 Kerne, 10 GB RAM 2 Kerne 601–1.200 Juli 2017
P1 8 V-Kerne 4 Kerne, 25 GB RAM 4 Kerne 30 pro Sekunde 1.201–2.400 Verfügbarkeit
P2 16 V-Kerne 8 Kerne, 50 GB RAM 8 Kerne 60 pro Sekunde 2.401–4.800 Verfügbarkeit
P3 32 V-Kerne 16 Kerne, 100 GB RAM 16 Kerne 120 pro Sekunde 4.801–9600 Verfügbarkeit
Hinweis:

Sie müssen in ihrem Mandanten ein globaler oder Abrechnungsadministrator sein, um Power BI Premium erwerben zu können. Informationen zum Erwerb von Power BI Premium finden Sie unter How to purchase Power BI Premium (Erwerben von Power BI Premium).

  • Bearbeiten Sie den App-Arbeitsbereich, und weisen Sie diesen einer Premium-Kapazität unter „Erweitert“ zu.

  • Stellen Sie die aktualisierte Anwendung für die Produktion bereit, und beginnen Sie mit dem Einbetten von Berichten aus dem Power BI-Dienst.

Nächste Schritte

Einbetten mit Power BI
Migrieren von Inhalten aus Power BI Embedded-Arbeitsbereichsammlungen zu Power BI
Power BI Premium – Beschreibung
How to purchase Power BI Premium (Erwerben von Power BI Premium)
JavaScript-API-Git-Repository
Power BI-C#-Git-Repository
JavaScript-Einbettungsbeispiel
Whitepaper zur Kapazitätsplanung der eingebetteten Analyse
Power BI Premium-Whitepaper

Weitere Fragen? Stellen Sie Ihre Frage in der Power BI-Community.