通过

启用持久筛选器

  • 项目

在为组织嵌入的报表中，启用永久性筛选器功能后，报表会保留其状态，包括筛选器、切片器和其他数据视图更改。 当用户打开报表时，保存的用户状态将加载到报表中。 此外，如果启用了持久筛选器，则用户在不同的方案中获得相同的用户状态。

若要在嵌入方案中重置永久性筛选器，需要实现按钮并使用 resetPersistentFilters API，或显示操作栏以获取 Power BI 重置为操作栏上的默认 按钮。

如何启用持久筛选器

默认情况下禁用持久性筛选器。 若要启用持久性筛选器，请遵循本部分中的步骤。

  1. 验证是否在 Power BI 服务或桌面的报表设置中启用了持久性筛选器。

  2. 验证 Azure Active Directory （Azure AD） 应用是否具有 UserState.ReadWrite.All 权限。

  3. 将 persistentFiltersEnabled 属性设置为 true。

    let config = {
        type: 'report',
        ...
        settings: {
            persistentFiltersEnabled: true
        }
    };

如果状态存在，则报表将加载最新用户的报表状态。 用户的报告状态在 60 秒后自动保存，没有任何更改。

注意

仅保存对现有筛选器的更新。 不会保存由 setFilters API 添加的新筛选器。

持久筛选器 API

重置持久筛选器

重置用户的筛选器、切片器和其他数据视图更改，以更改报表的默认状态。

    resetPersistentFilters(): Promise<void>

保存持久筛选器

保存用户的报表筛选器、切片器和其他数据视图更改。

    savePersistentFilters(): Promise<void>

应用的持久筛选器

如果报表存在，则返回用户的筛选器、切片器或其他数据视图更改。 如果禁用持久性筛选器，则返回 false。

可以使用此 API 来确定重置按钮状态。

    arePersistentFiltersApplied(): Promise<boolean>

注意事项和限制

仅组织（用户拥有数据）解决方案的 嵌入支持持久性筛选器。

相关内容