Incorporer vos tableaux de bord, rapports et vignettes Power BIEmbed your Power BI dashboards, reports and tiles

Découvrez les étapes à suivre pour incorporer du contenu Power BI dans votre application.Learn about the steps you need to take to embed Power BI content within your application.

Microsoft a annoncé Power BI Premium, un nouveau modèle de gestion des licences basé sur la capacité, qui augmente la flexibilité en ce qui concerne la manière dont les utilisateurs consultent, partagent et distribuent du contenu.Microsoft announced Power BI Premium, a new capacity-based licensing model that increases flexibility for how users access, share and distribute content. L’offre renforce également l’extensibilité et les performances du service Power BI.The offering also delivers additional scalability and performance to the Power BI service. Il a également été annoncé que Power BI Embedded permet de créer une capacité dans Microsoft Azure.Power BI Embedded was also announced that allows for creating capacity within Microsoft Azure. Power BI Embedded se concentre sur votre application et vos clients.Power BI Embedded is focused on your application and your customers.

Cet article traite de l’incorporation de contenu Power BI pour votre organisation et vos clients.This article looks at embedding your Power BI content for both your organization and your customers. Les étapes à suivre sont semblables pour les deux scénarios.The steps are similar between the two scenarios. Les étapes spécifiques à l’incorporation pour vos clients sont signalées.Callouts are made when a step is specific to embedding for your customer.

Pour que cela soit possible, vous devez suivre quelques étapes avec votre application.There are a few steps you have to do with your application to make this possible. Nous passons en revue les étapes nécessaires pour créer et utiliser du contenu incorporé dans votre application.We go through the steps needed to allow you to create and use embedded content within your application.

Note

Les API Power BI font encore référence aux espaces de travail d’application en tant que groupes.The Power BI APIs still refer to app workspaces as groups. Toutes les références à des groupes indiquent que vous travaillez avec des espaces de travail d’applications.Any references to groups mean that you are working with app workspaces.

Étape 1 : configurer votre environnement de développement d’analytique incorporéeStep 1: Setup your embedded analytics development environment

Avant de commencer à incorporer des tableaux de bord et des rapports dans votre application, vous devez vérifier que votre environnement est configuré pour autoriser l’incorporation.Before you start embedding dashboards and reports into your application, you need to make sure your environment is set up to allow for embedding. Dans le cadre de la configuration, vous devez effectuer les opérations suivantes.As part of the setup, you need to do the following.

Vous pouvez passer par l’outil d’expérience d’intégration pour démarrer et télécharger rapidement un exemple d’application.You can go through the Onboarding experience tool to quickly get started and download a sample application.

Choisissez la solution qui vous convient :Choose the solution that is right for you:

Cependant, si vous choisissez de configurer l’environnement manuellement, vous pouvez continuer et suivre les instructions ci-dessous.However, if you choose to set up the environment manually, you can continue below.

Note

La capacité dédiée n’est pas nécessaire pour le développement de votre application.Dedicated capacity is not required for the development of your application. Les développeurs de l’application doivent disposer d’une licence Power BI Pro.The developers of the application need to have a Power BI Pro license.

Locataire Azure Active DirectoryAzure Active Directory tenant

Pour incorporer des éléments à partir de Power BI, vous devez avoir un locataire Azure Active Directory (Azure AD).You need an Azure Active Directory (Azure AD) tenant to embed items from Power BI. Au moins un utilisateur Power BI Pro doit être attribué à ce locataire.This tenant must have at least one Power BI Pro user. Vous devez également définir une application Azure AD au sein du locataire.You also need to define an Azure AD app within the tenant. Vous pouvez recourir à un locataire Azure AD existant ou créer un locataire dédié à l’incorporation.You can make use of an existing Azure AD tenant or create a new one specifically for embedding purposes.

Vous devez déterminer quel locataire utiliser si vous incorporez du contenu pour vos clients.You need to determine what tenant setup to use if you are embedding for your customers.

  • Utiliser le locataire Power BI existant de votre entreprise ?Use your existing corporate Power BI tenant?
  • Utiliser un locataire distinct pour votre application ?Use a separate tenant for your application?
  • Utiliser un locataire distinct pour chaque client ?Use a separate tenant for each customer?

Si vous ne voulez pas utiliser un locataire existant et décidez de créer un locataire pour votre application, ou pour chaque client, voir Créer un locataire Azure Active Directory ou Obtenir un locataire Azure Active Directory.If you do not want to use an existing tenant, you can decide to create a new tenant for your application, or one for each customer, see Create an Azure Active Directory tenant or How to get an Azure Active Directory tenant.

