Configurer Power BI Embedded

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

Si vous souhaitez commencer à utiliser Power BI Embedded pour partager vos rapports avec d’autres utilisateurs, utilisez l’outil de configuration de l’analytique incorporée Power BI pour bien démarrer. Cet article vous montre comment procéder.

Pour utiliser l’analytique incorporée Power BI, vous devez inscrire une application Microsoft Entra dans Azure. L’application Microsoft Entra établit des autorisations pour les ressources REST Power BI et autorise l’accès aux API REST Power BI.

Prérequis

Pour configurer un environnement d’analytique incorporée Power BI, vous avez besoin de l’un des éléments suivants :

Avant de commencer

Avant de pouvoir inscrire votre application, choisissez la solution qui correspond le mieux à vos besoins parmi les options ci-dessous :

Incorporer pour vos clients

Utilisez la solution Incorporer pour vos clients, également appelée L’application est propriétaire des données, si vous créez une application conçue pour vos clients. Les utilisateurs n’ont pas besoin de se connecter à Power BI ni de disposer d’une licence Power BI pour utiliser votre application. Votre application s’authentifie auprès de Power BI à l’aide d’un compte utilisateur maître (licence Power BI Pro utilisée pour la connexion à Power BI) ou d’un principal de service.

La solution Incorporer pour vos clients est généralement utilisée par les éditeurs de logiciels indépendants (ISV) et les développeurs qui créent des applications pour un tiers.

Incorporer pour votre organisation

Utilisez la solution Incorporer pour votre organisation, également appelée L’utilisateur propriétaire des données, si vous créez une application qui impose aux utilisateurs d’utiliser leurs informations d’identification pour s’authentifier auprès de 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.

Pour plus d’informations sur les deux solutions, consultez Quelles sont les solutions d’analytique incorporée Power BI ?.

Configurer votre environnement

Une fois que vous avez compris les deux options d’incorporation, vous pouvez utiliser l’outil de configuration pour créer votre environnement Power BI Embedded.

Si vous préférez configurer l’environnement manuellement, ignorez les étapes des sections suivantes. Procédez plutôt comme décrit dans la section Inscription manuelle de cet article.

Important

Si vous effectuez une incorporation pour un Cloud de la communauté du secteur public, suivez les instructions de la section Inscription manuelle.

Pour utiliser l’outil afin de configurer votre environnement, accédez à l’outil de configuration de l’analytique incorporée Power BI. Sélectionnez l’option d’incorporation de votre choix.

Screenshot of the Power BI embedded analytics setup tool. The options for embedding for your customers or for your organization are highlighted.

Étape 1 : se connecter à Power BI

  1. Sous Étape 1 de l’outil d’installation, sélectionnez Se connecter. Cette étape vous connecte à Power BI. Si vous êtes invité à choisir un compte, connectez-vous avec un utilisateur qui fait partie de votre locataire Power BI. L’application Microsoft Entra est inscrite sous cet utilisateur.

    Screenshot of the Power BI embedded analytics setup tool. Under Step 1, the Sign in button is highlighted.

    Remarque

    Si vous êtes déjà connecté, vérifiez que vous êtes connecté sous le nom d’utilisateur avec lequel vous souhaitez créer l’application Microsoft Entra. Pour modifier les utilisateurs, sélectionnez Se déconnecter. Une fois que l’outil a redémarré, connectez-vous avec l’utilisateur approprié.

  2. Sélectionnez Suivant pour passer à l’étape suivante.

    Screenshot of the Power BI embedded analytics setup tool after a user has signed in to Power BI. The Next button in highlighted.

Étape 2 : inscrire votre application

Dans cette étape, vous inscrivez une application Microsoft Entra dans Azure. L’application Microsoft Entra établit des autorisations pour les ressources REST Power BI et autorise l’accès aux API REST Power BI. Vous pouvez toujours modifier ces paramètres ultérieurement.

  1. Pour inscrire votre application pour vos clients, renseignez les champs suivants :

    Screenshot of the Power BI embedded analytics setup tool. The step for registering an app is visible, with an app name box and API access options.

  2. Sélectionnez Inscrire.

  3. L’ID d’application de votre application Microsoft Entra s’affiche dans la zone Résumé. Copiez cette valeur en vue d’une utilisation ultérieure.

    Screenshot of the Power BI embedded analytics setup tool, with a Summary box on the right. Information in the box includes an application ID.

