Power BI 视觉对象中的高级编辑模式

  • 版本 :2023.1(当前版本)

Power BI 视觉对象中的高级编辑模式

在“高级编辑”模式下,可以在 Power BI 视觉对象中使用高级 UI 控件。 在“报表编辑”模式下,选择视觉对象上的“编辑”按钮,然后选择“高级编辑”模式。 视觉对象使用 EditMode 标志来确定视觉对象是否显示“编辑 UI”控件。

Power BI 视觉对象的屏幕截图,其中显示了视觉对象菜单中的“编辑”按钮。

默认情况下,视觉对象不支持“高级编辑”模式 ("advancedEditModeSupport: 0")。 若要启用“高级编辑”模式,请向视觉对象的 capabilities.json 文件添加一行来设置 advancedEditModeSupport 属性。

可能的值包括:

  • 0 - NotSupported。 视觉对象不支持高级编辑模式。 此视觉对象上未显示“编辑”按钮。

  • 1 - SupportedNoAction。 该视觉对象支持“高级编辑”模式,且无需进一步更改。 Power BI 不会将该视觉对象切换到“焦点”模式。 开发人员可能使用此设置作为外部按钮,在同一视窗中运行多个进程。

  • 2 - SupportedInFocus。 此视觉对象支持高级编辑模式,并且在进入高级编辑模式时要求主机进入“焦点”模式 。

进入高级编辑模式

在以下情况下,显示“编辑”按钮:

  • 在 capabilities.json 文件中将 advancedEditModeSupport 属性设置为 SupportedNoActionSupportedInFocus

  • 在报表编辑模式下查看视觉对象。

如果 capabilities.json 文件中缺少属性 advancedEditModeSupport 或将其设置为 NotSupported,则不显示“编辑”按钮。

选择“编辑”时,视觉对象将获取 update() 调用,并将 EditMode 设置为 Advanced。 根据 capabilities.json 文件中设置的值,将发生以下操作

  • SupportedNoAction:主机不需要进一步操作。

  • SupportedInFocus:主机以焦点模式弹出视觉对象。

退出高级编辑模式

如果在 capabilities.json 文件中将 advancedEditModeSupport 属性设置为了 SupportedInFocus,则显示“返回报表”按钮。