Créer un compte d’utilisateur Power BI ProCreate a Power BI Pro user account

Un seul compte Power BI Pro suffit pour incorporer du contenu.You only need a single Power BI Pro account to embed content. Toutefois, vous pouvez créer plusieurs utilisateurs pour les accès spécifiques aux éléments.However, you may want to have a few different users that have specific access to items. Vous pouvez par exemple attribuer les utilisateurs suivants à votre locataire.Here is a look at possible users to consider within your tenant.

Les comptes suivants doivent être disponibles dans votre locataire et une licence Power BI Pro doit leur être attribuée.The following accounts need to exist within your tenant and have a Power BI Pro license assigned to them. Une licence Power BI Pro est requise pour utiliser des espaces de travail application au sein de Power BI.A Power BI Pro license is required to work with app workspaces within Power BI.

Un utilisateur administrateur d’organisation ou de clientAn organization/tenant admin user

Si possible, le compte de votre application ne doit pas être l’utilisateur Administrateur général de votre organisation/locataire si vous incorporez du contenu pour vos clients.It is recommended that your organization/tenant Global Admin user should not be used as account your application uses if embedding for your customers. L’accès dont dispose le compte de l’application au sein de votre locataire est ainsi minimisé.This is to minimize access that the application account has within your tenant. L’utilisateur administrateur doit être administrateur de tous les espaces de travail d’applications créés pour l’incorporation.The admin user is required to be an admin of all the app workspaces created for embedding.

Des comptes pour les analystes qui créent du contenuAccounts for analysts that create content

Il se peut que vous ayez plusieurs utilisateurs qui créent du contenu pour Power BI.You may have multiple users that create content for Power BI. Un compte Power BI Pro est requis pour chaque analyste qui crée et déploie du contenu dans Power BI.You need a Power BI Pro account for each analyst that is creating and deploying content to Power BI.

Un compte utilisateur principal d’application si vous incorporez pour vos clientsAn application master user account for embedding for your customers

Il s’agit du compte à utiliser par votre application lors de l’incorporation de contenu pour vos clients.The master account is the account your application uses when embedding content for your customers. Le scénario est généralement adapté aux applications d’éditeurs de logiciels indépendants.The scenario is typically for ISV applications. Le compte principal est le seul compte requis dont vous avez besoin au sein de votre organisation.The master account is the only required account you need within your organization. Il peut également être utilisé en tant que compte d’administrateur et d’analyste, mais cela n’est pas recommandé.It can also be used as the admin and analyst account, but it is not recommended. Le serveur principal de votre application stocke les informations d’identification de ce compte et les utilise pour acquérir le jeton d’authentification Azure AD à utiliser avec les API de Power BI.Your application's backend stores the credentials for this account and use it for acquiring an Azure AD auth token for use with the Power BI APIs. Ce compte génère un jeton d’incorporation pour l’application à utiliser pour vos clients.This account generates an embed token for the application to use for your customers.

Le compte principal est simplement un utilisateur standard avec une licence Power BI Pro que vous utilisez avec votre application.The master account is just a regular user with a Power BI Pro license that you use with your application. Le compte doit également être administrateur de l’espace de travail d’applications créé pour l’incorporation.The account must be an admin of the app workspace that is being used for embedding.

Inscription de l’application et octroi d’autorisationsApp registration and permissions

Vous devez inscrire votre application avec Azure AD pour effectuer des appels d’API REST.You need to register your application with Azure AD to make REST API calls. Pour plus d’informations, consultez Inscrire une application Azure AD pour incorporer du contenu Power BI.For more information, see Register an Azure AD app to embed Power BI content.

Créer des espaces de travail d’applicationsCreate app workspaces

