Chargement progressif du contenu incorporé dans Power BI Embedded
Date de publication : 15 mars, 2018
Le chargement d’un artefact incorporé dans Power BI Embedded s’effectue via un appel d’incorporation (embed) qui contient un objet de configuration incorporé et l’élément <div> qui contient iframe. Une fois l’objet incorporé appelé, il est chargé devant l’utilisateur.
Pour améliorer l’expérience utilisateur et fournir plus d’outils aux développeurs, nous avons étendu ce flux avec d’autres appels JavaScript qui ajoutent des phases au processus d’incorporation :
- Préchargement. L’appel powerbi.preload() utilise le cache du navigateur et les scripts de téléchargement avant d’afficher l’objet incorporé lui-même. Cela peut être utile pour les applications qui hébergent plusieurs rapports incorporés. Un événement ready est déclenché une fois le préchargement terminé.
- Chargement des métadonnées. L’appel powerbi.load() permet de récupérer des informations sur l’objet incorporé et modifie dynamiquement les paramètres ou l’élément <div> en arrière-plan, avant que l’objet ne soit affiché à l’utilisateur. Par exemple, vous pouvez utiliser cette fonction pour obtenir des pages, puis décider quelle page afficher pour l’utilisateur. Vous pouvez également utiliser get visuals (obtenir des visuels), puis choisir les visuels que vous souhaitez afficher ou masquer. Si vous utilisez cette fonction, vous devez appeler la fonction render() pour afficher l’objet incorporé. Un événement loaded est déclenché une fois le chargement effectué.
- Restitution de l’objet. L’appel final, si vous avez implémenté la fonction powerbi.load(), est render(). Il effectue les dernières actions nécessaires pour restituer et afficher l’objet incorporé à l’utilisateur. Un événement rendered (restitué) est déclenché une fois la restitution effectuée.
Bien que les fonctions load et render doivent être utilisées ensemble, preload est indépendant d’elles. Vous pouvez utiliser la fonction embed pour afficher l’objet incorporé après le préchargement. Vous pouvez également utiliser la procédure complète en appelant respectivement preload, load et render.