共用方式為

Power BI 視覺效果 API 變更記錄

  • 發行項

此頁面包含現有 API 版本以及即將推出的版本中的預期內容的簡短摘要。 此處所列的版本會視為穩定，且不會變更。

API v5.10.0

  • DataViewMetadataColumn 有一個名為 sourceFieldParameters 的新屬性。 此屬性指示目前欄位是否為欄位參數的結果。 如果單一欄位可以源自多個欄位參數，則此屬性會列出所有相關欄位參數。
  • 支援桌面版 (2024 年 6 月)

API v5.9.1

  • acquireAADTokenService：已增強以支援下列雲端。
    • 商業雲端
    • 中國雲端
    • 美國 Government Community Cloud
    • 美國政府社群雲端 - 高
    • 美國國防部雲端

API v5.9.0

  • 階層式身分識別篩選 API：可讓您建立使用 Matrix DataView Mapping 的視覺效果，根據使用階層式結構的數據點來篩選數據。 這對於利用分組索引鍵語意模型並希望根據資料點篩選階層的自訂視覺效果非常有用。
  • acquireAADTokenService：已擴充其他屬性
  • 支援桌面版 (2024 年 3 月)

API v5.8.0

  • 本機儲存體 API：新版本的本機儲存體 API 可用於所有自訂視覺效果，並由預設開啟的全域設定所控制。 系統管理員可以關閉全域設定以停用舊版 API 和新版本的 API。
  • 對自訂視覺效果的在物件上支援：對自訂視覺效果的在物件上支援，以最佳化使用者體驗並提供與現成可用的視覺效果相媲美的統一撰寫體驗。
  • 支援桌面版 (2024 年 2 月)

API v5.7.0

  • Power BI 自訂視覺效果驗證 API：允許自訂視覺效果透過單一登入 (SSO) 取得 Microsoft Entra 存取權杖，以幫助進行安全且有效率的使用者情境作業。
  • 動態鑽研控制項：允許視覺效果使用 API 呼叫來動態啟用或停用鑽研功能。
    • 啟用鑽研功能時，可以使用向下鑽研和展開/折疊功能的所有功能。 這些功能包括 API 呼叫、操作功能表命令、標頭鑽研按鈕，以及對階層資料的支援。
    • 停用鑽研功能時，無法使用這些功能。
  • 支援桌面版 (2023 年 12 月)

API v5.4.0

API v5.3.0

  • SelectionId 針對矩陣dataView 的更新修正。

    注意

    selectionId 的核心資料可能會變更。 因此，使用較舊 API 版本的持久性 selectionId/identityIndex 可能與矩陣視覺效果無關。

  • downloadService：新增方法exportVisualsContentExtended，其會傳回下載的擴充結果資訊。
  • 支援桌面版 (2023 年 3 月)

API v5.2.0

  • 自訂資料縮減 - 新增至 capability.json 結構描述中的這項功能可讓報表作者透過自訂視覺效果程式碼動態修改資料擷取視窗。
  • 支援桌面版 (2022 年 12 月)

API v5.1.0

  • 自訂排序 - 改善了資料表的自訂排序
  • 小計 - 新的小計類型指示是應在其餘資料之前還是之後擷取總計
  • 身分識別篩選 - 篩選分類資料
  • 新格式窗格 - 設計支援新格式窗格設計的自訂視覺效果
  • 支援桌面版 (2022 年 10 月)

API v4.7.0

  • 授權 API - 直接透過商業市集銷售、管理和強制執行授權。
  • 向下鑽研 API - 建立一個可自行觸發向下鑽研作業的視覺效果，無需使用者互動。
  • 支援桌面版 (2022 年 7 月)

API v4.6.0

  • 新的功能屬性：權限和兩個權限：
    • Web 存取
    • 從自訂視覺效果下載檔案
  • 已新增兩個對應的租用戶系統管理員參數
  • 下載 API，以允許將視覺效果下載到檔案中
  • 支援桌面版 (2022 年 6 月)

API v4.2.0

API v3.8.0

  • 支援桌面版 (2021 年 5 月和更新版本)。

API v3.7.0

  • 支援桌面版 (2021 年 4 月和更新版本)。

API v3.6.0

  • Visual 可以從 Power BI 接收更新，無需繫結任何資料。
  • 支援桌面版 (2021 年 2 月和更新版本)。
  • 支援桌面 RS 版 (2021 年 5 月和更新版本)。

API v3.4.0

  • fetchMoreData：新的 aggregateSegments 參數 (預設為 true)，用於支援無彙總 fetchMoreData
  • 支援桌面版 (2020 年 11 月和更新版本)。
  • 支援桌面 RS 版 (2021 年 1 月和更新版本)。

API v3.2.0

  • 支援 supportsMultiVisualSelection
  • 支援桌面版 (2019 年 9 月和更新版本)。
  • 支援桌面 RS 版 (2020 年 1 月和更新版本)。

API v2.6.0

  • 加入 isInFocus 以更新選項，並將 switchFocusModeState 方法加入至視覺效果主機
  • 支援小計自訂
  • 支援桌面版 (2019 年 6 月和更新版本)。
  • 支援桌面 RS 版 (2019 年 5 月和更新版本)。

API v2.5.0

  • 支援分析窗格
  • 支援 SelectionIdBuilderwithMatrixNode 與 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 屬性不會再將隱藏的 metadata\data 儲存在 dataView 內。 透過 proto 存取屬性的視覺效果，可能因此更新而中斷。

API v1.13.0

API v1.12.0

API v1.11.0

API v1.10.0

  • 加入 ILocalizationManager
  • 驗證 API

API v1.9.0

API v1.8.0

  • 支援功能結構描述中的新類型 fillRule (漸層)
  • 支援物件屬性之功能結構描述中的規則屬性

API v1.7.0

API 1.6.2 版

API 1.5.0 版

API 1.4.0 版

API 1.3.0 版

API 1.2.0 版

  • 新增 colorPalette，以管理您視覺效果上所使用的色彩。
  • 支援多重選取項目 - selectionManager 可以接受 SelectionId 的陣列。
  • 支援使用 R 指令碼的 R 視覺效果

API 1.1.0 版

  • 支援在 iFrame 中針對視覺效果進行偵錯
  • 使用更快速的 iFrame 初始化來新增輕量型沙盒
  • 修正 Capabilities.objects 不支援 "text" 類型 \(英文\) 的問題
  • 支援 pbiviz update 以更新視覺效果 API 類型定義與結構描述
  • 支援 pbiviz new 中的 --api-version 旗標，以使用特定 API 版本建立視覺效果
  • 支援 API 1.2.0 版的 Alpha 版本

視覺效果主機

  • 新增 createSelectionIdBuilder，以建立用於資料選擇的唯一識別碼
  • 新增 createSelectionManager 來管理視覺效果的選取狀態，並將變更傳達給視覺效果主機
  • 新增用於視覺效果中的預設色彩陣列

API 1.0.0 版

  • 初始 API 版本