跳到主内容

在 Power BI Embedded 中分阶段加载嵌入内容

发布日期:三月 15, 2018

 

利用包含嵌入的配置对象的 embed 调用和包含 iframe 的 <div> 元素可以在 Power BI Embedded 中加载嵌入的项目。调用嵌入的对象后,即可为用户加载。

为了改善用户体验和为开发人员提供更多工具,我们对此流程进行了扩展 - 增加了 JavaScript 调用以增加嵌入流程的阶段

  1. 预加载。在显示嵌入的对象前,powerbi.preload() 调用将使用浏览器缓存并下载脚本。对于托管多个嵌入报表的应用程序而言,这非常有用。预加载完成后将触发“就绪”事件
  2. 加载元数据。向用户显示嵌入的对象前,powerbi.load() 调用会检索嵌入的对象中的信息,动态更改后台的设置或 <div> 元素。例如,可以使用此函数获取页面,然后决定向用户显示哪一个页面。或者,可以使用 get visuals,然后决定要显示或隐藏哪些视觉对象。要使用此功能,需要调用 render() 函数以显示嵌入的对象。 加载完成后将触发“已加载”事件
  3. 呈现对象。如果已实现 powerbi.load() 函数,则最后的调用为 render()。它将完成向用户呈现并显示嵌入的对象所需的最后操作。呈现完成后将触发“已呈现”事件

虽然 load 和 render 函数必须一起使用,但 preload 与它们是相互独立的。预加载后,可以使用 embed 函数来显示嵌入的对象。 还可以通过分别调用 preload、load 和 render 来使用完整的分阶段过程

  • Power BI Embedded
  • Features

相关产品