Power BI 视觉对象 API 更改日志

此页面包含 API 版本的快速摘要。 此处列出的版本被视为稳定版本，不会更改。

API v5.1.0

• 自定义排序 - 改进了表的自定义排序功能

• 小计 - 新的小计类型指示是否应在检索其余数据之前或之后检索总计

• 标识筛选器 - 筛选分类数据

• 新格式窗格 - 设计支持新格式窗格设计的自定义视觉对象

• 支持 Desktop 2022 年 10 月版

API v4.7.0

• 许可 API - 直接通过商业市场销售、管理和强制实施许可证。

• 向下钻取 API - 创建一个视觉对象，该视觉对象可以自行触发向下钻取操作，而无需用户交互。

• 支持 Desktop 2022 7 月版

API v4.6.0

• 新的功能属性：特权和两个特权：

• Web 访问

• 从自定义视觉对象下载文件

• 添加了两个相应的租户管理开关

• 下载 API 以允许将视觉对象下载到文件

• 支持 Desktop 2021 6 月版

API v4.2.0

• 新的标志，用于展开和折叠行标题

• 支持 Desktop 2022 2 月版

API v3.8.0

• 支持 Desktop 2021 5 月版和更高版本。

API v3.7.0

• 支持 Desktop 2021 4 月版和更高版本。

API v3.6.0

• 视觉对象可从 Power BI 接收更新，无需绑定任何数据。

• 支持 Desktop 2021 2 月版和更高版本。

• 支持 Desktop RS 2021 5 月版和更高版本。

API v3.4.0

• fetchMoreData：新的 aggregateSegments 参数（默认为 True），用于支持无聚合 fetchMoreData

• 支持 Desktop 2020 11 月版和更高版本。

• 支持 Desktop RS 2021 1 月版和更高版本。

API v3.2.0

• 支持 supportsMultiVisualSelection

• 支持 Desktop 2019 9 月版和更高版本。

• 支持 Desktop RS 2020 1 月版和更高版本。

API v2.6.0

• 将 isInFocus 添加到更新选项，并将 switchFocusModeState 方法添加到视觉对象主机

• 支持“小计”自定义

• 支持 Desktop 2019 6 月版和更高版本。

• 支持 Desktop RS 2019 5 月版和更高版本。

API v2.5.0

• 支持分析窗格

• 支持 SelectionIdBuilder withMatrixNode 和 withTable 方法

• 不再支持 DataRepetitionSelector 接口，已替换为 data.CustomVisualOpaqueIdentity 接口

API v2.3.0

• 登陆页 API

• 本地存储 API

• 元组筛选器 API（多列筛选器）

• 呈现事件 API

API v2.2.0

• 支持 从数据视图还原 JSON 筛选器

• ContextMenu API

• 支持钻取功能

API v2.1.0

• 性能增强：

• 加载时间更快

• 内存占用情况更小

• 优化的数据和事件事务

发行说明

• 重构的筛选 API 将在 API 2.2 中提供，在 API 2.1 中不受支持。

• 视觉对象将仅接收在其功能中声明的 dataView 类型。 由于此更新，使用了多个 dataView 类型的视觉对象将中断。

• 不再支持 DataViewScopeIdentity 接口，已替换为 data.DataRepetitionSelector 接口。 如果使用了 DataViewScopeIdentity 接口的关键属性，则可使用 JSON.stringify(identity) 将其替换

• undefined 由 dataView 中的 null 替换。 使用 var item in myArray 循环访问数组时，它会跳到 undefined，但不会跳到 null。 此更新可能会破坏使用此模式的视觉对象。 确保检查数组中的 null：

  TypeScript复制

  for (var item in myArray) {   if (!item) {     continue;
     }   console.log(item);
  }
  

• proto 属性不再将隐藏的元数据/数据存储在 dataView 中。 通过 proto 访问属性的视觉对象可能会被此更新中断。

API v1.13.0

• 支持同步切片器 ，请注意，由于 PBI 当前代码状态，此方法仅适用于单字段切片器，了解更多信息。

• 辅助功能：高对比度支持

• 辅助功能：允许键盘焦点标志

API v1.12.0

• 支持主题

• 支持 fetchMoreData ，请注意，提取“更多的数据 API”克服 30000 数据点的硬限制

• 画布工具提示 API

API v1.11.0

• FilterManager API

• 支持书签

API v1.10.0

• 添加 ILocalizationManager

• 身份验证 API

API v1.9.0

• launchUrl API

API v1.8.0

• 支持功能架构中的新型 fillRule（渐变）

• 支持功能架构中对象属性的 rule 属性

API v1.7.0

• 支持 RESJSON

API v1.6.2

• 支持编辑模式 ，以使视觉对象进入可视编辑模式

• 支持基于 html 的 交互式 (html) R Power BI 视觉对象

API v1.5.0

• 支持允许交互 ，以实现视觉对象交互

API v1.4.0

• 支持 本地化

API v1.3.0

• 支持工具提示

API v1.2.0

• 添加 colorPalette，以管理视觉对象上使用的颜色。

• 支持多选 - selectionManager 可以接受 SelectionId 的数组。

• 支持使用 R 脚本的 R 视觉对象

API v1.1.0

• 支持 iFrame 中的调试视觉对象

• 通过更快地初始化 iFrame 来添加轻型沙盒

• 修复 Capabilities.objects 不支持“text”类型问题

• 支持 pbiviz update 以更新视觉对象 API 类型定义和架构

• 支持 pbiviz new 中的 --api-version 标志，以使用特定 API 版本创建视觉对象

• 支持 API v1.2.0 的 alpha 发布

视觉对象主机

• 添加 createSelectionIdBuilder，以创建用于数据选择的唯一标识符

• 添加 createSelectionManager 以管理视觉对象的选择状态，并将更改传达给视觉对象主机

• 添加要在视觉对象中使用的默认颜色数组

API v1.0.0

• 初始 API 版本