Compartir a través de

Uso del arranque para mejorar el rendimiento

  • Artículo

powerbi.bootstrap es un método introducido en la versión 2.9.0 del SDK de cliente para ayudar a los desarrolladores a insertar entidades de Power BI más rápido y obtener un mejor rendimiento.

La inserción de un informe mediante powerbi.embed requiere varios parámetros, como reportId, embedURLy accessToken. Estos parámetros no siempre están disponibles inmediatamente.

powerbi.bootstrap permite iniciar la inserción antes de que todos los parámetros necesarios estén disponibles. La API de arranque prepara e inicializa el iframe.

Una vez recibidos los parámetros necesarios, se debe llamar a powerbi.embed(element, config) en el mismo elemento HTML.

API de arranque

El método powerbi.bootstrap(element, config) recibe un elemento y una configuración, igual que 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;

Configuración de inserción de arranque

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

Parámetros de configuración:

  • tipo (obligatorio): el tipo de entidad que desea insertar, como "report", "dashboard", "tile", "qna" o "visual".
  • nombre de host: si aún no tiene un embedURL, puede proporcionar un nombre de host. El nombre de host es el nombre de dominio de la dirección URL de inserción. Por ejemplo, si la dirección URL de inserción es "https://app.powerbi.com/reportEmbed", el nombre de host es "https://app.powerbi.com/". Si no se proporciona ningún nombre de host o embedUrl, se usa el nombre de host predeterminado, https://app.powerbi.com/, .
  • embedUrl: la misma dirección URL de inserción que proporcionará más adelante a powerbi.embed. Si no se proporciona ningún nombre de host o embedUrl, se usa el nombre de host predeterminado, https://app.powerbi.com/, .
  • configuración: para insertar el informe en un diseño móvil o para proporcionar una configuración regional (idioma), incluya estos parámetros en la configuración inicial.

Ejemplos de bootstrap

En los ejemplos siguientes se proporciona una referencia para el método bootstrap al insertar entidades de Power BI.

Nota

Asegúrese de llamar a powerbi.embed después de recibir los parámetros de inserción.

Para arrancar para insertar un informe:

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

Para arrancar para insertar un panel:

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

Para arrancar para insertar un informe solo con el nombre de host:

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

Para arrancar para insertar un informe con diseño móvil:

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

Consideraciones y limitaciones

  • Las siguientes entidades de arranque no se pueden cambiar sin llamar a powerbi.reset(element).

    • Tipo de componente (informe, panel): por ejemplo, si arranca un informe, solo puede insertar informes en el mismo elemento HTML.
    • Diseño (escritorio/móvil)
    • Configuración regional (idioma)

  • No se admite el método powerbi.bootstrap al insertar informes paginados.

Contenido relacionado