Si vous incorporez des tableaux de bord et des rapports pour vos clients, ceux-ci doivent être placés dans un espace de travail d’application.If you are embedding dashboards and reports for your customers, those dashboards and reports have to be placed in an app workspace. Le compte principal mentionné précédemment doit être administrateur de l’espace de travail d’application.The master account, which was mentioned above, must be an admin of the app workspace.

  1. Commencez par créer l’espace de travail.Start by creating the workspace. Sélectionnez Espaces de travail > Créer un espace de travail d’application.Select Workspaces > Create app workspace.

    Créer un espace de travail d’application

    Il s’agit de l’emplacement où placer le contenu sur lequel vos collègues et vous collaborez.This will be the place to put content that you and your colleagues collaborate on.

  2. Nommez l’espace de travail.Give the workspace a name. Si l’ID d’espace de travail correspondant n’est pas disponible, modifiez-le de façon à obtenir un ID unique.If the corresponding Workspace ID isn't available, edit it to come up with a unique ID.

    Ce sera aussi le nom de l’application.This will be the name of the app, too.

    Nommer l’espace de travail

  3. Vous devez définir quelques options.You have a few options to set. Si vous choisissez Public, toute personne au sein de votre organisation peut voir le contenu de l’espace de travail.If you choose Public, anyone in your organization can see what’s in the workspace. En revanche, Privé signifie que seuls les membres de l’espace de travail peuvent en voir le contenu.Private, on the other hand, means only members of the workspace can see its contents.

    Définir comme public ou privé

    Vous ne pouvez pas modifier le paramètre Public/Privé après avoir créé le groupe.You can't change the Public/Private setting after you've created the group.

  4. Vous pouvez également spécifier si les membres peuvent apporter des modifications ou consulter en lecture seule.You can also choose if members can edit or have view-only access.

    Définir la modification ou l’affichage uniquement

    Ajoutez des utilisateurs à l’espace de travail d’application uniquement pour qu’ils puissent modifier le contenu.Only add people to the app workspace so they can edit the content. S’il consulte uniquement le contenu, ne l’ajoutez pas à l’espace de travail.If they're only going to view the content, don't add them to the workspace. Vous pouvez l’inclure lorsque vous publiez l’application.You can include them when you publish the app.

  5. Ajouter les adresses e-mail des personnes qui doivent avoir accès à l’espace de travail, puis sélectionnez Ajouter.Add email addresses of people you want to have access to the workspace, and select Add. Vous ne pouvez ajouter d’alias de groupe, uniquement des individus.You can’t add group aliases, just individuals.

  6. Décidez pour chaque personne si celle-ci est membre ou administrateur.Decide whether each person is a member or an admin.

    Définir le statut de membre ou d’administrateur

    Les administrateurs peuvent modifier l’espace de travail, y compris y ajouter des membres.Admins can edit the workspace itself, including adding other members. Les membres peuvent modifier le contenu de l’espace de travail, sauf s’ils disposent d’un accès en affichage seul.Members can edit the content in the workspace, unless they have view-only access. Les administrateurs et les membres peuvent publier l’application.Both admins and members can publish the app.

  7. Sélectionnez Enregistrer.Select Save.

Power BI crée l’espace de travail et l’ouvre.Power BI creates the workspace and opens it. Celui-ci figure dans la liste des espaces de travail dont vous êtes membre.It appears in the list of workspaces you’re a member of. Étant donné que vous êtes administrateur, vous pouvez sélectionner les points de suspension (…) pour revenir en arrière afin d’apporter des modifications, d’ajouter des membres ou de modifier leurs autorisations.Because you’re an admin, you can select the ellipsis (…) to go back and make changes to it, adding new members or changing their permissions.

Modifier l'espace de travail

Note

Un utilisateur non-administrateur peut créer jusqu’à 250 espaces de travail d’application.A non-admin user can only create up to 250 app workspaces. Pour créer plus d’espaces de travail d’application, vous devez utiliser un compte d’administrateur de locataire.To create more app workspaces, you need to use a tenant admin account.

Créer et charger vos rapportsCreate and upload your reports

Vous pouvez créer vos rapports et jeux de données à l’aide de Power BI Desktop, puis publier ces rapports dans un espace de travail d’applications.You can create your reports and datasets using Power BI Desktop and then publish those reports to an app workspace. Pour publier les rapports dans un espace de travail d’application, l’utilisateur final doit disposer d’une licence Power BI Pro.The end user publishing the reports need to have a Power BI Pro license to publish to an app workspace.

Étape 2 : incorporer votre contenuStep 2: Embed your content

Dans votre application, vous devez vous authentifier auprès de Power BI.Within your application, you need to authenticate with Power BI. Si vous incorporez du contenu pour vos clients, vous devez stocker les informations d’identification du compte principal dans votre application.If you are embedding content for your customers, you store the credentials for the master account within your application.

Note

Pour plus d’informations sur l’authentification des utilisateurs pendant que vous procédez à une incorporation pour vos clients, consultez Authentifier les utilisateurs et obtenir un jeton accès Azure AD pour votre application Power BI.For more information about authenticating users while embedding for your customers, see Authenticate users and get an Azure AD access token for your Power BI app.

Une fois que vous êtes authentifié, dans votre application, utilisez les API REST Power BI et JavaScript pour incorporer des tableaux de bord et des rapports dans votre application.Once authenticated, within your application, use the Power BI REST APIs and JavaScript APIs to embed dashboards and reports into your application.

