Comprendre les différentes solutions d’incorporation
L’incorporation d’éléments Power BI (tels que des rapports, des tableaux de bord et des Q&A) dans votre application vous permet d’intégrer des analyses entièrement interactives sans avoir à créer vos propres visualisations et contrôles de données à partir de zéro. L’analytique Power BI que vous incorporez peut soit présenter des données que votre application possède via votre propre compte Power BI, soit des données que l’utilisateur possède via son compte Power BI.
Scénarios d’application
Il existe deux scénarios différents pour incorporer un rapport Power BI dans une application.
- Incorporer pour vos organization (également appelées données propriétaires de l’utilisateur) : l’application vous permet d’intégrer des données, des rapports, des tableaux de bord et des vignettes accessibles aux utilisateurs de votre organization lorsqu’ils se connectent à l’aide de leurs propres comptes Power BI. Dans ce type d’application, les utilisateurs sont propriétaires des données que vous incorporez.
- Incorporer pour vos clients (également appelées données propriétaires de l’application) : l’application présente les données, les rapports, les tableaux de bord ou les vignettes que vous avez chargés sur votre propre compte Power BI. Dans ce type d’application, vous utilisez votre propre compte, de sorte que votre application possède les données de vos clients. Vos clients n’ont pas besoin de leur propre compte Power BI.
Le scénario d’application que vous utilisez détermine comment récupérer un jeton d’accès qui vous permet d’accéder aux données et d’incorporer du contenu dans votre application.
Le type de contenu que vous incorporez est spécifié par la valeur duembedUrl paramètre . Pour récupérer une URL incorporée pour un type particulier de contenu, appelez l’API REST Power BI correspondante. Par exemple, appelez Obtenir des rapports pour récupérer l’URL incorporée pour incorporer un rapport.
Les sections suivantes vous montrent comment récupérer un jeton d’accès et incorporer un rapport pour chacun de ces scénarios d’application.
Incorporer pour votre organisation
Dans ce scénario, les utilisateurs de votre application se connectent à l’aide de leur compte Power BI. Cela vous donne le jeton d’accès pour accéder à leurs données et incorporer leurs rapports, tableaux de bord et vignettes.
Dans , embedConfigurationdéfinissez sur TokenType.AadtokenType .
// Get models so you can use the TokenType enum.
let models = window['powerbi-client'].models;
let embedConfiguration = {
type: 'report',
id: '5dac7a4a-4452-46b3-99f6-a25915e0fe55',
embedUrl: 'https://app.powerbi.com/reportEmbed',
tokenType: models.TokenType.Aad,
accessToken: 'e4...rf'
};
let reportContainer = $('#reportContainer')[0];
let report = powerbi.embed(reportContainer, embedConfiguration);
Incorporer pour vos clients
Dans ce scénario, vous créez une identité dédiée qui a accès à tous les éléments Power BI. Ensuite, vous générez un jeton d’incorporation pour les rapports, les tableaux de bord ou les vignettes que vous souhaitez incorporer en appelant le jeton d’incorporation de l’API REST Power BI. Une fois que vous avez un jeton incorporé, utilisez le code suivant pour incorporer le rapport :
Dans , embedConfigurationdéfinissez sur TokenType.EmbedtokenType .
// Get models so you can use the TokenType enum.
let models = window['powerbi-client'].models;
let embedConfiguration = {
type: 'report',
id: '5dac7a4a-4452-46b3-99f6-a25915e0fe55',
embedUrl: 'https://app.powerbi.com/reportEmbed',
tokenType: models.TokenType.Embed,
accessToken: 'h4...rf'
};
let reportContainer = $('#reportContainer')[0];
let report = powerbi.embed(reportContainer, embedConfiguration);