在没有数据绑定的情况下创建自定义 Power BI 视觉对象

  • 版本 :2023.1(当前版本)

在没有数据绑定的情况下创建自定义 Power BI 视觉对象

本文介绍如何使用“无数据绑定”功能创建没有数据角色的 Power BI 自定义视觉对象。 通常,在 Power BI 报表内创建视觉对象时,可向“可视化效果”窗格上的“值”井中添加数据字段,以交互方式定义值。

Power BI 视觉对象的屏幕截图,其中显示了“可视化效果”窗格中的“值”井。

默认情况下,如果未定义任何值,格式设置将处于禁用状态,并且无法更新视觉对象的格式。

通过 模型的 dataRoles 属性,无需绑定数据即可在 Power BI 中设置图形格式。

通过使用 dataRoles capabilities 属性,可以呈现视觉对象以及使用 update 方法更改格式设置。 即使数据存储桶为空,或者视觉对象不使用任何数据角色,也可以更改设置。

以下选项卡显示了两个 Power BI 视觉对象示例。 一个视觉对象需要绑定数据,另一个视觉对象使用“无数据角色”功能并且不需要绑定数据。

  • 需要绑定数据

  • 不需要绑定数据

当需要绑定数据时,如果没有数据角色或数据井为空,则会禁用格式设置。

Power BI 视觉对象的屏幕截图,其中显示了“可视化效果”窗格中的空数据和非活动视觉对象设置。

如何创建不需要数据绑定的视觉对象

备注

此功能可从 API 版本 3.6.0 及更高版本获取。

若要启用“无数据绑定”功能,请将 capabilities.json 文件中的以下两个参数设置为 true

  • 通过 supportsLandingPage,可在 Power BI 卡片加载数据之前在上面显示信息。

  • 通过 supportsEmptyDataView,可在值字段为空时更新 Power BI。

JSON复制

    {        "supportsLandingPage": true,        "supportsEmptyDataView": true,
}