Einbetten eines Berichts in ein sicheres Portal oder eine sichere WebsiteEmbed a report in a secure portal or website

Mit der neuen Option Einbetten für Power BI-Berichte können Sie Berichte ohne großen Aufwand und sicher in interne Webportale einbetten.With the new Embed option for Power BI reports, you can easily and securely embed reports in internal web portals. Diese Portale können cloudbasiert sein oder lokal gehostet werden (z. B. SharePoint 2019).These portals can be cloud-based or hosted on-premises, such as SharePoint 2019. Bei eingebetteten Berichten werden alle Elementberechtigungen und Anforderungen an die Datensicherheit über Sicherheit auf Zeilenebene berücksichtigt.Embedded reports respect all item permissions and data security through row-level security (RLS). Diese Option ermöglicht das Einbetten in beliebige Portale, die URL oder iFrame akzeptieren, ohne Programmieraufwand.They provide no-code embedding into any portal that accepts a URL or iFrame.

Die Option Einbetten unterstützt URL-Filter und URL-Einstellungen.The Embed option supports URL Filters and URL settings. Sie ermöglicht eine Integration in Portale mit geringem Programmieraufwand, für die nur grundlegende HTML- und JavaScript-Kenntnisse benötigt werden.It allows you to integrate with portals using a low-code approach requiring only basic HTML and JavaScript knowledge.

Einbetten von Power BI-Berichten in PortaleHow to Embed Power BI reports into portals

  1. Sie finden die neue Option Einbetten im Power BI-Dienst im Menü Datei für Berichte.The new Embed option is available on the File menu for reports in the Power BI service.

    Dropdownoption für das sichere Einbetten

  2. Klicken Sie auf die Option Einbetten, um ein Dialogfeld mit einem Link und einem iFrame zu öffnen, die Sie zum sicheren Einbetten des Berichts verwenden können.Select the Embed option to open a dialog that provides a link and an iFrame you can use to embed the report securely.

    Dialogfeld für die Option „Einbetten“

  3. Unabhängig davon, ob ein Benutzer eine Berichts-URL direkt öffnet oder einen eingebetteten Bericht in einem Webportal öffnet, ist eine Authentifizierung für den Zugriff auf den Bericht erforderlich.Whether a user opens a report URL directly, or one embedded in a web portal, report access requires authentication. Die folgende Anzeige wird angezeigt, wenn ein Benutzer sich in seiner Browsersitzung nicht bei Power BI angemeldet hat.The following screen appears if a user has not signed-in to Power BI in their browser session. Wenn dieser Benutzer auf Anmelden klickt, kann ein neues Browserfenster oder eine Registerkarte geöffnet werden.When they select Sign-In, a new browser window or tab could open. Weisen Sie die Benutzer an, Popupblocker zu überprüfen, wenn ihnen keine Anmeldeaufforderung angezeigt wird.Have them check for pop-up blockers if they don't get prompted to sign in.

    Anmelden, um den Bericht anzuzeigen

  4. Nachdem sich der Benutzer angemeldet hat, wird der Bericht mit den Daten geöffnet. Anschließend kann er zwischen den Seiten navigieren und Filter festlegen.After the user has signed in, the report opens, showing the data and allowing page navigation and filter setting. Nur Benutzer mit Leseberechtigung können den Bericht in Power BI anzeigen.Only users who have view permission can see the report in Power BI. Alle Regeln der Sicherheit auf Zeilenebene werden ebenfalls angewendet.All row-level security (RLS) rules are also applied. Schließlich muss der Benutzer ordnungsgemäß lizenziert sein, d.h., er benötigt eine Power BI Pro-Lizenz oder der Bericht muss sich in einem Arbeitsbereich in einer Power BI Premium-Kapazität befinden.Lastly, the user needs to be correctly licensed – either they need a Power BI Pro license, or the report must be in a workspace that is in a Power BI Premium capacity. Jedes Mal, wenn der Benutzer ein neues Browserfenster öffnet, muss er sich neu anmelden.The user needs to sign in each time they open a new browser window. Sobald er jedoch ein mal angemeldet ist, werden andere Berichte automatisch geladen.However, once signed in, other reports load automatically.

    Einbetten des Berichts

  5. Wenn ein iFrame verwendet wird, müssen Sie möglicherweise die Höhe und Breite anpassen, damit es auf die Webseite Ihres Portals passt.When using an iFrame, you may need to edit the height and width to have it fit in your portal’s web page.

    Festlegen von Höhe und Breite