Étape 3 : créer un espace de travail (facultatif)

Créez un espace de travail dans le service Power BI :

  • Si vous disposez déjà d’un espace de travail Power BI, sélectionnez Ignorer.

  • Pour créer un espace de travail, entrez un nom pour votre espace de travail, puis sélectionnez Créer un espace de travail. Le nom et l’ID de votre espace de travail s’affichent dans la zone Résumé. Copiez ces valeurs pour les utiliser ultérieurement.

    Conseil

    Pour que l’exemple d’application d’analytique incorporée fonctionne comme prévu, vous devez utiliser l’outil afin de créer un espace de travail.

Étape 4 : importer du contenu (facultatif)

Sélectionnez l’une des options suivantes :

  • Si vous disposez de votre propre application Power BI, vous pouvez sélectionner Ignorer.

  • Si vous souhaitez créer un exemple d’application Power BI à l’aide d’un exemple de rapport, sélectionnez Exemple de rapport Power BI, puis sélectionnez Importer.

  • Si vous souhaitez créer un exemple d’application Power BI à l’aide de votre propre rapport, sélectionnez Charger un fichier .pbix, recherchez votre fichier, puis sélectionnez Importer.

Étape 5 : accorder des autorisations (Incorporer pour vos clients uniquement)

Sélectionnez Accorder des autorisations. Dans la boîte de dialogue, sélectionnez Accepter. Cette étape permet à votre application Microsoft Entra d’accéder aux API que vous avez sélectionnées (également appelées « étendues ») avec l’utilisateur connecté. Cet utilisateur est aussi appelé utilisateur maître.

Télécharger l’exemple d’application (facultatif)

Si vous avez créé un espace de travail Power BI et que vous y avez chargé du contenu à l’aide de cet outil, vous pouvez maintenant sélectionner Télécharger l’exemple d’application.

Notes

Si vous avez ignoré les étapes facultatives, vous pouvez toujours télécharger un exemple d’application Power BI. Cependant, les propriétés renseignées pendant l’inscription manquent dans le code de l’application téléchargée. Par exemple, si vous n’avez pas créé d’espace de travail, l’exemple d’application ne comporte pas l’ID d’espace de travail.

Veillez à copier toutes les informations contenues dans la zone Résumé. Votre environnement d’incorporation Power BI est prêt à l’emploi.

Inscription manuelle

Si vous n’avez pas utilisé l’outil de configuration de l’analytique incorporée Power BI, procédez comme suit pour inscrire manuellement une application Microsoft Entra. Toutefois, effectuez ces étapes uniquement si vous créez l’une des solutions suivantes :

  • Une application Incorporer pour votre organisation
  • Une application Incorporer pour vos clients avec un principal de service

Pour plus d’informations sur l’inscription des applications dans Microsoft Entra ID, consultez Inscrire une application auprès de la plateforme d’identités Microsoft.

  1. Connectez-vous au portail Azure.

  2. Sélectionnez votre locataire Microsoft Entra en sélectionnant votre compte dans l’angle supérieur droit de la page.

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

  4. Dans Inscriptions d’applications, sélectionnez Nouvelle inscription.

  5. Remplissez les champs suivants :

    • Nom – Donnez un nom à votre application.

    • Type de compte pris en charge – Sélectionnez qui peut utiliser l’application.

  6. (Facultatif) Dans la zone URI de redirection, ajoutez une URL de redirection.

  7. Sélectionnez Inscription. Une fois votre application inscrite, vous êtes dirigé vers la page Vue d’ensemble de votre application, où vous pouvez obtenir l’ID d’application.

D’autres questions ? Essayez d’interroger la communauté Power BI