存取 Azure DevOps 中分析的許可權和必要條件
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
若要使用 Analytics 並建立報告，必須符合數個必要條件，如本文摘要說明。
根據預設，所有專案成員都會存取其所屬專案的 Analytics 數據，包括新增至專案 讀者 群組的成員。 具有 項目關係人 存取權的用戶無法檢視或編輯分析檢視。
服務與功能啟用
一般而言，分析一律開啟，可供組織或集合的成員檢視數據及建立報表。
分析服務
針對 Azure DevOps Services，分析一律為開啟。 您無法停用或暫停它。
針對 Azure DevOps Server 2020 和更新版本的內部部署版本，Analytics 會自動隨您所建立的每個專案集合一起安裝。
針對 Azure DevOps Server 2019，您必須先在您所建立的每個專案集合上安裝 Analytics。
您可以暫停並重新啟動服務。 暫停時，不會將任何新數據新增至 Analytics。
如需詳細資訊，請參閱 安裝或啟用 Analytics 服務。
Azure DevOps 服務
若要練習任何 Azure DevOps 服務，必須啟用它。 已停用的服務無法擷取任何數據。 您可以依專案依項目啟用或停用服務。
若要確認所有服務都已啟用，請參閱 開啟或關閉服務。
分析檢視
分析檢視是入口網站中的中樞，提供簡化的方式，可根據分析數據指定Power BI報表的篩選準則。 如需詳細資訊，請參閱 什麼是 Analytics Service？
若要存取 分析檢視，您必須啟用它。 Project Collection Administrators 群組的組織擁有者或成員可以為組織中的每個人啟用它。 或者，每個項目成員都可以自行啟用它。
若要瞭解如何，請參閱 管理或啟用功能。
權限
您可以在專案層級設定服務的許可權，以及在物件層級設定共用分析檢視的許可權。
下表摘要說明可供設定的許可權，以及對專案安全組進行的預設指派。
| 權限 | 讀取者 | 參與者 | 專案管理員 |
|---|---|---|---|
| 檢視分析 | ✔️ | ✔️ | ✔️ |
| 檢視共用分析檢視 | ✔️ | ✔️ | |
| 新增私人或共用分析檢視 | ✔️ | ✔️ | |
| 編輯和刪除共用分析檢視 | ✔️ |
數據追蹤必要條件
若要擷取有意義的數據，軟體小組必須執行有意義的動作。 下列各節會根據您要報告的數據類型提供一般建議。
注意
Analytics v3.0-preview 和更新版本支援分支、管線和測試實體集。 使用 Analytics v4.0-preview 版本新增了支援管線作業、工作代理程式要求和工作代理程式集區的快照集。 請確定您指定支援相關實體集的分析版本。
若要瞭解您可以篩選或分組數據的屬性和列舉清單值， 請瀏覽對應實體類型的 Analytics 元數據 。
Azure Boards 和工作追蹤
如需您可以查詢之可用實體集的檢閱，請參閱 Azure Boards 分析的元數據參考。
若要報告工作追蹤，小組必須執行數項工作，以確保有有意義的數據可供使用。 在定義分析查詢和報表之前，請先檢閱下列工作。
- 若要報告作用中的 Bug 或 Bug 趨勢，請定義 Bug 並更新 Bug 狀態 ，因為它已修正、驗證，然後關閉。
- 若要報告待辦專案工作或其他工作專案類型，請確定您定義這些工作專案，並在其從新的移至關閉時更新其 狀態 。 請考慮您將用來篩選或分組報表中數據的任何欄位或標籤，並確定已妥善定義且一致。
- 若要支持匯總報表，請確定產品待辦專案與工作/Bug 之間有父子連結，或功能或組合待辦專案及其子項目之間有父子連結。 如需詳細資訊，請參閱 組織待辦專案並將子工作項目對應至父代。
- 若要建立燒毀或燒毀報表，例如 Sprint 燒毀 或 發行燒毀，請確定您已瞭解如何篩選和分組報表中的數據。 燒毀/燒毀報告會參考
WorkItemsSnapshot實體集。 快照集實體集會模型化為每日快照集。 數據會根據指派日期所做的指派來匯總。 這表示，若要根據欄位或標記指派來篩選燒毀/燒毀報表，您必須在想要回報的期間之前指派欄位或標籤。 否則，在套用字段/標記的日期之前，報表不會註冊這些字段/標記。 - 若要支援 需求追蹤，請定義測試案例，並從每個測試案例建立 Test By 連結至使用者案例、產品待辦專案或需求。 使用 [測試依據] 鏈接，定義測試案例，並將測試案例連結至其父 PBIS。 請參閱建立測試。
- （建議）若要支援在報表內篩選和分組，請將區域路徑和反覆專案指派給所有工作專案。 如需如何定義反覆專案和區域路徑的資訊，請參閱 定義區域路徑並指派給小組 或 定義反覆專案路徑（短期衝刺），以及設定小組反覆專案。
注意
新增至工作項目類型的所有自定義欄位都可用於報表。 自定義欄位會標示為 Custom_DisplayNameOfField，其中所有空格都已從顯示名稱中移除。
測試計劃
若要檢閱測試計劃進度和測試案例整備程度，小組必須執行下列活動。
- 定義測試案例、測試計劃和測試套件，並指定其目前狀態。 如需詳細資訊，請參閱 建立測試計劃和測試套件 和 建立測試案例。
- 將測試物件的狀態從 [設計] 更新為 [已就緒] 至 [已關閉]。
- 針對手動測試，將測試案例中每個驗證步驟的結果標示為通過或失敗。
提示
如果測試人員是驗證測試步驟，則必須標示狀態為測試步驟的測試步驟。 測試的整體結果會反映已標記之所有測試步驟的狀態。 因此，如果任何測試步驟標示為失敗或未標示，測試將會有失敗的狀態。
- 針對自動化測試，每個測試都會自動標示為通過或失敗。
- （建議）若要支援在報表內篩選和分組，請將區域路徑和反覆專案路徑指派給測試案例、測試套件和測試計劃。
管線
若要報告管線，小組必須使用 YAML 定義管線，並定期執行管線。 如需詳細資訊，請參閱 新 Azure Pipelines 使用者的重要概念。
此外，請考慮下列動作：
- 請考慮您要報告哪些數據，然後選擇正確的實體集。 如需要查詢之可用實體集的檢閱，請參閱 Azure Pipelines Analytics 的元數據參考。
- 請考慮您要報告哪些管線，以及報表的日期範圍。 您會想要篩選數據，以符合 查詢最佳做法 ，並將任何效能問題降到最低。
管線和測試
若要報告管線和測試結果，請務必將測試工作新增至管線定義。 如需詳細資訊，請參閱 建置和發行工作-測試。
如果您剛開始使用，請考慮檢閱此 Learn 課程模組： 使用 Azure Pipelines 在組建管線中執行質量測試。