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 est consacré à l’incorporation de contenu Power BI s’adressant à votre organisation et à vos clients.This article will look 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 will be 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 allons examiner les étapes à suivre pour créer et utiliser du contenu incorporé dans votre application.We will 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 setup to allow for embedding. Dans le cadre de la configuration, vous devez effectuer les opérations suivantes.As part of the setup, you will need to do the following.

Note

La capacité Power BI n’est pas nécessaire pour le développement de votre application.Power BI capacity is not required for development of your application. Les développeurs de l’application doivent disposer d’une licence Power BI Pro.The developers of the application will 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 disposer d’un locataire Azure Active Directory (Azure AD).You will need an Azure Active Directory (Azure AD) tenant in order 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 will 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 s’adressant à vos clients.You will 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 will 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. De préférence, l’utilisateur administrateur doit être membre de tous les espaces de travail d’applications créés à des fins d’incorporation.It is recommended that the admin user be an admin of all app workspaces created for the purpose of embedding.

Des comptes pour les analystes devant créer du contenuAccounts for analysts that will 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 will 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 will use 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 vraiment le seul compte requis dont vous avez besoin au sein de votre organisation.The master account is really 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 will store the credentials for this account and use it for acquiring an Azure AD auth token for use with the Power BI APIs. Ce compte est utilisé afin de générer le jeton d’incorporation de l’application pour vos clients.This account will be used to generate 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 afin d’effectuer des appels d’API REST.You will need to register your application with Azure AD in order 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’applications.If you are embedding dashboards and reports for your customers, those dashboards and reports have to be placed within an app workspace. Le compte principal mentionné précédemment doit être administrateur de l’espace de travail d’applications.The master account, that 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

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’applications, 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 in order 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 will 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 will store the credentials for the master account within your application. Pour plus d’informations, consultez Authentifier des utilisateurs et obtenir un jeton d’accès Azure AD pour votre application Power BI.For more information, 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 les rubriques suivantes :For embeding 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 plus d’informations, consultez Générer des jetons.To learn more see, GenerateToken.

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

Les utilisateurs de la version gratuite peuvent consommer du contenu incorporé à partir d’un espace de travail d’application (groupe), si cet espace de travail est soutenu par une capacité.Free users can consume content that is embedded from an app workspace (group), if that workspace is backed by capacity. Chaque utilisateur de la version gratuite doit être répertorié en tant que membre de l’espace de travail d’application (groupe). Sinon, le système génère une erreur « (401) Non autorisé ».List the Free user as a member of app workspace (group), 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, in order 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 incorporés sont uniquement destinés aux tests de développement, le nombre de jetons incorporés qu’un compte principal Power BI peut générer est limité.Because embed tokens are intended for development 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. Une fois une capacité achetée, la génération de jetons incorporés n’est pas limitée.There is no limit to embed token generation when a capacity is purchased.

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’applications et attribuez-le à une capacité sous Avancé.Edit the app workspace and assign it to a 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