Condividi tramite

Usare bootstrap per ottenere prestazioni migliori

  • Articolo

powerbi.bootstrap è un metodo introdotto in Client SDK versione 2.9.0 per consentire agli sviluppatori di incorporare entità di Power BI più velocemente e ottenere prestazioni migliori.

L'incorporamento di un report tramite powerbi.embed richiede più parametri, ad esempio reportId, embedURLe accessToken. Questi parametri non sono sempre immediatamente disponibili.

powerbi.bootstrap consente di avviare l'incorporamento prima che siano disponibili tutti i parametri obbligatori. L'API bootstrap prepara e inizializza l'iframe.

Dopo aver ricevuto i parametri obbligatori, powerbi.embed(element, config) deve essere chiamato sullo stesso elemento HTML.

Bootstrap API

Il metodo powerbi.bootstrap(element, config) riceve un elemento e una configurazione, come 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;

Configurazione di incorporamento bootstrap

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

Parametri di configurazione:

  • tipo (obbligatorio): tipo di entità da incorporare, ad esempio "report", "dashboard", "tile", "qna" o "visual".
  • nome host: se non si dispone ancora di un embedURL, è possibile specificare un nome host. Il nome host è il nome di dominio dell'URL di incorporamento. Ad esempio, se l'URL di incorporamento è 'https://app.powerbi.com/reportEmbed' , il nome host è 'https://app.powerbi.com/'. Se non viene specificato alcun nome host o embedUrl, viene usato il nome host predefinito, https://app.powerbi.com/, .
  • embedUrl: lo stesso URL di incorporamento che verrà fornito in un secondo momento a powerbi.embed. Se non viene specificato alcun nome host o embedUrl, viene usato il nome host predefinito, https://app.powerbi.com/, .
  • impostazioni: per incorporare il report in un layout per dispositivi mobili o per fornire impostazioni locali (lingua), includere questi parametri nelle impostazioni iniziali.

Esempi di Bootstrap

Gli esempi seguenti forniscono un riferimento per il metodo bootstrap durante l'incorporamento di entità di Power BI.

Nota

Assicurarsi di chiamare powerbi.embed dopo aver ricevuto i parametri di incorporamento.

Per eseguire il bootstrap per l'incorporamento di un report:

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

Per eseguire il bootstrap per l'incorporamento di un dashboard:

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

Per eseguire il bootstrap per l'incorporamento di un report solo con il nome host:

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

Per eseguire il bootstrap per l'incorporamento di un report con layout per dispositivi mobili:

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

Considerazioni e limitazioni

  • Non è possibile modificare le entità di avviostrate seguenti senza chiamare powerbi.reset(element).

    • Tipo di componente (report, dashboard): ad esempio, se si avvia un report, è possibile incorporare solo i report nello stesso elemento HTML.
    • Layout (desktop/mobile)
    • Impostazioni locali (lingua)

  • Il metodo powerbi.bootstrap non è supportato durante l'incorporamento di report impaginati.

Contenuto correlato