建立 Azure DevOps 的分析小工具
Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019
您可以建置自己的 Analytics 小工具,以在 Azure DevOps 的 儀錶板 中顯示。 github 上的 範例小工具 示範:
- 如何呈現與工作項目狀態相關聯的趨勢線
- 如何查詢數據集,使用者將會透過小工具組態檢視進行設定
- 如何建置小工具並將其發佈至 Azure DevOps Marketplace
利用這項資訊,您將能夠建立自己的分析小工具。
的預覽
注意
所有 Azure DevOps Services 的生產環境中都會自動啟用及支援 Analytics 服務。
Power BI 整合 以及存取 OData 資料饋送 的 Analytics Service 現已全面上市。 我們鼓勵您使用它,並提供意見反應給我們。
可用的數據與版本相關。 最新支援的版本是 v2.0
,而最新的預覽版本則 v4.0-preview
。 如需詳細資訊,請參閱 OData API 版本設定。
注意
Azure DevOps Server 2020 和更新版本的所有新專案集合都會在生產環境中自動安裝並支援 Analytics 服務。 Power BI 整合 以及存取 OData 資料饋送 的 Analytics Service 現已全面上市。 我們鼓勵您使用它,並提供意見反應給我們。 如果您從 Azure DevOps Server 2019 升級,則可以在升級期間安裝 Analytics 服務。
可用的數據與版本相關。 最新支援的版本是 v2.0
,而最新的預覽版本則 v4.0-preview
。 如需詳細資訊,請參閱 OData API 版本設定。
先決條件
類別 | 要求 |
---|---|
存取層級 |
-
專案成員。 - 至少 基礎 存取權。 |
許可權 | 根據預設,項目成員具有查詢分析及建立檢視的許可權。 如需有關服務與功能啟用和一般數據追蹤活動之其他必要條件的詳細資訊,請參閱 存取 Analytics的許可權和必要條件。 |
本文中的範例提供現成的小工具,涵蓋儀錶板、圖表和分析主題的基本概念。 下列文件提供更詳細的說明,關於此範例所示範的內容:
- 建立 Azure DevOps Widget 擴充功能,參考 Widget 擴充功能範例
- 呈現 Azure DevOps 圖表控制項,參考 以新增圖表
- 查詢 Analytics 的 OData
提供組態檢視
- 執行配置檢視所需的UI控制項的簡單分析查詢。
- 管理組態 UI的狀態,其中包含以使用者動作為基礎的更新,以及來自 Analytics 查詢的新數據。
- 使用 Typescript 和 React 渲染配置 UI。
在元件內呈現資料
後續步驟
為了避免範例中的過度複雜度,我們省略了某些技術和做法,生產小工具當然應該包含這些技術與做法。 github 上的 ui-fabric-react 範例展示運用這些詳細數據的建置過程。
- JavaScript 組合和內容縮減 - 範例中的一組小型鬆散腳本檔案可以在合併成單一檔案並縮製時更快載入。
- Fabric UI 控制項 - Fabric UI 控制項為 React 提供豐富的配置 UI 元件。