当前位置 > 支持 > 帮助中心 > Powerbi 帮助手册 > 在 Power BI 中进行开发 > Power BI 视觉对象 > 向自定义视觉对象添加功能

Power BI 视觉对象中的“分析”窗格

版本：2023.1(当前版本)

通过“分析”窗格，可以将动态参考行（最小值、最大值、平均值等）添加到视觉对象。这些行可帮助你详细了解重要趋势或见解。本文讨论如何创建 Power BI 视觉对象，这些视觉对象可在“分析”窗格中显示和管理动态参考行。

“分析”窗格的屏幕截图。

备注

“分析”窗格自 API 版本 2.5.0 开始提供。若要了解正在使用的版本，请检查 pbiviz.json 文件中的 apiVersion。

管理“分析”窗格

在“分析”窗格和“格式”窗格中，属性的管理方式非常相似。可在视觉对象的 capabilities.json 文件中定义一个对象。

对于“分析”窗格，对象定义如下：

API 5.1+
使用 FormattingModel Utils
不使用 FormattingModel Utils
旧版 API（5.1 之前的版本）

在对象的定义下，仅添加对象名称、属性名称和类型，如此处所示。示例：

JSON复制

{  "objects": {    "YourAnalyticsPropertiesCard": {      "properties": {        "show": {          "type": {            "bool": true
          }
        },        "displayName": {          "type": {            "text": true
          }
        },
      ... //any other properties for your Analytics card
      }
    }
  ...
  }
}

在格式设置卡片中，指定此卡片属于分析窗格，方法是将卡片 analyticsPane 参数设置为 true。默认情况下，卡片 analyticsPane 参数为 false，卡片将添加到格式设置窗格，请参阅以下实现：

定义其他属性的方式与定义“格式”对象的方式相同，并且定义枚举对象的方式与在“格式”窗格中的执行方式相同。

备注

仅为用于添加新信息或进一步阐述显示的信息的对象使用“分析”窗格（例如，说明重要趋势的动态参考线）。
控制视觉对象外观的任何选项（即格式设置）都应限制为“格式设置”窗格。

注意事项和限制

“分析”窗格尚无多实例支持。对象的选择器只能是静态选择器（即 selector: null），并且 Power BI 视觉对象不能有用户定义的多个卡片实例。
类型 integer 的属性显示不正确。一种解决方法是，改用类型 numeric。