Embed a report (Intégrer un rapport)

Conseil

Essayez d’incorporer un rapport ou d’expérimenter nos API clientes dans la section Explorer nos API du terrain de jeu Power BI Embedded Analytics.

Cet article décrit les étapes d’incorporation d’un rapport Power BI dans votre application. En savoir plus sur les rapports dans Rapports dans Power BI.

Guide pratique pour incorporer un rapport

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. Pour plus d’informations, consultez Configurer les paramètres de rapport .

Incorporer un rapport existant

Lorsque vous incorporez un rapport qui existe déjà, utilisez un objet de configuration de type IReportLoadConfiguration.

interface IReportLoadConfiguration {
    accessToken: string;
    bookmark?: models.IApplyBookmarkRequest;
    contrastMode?: models.ContrastMode;
    datasetBinding?: models.IDatasetBinding;
    embedUrl?: string;
    filters?: models.ReportLevelFilters[];
    id: string;
    pageName?: string;
    permissions?: models.Permissions;
    settings?: models.IEmbedSettings;
    slicers?: models.ISlicer[];
    theme?: models.IReportTheme;
    tokenType?: models.TokenType;
    type: string;
    viewMode?: models.ViewMode;
}

Cette interface inclut 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.

• datasetBinding - Jeu de données qui définit le schéma de données que le rapport incorporé utilise. Pour plus d’informations sur les jeux de données, consultez Lier des jeux de données dynamiquement à un rapport .

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

  • Rapports - Obtenir un rapport dans un groupe
  • Rapports - Obtenir des rapports dans un groupe

• id - ID du rapport Power BI que vous incorporez.

• permissions - Opérations que vous accordez aux utilisateurs pour le rapport incorporé. Ces valeurs sont disponibles :

  • Read - Les utilisateurs peuvent afficher le rapport.
  • ReadWrite - Les utilisateurs peuvent afficher, modifier et enregistrer le rapport.
  • Copy - Les utilisateurs peuvent enregistrer une copie du rapport à l’aide de l’option Enregistrer sous.
  • Create - Les utilisateurs peuvent créer un rapport.
  • All - Les utilisateurs peuvent créer, afficher, modifier, enregistrer et enregistrer une copie du 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 organisation (l’utilisateur possède les données).
  • Utilisez models.TokenType.Embed si vous incorporez vos clients (l’application possède les données).

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

• type - Type de contenu que vous incorporez. Utiliser 'report' pour un rapport Power BI.

L’interface IReportLoadConfiguration contient également d’autres propriétés. Pour plus d’informations sur ces propriétés, consultez Configurer les paramètres de rapport :

• bookmark
• contrastMode
• filters
• pageName
• settings
• slicers
• theme
• viewMode

Incorporer un nouveau rapport

Lorsque vous incorporez un rapport que vous créez à partir d’un jeu de données, utilisez un objet de configuration de type IReportCreateConfiguration.

interface IReportCreateConfiguration {
    accessToken: string;
    datasetId: string;
    embedUrl?: string;
    settings?: models.IEmbedSettings;
    theme?: IReportTheme;
    tokenType?: models.TokenType;
    type: string;
}

Les propriétés de cette interface sont similaires aux propriétés de l’interface IReportLoadConfiguration , avec les exceptions suivantes :

• datasetId - ID du jeu de données qui définit le schéma de données que le nouveau rapport utilise.

• embedUrl - URL du jeu de données qui définit le schéma de données que le nouveau rapport utilise. Cette URL devient la source de l’élément HTML iframe qui contient le rapport incorporé. Plus précisément, l’API affecte l’URL à l’attribut src du iframe. Vous pouvez utiliser une API Datasets pour obtenir cette URL. En voici deux exemples:

  • Jeux de données - Obtenir un jeu de données dans un groupe
  • Jeux de données - Obtenir des jeux de données dans un groupe

Consultez Créer, modifier et enregistrer un rapport incorporé pour plus d’informations sur la modification et la création de rapports.

Exemple

L’exemple suivant montre comment incorporer un rapport :

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

Étapes suivantes

Incorporer un visuel de rapport

Incorporer un rapport paginé

Configurer les paramètres de rapport

Créer, modifier et enregistrer un rapport

Utiliser bootstrap pour améliorer les performances