Tutoriel : Incorporer du contenu Power BI en utilisant un exemple d’application Incorporer pour vos clients

S’APPLIQUE À : L’application est propriétaire des données L’utilisateur est propriétaire des données

L’Analytique incorporée et Power BI Embedded (l’offre Azure) vous permettent 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 vos clients (également appelée L’application possède les données).

Pour utiliser votre application, vos utilisateurs n’ont pas besoin de se connecter à Power BI ou de disposer d’une licence Power BI.

Nous vous recommandons d’utiliser la méthode Incorporer pour vos clients pour incorporer votre contenu Power BI si vous êtes éditeur de logiciels indépendant (ISV) ou développeur, et que vous voulez créer des applications pour des tiers.

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 vos clients dans un des frameworks suivants :

  • .NET Framework
  • .NET Core
  • Java
  • Node JS
  • Python

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 ci-dessous :

  • Dépendances de Power BI

  • Dépendances du code

Méthode

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

  1. Sélectionnez votre méthode d’authentification.

  2. Inscrivez une application Microsoft Entra.

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

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

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

  6. Accès à l’API du principal de service

  7. Activez l’accès à l’espace de travail.

  8. Incorporez votre contenu.

Étape 1 - Sélectionner votre méthode d’authentification

Votre solution incorporée va varier en fonction de la méthode d’authentification que vous sélectionnez. Par conséquent, il est important de comprendre les différences entre les méthodes d’authentification et de déterminer celle qui convient le mieux à votre solution.

Le tableau ci-dessous décrit quelques-unes des principales différences entre les méthodes d’authentification principal de service et utilisateur maître.

Considération Principal du service Utilisateur maître
Mechanism L’objet principal de service de votre application Microsoft Entra permet à Microsoft Entra ID d’authentifier votre application solution incorporée sur Power BI. Votre application Microsoft Entra utilise les informations d’identification (nom d’utilisateur et mot de passe) d’un utilisateur Power BI pour s’authentifier auprès de Power BI.
Sécurité Le principal de service est la méthode d’autorisation recommandée par Microsoft Entra ID. Si vous utilisez un principal de service, vous pouvez vous authentifier à l’aide d’un secret d’application ou d’un certificat.

Ce tutoriel décrit uniquement l’utilisation d’un principal de service avec un secret d’application. Pour incorporer en utilisant un principal de service et un certificat, reportez-vous à l’article principal de service avec un certificat.
Cette méthode d’authentification n’est pas aussi sécurisée qu’un principal de service. Vous devez être vigilant avec les informations d’identification (nom d’utilisateur et mot de passe) de l’utilisateur maître. Par exemple, ne les exposez pas dans votre application d’incorporation et changez le mot de passe fréquemment.
Autorisations déléguées de Microsoft Entra ID Non obligatoire. Votre utilisateur maître ou un administrateur doit donner son consentement à votre application pour qu’elle puisse accéder aux autorisations de l’API REST Power BI (également appelées « étendues »). Par exemple, Report.ReadWrite.All.
Accès au service Power BI Vous ne pouvez pas accéder au service Power BI avec un principal de service. Vous pouvez accéder au service Power BI avec les informations d’identification de votre utilisateur maître.
Licence Ne nécessite pas de licence Pro. Vous pouvez utiliser le contenu de n’importe quel espace de travail dont vous êtes membre ou administrateur. Nécessite Vous avez une licence Power BI Pro ou Premium par utilisateur.

Étape 2 : Inscrire une application Microsoft Entra

L’inscription de votre application avec Microsoft Entra ID vous permet de :

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

Remarque

Avant d’inscrire votre application, vous devez décider de la méthode d’authentification à utiliser, principal de service ou utilisateur maître.

Étape 3 - 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 4 - 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 5 - Obtenir les valeurs des paramètres d’incorporation

Pour incorporer votre contenu, vous devez obtenir certaines valeurs de paramètre. Le tableau ci-dessous montre les valeurs nécessaires et indique si elles s’appliquent à la méthode d’authentification principal de service, à la méthode d’authentification, utilisateur maître ou aux deux.

Avant d’incorporer votre contenu, vérifiez que vous disposez de toutes les valeurs listées ci-dessous. Certaines des valeurs diffèrent selon la méthode d’authentification que vous utilisez.

Paramètre Principal du service Utilisateur maître
ID client Applies to. Applies to.
ID de l’espace de travail Applies to. Applies to.
ID du rapport Applies to. Applies to.
Clè secrète client Applies to. Does not apply to.
Tenant ID Applies to. obligatoire uniquement pour Node JS
Nom d’utilisateur Power BI Does not apply to. Applies to.
Mot de passe Power BI Does not apply to. Applies to.

ID client

Conseil

S’applique à :Applies to.Principal de service Applies to.Utilisateur maître

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) .

ID de l’espace de travail

Conseil

S’applique à :Applies to.Principal de service Applies to.Utilisateur maître

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

Vous pouvez également trouver l’ID de l’espace de travail dans les paramètres Portail d’administration en sélectionnant Détails en regard du nom de l’espace de travail.

A screenshot showing how to find the workspace I D from the admin settings.

ID du rapport

Conseil

S’applique à :Applies to.Principal de service Applies to.Utilisateur maître

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

Clé secrète client

Conseil

S’applique à :Applies to.Principal de service Does not apply to.Utilisateur maître

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 client

Conseil

S’applique à :Applies to.Principal de service Does not apply to.Utilisateur maître

