Tutoriel : Incorporer du contenu Power BI en utilisant un exemple d’application Incorporer pour votre organisation

L’analytique incorporée de Power BI vous permet d’incorporer dans votre application des contenus Power BI comme des rapports, des tableaux de bord et des vignettes.

Ce didacticiel vous montre comment effectuer les opérations suivantes :

  • Configurer votre environnement incorporé.
  • Configurer un exemple d’application Incorporer pour votre organisation (également appelée L’utilisateur possède les données).

Pour utiliser votre application, vos utilisateurs ont besoin de se connecter à Power BI.

La solution Incorporer pour votre organisation est généralement utilisée par les grandes entreprises et organisations et s’adresse aux utilisateurs internes.

Important

Si vous incorporez du contenu pour un cloud national/régional, les premières étapes de ce tutoriel sont différentes. Pour plus d’informations, consultez l’article Incorporer du contenu pour des clouds nationaux/régionaux.

Spécifications de l’exemple de code

Ce tutoriel inclut des instructions sur la configuration d’un exemple d’application Incorporer pour votre organisation dans un des frameworks suivants :

  • .NET Framework
  • .NET Core
  • React TypeScript

Notes

Les exemples .NET Core et .NET Framework permettent à l’utilisateur final d’afficher un tableau de bord, un rapport ou une vignette Power BI auxquels il a accès dans le service Power BI. L’exemple React TypeScript vous permet d’incorporer un seul rapport auquel votre utilisateur final a déjà accès sur le service Power BI.

Les exemples de code prennent en charge les navigateurs suivants :

  • Microsoft Edge
  • Google Chrome
  • Mozilla Firefox

Prérequis

Avant de commencer ce tutoriel, vérifiez que vous disposez des dépendances de Power BI et du code listées suivantes :


Méthode

Pour créer un exemple d’application Incorporer pour votre organisation, effectuez les étapes suivantes :

  1. Inscrivez une application Microsoft Entra.

  2. Créez un espace de travail Power BI.

  3. Créez et publiez un rapport Power BI.

  4. Obtenez les valeurs des paramètres d’incorporation.

  5. Incorporez votre contenu.

Étape 1 : Inscrire une application Microsoft Entra

L’inscription de votre application auprès de Microsoft Entra ID vous permet d’établir une identité pour votre application.

Pour inscrire votre application auprès de Microsoft Entra ID, suivez les instructions données dans Inscrire votre application.

Étape 2 - Créer un espace de travail Power BI

Power BI conserve vos rapports, tableaux de bord et vignettes dans un espace de travail. Pour incorporer ces éléments, vous devez les créer et les charger dans un espace de travail.

Conseil

Si vous disposez déjà d’un espace de travail, vous pouvez passer cette étape.

Pour créer un espace de travail, effectuez les actions suivantes :

  1. Connectez-vous à Power BI.

  2. sélectionnez Espaces de travail.

  3. Sélectionnez Créer un espace de travail.

  4. Nommez votre espace de travail, puis sélectionnez Enregistrer.

Étape 3 - Créer et publier un rapport Power BI

L’étape suivante consiste à créer un rapport et à le charger dans votre espace de travail. Vous pouvez créer votre propre rapport en utilisant Power BI Desktop, puis le publier dans votre espace de travail. Vous pouvez aussi charger un exemple de rapport dans votre espace de travail.

Conseil

Si vous disposez déjà d’un espace de travail avec un rapport, vous pouvez passer cette étape.

Pour télécharger un exemple de rapport et le publier dans votre espace de travail, effectuez les étapes suivantes :

  1. Ouvrez le dossier GitHub des exemples Power BI Desktop.

  2. Sélectionnez Code, puis sélectionnez Download zip (Télécharger le fichier zip).

    A screenshot showing the ZIP download option in the Power B I desktop samples GitHub

  3. Extrayez le fichier ZIP téléchargé et accédez au dossier Samples Reports.

  4. Sélectionnez un rapport à incorporer, puis publiez-le dans votre espace de travail.

Étape 4 - Obtenir les valeurs des paramètres d’incorporation

Pour incorporer votre contenu, vous devez obtenir quelques valeurs de paramètre. Les valeurs de paramètre dépendent de la langue de l’exemple d’application que vous voulez utiliser. Le tableau ci-dessous liste les valeurs de paramètre obligatoires pour chaque exemple.

Paramètre .NET Core .NET Framework React TypeScript
ID client
Clé secrète client
ID de l’espace de travail
ID du rapport

ID client

Conseil

S’applique à : .NET Core .NET Framework React TypeScript

Pour obtenir le GUID de l’ID client (également appelé ID d’application), effectuez les étapes suivantes :

  1. Connectez-vous à Microsoft Azure.

  2. Recherchez Inscriptions d’applications, puis sélectionnez le lien Inscriptions d’applications.

  3. Sélectionnez l’application Microsoft Entra que vous utilisez pour incorporer votre contenu Power BI.

  4. Dans la section Vue d’ensemble, copiez le GUID ID d’application (client) .

Clé secrète client

Conseil

S’applique à : .NET Core .NET Framework React TypeScript