Pour l’incorporation de contenu s’adressant à votre organisation, consultez les procédures suivantes :For embedding for your organization, see the following walkthroughs:

Pour l’incorporation avec vos clients, qui est généralement utilisée par les éditeurs de logiciels indépendants, consultez :For embedding with your customers, which is typical for ISVs, see the following:

Si l’incorporation s’adresse à vos clients, un jeton d’incorporation est requis.When embedding for your customers, an embed token is required. Pour en savoir plus, consultez Jeton d’incorporation.To learn more see, Embed Token.

Étape 3 : promouvoir votre solution en mode de productionStep 3: Promote your solution to production

Le passage en production nécessite quelques étapes supplémentaires.Moving to production requires a few extra steps.

Incorporation pour votre organisationEmbedding for your organization

Si votre incorporation s’adresse à votre organisation, vous devez simplement leur indiquer comment accéder à votre application.If you are embedding for your organization, you only need to let people know how to get to your application.

Tous les utilisateurs, quelle que soit la licence qui leur est attribuée, peuvent consommer du contenu incorporé à partir d’un espace de travail d’application (groupe), si la capacité dédiée supporte cet espace de travail.All users, regardless of the license they're assigned, can consume content that is embedded from an app workspace (group), if dedicated capacity backs that workspace. Ceci dit, vous devez ajouter explicitement à l’espace de travail d’application les utilisateurs qui n’ont pas de licence Power BI Pro ; à défaut, vous obtenez une erreur « 401 Non autorisée ».That said, you must explicitly add to the app workspace any users who don't have a Power BI Pro license; otherwise, you receive a 401 unauthorized error. Le tableau suivant répertorie les références Power BI Premium disponibles dans Office 365.The following table lists the available Power BI Premium SKUs available within Office 365.

Nœud de capacitéCapacity Node Nombre total de cœursTotal cores
(Serveur principal + serveur frontal)(Backend + frontend)
Cœurs du serveur principalBackend Cores Cœurs du serveur frontalFrontend Cores Limites de connexions actives/DirectQueryDirectQuery/live connection limits Rendus de pages au maximum aux heures de pointeMax page renders at peak hour
EM3EM3 4 cœurs virtuels4 v-cores 2 cœurs, 10 Go de RAM2 cores, 10GB RAM 2 cœurs2 cores 601-1 200601-1,200
P1P1 8 cœurs virtuels8 v-cores 4 cœurs, 25 Go de RAM4 cores, 25GB RAM 4 cœurs4 cores 30 par seconde30 per second 1 201-2 4001,201-2,400
P2P2 16 cœurs virtuels16 v-cores 8 cœurs, 50 Go de RAM8 cores, 50GB RAM 8 cœurs8 cores 60 par seconde60 per second 2 401-4 8002,401-4,800
P3P3 32 cœurs virtuels32 v-cores 16 cœurs, 100 Go de RAM16 cores, 100GB RAM 16 cœurs16 cores 120 par seconde120 per second 4 801-9 6004,801-9600

Note

Pour acheter Power BI Premium, vous devez être Administrateur général ou Administrateur de facturation de votre locataire.You must be a Global or Billing Admin, within your tenant, to purchase Power BI Premium. Pour plus d’informations sur l’achat de Power BI Premium, consultez Acheter Power BI Premium.For information on how to purchase Power BI Premium, see How to purchase Power BI Premium.

Incorporation pour vos clientsEmbedding for your customers

Si l’incorporation s’adresse à vos clients, effectuez les opérations suivantes.If you are embedding for your customers, do the following.

  • Si vous utilisez un locataire distinct pour le développement, vérifiez que vos espaces de travail d’applications ainsi que vos tableaux de bord et rapports sont disponibles dans votre environnement de production.If you are using a separate tenant for development, then you must make sure your app workspaces, along with dashboards and reports, are available in your production environment. Vérifiez que vous avez créé l’application dans Azure AD pour votre locataire de production et attribué les autorisations d’application appropriées comme indiqué à l’étape 1.Make sure that you create the application in Azure AD for your production tenant and assign the proper app permissions as indicated in Step 1.
  • Achetez une capacité adaptée à vos besoins.Purchase a capacity that fits your needs. Vous pouvez utiliser le tableau ci-dessous pour identifier la référence SKU de la capacité Power BI Embedded dont vous avez besoin.You can use the table below to understand which Power BI Embedded capacity SKU you may need. Pour plus d’informations, consultez le livre blanc Planification d’une capacité d’analytique incorporée.For more details, see Embedded analytics capacity planning whitepaper. Lorsque vous êtes prêt, vous pouvez procéder à l’achat à partir du portail Microsoft Azure.When you are ready to purchase, you can do so within the Microsoft Azure portal. Pour plus d’informations sur la façon de créer une capacité Power BI Embedded, consultez Créer une capacité Power BI Embedded dans le portail Azure.For details on how to create Power BI Embedded capacity, see Create Power BI Embedded capacity in the Azure portal.

