Carregamento em fases de conteúdo inserido no Power BI Embedded

O carregamento de um artefato inserido no Power BI Embedded é realizado por meio de uma chamada embed que contém um objeto de configuração inserido e o elemento <div> que contém o iframe. Depois que o objeto inserido é chamado, ele é carregado na frente do usuário.

Para melhorar a experiência do usuário e oferecer mais ferramentas aos desenvolvedores, nós ampliamos esse fluxo com mais chamadas de JavaScript que adicionam fases ao processo de inserção:

1. Pré-carregamento. A chamada powerbi.preload() usa o scripts de cache e de download do navegador antes de mostrar o objeto inserido propriamente dito. Isso pode ser útil para aplicativos que hospedam vários relatórios inseridos. Um evento ready é disparado depois que o pré-carregamento é concluído.
2. Carregar metadados. A chamada powerbi.load() ajuda a recuperar informações no objeto inserido e altera dinamicamente as configurações ou o elemento <div> em segundo plano, antes de o objeto ser exibido para o usuário. Por exemplo, você pode usar essa função para obter páginas e, em seguida, decidir qual página será mostrada ao usuário. Ou então, você pode usar get visuals e, em seguida, decidir quais visuais deseja mostrar ou ocultar. Se você usar essa função, será necessário chamar a função render() para mostrar o objeto inserido. Depois que o carregamento for concluído, um evento loaded será disparado.
3. Renderizar objeto. A última chamada, se você tiver implementado a função powerbi.load(), será render(). Ela conclui as últimas ações necessárias para renderizar e mostrar o objeto inserido ao usuário. Um evento rendered será disparado depois que a renderização for concluída.

Embora as funções load e render precisem ser usadas juntas, preload é independente delas. Você poderá usar a função embed para mostrar o objeto inserido após o pré-carregamento. Você também pode usar o procedimento em fases completo chamando preload, load e render, respectivamente.