Pour obtenir le GUID de l’ID de locataire, 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 de l’ID de l’annuaire (locataire) .

Nom d’utilisateur et mot de passe Power BI

Conseil

S’applique à :Does not apply to.Principal de service Applies to.Utilisateur maître

Obtenez le nom d’utilisateur et le mot de passe de l’utilisateur Power BI que vous utilisez comme utilisateur maître. C’est le même utilisateur que celui que vous avez utilisé dans le service Power BI pour créer un espace de travail et y charger un rapport.

Étape 6 - Accès à l’API du principal de service

Conseil

S’applique à :Applies to.Principal de service Does not apply to.Utilisateur maître

Cette étape est nécessaire seulement si vous utilisez la méthode d’authentification principal de service. Si vous utilisez un utilisateur maître, ignorez cette étape et passez à Étape 7 - Activer l’accès à l’espace de travail.

Pour qu’une application Microsoft Entra soit en mesure d’accéder au contenu et aux API de Power BI, un administrateur Power BI doit activer l’accès au principal de service dans le portail d’administrateur Power BI. Si vous n’êtes pas administrateur de votre locataire, demandez à l’administrateur du locataire d’activer les Paramètres du client pour vous.

  1. Dans Service Power BI, sélectionnez Paramètres>Paramètres>Portail d’administration.

    A screenshot showing the admin settings menu option in the Power B I service settings menu.

  2. Sélectionnez Paramètres du client, puis faites défiler vers le bas jusqu’à la section Paramètres de développeur.

  3. Développez Autoriser les principaux de service à utiliser les API Power BI et activez cette option.

    A screenshot showing how to enable the developer settings option, in the tenant settings menu option, in Power B I service.

Remarque

Lors de l’utilisation d’un principal de service, il est recommandé de limiter son accès aux paramètres du locataire en utilisant un groupe de sécurité. Pour plus d’informations sur cette fonctionnalité, consultez les sections suivantes dans l’article Principal de service :

Étape 7 - Activer l’accès à l’espace de travail

Pour activer vos objets d’accès à l’application Microsoft Entra, comme les rapports, tableaux de bord et modèles sémantiques du service Power BI, ajoutez le principal de service ou l’utilisateur maître en tant que membre ou administrateur à votre espace de travail.

  1. Connectez-vous au service Power BI.

  2. Accédez à l’espace de travail pour lequel vous souhaitez activer l’accès, puis dans le menu Plus, sélectionnez Accès à l’espace de travail.

    Screenshot showing the workspace access button in the more menu of a Power B I workspace.

  3. Dans le volet Accès, en fonction de la méthode d’authentification que vous utilisez, copiez le principal de service ou l’utilisateur maître dans la zone de texte Saisissez une adresse e-mail.

    Remarque

    Si vous utilisez un principal de service, son nom correspond au nom que vous avez donné à votre application Microsoft Entra.

  4. Sélectionnez Ajouter.

Étape 8 - Incorporer votre contenu

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

Effectuez les étapes suivantes pour modifier l’exemple d’application Incorporer pour vos clients 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. Selon le langage que votre application doit utiliser, ouvrez un de ces dossiers :

    • .NET Core
    • .NET Framework
    • Java
    • Node JS
    • Python

    Notes

    Les exemples d’applications Incorporer pour vos clients prennent uniquement en charge les frameworks listés ci-dessus. L’exemple d’application React prend uniquement en charge la solution Incorporer pour votre organisation .

  2. Ouvrez le dossier Embed for your customers.

  1. Ouvrez l’exemple d’application Incorporer pour vos clients en utilisant une de ces méthodes :

  2. Ouvrez appsettings.json.

  3. En fonction de votre méthode d’authentification, entrez les valeurs de paramètre suivantes :

    Paramètre Principal du service Utilisateur maître
    AuthenticationMode ServicePrincipal MasterUser
    ClientId L’ID client de votre application Microsoft Entra L’ID client de votre application Microsoft Entra
    TenantId Votre ID de locataire Microsoft Entra N/A
    PbiUsername N/A Nom d’utilisateur de votre utilisateur maître ; consultez nom d’utilisateur et mot de passe Power BI
    PbiPassword N/A Mot de passe de votre utilisateur maître ; consultez nom d’utilisateur et mot de passe Power BI
    ClientSecret Votre clé secrète client Microsoft Entra ID S/O
    WorkspaceId ID de l’espace de travail avec votre rapport incorporé ; consultez ID d’espace de travail ID de l’espace de travail avec votre rapport incorporé ; consultez ID d’espace de travail
    ReportId ID du rapport que vous incorporez ; consultez ID de rapport ID du rapport que vous incorporez ; consultez ID de rapport
  4. 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.

Développement de 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.

Essayez le terrain de jeu d’analyse incorporée Power BI pour commencer à développer et suivre toutes les nouvelles fonctionnalités et mises à jour Power BI Embedded.

Quand vous êtes prêt, examinez les exigences pour passer en production. Vous aurez également besoin d’une capacité ; lisez l’article sur la planification de la capacité pour déterminer la référence SKU la mieux adaptée à vos besoins.

Important

Si vous avez utilisé des jetons intégrés d’essai gratuits pour le développement, vous devez acheter une capacité de production. Tant qu’une capacité n’est pas achetée, la bannière Version d’évaluation gratuite continuera d’apparaître en haut du rapport intégré.

D’autres questions ? Poser des questions à la communauté Power BI.