Présentation des différentes solutions d’incorporation

  • Article

L’incorporation d’éléments Power BI (tels que les rapports, les tableaux de bord et Q&A) dans votre application vous permet d’intégrer une analytique incroyable et entièrement interactive 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 présenter des données que votre application possède via votre propre compte Power BI, ou des données que l’utilisateur possède via ses comptes Power BI.

Scénarios d’application

Il existe deux scénarios différents pour incorporer un rapport Power BI dans une application.

  • Incorporer pour votre organisation (également appelée 'utilisateur possède des données) : l’application vous permet d’intégrer des données, des rapports, des tableaux de bord et des vignettes accessibles aux utilisateurs de votre organisation lorsqu’ils se connectent à l’aide de leurs propres comptes Power BI. Dans ce type d’application, les utilisateurs possèdent les données que vous incorporez.
  • Incorporer pour vos clients (également appelée application possède des données) : l’application présente les données, rapports, tableaux de bord ou 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 du paramètreembedUrl. Pour récupérer une URL incorporée pour un type de contenu particulier, 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 leurs comptes 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 le embedConfiguration, définissez tokenType sur TokenType.Aad.

// 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 incorporer un jeton pour les rapports, tableaux de bord ou vignettes que vous souhaitez incorporer en appelant l’API REST Power BI Incorporer le jeton. Une fois que vous avez un jeton incorporé , utilisez le code suivant pour incorporer le rapport :

Dans le embedConfiguration, définissez tokenType sur TokenType.Embed.

// 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);

Contenu connexe