Gewähren des Zugriffs auf einen BerichtGranting report access

Wenn Sie die Option Einbetten verwenden, erhalten Benutzer nicht automatisch die Berechtigung zum Anzeigen des Berichts.The Embed option doesn't automatically permit users to view the report. Die Leseberechtigungen werden im Power BI-Dienst festgelegt.View permissions are set in the Power BI service.

Im Power BI-Dienst können Sie eingebettete Berichte für Benutzer freigeben, die Zugriff benötigen.In the Power BI service, you can share embedded reports with users requiring access. Wenn Sie eine Office 365-Gruppe verwenden, können Sie Benutzer als Mitglieder des App-Arbeitsbereichs aufführen.If you're using an Office 365 Group, you can list the user as an app workspace member. Weitere Informationen dazu finden Sie unter Verwalten Ihres App-Arbeitsbereichs in Power BI und Office 365.For more information, see how to manage your app workspace in Power BI and Office 365.

LizenzierungLicensing

Benutzer, die den eingebetteten Bericht anzeigen möchten, benötigen entweder eine Power BI Pro-Lizenz, oder der Inhalt muss sich in einem Arbeitsbereich in einer Power BI Premium-Kapazität (EM oder P SKU) befinden.To view the embedded report, users need either a Power BI Pro license or the content needs to be in a workspace that's in a Power BI Premium capacity (EM or P SKU).

Anpassen der Darstellung des eingebetteten Berichts über URL-EinstellungenCustomize your embed experience using URL settings

Sie können die Benutzeroberfläche mithilfe der Eingabeeinstellungen der Einbettungs-URL anpassen.You can customize the user experience using the embed URL's input settings. Im bereitgestellten iFrame können Sie die src-Einstellungen der URL aktualisieren.In the provided iFrame, you can update the URL's src settings.

EigenschaftProperty BeschreibungDescription
pageNamepageName Sie können den Abfragezeichenfolgenparameter pageName verwenden, um festzulegen, welche Berichtsseite geöffnet werden soll.You can use the pageName query string parameter to set which report page to open. Diesen Wert finden Sie am Ende der Berichts-URL, wenn Sie einen Bericht wie im Folgenden gezeigt im Power BI-Dienst anzeigen.You can find this value at the report URL's end when viewing a report in the Power BI service, as shown below.
URL-FilterURL Filters Sie können URL-Filter in der Einbettungs-URL verwenden, die Sie aus der Benutzeroberfläche von Power BI abgerufen haben, um die eingebetteten Inhalte zu filtern.You can use URL Filters in the embed URL you received from the Power BI UI to filter the embed content. Auf diese Weise lassen sich Integrationen mit geringem Programmieraufwand erstellen, für die nur grundlegende Kenntnisse in HTML und JavaScript erforderlich sind.This way you can build low-code integrations with only basic HTML and JavaScript experience.

Festlegen der geöffneten Seite für einen eingebetteten BerichtSet which page opens for an embedded report

Den Wert pageName finden Sie am Ende der Berichts-URL, wenn Sie einen Bericht im Power BI-Dienst anzeigen.You can find the pageName value at the report URL's end when viewing a report in the Power BI service.

  1. Öffnen Sie den Bericht über den Power BI-Dienst in Ihrem Webbrowser, und kopieren Sie dann die URL aus der Adressleiste.Open the report from the Power BI service in your web browser, and then copy the address bar URL.

    Berichtsabschnitt

  2. Hängen Sie die Einstellung pageName an die URL an.Append the pageName setting to the URL.

    Anhängen von pageName

Filtern der Berichtsinhalte mit URL-FilternFilter report content using URL filters

