Incorporer un visuel de rapport

  • Article

Conseil

Essayez d’incorporer un visuel de rapport ou une expérience avec nos API clientes dans la section Explorer nos API du Power BI Embedded Analytics Playground.

Cet article décrit les étapes d’incorporation d’un visuel dans votre application. En savoir plus sur les visuels dans Visuels dans Power BI.

Guide pratique pour incorporer un visuel

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 un visuel, utilisez un objet de configuration de type IVisualLoadConfiguration:

interface IVisualLoadConfiguration {
    accessToken?: string;
    embedUrl?: string;
    id?: string;
    pageName: string;
    tokenType?: models.TokenType;
    type: string;
    visualName: string;
}

Cette interface comprend les propriétés suivantes :

  • accessToken - Jeton qui vous donne accès aux données Power BI que vous incorporez. Pour en savoir plus sur les jetons d’accès, consultez Comprendre les différentes solutions d’incorporation .

  • embedUrl - URL du rapport qui contient le visuel que vous incorporez. Cette URL devient la source de l’élément HTML iframe qui contient le visuel incorporé. Plus précisément, l’API affecte l’URL à l’attribut src de .iframe Vous pouvez utiliser une API de rapport pour obtenir cette URL. En voici deux exemples:

  • id - ID du rapport Power BI qui contient le visuel que vous incorporez.

  • pageName - Nom de la page qui contient le visuel que vous incorporez. Vous pouvez utiliser la méthode getPages de rapport pour obtenir les pages d’un rapport.

  • tokenType - Type de jeton qui vous donne accès aux données Power BI que vous incorporez.

    • Utilisez models.TokenType.Aad si vous incorporez pour votre organization (l’utilisateur est propriétaire des données).
    • Utilisez models.TokenType.Embed si vous incorporez pour vos clients (l’application est propriétaire des données).

    Pour plus d’informations, consultez Comprendre les différentes solutions d’incorporation .

  • type - Type de contenu que vous incorporez. Utilisez 'visual' pour un visuel.

  • visualName - Nom du visuel que vous incorporez. Vous pouvez utiliser la méthode GetVisuals page pour obtenir les visuels d’une page.

Exemple

L’exemple suivant montre comment incorporer un seul visuel :

// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
    accessToken: anAccessToken,
    embedUrl: anEmbedUrl,
    id: aReportId,
    pageName: aPageName,
    tokenType: aTokenType,
    type: 'visual',
    visualName: aVisualName
};
 
// Get a reference to the HTML element that contains the embedded report.
let embedContainer = $('#embedContainer')[0];
 
// Embed the visual.
let visual = powerbi.embed(embedContainer, embedConfiguration);

Filtres

Par défaut, l’API updateFilters applique des filtres de niveau visuel lors de l’incorporation d’un seul visuel de rapport. Cela peut entraîner un conflit avec les filtres appliqués dans l’objet de configuration incorporé, car ils sont appliqués au niveau du rapport. Pour résoudre ce problème, vous pouvez définir le niveau des filtres avec l’API :

await visual.updateFilters(FiltersOperations.Add, filters, FiltersLevel.Report);

En savoir plus sur les filtres dans Contrôler les filtres de rapport.

Étapes suivantes

Embed a report (Intégrer un rapport)

Incorporer un rapport paginé

Incorporer un visuel Q&R autonome

Utiliser le bootstrap pour de meilleures performances