Compartilhar via


Usar o pré-carregamento para reduzir o tempo de carga

A API powerbi.preload é usada para reduzir o tempo de carga do conteúdo inserido no Power BI quando o conteúdo inserido estiver em uma página diferente. O pré-carregamento usa uma configuração mínima (apenas type e embedURL) para ajudar a baixar os scripts necessários para inserir o conteúdo do Power BI antes de seus usuários navegarem até essa página. Isso fornece uma experiência mais rápida ao exibir relatórios e dashboards inseridos. Pré-carregamento só deverá ser usado se o conteúdo do Power BI estiver em uma página diferente do aplicativo Web.

Nota

Como prática recomendada para o desempenho, recomendamos usar o método bootstrap em vez de pré-carregar.

Como usar o pré-carregamento

powerbi.preload() é usado para baixar os scripts necessários antes de inserir seu conteúdo. O navegador armazena esses scripts em seu cache, tornando a chamada inicial para powerbi.embed() mais rápida. Para usar o pré-carregamento, você deve fornecer o tipo de entidade inserida e uma URL base para o Power BI (inserir URLs sem parâmetros de URL específicos, como reportId ou groupId).

// Building the config object
let config = {
    type: 'report',
    embedUrl: 'https://app.powerbi.com/reportEmbed',
};

let element = powerbi.preload(config);

O evento preload será acionado quando o pré-carregamento for concluído.

element.on('preloaded', function () {
    ...
});