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

  • Article

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, les premières étapes de ce tutoriel sont différentes. Pour obtenir des informations plus détaillées, consultez Incorporer du contenu pour des clouds nationaux.

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 Azure AD.

  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 de principal de service de votre application Azure AD permet à Azure AD d’authentifier votre application de solution incorporée auprès de Power BI. Votre application Azure AD 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é Principal de service est la méthode d’autorisation recommandée d’Azure AD. 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 d’Azure AD 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 Azure AD

L’inscription de votre application auprès d’Azure AD vous permet les actions suivantes :

Pour inscrire votre application auprès d’Azure AD, suivez les instructions données dans Inscrire votre application.

Notes

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

    Capture d’écran montrant l’option de téléchargement du fichier ZIP dans les exemples Power BI Desktop de 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 S’applique à. S’applique à.
ID de l’espace de travail S’applique à. S’applique à.
ID du rapport S’applique à. S’applique à.
Clé secrète client S’applique à. Non applicable.
Tenant ID S’applique à. obligatoire uniquement pour Node JS
Nom d’utilisateur Power BI Non applicable. S’applique à.
Mot de passe Power BI Non applicable. S’applique à.

ID client

Conseil

S’applique à :S’applique à.Principal de service S’applique à.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 Azure AD 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 à :S’applique à.Principal de service S’applique à.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/ .

    Capture d’écran montrant le GUID de l’ID d’espace de travail dans l’URL du service Power BI

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.

Capture d’écran montrant comment rechercher l’ID de l’espace de travail dans les paramètres d’administration.

ID du rapport

Conseil

S’applique à :S’applique à.Principal de service S’applique à.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/ .

    Capture d’écran montrant le GUID de l’ID de rapport dans l’URL du service Power BI

Clé secrète client

Conseil

S’applique à :S’applique à.Principal de service Ne s’applique pas à.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 Azure AD 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 à :S’applique à.Principal de service Ne s’applique pas à.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 Azure AD 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 à :Ne s’applique pas à.Principal de service S’applique à.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 à :S’applique à.Principal de service Ne s’applique pas à.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 Azure AD 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.

    Capture d’écran montrant l’option de menu Paramètres d’administration dans le menu des paramètres du service Power BI.

  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.

    Capture d’écran montrant comment activer l’option des paramètres de développeur, dans l’option de menu Paramètres du locataire, dans le service Power BI.

Notes

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 Azure AD, comme les rapports, tableaux de bord et jeux de données 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.

    Capture d’écran montrant le bouton d’accès à l’espace de travail dans le menu Plus d’un espace de travail Power BI.

  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.

    Notes

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

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

    Capture d’écran montrant l’option de téléchargement du fichier ZIP dans les exemples Power BI pour les développeurs de 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 ID de client de votre application Azure AD ID de client de votre application Azure AD
    TenantId Votre ID de locataire Azure AD 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 secret client Azure AD N/A
    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é.

Étapes suivantes

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