Caricamento a fasi del contenuto incorporato in Power BI Embedded

Il caricamento di un elemento incorporato in Power BI Embedded viene eseguito tramite una chiamata embed che contiene un oggetto di configurazione incorporato e l'elemento <div> che contiene l'iframe. Dopo che l'oggetto incorporato è stato chiamato, viene caricato davanti all'utente.

Per migliorare l'esperienza utente e fornire più strumenti per gli sviluppatori, abbiamo esteso questo flusso con più chiamate JavaScript che aggiungono fasi al processo di incorporamento:

1. Precaricamento. La chiamata di powerbi.preload() usa la cache e gli script di download del browser prima di visualizzare l'oggetto incorporato stesso. Può essere utile per le applicazioni che ospitano numerosi report incorporati. Un evento ready viene generato al termine del precaricamento.
2. Caricamento dei metadati. La chiamata di powerbi.load() consente di recuperare le informazioni sull'oggetto incorporato e cambia in modo dinamico le impostazioni o l'elemento <div> in background, prima che l'oggetto venga visualizzato all'utente. Ad esempio, puoi usare questa funzione per recuperare le pagine e decidere quale pagina mostrare all'utente. In alternativa, puoi usare la funzione get visuals e quindi decidere quali oggetti visivi mostrare o nascondere. Se usi questa funzione, devi chiamare la funzione render() per mostrare l'oggetto incorporato. Al termine del caricamento, viene generato un evento loaded.
3. Rendering dell'oggetto. La chiamata finale, se hai implementato la funzione powerbi.load() è render(). Completa le ultime azioni necessarie per eseguire il rendering e mostrare l'oggetto incorporato all'utente. Al termine del rendering, viene generato un evento rendered.

Le funzioni load e render devono essere usate insieme, mentre la funzione preload è indipendente. Puoi anche usare la funzione embed per mostrare l'oggetto incorporato dopo il precaricamento e usare la procedura a fasi completa chiamando rispettivamente le funzioni preload, load e render.