Important

Étant donné que les jetons d’incorporation sont uniquement destinés aux tests de développeur, le nombre de jetons d’incorporation qu’un compte principal Power BI peut générer est limité.Because embed tokens are intended for developer testing only, the number of embed tokens a Power BI master account can generate is limited. Vous devez acheter une capacité pour les scénarios d’incorporation de production.A capacity must be purchased for production embedding scenarios. Si vous achetez une capacité dédiée, vous pouvez générer autant de jetons d’incorporation que vous voulez.There is no limit to embed token generation when a dedicated capacity is purchased. Accédez à Fonctionnalités disponibles pour vérifier combien de jetons d’incorporation gratuits ont été utilisés.Go to Available Features to check for how many free embed tokens have been used.

Nœud de capacitéCapacity Node Nombre total de cœursTotal cores
(Serveur principal + serveur frontal)(Backend + frontend)
Cœurs du serveur principalBackend Cores Cœurs du serveur frontalFrontend Cores Limites de connexions actives/DirectQueryDirectQuery/live connection limits Rendus de pages au maximum aux heures de pointeMax page renders at peak hour
A1A1 1 cœur virtuel1 v-cores .5 cœurs, 3 Go de RAM.5 cores, 3GB RAM .5 cœurs.5 cores 5 par seconde5 per second 1-3001-300
A2A2 2 cœurs virtuels2 v-cores 1 cœur, 5 Go de RAM1 core, 5GB RAM 1 cœur1 core 10 par seconde10 per second 301-600301-600
A3A3 4 cœurs virtuels4 v-cores 2 cœurs, 10 Go de RAM2 cores, 10GB RAM 2 cœurs2 cores 15 par seconde15 per second 601-1 200601-1,200
A4A4 8 cœurs virtuels8 v-cores 4 cœurs, 25 Go de RAM4 cores, 25GB RAM 4 cœurs4 cores 30 par seconde30 per second 1 201-2 4001,201-2,400
A5A5 16 cœurs virtuels16 v-cores 8 cœurs, 50 Go de RAM8 cores, 50GB RAM 8 cœurs8 cores 60 par seconde60 per second 2 401-4 8002,401-4,800
A6A6 32 cœurs virtuels32 v-cores 16 cœurs, 100 Go de RAM16 cores, 100GB RAM 16 cœurs16 cores 120 par seconde120 per second 4 801-9 6004,801-9600
  • Modifiez l’espace de travail d’application et attribuez-le à une capacité dédiée sous Avancé.Edit the app workspace and assign it to a dedicated capacity under advanced.

    Affecter un espace de travail à une capacité

  • Déployez votre application mise à jour en production, puis commencez à incorporer des rapports et tableaux de bord Power BI.Deploy your updated application to production and begin embedding Power BI dashboards and reports.

Paramètres d’administrateurAdmin settings

Les administrateurs globaux ou les administrateurs de service Power BI peuvent activer ou désactiver la possibilité d’utiliser les API REST pour un locataire.Global Admins, or Power BI service administrators, can turn the ability to use the REST APIs, on or off for a tenant. Les administrateurs Power BI peuvent définir ce paramètre pour toute l’organisation ou pour certains groupes de sécurité.Power BI admins can set this setting for the entire organization, or for individual security groups. Il est activé par défaut pour toute l’organisation.It is enabled for the entire organization by default. Son réglage s’effectue au moyen du Portail d’administration Power BI.This is done through the Power BI admin portal.

Étapes suivantesNext steps

Incorporation avec Power BIEmbedding with Power BI
Comment migrer le contenu d’une collection d’espaces de travail Power BI Embedded vers Power BIHow to migrate Power BI Embedded workspace collection content to Power BI
Qu’est-ce que Power BI Premium ?Power BI Premium - what is it?
Acheter Power BI PremiumHow to purchase Power BI Premium
Dépôt Git d’API JavaScriptJavaScript API Git repo
Dépôt Git de C# pour Power BI Power BI C# Git repo
Exemple de JavaScript incorporéJavaScript embed sample
Livre blanc Planification d’une capacité d’analytique incorporéeEmbedded analytics capacity planning whitepaper
Livre blanc sur Power BI PremiumPower BI Premium whitepaper

D’autres questions ?More questions? Essayez d’interroger la communauté Power BITry asking the Power BI Community