Incorporation avec Power BIEmbedding with Power BI

Power BI fournit des API pour l’incorporation de vos tableaux de bord et rapports dans des applications.Power BI offers APIs for embedding your dashboards and reports into applications. Les API Power BI offrent un ensemble cohérent de fonctionnalités et l’accès aux dernières fonctionnalités de Power BI telles que des tableaux de bord, des passerelles et des espaces de travail d’application lors de l’incorporation de contenu.The Power BI APIs offer a consistent set of capabilities and access to the latest Power BI features – such as dashboards, gateways and app workspaces – when embedding content.

Une seule APIA single API

Les deux principaux scénarios d’incorporation de contenu Power BI sont les suivants :There are two main scenarios when embedding Power BI content. Incorporation pour les utilisateurs de votre organisation (disposant de licences Power BI) et incorporation pour les utilisateurs et les clients sans que ceux-ci aient besoin de licences Power BI.Embedding for users in your organization (who have licenses for Power BI) and embedding for your users and customers without requiring them to have Power BI licenses. L’API REST Power BI est adaptée aux deux scénarios.The Power BI REST API allows for both scenarios.

Pour les clients et utilisateurs sans licence Power BI, vous pouvez incorporer des tableaux de bord et des rapports dans votre application personnalisée, en utilisant la même API pour votre organisation ou vos clients.For customers and users without Power BI licenses, you can embed dashboards and reports into your custom application, using the same API to either service your organization or your customers. Vos clients voient les données qui sont gérées par l’application.Your customers see the data that is managed by the application. Et les utilisateurs Power BI de votre organisation possèdent des options supplémentaires pour afficher leurs propres données directement dans Power BI ou dans le contexte de l’application incorporée.And for Power BI users in your organization, they'll have the additional options to view their own data directly in Power BI or in the context of the embedded application. Vous pouvez tirer pleinement parti des API JavaScript et REST pour vos besoins d’incorporation.You can take full advantage of the JavaScript and REST APIs for your embedding needs.

Reportez-vous à Exemple de JavaScript incorporé pour consulter un exemple d’incorporation.To view a sample of how embedding works, see the JavaScript embed sample.

Incorporation pour votre organisationEmbedding for your organization

L’incorporation pour votre organisation vous permet d’étendre le service Power BI.Embedding for your organization allows you to extend the Power BI service. Pour voir son contenu, l’utilisateur de votre application doit se connecter au service Power BI.This requires that users of your application sign into the Power BI service when they want to view their content. Une fois qu’un utilisateur de votre organisation est connecté, il a uniquement accès aux tableaux de bord et rapports dont il est propriétaire ou qui ont été partagés avec lui dans le service Power BI.Once someone in your organization signs in, they will only have access to dashboards and reports that they own or that have been shared with them in the Power BI service.

Une application web interne, le composant WebPart SharePoint Online et l’intégration de Microsoft Teams sont des exemples d’incorporation pour votre organisation.Examples of embedding for your organization include internal web application, the SharePoint Online web part and Microsoft Teams integration.

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

Les fonctionnalités en libre-service, telles que la modification ou l’enregistrement, sont disponibles par le bais de l’API JavaScript lors de l’incorporation relative aux utilisateurs Power BI.Self-service capabilities, such as edit, save and more, are available through the JavaScript API when embedding for Power BI users.

Incorporation pour vos clientsEmbedding for your customers

L’incorporation pour vos clients permet d’incorporer des tableaux de bord et des rapports pour les utilisateurs qui n’ont pas de compte Power BI.Embedding for your customers provides the ability to embed dashboards and reports to users who don't have an account for Power BI. Vos clients n’ont pas à se soucier de Power BI.Your customers don't need to know anything about Power BI. Au moins un compte Power BI Pro est nécessaire pour créer une application incorporée.At least one Power BI Pro account is needed to create an embedded application. Ce compte sert de compte principal pour votre application.The Power BI Pro account acts as a master account for your application. Considérez-le comme un compte proxy.Think of this as a proxy account. Ce compte Power BI Pro vous permet également de générer les jetons d’incorporation qui offrent un accès aux tableaux de bord et rapports au sein du service Power BI qui sont gérés ou possédés par votre application.The Power BI Pro account also allows you to generate embed tokens that provide access to dashboards and reports within the Power BI service that are owned/managed by your application.

Un exemple d’incorporation pour vos clients est un application d’éditeur de logiciel indépendant vendue à d’autres sociétés.An example of embedding for your customers is an ISV application being sold to other companies.

Flux relatif à l’incorporation de vos clients

Pour incorporer des tableaux de bord, des rapports et des vignettes, vous pouvez utiliser les mêmes API que pour une incorporation s’adressant à votre organisation.To embed dashboards, reports and tiles, you would use the same APIs that you would use for embedding for your organization.

Important

Même si l’incorporation dépend du service Power BI, vos clients ne dépendent pas de Power BI.While embedding has a dependency on the Power BI service, there is not a dependency on Power BI for your customers. Ils n’ont pas besoin de s’inscrire à Power BI pour afficher le contenu incorporé dans votre application.They do not need to sign up for Power BI to view the embedded content in your application.

Lorsque vous êtes prêt à passer en mode de production, vous devez attribuer une capacité à votre espace de travail d’applications.When you are ready to move to production, your app workspace must be assigned to a capacity. Power BI Embedded, au sein de Microsoft Azure, offre une capacité à utiliser avec vos applications.Power BI Embedded, within Microsoft Azure, offers capacity to use with your applications.

Pour plus d’informations sur l’incorporation, consultez Comment incorporer vos tableaux de bord, rapports et vignettes Power BI.For details on how to embed, see How to embed your Power BI dashboards, reports and tiles.

Si vous utilisiez le service Collection d’espaces de travail Power BI au sein d’Azure, pour plus d’informations sur la façon de migrer votre contenu, consultez Migrer le contenu du service Azure Collection d’espaces de travail Power BI.If you were using the Power BI Workspace Collections service within Azure, see Migrate content from the Power BI Workspace Collections Azure service for information on how to migrate your content over.

Étapes suivantesNext steps

Comment incorporer vos tableaux de bord, rapports et vignettes Power BIHow to embed your Power BI dashboards, reports and tiles
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?
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