Utiliser le bootstrap pour de meilleures performances

  • Article

powerbi.bootstrap est une méthode introduite dans le Kit de développement logiciel (SDK) client version 2.9.0 pour aider les développeurs à incorporer plus rapidement des entités Power BI et à obtenir de meilleures performances.

L’incorporation d’un rapport à l’aide powerbi.embed de nécessite plusieurs paramètres, tels que reportId, embedURLet accessToken. Ces paramètres ne sont pas toujours disponibles immédiatement.

powerbi.bootstrap vous permet de commencer à incorporer avant que tous les paramètres requis soient disponibles. L’API d’amorçage prépare et initialise l’iframe.

Une fois les paramètres requis reçus, powerbi.embed(element, config) doivent être appelés sur le même élément HTML.

Bootstrap API

La powerbi.bootstrap(element, config) méthode reçoit un élément et une configuration, identiques à powerbi.embed(...).

/**
    * Given an HTML element and entityType, creates a new component instance, and bootstrap the iframe for embedding.
    *
    * @param {HTMLElement} an HTML Element where you need to embed. must be the same div element you will use in powerbi.embed.
    * @param {IBootstrapEmbedConfiguration} config: a bootstrap config.
    */
bootstrap(element: HTMLElement, config: IBootstrapEmbedConfiguration): embed.Embed;

Configuration d’incorporation de bootstrap

interface IBootstrapEmbedConfiguration {
  type: string;
  hostname?: string;
  embedUrl?: string;
  settings?: ISettings;
}

Paramètres de configuration :

  • type (obligatoire) : type d’entité que vous souhaitez incorporer, tel que « rapport », « tableau de bord », « vignette », « qna » ou « visuel ».
  • nom d’hôte : si vous n’en avez embedURL pas encore, vous pouvez fournir un nom d’hôte. Le nom d’hôte est le nom de domaine de l’URL incorporée. Par exemple, si l’URL incorporée est « »,https://app.powerbi.com/reportEmbed le nom d’hôte est « ».https://app.powerbi.com/ Si aucun nom d’hôte ou embedUrl n’est fourni, le nom d’hôte par défaut, https://app.powerbi.com/, est utilisé.
  • embedUrl : URL d’incorporation que vous fournirez ultérieurement à powerbi.embed. Si aucun nom d’hôte ou embedUrl n’est fourni, le nom d’hôte par défaut, https://app.powerbi.com/, est utilisé.
  • paramètres : pour incorporer le rapport dans une disposition mobile ou pour fournir des paramètres régionaux (langue), incluez ces paramètres dans les paramètres initiaux.

Exemples de démarrage

Les exemples suivants fournissent une référence pour la méthode bootstrap lors de l’incorporation d’entités Power BI.

Notes

Assurez-vous d’appeler powerbi.embed après avoir reçu les paramètres incorporés.

Pour démarrer l’incorporation d’un rapport :

powerbi.bootstrap(
        reportContainerDivElement,
        {
            type: 'report',
        }
    );

Pour démarrer l’incorporation d’un tableau de bord :

powerbi.bootstrap(
        reportContainerDivElement,
        {
            type: 'dashboard',
            embedUrl: "https://app.powerbi.com/dashboardEmbed?dashboardId=06e3ba63-47ea-4579-b010-fdb5484b325a&config=eyJjbHVzdGVyVXJsIjoiaHR0cHM6mLndpbmRvd3MubmV0In0="
        }
    );

Pour démarrer l’incorporation d’un rapport avec le nom d’hôte uniquement :

powerbi.bootstrap(
        reportContainerDivElement,
        {
            type: 'report',
            hostname: "https://app.powerbi.com"
        }
    );

Pour démarrer l’incorporation d’un rapport avec une disposition mobile :

powerbi.bootstrap(
        reportContainerDivElement,
        {
            type: 'report',
            hostname: "https://app.powerbi.com",
            settings: {
	            layoutType: models.LayoutType.MobilePortrait
            }
        }
    );

Limites

  • Les entités de démarrage suivantes ne peuvent pas être modifiées sans appeler powerbi.reset(element).

    • Type de composant (rapport, tableau de bord) : par exemple, si vous démarrez un rapport, vous pouvez uniquement incorporer des rapports dans le même élément HTML.
    • Disposition (bureau/mobile)
    • Paramètres régionaux (langue)

  • La méthode powerbi.bootstrap n’est pas prise en charge lors de l’incorporation de rapports paginés.

Étapes suivantes