Incorporer un rapport dans un site web ou portail sécuriséEmbed a report in a secure portal or website

Avec la nouvelle option Incorporer pour les rapports Power BI, vous pouvez incorporer des rapports dans les portails web internes de manière simple et sécurisée.With the new Embed option for Power BI reports, you can easily and securely embed reports in internal web portals. Ces portails peuvent être basés sur le cloud ou hébergés localement, à l’image de SharePoint 2019.These portals can be cloud-based or hosted on-premises, such as SharePoint 2019. Les rapports incorporés respectent toutes les autorisations d’élément et les données de sécurité via la sécurité au niveau des lignes (RLS).Embedded reports respect all item permissions and data security through row-level security (RLS). Ils fournissent l’intégration sans code dans n’importe quel portail qui accepte une URL ou un iFrame.They provide no-code embedding into any portal that accepts a URL or iFrame.

L’option Incorporer prend en charge les filtres URL et les paramètres d’URL.The Embed option supports URL filters and URL settings. Elle vous permet d’effectuer une intégration aux portails à l’aide d’une approche avec peu de code qui nécessite uniquement une connaissance élémentaire de HTML et de JavaScript.It allows you to integrate with portals using a low-code approach requiring only basic HTML and JavaScript knowledge.

Comment incorporer des rapports Power BI dans des portailsHow to embed Power BI reports into portals

  1. Ouvrez un rapport dans le service Power BI.Open a report in the Power BI service.

  2. Dans le menu Partager, sélectionnez Incorporer un rapport > Site web ou portail.On the Share menu, select Embed report > Website or portal.

    Option Site web ou portail

  3. Dans la boîte de dialogue Code d’incorporation sécurisée, sélectionnez le Lien que vous pouvez utiliser pour incorporer ce contenu ou le Code HTML que vous pouvez coller dans votre blog ou votre site web dans un iFrame.In the Secure embed code dialog, select the link you can use to embed this content, or the HTML you can paste into your blog or website in an iFrame.

    Boîte de dialogue de l’option Incorporer

  4. Qu’un utilisateur ouvre directement une URL de rapport ou une URL incorporée dans un portail web, l’accès aux rapports nécessite une authentification.Whether a user opens a report URL directly, or one embedded in a web portal, report access requires authentication. L’écran suivant s’affiche si un utilisateur ne s’est pas connecté à Power BI dans sa session de navigateur.The following screen appears if a user has not signed-in to Power BI in their browser session. Quand il sélectionne Connexion, une nouvelle fenêtre de navigateur ou un nouvel onglet peut s’ouvrir.When they select Sign-In, a new browser window or tab could open. Faites en sorte qu’il vérifie les bloqueurs de fenêtres contextuelles s’il n’est pas invité à se connecter.Have them check for pop-up blockers if they don't get prompted to sign in.

    Connectez-vous pour voir ce rapport

  5. Une fois que l’utilisateur s’est connecté, le rapport s’ouvre, affichant les données et permettant de naviguer entre les pages et de définir des filtres.After the user has signed in, the report opens, showing the data and allowing page navigation and filter setting. Seuls les utilisateurs qui disposent de l’autorisation d’affichage peuvent voir le rapport dans Power BI.Only users who have view permission can see the report in Power BI. Toutes les règles de sécurité au niveau des lignes (RLS) sont également appliquées.All row-level security (RLS) rules are also applied. Enfin, l’utilisateur doit disposer d’une licence correcte. Il doit avoir une licence Power BI Pro, ou le rapport doit être dans un espace de travail qui se trouve dans une capacité Power BI Premium.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. L’utilisateur doit se connecter chaque fois qu’il ouvre une nouvelle fenêtre de navigateur.The user needs to sign in each time they open a new browser window. Toutefois, une fois connecté, les autres rapports se chargent automatiquement.However, once signed in, other reports load automatically.

    Incorporer un rapport

  6. Quand vous utilisez un iFrame, vous pouvez être amené à modifier la hauteur et la largeur afin qu’il tienne dans la page web de votre portail.When using an iFrame, you may need to edit the height and width to have it fit in your portal's web page.

    Définir la hauteur et la largeur

Octroi d’un accès au rapportGranting report access

L’option Incorporer ne permet pas automatiquement aux utilisateurs de voir le rapport.The Embed option doesn't automatically permit users to view the report. Les autorisations de consultation sont définies dans le service Power BI.View permissions are set in the Power BI service.

Dans le service Power BI, vous pouvez partager des rapports incorporés avec des utilisateurs qui ont besoin d’un accès.In the Power BI service, you can share embedded reports with users requiring access. Si vous utilisez un groupe Microsoft 365, vous pouvez lister l’utilisateur comme membre de l’espace de travail.If you're using a Microsoft 365 Group, you can list the user as a workspace member. Pour plus d’informations, consultez Gérer l’espace de travail dans Power BI et Microsoft 365.For more information, see how to manage your workspace in Power BI and Microsoft 365.

LicencesLicensing

Pour que les utilisateurs puissent voir le rapport incorporé, ils ont besoin d’une licence Power BI Pro ou le contenu doit se trouver dans un espace de travail qui se trouve dans une capacité Power BI Premium (référence SKU EM ou P).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).

Personnaliser votre expérience d’incorporation à l’aide des paramètres d’URLCustomize your embed experience using URL settings

Vous pouvez personnaliser l’expérience utilisateur à l’aide des paramètres d’entrée de l’URL d’incorporation.You can customize the user experience using the embed URL's input settings. Dans l’iFrame fourni, vous pouvez mettre à jour les paramètres src de l’URL.In the provided iFrame, you can update the URL's src settings.

