使用 Power BI 实例

了解如何获取或重置 Power BI 实例。 例如,可能需要获取报表实例才能设置筛选器。

获取对现有 Power BI 组件的引用

当给定 <div>上已有嵌入项时,powerbi.get 方法用于检索嵌入的实例。

通常,可以使用 powerbi.embedpowerbi.bootstrap 方法获取 Power BI 项实例(如报表)。 但是,如果需要在嵌入报表 后 获取项实例,则可能无法使用这些实例。 在这些情况下,请使用 get 方法检索实例。

JavaScript
let report = powerbi.get(element);

重置元素

如果已在元素中嵌入报表,并且想要将元素重置回其初始状态,请调用:

JavaScript
powerbi.reset(element);

此方法从服务中删除嵌入并删除 iframe,这是防止服务保留 DOM 中不存在的引用所必需的。 通常需要在父元素从 DOM 中删除包含元素之前调用重置。