建立 Azure DevOps 的分析小工具

  • 發行項

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

您可以建置自己的 Analytics 小工具，以在 Azure DevOps 的 儀表板 中顯示。 github 上的範例小工具示範：

  • 如何轉譯與工作專案狀態相關聯的趨勢線
  • 如何查詢資料集，讓使用者透過小工具組態檢視進行設定
  • 如何建置小工具並將其發佈至 Azure DevOps Marketplace

使用這項資訊，您將能夠建立自己的 Analytics 小工具。

使用 Widget 預覽設定的檢視

注意

所有Azure DevOps Services的生產環境中都會自動啟用及支援 Analytics 服務。 Power BI 整合及存取 Analytics Service 的OData 摘要已正式推出。 我們鼓勵您使用它，並提供意見反應給我們。 可用的資料與版本相關。 最新支援的版本是 v2.0 ，而最新的預覽版本是 v4.0-preview 。 如需詳細資訊，請參閱 OData API 版本設定。

注意

Azure DevOps Server 2020 版和更新版本的所有新專案集合，都會在生產環境中自動安裝及支援 Analytics 服務。 Power BI 整合及存取 Analytics Service 的OData 摘要已正式推出。 我們鼓勵您使用它，並提供意見反應給我們。 如果您從 Azure DevOps Server 2019 升級，您可以在升級期間安裝 Analytics 服務。

可用的資料與版本相關。 最新支援的版本是 v2.0 ，而最新的預覽版本是 v4.0-preview 。 如需詳細資訊，請參閱 OData API 版本設定。

注意

Azure DevOps Server 2019 的 Analytics 服務處於預覽狀態。 您可以為專案集合 啟用或安裝它 。 Power BI 整合 及存取 Analytics Service 的 OData 摘要 處於預覽狀態。 我們鼓勵您使用它，並提供意見反應給我們。

可用的資料與版本相關。 最新支援的版本是 v2.0 ，而最新的預覽版本是 v4.0-preview 。 如需詳細資訊，請參閱 OData API 版本設定。

必要條件

此範例提供現成的小工具，涵蓋儀表板、圖表和分析主題的基本概念。 下列檔提供此範例中示範的詳細資料：

  1. 建立 Azure DevOps Widget 擴充功能，參考 小工具延伸模組範例
  2. 轉譯 Azure DevOps 圖表控制項，參考 新增圖表
  3. 從分析查詢 OData

提供組態檢視

  1. 執行 UI 控制項用於設定檢視所需的簡單分析查詢。
  2. 使用以使用者動作為基礎的更新，以及來自 Analytics 查詢的新資料來管理設定UI 的狀態。
  3. 使用 Typescript 和 React轉譯組態 UI。

在小工具內轉譯資料

  1. 以POST 要求身分執行使用者設定的查詢
  2. 解譯分析的資料以 轉譯圖表

下一步

為了避免範例中過多的複雜度，我們省略了某些技術和做法，生產小工具應該包含這些技術與做法。 github 上的 ui-fabric-react 範例會醒目提示執行這些詳細資料的建置程式。

  1. JavaScript 統合和內容縮制 - 範例中的一組小型鬆散腳本檔案可在合併成單一檔案並縮制時更快載入。
  2. 網狀架構 UI 控制項 - 網狀架構UI 控制項提供一組豐富的組態 UI 元件，以供React使用。