Utiliser bootstrap pour améliorer les 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 des entités Power BI plus rapidement et à obtenir de meilleures performances.

L’incorporation d’un rapport à l’aide de powerbi.embed 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 bootstrap prépare et initialise l’iframe.

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

Bootstrap API

La méthode powerbi.bootstrap(element, config) 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 bootstrap

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

Paramètres de configuration :

  • type (obligatoire) : type d’entité que vous souhaitez incorporer, par exemple « rapport », « tableau de bord », « vignette », « qna » ou « visuel ».
  • nom d’hôte: si vous n’avez pas encore de embedURL, 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: la même 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 fournir des paramètres régionaux (langue), incluez ces paramètres dans les paramètres initiaux.

Exemples bootstrap

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

Note

Veillez à appeler powerbi.embed après avoir reçu les paramètres d’incorporation.

Pour démarrer pour incorporer un rapport :

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

Pour démarrer pour incorporer 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 pour incorporer 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
            }
        }
    );

Considérations et limitations

  • Les entités bootstrapped 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.

Contenu connexe