PropriétéProperty DescriptionDescription
pageNamepageName Vous pouvez utiliser le paramètre de chaîne de requête pageName pour définir la page de rapport à ouvrir.You can use the pageName query string parameter to set which report page to open. Vous pouvez trouver cette valeur à la fin de l’URL du rapport quand vous affichez un rapport dans le service Power BI, comme indiqué ci-dessous.You can find this value at the report URL's end when viewing a report in the Power BI service, as shown below.
Filtres d’URLURL Filters Vous pouvez utiliser des filtres d’URL dans l’URL d’incorporation que vous avez reçue à partir de l’interface utilisateur de Power BI pour filtrer le contenu d’incorporation.You can use URL Filters in the embed URL you received from the Power BI UI to filter the embed content. Ainsi, vous pouvez créer des intégrations avec peu de code et des connaissances de base de HTML et de JavaScript.This way you can build low-code integrations with only basic HTML and JavaScript experience.

Définir la page qui s’ouvre pour un rapport incorporéSet which page opens for an embedded report

Vous pouvez trouver la valeur pageName à la fin de l’URL du rapport quand vous consultez un rapport dans le service Power BI.You can find the pageName value at the report URL's end when viewing a report in the Power BI service.

  1. Ouvrez le rapport à partir du service Power BI dans votre navigateur web et copiez l’URL de la barre d’adresses.Open the report from the Power BI service in your web browser, and then copy the address bar URL.

    Section du rapport

  2. Ajoutez le paramètre pageName à l’URL.Append the pageName setting to the URL.

    Ajouter pageName

Filtrer le contenu du rapport à l’aide de filtres d’URLFilter report content using URL filters

Vous pouvez utiliser des filtres d’URL pour fournir différentes vues du rapport.You can use URL Filters to provide different report views. Par exemple, l’URL ci-dessous filtre le rapport pour afficher les données pour le secteur de l’énergie.For example, the URL below filters the report to show data for the Energy industry.

L’utilisation de la combinaison de pageName et de filtres d’URL peut être très puissante.Using the combination of pageName and URL Filters can be powerful. Vous pouvez créer des expériences à l’aide de code HTML et JavaScript de base.You can build experiences using basic HTML and JavaScript.

Par exemple, voici un bouton que vous pouvez ajouter à une page HTML :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>

Quand l’utilisateur le sélectionne, le bouton appelle une fonction pour mettre à jour l’iFrame avec une URL mise à jour, qui inclut le filtre pour le secteur de l’énergie.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;

}

Filtre

Vous pouvez ajouter autant de boutons que vous le souhaitez pour créer une expérience personnalisée avec peu de code.You can add as many buttons as you'd like to create a low-code custom experience.

Considérations et limitationsConsiderations and limitations

  • Les rapports paginés sont pris en charge avec les scénarios d’incorporation sécurisée, et les rapports paginés avec des paramètres d’URL sont également pris en charge.Paginated reports are supported with secure embed scenarios, and paginated reports with URL parameters are also supported. Découvrez-en plus sur la transmission de paramètres de rapport dans une URL pour un rapport paginé.Read more about passing report parameters in a URL for a paginated report.

  • L’incorporation sécurisée fonctionne pour les rapports publiés sur le service Power BI.Secure embed works for reports published to the Power BI service.

  • L’utilisateur doit se connecter pour voir le rapport à chaque fois qu’il ouvre une nouvelle fenêtre de navigateur.The user needs to sign in to view the report whenever they open a new browser window.

  • Certains navigateurs vous obligent à actualiser la page après la connexion, en particulier lorsque vous utilisez les modes InPrivate ou Incognito.Some browsers require you to refresh the page after sign-in, especially when using InPrivate or Incognito modes.

  • Vous risquez de rencontrer des problèmes si vous utilisez des versions de navigateur non prises en charge.You may encounter issues if using unsupported browser versions. Power BI prend en charge la liste de navigateurs suivante.Power BI supports the following list of browsers.

  • La version classique de SharePoint Server n’est pas prise en charge, car elle requiert des versions d’Internet Explorer antérieures à la version 11, ou l’activation du mode d’Affichage de compatibilité.The classic SharePoint Server isn't supported, as it requires Internet Explorer versions earlier than 11, or enabling the compatibility view mode.

  • Pour obtenir une expérience d’authentification unique, utilisez l’option Incorporer dans SharePoint Online, ou générez une intégration personnalisée suivant la méthode d’incorporation les données appartiennent à l’utilisateur.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.

  • La fonctionnalité d’authentification automatique fournie avec l’option Incorporer ne fonctionne pas avec l’API JavaScript Power BI.The automatic authentication capability provided with the Embed option doesn't work with the Power BI JavaScript API. Pour l’API JavaScript Power BI, utilisez la méthode d’incorporation les données appartiennent à l’utilisateur.For the Power BI JavaScript API, use the user owns data embedding method.

  • La durée de vie du jeton d’authentification est contrôlée en fonction de vos paramètres AAD.The authentication token lifetime is controlled based on your AAD settings. Quand le jeton d’authentification expire, l’utilisateur doit actualiser son navigateur pour recevoir un jeton d’authentification mis à jour.When the authentication token expires, the user will need to refresh their browser to get an updated authentication token. La durée de vie par défaut est d’une heure, mais elle peut être plus courte ou plus longue dans votre organisation.The default lifetime is one hour, but it could be shorter or longer in your organization. Il n’est pas possible d’actualiser automatiquement le jeton dans ce scénario.There is no ability to automatically refresh the token in this scenario.

Étapes suivantesNext steps