Pour obtenir le secret client, effectuez les étapes suivantes :

  1. Connectez-vous à Microsoft Azure.

  2. Recherchez Inscriptions d’applications, puis sélectionnez le lien Inscriptions d’applications.

  3. Sélectionnez l’application Microsoft Entra que vous utilisez pour incorporer votre contenu Power BI.

  4. Sous Gérer, sélectionnez Certificats et secrets.

  5. Sous Secrets client, sélectionnez Nouveau secret client.

  6. Dans la fenêtre contextuelle Ajouter un secret client, spécifiez une description du secret de votre application, sélectionnez la date d’expiration du secret de l’application, puis sélectionnez Ajouter.

  7. Dans la section Secrets client, copiez la chaîne qui se trouve dans la colonne Valeur du secret de l’application nouvellement créé. La valeur du secret client est votre ID de client.

Notes

Veillez à copier la valeur du secret client dès qu’elle s’affiche pour la première fois. Après avoir quitté cette page, le secret client est masqué et vous ne pouvez pas récupérer sa valeur.

ID de l’espace de travail

Conseil

S’applique à : .NET Core .NET Framework React TypeScript

Pour obtenir le GUID de l’ID d’espace de travail, effectuez les étapes suivantes :

  1. Connectez-vous au service Power BI.

  2. Ouvrez le rapport que vous voulez incorporer.

  3. Copiez le GUID à partir de l’URL. Le GUID est le nombre qui se trouve entre /groups/ et /reports/ .

    A screenshot showing workspace ID GUID in the Power B I service U R L

ID du rapport

Conseil

S’applique à : .NET Core .NET Framework React TypeScript

Pour obtenir le GUID de l’ID de rapport, effectuez les étapes suivantes :

  1. Connectez-vous au service Power BI.

  2. Ouvrez le rapport que vous voulez incorporer.

  3. Copiez le GUID à partir de l’URL. Le GUID est le nombre qui se trouve entre /reports/ et /ReportSection/ .

    A screenshot showing report ID GUID in the Power B I service U R L

Étape 5 : incorporer votre contenu

L’exemple d’application incorporée Power BI vous permet de créer une application Power BI Incorporer pour votre organisation.

Effectuez les étapes suivantes pour modifier l’exemple d’application Incorporer pour votre organisation de façon à incorporer votre rapport Power BI.

  1. Ouvrez le dossier Power BI-Developer-Samples.

  2. Sélectionnez Code, puis sélectionnez Download zip (Télécharger le fichier zip).

    A screenshot showing the ZIP download option in the Power B I developer samples GitHub

  3. Extrayez le fichier ZIP téléchargé et accédez au dossier PowerBI-Developer-Samples-master.

  1. Ouvrez l’un des dossiers suivants en fonction du langage que votre application doit utiliser :

    • .NET Core
    • .NET Framework
    • React-TS

    Notes

    Les exemples d’applications Incorporer pour votre organisation prennent uniquement en charge les frameworks indiqués ci-dessus. Les exemples d’applications Java, Node JS et Python prennent uniquement en charge la solution Incorporer pour vos clients .

Configurer votre application Microsoft Entra

  1. Connectez-vous au portail Azure.

  2. Sélectionnez Inscriptions d’applications. Si vous ne voyez pas cette option, recherchez-la.

  3. Ouvrez l’application Microsoft Entra que vous avez créée à l’étape 1 : Inscrire une application Microsoft Entra.

  4. Dans le menu Gérer, sélectionnez Authentification.

  1. Dans Configurations de plateforme, ouvrez votre plateforme Web et dans la section URI de redirection, ajoutez https://localhost:5000/signin-oidc.

    Notes

    Si vous n’avez pas de plateforme Web, sélectionnez Ajouter une plateforme, puis, dans la fenêtre Configurer les plateformes, Web.

  2. Enregistrez vos modifications.

Screenshot of the Azure portal window, which shows the app authentication configurations and the web redirect URI for the .NET core app sample.

Configurer l’exemple d’application d’incorporation

  1. Ouvrez le dossier Incorporer pour votre organisation.

  2. Ouvrez l’exemple d’application Incorporer pour votre organisation en utilisant une de ces méthodes :

  3. Ouvrez appsettings.json et renseignez les valeurs de paramètre suivantes :

Exécution de l'exemple d'application

  1. Exécutez le projet en sélectionnant l’option appropriée :

    • Si vous utilisez Visual Studio, sélectionnez IIS Express (lecture).

    • Si vous utilisez Visual Studio Code, sélectionnez Exécuter > Démarrer le débogage.

  1. Connectez-vous à l’exemple d’application d’incorporation.

    Remarque

    Lors de votre première connexion, vous êtes invité à donner des autorisations Microsoft Entra pour l’application.

  2. Lors du chargement de l’exemple d’application d’incorporation, sélectionnez le contenu Power BI à incorporer, puis sélectionnez Incorporer.

    Screenshot showing the Power BI embedding sample app.

Développer votre application

Après avoir configuré et exécuté l’exemple d’application Incorporer pour vos clients, vous pouvez commencer à développer votre propre application.

Mettre à jour les autorisations utilisateur

Les utilisateurs doivent être autorisés à accéder au dossier Power BI dans lequel se trouve le rapport. Lorsque vous accordez à un utilisateur l’autorisation d’accéder à un dossier, la modification prend généralement effet uniquement une fois que l’utilisateur s’est connecté au portail Power BI. Pour que les nouvelles autorisations prennent effet immédiatement, dans le scénario Incorporé, effectuez un appel explicite à l’API REST RefreshUser Permissions au démarrage. Cet appel d’API actualise les autorisations et évite les échecs d’autorisation pour les utilisateurs disposant d’autorisations nouvellement accordées.