Incorporer une vignette de tableau de bord
Pourboire
Essayez d’incorporer une vignette de tableau de bord ou d’expérimenter nos API clientes dans la section Explorer nos API de la Power BI Embedded Analytics Playground.
Cet article décrit les étapes d’incorporation d’une vignette de tableau de bord dans votre application. En savoir plus sur les vignettes de tableau de bord dans Présentation des vignettes de tableau de bord pour les concepteurs Power BI.
Guide pratique pour incorporer une vignette de tableau de bord
Lorsque vous incorporez du contenu Power BI dans une application, vous utilisez un objet de configuration pour définir le contenu que vous incorporez et pour spécifier les paramètres du contenu. Ensuite, vous passez cet objet à l’API.
Lorsque vous incorporez une vignette de tableau de bord, utilisez un objet de configuration de type ITileLoadConfiguration:
interface ITileLoadConfiguration {
accessToken: string;
dashboardId: string;
embedUrl: string;
id: string;
tokenType?: models.TokenType;
type: string;
}
Cette interface contient les propriétés suivantes :
accessToken: jeton qui vous donne accès aux données Power BI que vous incorporez. Consultez Comprendre les différentes solutions d’incorporation pour en savoir plus sur les jetons d’accès.dashboardId: ID du tableau de bord qui contient la vignette que vous incorporez. Vous pouvez utiliser une API Dashboards pour obtenir cet ID. Deux exemples sont les suivants :embedUrl: URL de la vignette de tableau de bord que vous incorporez. Cette URL devient la source de l’élément HTMLiframequi contient la vignette du tableau de bord incorporé. Plus précisément, l’API affecte l’URL à l’attributsrcduiframe. Vous pouvez utiliser une api Dashboards pour obtenir cette URL. Deux exemples sont les suivants :- Tableaux de bord - Obtenir une vignette dans le groupe
- Tableaux de bord - Obtenir des vignettes dans le de groupe
id: ID de la vignette de tableau de bord que vous incorporez. Vous pouvez utiliser une API Dashboards pour obtenir cet ID. Deux exemples sont les suivants :- Tableaux de bord - Obtenir une vignette dans le groupe
- Tableaux de bord - Obtenir des vignettes dans le de groupe
tokenType: type de jeton qui vous donne accès aux données Power BI que vous incorporez.- Utilisez
models.TokenType.Aadsi vous incorporez pour votre organisation (l’utilisateur possède les données). - Utilisez
models.TokenType.Embedsi vous incorporez vos clients (l’application possède les données).
Pour plus d’informations, consultez Comprendre les différentes solutions d’incorporation.
- Utilisez
type: type de contenu que vous incorporez. Utilisez'tile'pour une vignette de tableau de bord.
Exemple
L’exemple suivant montre comment incorporer une vignette de tableau de bord unique :
// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
accessToken: anAccessToken,
dashboardId: aDashboardId,
embedUrl: anEmbedUrl,
id: aTileId,
tokenType: aTokenType,
type: 'tile'
};
// Get a reference to the HTML element that contains the embedded dashboard tile.
let tileContainer = $('#tileContainer')[0];
// Embed the dashboard.
let tile = powerbi.embed(tileContainer, embedConfiguration);