Sie können URL-Filter verwenden, um verschiedene Berichtsansichten bereitzustellen.You can use URL Filters to provide different report views. Beispielsweise wird der Bericht mit der unten aufgeführten URL so gefiltert, dass Daten für die Energiebranche angezeigt werden.For example, the URL below filters the report to show data for the Energy industry.

Die Kombination von pageName und URL-Filter erlaubt besonders ausgefeilte Funktionen.Using the combination of pageName and URL Filters can be powerful. Mit einfachem HTML und JavaScript lassen sich verschiedene Benutzeroberflächen gestalten.You can build experiences using basic HTML and JavaScript.

Beispielsweise sehen Sie hier eine Schaltfläche, die Sie zu einer HTML-Seite hinzufügen können:For example, here’s a button you can add to an HTML page:

<button class="textLarge" onclick='show("ReportSection", "Energy");' style="display: inline-block;">Show Energy</button>

Wenn auf diese Schaltfläche geklickt wird, wird eine Funktion aufgerufen, durch die das iFrame mit einer aktualisierten URL versehen wird, die den Filter für Energiebranchen enthält.When selected, the button calls a function to update the iFrame with an updated URL, which includes the Energy industry filter.

function show(pageName, filterValue)

{

var newUrl = baseUrl + "&pageName=" + pageName;

if(null != filterValue && "" != filterValue)

{

newUrl += "&$filter=Industries/Industry eq '" + filterValue + "'";

}

//Assumes there’s an iFrame on the page with id=”iFrame”

var report = document.getElementById("iFrame")

report.src = newUrl;

}

Filtern

Sie können beliebig viele Schaltflächen hinzufügen, um mit geringem Programmieraufwand eine individuelle Benutzeroberfläche zu erstellen.You can add as many buttons as you’d like to create a low-code custom experience.

Überlegungen und EinschränkungenConsiderations and limitations

  • Externe Gastbenutzer mit Azure B2B (Business-to-Business) werden nicht unterstützt.Doesn't support external guest users with Azure business to business (B2B).

  • Das sichere Einbetten kann für Berichte verwendet werden, die im Power BI-Dienst veröffentlicht wurden.Secure embed works for reports published to the Power BI service.

  • Der Benutzer muss sich anmelden, um den Bericht anzuzeigen, wenn er ein neues Browserfenster öffnet.The user needs to sign in to view the report whenever they open a new browser window.

  • Bei einigen Browsern müssen Sie die Seite nach der Anmeldung aktualisieren, insbesondere bei Verwendung des InPrivate- oder Inkognitomodus.Some browsers require you to refresh the page after sign-in, especially when using InPrivate or Incognito modes.

  • Einmaliges Anmelden wird unterstützt, wenn Sie die Option „Einbetten“ in SharePoint Online verwenden oder über die Einbettungsmethode Benutzer ist Besitzer der Daten eine benutzerdefinierte Integration erstellen.To achieve a single sign-on experience, use the Embed in SharePoint Online option, or build a custom integration using the user owns data embedding method.

  • Die Funktion zur automatischen Authentifizierung, die von der Option Einbetten unterstützt wird, kann nicht mit der Power BI-JavaScript-API verwendet werden.The automatic authentication capability provided with the Embed option doesn't work with the Power BI JavaScript API. Verwenden Sie zum Einbetten mit der Power BI-JavaScript-API die Einbettungsmethode Benutzer ist Besitzer der Daten.For the Power BI JavaScript API, use the user owns data embedding method.

  • Die Lebensdauer des Authentifizierungstokens wird basierend auf Ihren AAD-Einstellungen gesteuert.The authentication token lifetime is controlled based on your AAD settings. Wenn das Authentifizierungstoken abläuft, muss der Benutzer seinen Browser aktualisieren, um ein aktualisiertes Authentifizierungstoken zu erhalten.When the authentication token expires, the user will need to refresh their browser to get an updated authentication token. Die Standardlebensdauer beträgt eine Stunde. Sie kann in Ihrer Organisation aber auch kürzer oder länger sein.The default lifetime is one hour, but it could be shorter or longer in your organization.

Nächste SchritteNext steps