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

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

Screenshot of a Power BI visual that shows the Values well in the Visualizations pane.

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

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

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

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

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

Screenshot of a Power BI visual that shows empty data and inactive visual settings in the Visualizations pane.

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

注意

此功能可从 API 版本 3.6.0 及更高版本获取。若要了解正在使用的版本，请检查 pbiviz.json 文件中的 apiVersion。

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

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