通过

Power BI 视觉对象 API 更改日志

  • 项目

本页面简要汇总了现有的 API 版本，还介绍了即将发布的版本中的预期内容。 此处列出的版本被视为稳定版本，不会更改。

API v5.10.0

  • DataViewMetadataColumn 具有名为 sourceFieldParameters 的新属性。 该属性指示当前字段是否为某个字段参数的结果。 如果单个字段可能源自多个字段参数，则该属性将列出所有相关字段参数。
  • 支持 Desktop 2024 年 6 月版

API v5.9.1

  • acquireAADTokenService：增强了功能以支持以下云。
    • 商业云
    • 中国云
    • 美国政府社区云
    • 美国政府社区云高
    • 美国国防部云

API v5.9.0

  • 层次结构标识筛选器 API：让你能够创建视觉对象，从而使用矩阵 DataView 映射并根据使用层次结构的数据点筛选数据。 这对于利用分组键语义模型，并且希望基于数据点筛选层次结构的自定义视觉对象非常实用。
  • acquireAADTokenService：进行了扩展以包含更多属性
  • 支持 Desktop 2024 年 3 月版

API v5.8.0

  • 本地存储 API：新版本的本地存储 API 可用于所有自定义视觉对象，并由默认打开的全局设置控制。 管理员可关闭全局设置以禁用旧版 API 和新版本的 API。
  • 对自定义视觉对象的对象上支持：使用自定义视觉对象的对象上支持来优化用户体验，并提供与开箱即用的视觉对象相当的统一创作体验。
  • 支持 2024 年 2 月的桌面版

API v5.7.0

  • Power BI 自定义视觉对象身份验证 API：使自定义视觉对象可通过单一登录 (SSO) 获取 Microsoft Entra 访问令牌，从而促进安全高效的用户上下文操作。
  • 动态钻取控件：视觉对象可通过此功能使用 API 调用来动态启用或禁用钻取功能。
    • 启用钻取功能后，可以使用向下钻取和展开/折叠功能的所有功能。 这些功能包括 API 调用、上下文菜单命令、标头钻取按钮以及对层次结构数据的支持。
    • 禁用钻取功能后，这些功能不可用。
  • 支持 Desktop 2023 年 12 月版

API v5.4.0

API v5.3.0

  • 有关矩阵 dataView 的 SelectionId 更新修复。

    注意

    selectionId 的核心数据可能会发生变化。 因此使用旧版 API 的持久性 selectionIds/identityIndex 可能与矩阵视觉对象无关。

  • downloadService：添加一个新方法 exportVisualsContentExtended，该方法返回下载的扩展结果信息。
  • 支持 Desktop 2023 年 3 月版

API v5.2.0

  • 自定义数据缩减 - 此功能添加到 capabilities.json 架构中，允许报表作者的自定义可视化代码动态修改数据提取窗口。
  • 支持 Desktop 2022 年 12 月版

API v5.1.0

  • 自定义排序 - 改进了表的自定义排序功能
  • 小计 - 新的小计类型指示是否应在检索其余数据之前或之后检索总计
  • 标识筛选器 - 筛选分类数据
  • 新格式窗格 - 设计支持新格式窗格设计的自定义视觉对象
  • 支持 Desktop 2022 年 10 月版

API v4.7.0

  • 许可 API - 直接通过商业市场销售、管理和强制实施许可证。
  • 向下钻取 API - 创建一个视觉对象，该视觉对象可以自行触发向下钻取操作，而无需用户交互。
  • 支持 Desktop 2022 7 月版

API v4.6.0

  • 新的功能属性：特权和两个特权：
    • Web 访问
    • 从自定义视觉对象下载文件
  • 添加了两个相应的租户管理开关
  • 下载 API 以允许将视觉对象下载到文件
  • 支持 Desktop 2022 年 6 月版

API v4.2.0

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

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 v2.2.0

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：

    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

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 版本