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

Mit der neuen sicheren Power BI-Option Einbetten für Berichte können Benutzer Berichte sicher und einfach in interne Webportale einbetten. Diese können cloudbasiert oder wie bei SharePoint 2019 lokal gehostet sein.The new secure Embed option for reports in Power BI enables users to easily and securely embed reports in internal web portals, whether cloud-based or hosted on-premises, such as SharePoint 2019. Bei Berichten, die auf diese Weise eingebettet werden, werden alle Elementberechtigungen und Anforderungen an die Datensicherheit über Sicherheit auf Zeilenebene berücksichtigt.Reports embedded in this way respect all item permissions and data security through row-level security (RLS). Die Funktion wurde so entwickelt, dass ein Einbetten ohne Programmieraufwand in ein beliebiges Portal möglich ist, das das Einbetten einer URL oder eines iFrame gestattet.The feature is designed to allow no-code embedding into any portal that accepts a URL or iFrame to embed.

Die Option Einbetten unterstützt außerdem URL-Filter und URL-Einstellungen.The Embed option also supports URL Filters and URL settings. Die Option Einbetten ermöglicht eine Integration in Portale mit geringem Programmieraufwand, für die grundlegende HTML- und JavaScript-Kenntnisse benötigt werden.The Embed option allows you to integrate with portals using a low-code approach that requires 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. Wählen Sie die Option „Einbetten“ aus, um ein Dialogfeld mit einem Link und einem iFrame zu öffnen, die zum sicheren Einbetten des Berichts benötigt werden.Select the Embed option to open a dialog that provides a link and an iFrame that is used to embed the report securely.

    Dialogfeld für die Option „Einbetten“

  3. Nachdem Sie die URL in Ihr Webportal eingebettet haben oder wenn Sie die URL direkt öffnen, wird der Benutzer authentifiziert, bevor er Zugriff auf den Bericht erhält.After you embed your URL in your web portal, or if you open the URL directly, the user is authenticated before given access to the report. Im folgenden Beispiel hat sich der Benutzer in der Browsersitzung nicht bei Power BI angemeldet.Below, the user has not signed-in to Power BI in the browser session. Wenn er auf Anmelden klickt, wird ggf. ein neues Browserfenster oder eine neue Registerkarte geöffnet.When they press Sign-In, a new browser window or tab may need to open. Wenn Sie nicht aufgefordert werden, sich anzumelden, überprüfen Sie, ob Popupblocker aktiv sind.Check for pop-up blockers if you 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 users to navigate between pages and to set filters. Der Bericht wird nur Benutzern angezeigt, die die Berechtigung zum Anzeigen des Berichts in Power BI besitzen.The report is shown only to users who have permission to view 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. Der Benutzer muss sich jedes Mal erneut anmelden, wenn er ein neues Browserfenster öffnet. Sobald er sich jedoch einmal angemeldet hat, werden Berichte automatisch geladen.The user needs to sign in each time they open a new browser window, but after they’ve signed in once other reports load automatically.

    Einbetten des Berichts

  5. Wenn Sie die iFrame-Option verwenden, sollten Sie den bereitgestellten HTML-Code so ändern, dass die gewünschte Höhe und Breite auf der Webseite des Portals angegeben wird.When using the iFrame option, it's best to edit the HTML provided to specify the desired height and width to fit into your portal’s web page.

    Festlegen von Höhe und Breite

Zugriff gewähren auf BerichteGranting access to reports

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 Berechtigungen zum Anzeigen des Berichts werden im Power BI-Dienst festgelegt.The permissions to view the report are set within the Power BI service.

Um im Power BI-Dienst Zugriff auf den Bericht zu gewähren, können Sie den Bericht für die Benutzer freigeben, die auf den eingebetteten Bericht zugreifen werden.To provide access to the report within the Power BI service, you can share the report with the users who require access to the embedded report. Wenn Sie eine Office 365-Gruppe verwenden, können Sie den Benutzer als Mitglied des App-Arbeitsbereichs im Power BI-Dienst aufführen.If you're using an Office 365 Group, you can list the user as a member of the app workspace within the Power BI service. Weitere Informationen finden Sie unter Verwalten eines App-Arbeitsbereichs.For more information, see how to manage an app workspace.

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.Users viewing the embedded report 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

Die Einbettungs-URL unterstützt mehrere Eingabeeinstellungen zum Anpassen der Darstellung.The embed URL supports several input settings that help you customize your user experience. Wenn Sie den bereitgestellten iFrame verwenden, stellen Sie sicher, dass Sie die URL in den src-Einstellungen des iFrame aktualisiert haben.If you’re using the iFrame provided, make sure you update the URL in the iFrame’s src settings.

EigenschaftProperty BeschreibungDescription
pageNamepageName Mit dem Parameter pageName der Abfragezeichenfolge können Sie festlegen, welche Seite des Berichts geöffnet werden soll.You can use the pageName query string parameter to set which page of the report to open. Der Wert von pageName entspricht dem Ende der Berichts-URL, wenn ein Bericht im Power BI-Dienst angezeigt wird. Dies ist in der folgenden Abbildung dargestellt.The pageName value corresponds to the end of the report URL 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 Inhalte der Einbettung zu filtern.You can use URL Filters in the embed URL you received from the Power BI UI to filter the content of the embed. 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 zu öffnenden Seite im eingebetteten BerichtSet which page opens when the report is embedded

Der für die Einstellung pageName festgelegte Wert entspricht dem Ende der Berichts-URL, wenn ein Bericht im Power BI-Dienst angezeigt wird.The value provided in the pageName setting corresponds to the end of the report URL when viewing a report in the Power BI service.

  1. Öffnen Sie den Bericht aus dem 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 URL from the address bar.

    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

Dank URL-Filtern können Sie auch erweiterte Funktionen bei der Darstellung des Berichts verwenden.For some advanced features, you can URL Filters to build more experiences using the report. 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, wie Sie einer HTML-Seite eine Schaltfläche hinzufügen können:For example, here’s how you can add a button to an HTML page:

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

Beim Klicken auf die Schaltfläche wird eine Funktion aufgerufen, in der der iFrame mit einer neuen URL aktualisiert wird, die den Filter für die Energiebranche enthält.When pressed, the button calls a function to update the iFrame with an updated URL, which includes the filter for the Energy industry.

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 Methode 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 approach. Weitere Informationen zu Benutzer ist Besitzer der DatenLearn more about user owns data.

  • 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 Methode Benutzer ist Besitzer der Daten.For the Power BI JavaScript API, use the user owns data approach to embedding. Weitere Informationen zu Benutzer ist Besitzer der DatenLearn more about user owns data.

Nächste SchritteNext steps