Carga gradual de contenido insertado en Power BI Embedded

La carga de un artefacto insertado en Power BI Embedded se lleva a cabo con una llamada a embed que contiene un objeto de configuración insertado y el elemento <div> que contiene un iframe. Después de llamar al objeto insertado, se carga delante del usuario.

Para mejorar la experiencia de usuario y ofrecer más herramientas para desarrolladores, hemos ampliado este flujo con más llamadas de JavaScript que agregan fases al proceso de inserción:

1. Precarga. La llamada a powerbi.preload() utiliza la memoria caché del explorador y descarga los scripts antes de mostrar el objeto insertado en sí. Esto puede ser útil para aplicaciones que hospedan varios informes insertados. Una vez finalizada la precarga, se desencadena un evento ready.
2. Carga de metadatos. La llamada a powerbi.load() permite recuperar información sobre el objeto insertado y cambia de forma dinámica la configuración o el elemento <div> en segundo plano, antes de que se muestre el objeto al usuario. Por ejemplo, puede usar esta función para obtener páginas y decidir después cuál de ellas se muestra al usuario. O bien puede usar get visuals y después decidir qué objetos visuales desea mostrar u ocultar. Si utiliza esta función, debe llamar a la función render() para mostrar el objeto insertado. Una vez completada la carga, se desencadena un evento loaded.
3. Representación del objeto. La última llamada, si implementó la función powerbi.load(), es render(). Lleva a cabo las últimas acciones necesarias para representar y mostrar el objeto insertado al usuario. Una vez completada la representación, se desencadena un evento rendered.

Si bien las funciones load y render deben usarse juntas, la función preload es independiente de ellas. Utilice la función embed para mostrar el objeto insertado después de la precarga. También puede usar el procedimiento por fases completo llamando a preload, load y render, respectivamente.