在 Azure DevOps 中存取 Analytics 的許可權和必要條件

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

若要使用 Analytics 並建立報告，必須符合數個必要條件，如本文摘要所述。

根據預設，所有專案成員都會針對其所屬專案提供分析資料的存取權，包括新增至專案 讀者 群組的成員。 具有專案關係人存取權的使用者無法存取檢視或編輯分析檢視。

服務與功能啟用

一般而言，分析一律為開啟，可供組織或集合的成員檢視資料及建立報表。

分析服務

針對Azure DevOps Services，分析一律為開啟。 您無法將其停用或暫停。

Azure DevOps 服務

若要練習任何 Azure DevOps 服務，必須啟用它。 無法針對已停用的服務擷取任何資料。 您可以依專案依專案啟用或停用服務。

若要確認所有服務都已啟用，請參閱 開啟或關閉服務。

分析檢視

入口網站中的分析檢視是入口網站中的中樞，可讓您根據分析資料指定 Power BI 報表的篩選準則。 若要深入瞭解，請參閱 什麼是分析服務？

若要存取 分析檢視，您必須啟用它。 Project Collection Administrators 群組的組織擁有者或成員可以為組織中的每個人啟用它。 或者，每個專案成員都可以自行啟用它。

若要瞭解如何，請參閱 管理或啟用功能。

權限

您可以在專案層級設定服務 的許可權 ，以及在物件層級設定共用 分析檢視 的許可權。

下表摘要說明要設定的許可權，以及對專案安全性群組所做的預設指派。

權限	讀取者	參與者	Project Administrators
檢視分析	✔️	✔️	✔️
檢視共用分析檢視		✔️	✔️
新增私人或共用分析檢視		✔️	✔️
編輯和刪除共用分析檢視			✔️

資料追蹤必要條件

若要擷取有意義的資料，軟體小組必須執行有意義的動作。 下列各節會根據您想要報告的資料類型提供一般建議。

注意

Analytics v3.0-preview 和更新版本支援分支、管線和測試實體集。 快照集實體集可支援管線作業、工作代理程式要求和工作代理程式組件區大小，已使用 Analytics v4.0-preview 版本新增。 請確定您指定支援相關實體集的分析版本。

若要瞭解您可以篩選或分組資料的屬性和列舉清單值，請探索對應實體類型的 Analytics 中繼資料 。

Azure Boards和工作追蹤

如需您可以查詢的可用實體集檢閱，請參閱Azure Boards Analytics 的中繼資料參考。

若要報告工作追蹤，小組必須執行數項工作，以確保有有意義的資料可供使用。 在定義 Analytics 查詢和報表之前，請先檢閱下列工作。

• 若要報告作用中的 Bug 或 Bug 趨勢，請定義 Bug，並在修正、驗證後更新 Bug 狀態 ，然後關閉。
• 若要報告待辦專案工作或其他工作專案類型，請確定您定義這些工作專案，並在其從新的移至關閉時更新其 狀態 。 請考慮您將用來篩選或分組報表中資料的任何欄位或標籤，並確定已妥善定義且一致。
• 若要支援匯總報表，請確定產品待辦專案和工作/Bug 之間有父子連結，或功能或組合待辦專案工作專案與其子專案之間存在父子連結。 若要深入瞭解，請參閱 組織待辦專案，並將子工作專案對應至父系。
• 若要建立待用或待處理報表，例如 Sprint 待用或 發行待用 ，請確定您已思考過要如何篩選和分組報表中的資料。 待用/待用報告會參考 WorkItemsSnapshot 實體集。 快照集實體集會模型化為每日快照集。 資料會根據指派日期所做的指派進行匯總。 這表示若要根據欄位或標記指派來篩選待辦專案/待辦專案報告，您必須在想要報告期間之前指派欄位或標籤。 否則，在套用欄位/標記的日期之前，報表不會註冊欄位/標記。
• 若要支援 需求追蹤，請定義測試案例，並從每個測試案例建立 測試 依據連結至使用者劇本、產品待辦專案或需求。 定義測試案例，並使用 [測試者] 連結將測試案例連結至其父 PBI。 請參閱建立測試。
• (建議) 若要支援篩選和分組報表內，請將 [區域路徑 ] 和 [ 反復專案路徑 ] 指派給所有工作專案。 如需如何定義反復專案和區域路徑的資訊，請參閱 定義區域路徑並指派給小組 或定義反覆運算 路徑， (短期衝刺) 和設定小組反復專案。

注意

新增至工作專案類型的所有自訂欄位都可用於報表。 自訂欄位會標示 為Custom_DisplayNameOfField，其中所有空格都已從顯示名稱中移除。

測試計劃

若要檢閱測試計劃進度和測試案例整備程度，小組必須執行下列活動。

• 定義測試案例、測試計劃和測試套件，並指定其目前狀態。 若要深入瞭解，請參閱 建立測試計劃和測試套件 和 建立測試案例。
• 將測試物件的 狀態 從 [設計 ] 更新為 [ 就緒 ] 至 [已關閉]。
• 在手動測試中，將測試案例中每個驗證步驟的結果標記為成功或失敗。

  提示

  如果測試步驟是驗證測試步驟，則測試人員必須將該測試步驟標上狀態。 測試的整體結果會反映已標記的所有測試步驟狀態。 因此，如果有任何測試步驟標記為失敗或未標記，則測試會變成失敗狀態。

• 在自動化測試中，每項測試都會自動標記為成功或失敗。
• (建議) 若要支援篩選和分組報表內，請指派 區域路徑 和 反復專案路徑 給測試案例、測試套件和測試計劃。

Pipelines

若要報告管線，小組必須使用 YAML 定義管線，並定期執行管線。 若要深入瞭解，請參閱 新 Azure Pipelines 使用者的重要概念。

此外，請考慮下列動作：

• 請考慮您要報告哪些資料，然後選擇正確的實體集。 如需要查詢的可用實體集檢閱，請參閱 Azure Pipelines Analytics 的中繼資料參考。
• 請考慮您要報告哪些管線，以及報表的日期範圍。 您想要篩選資料，以符合 查詢最佳做法 ，並將任何效能問題降至最低。

管線和測試

若要報告管線和測試結果，請務必將測試工作新增至管線定義。 若要深入瞭解，請參閱 建置和發行工作-測試。

如果您剛開始使用，請考慮檢閱此 Learn 課程模組： 使用 Azure Pipelines 在組建管線中執行品質測試。

相關文章

• 什麼是分析服務？
• Azure DevOps 的預設權限快速參考
• 查詢分析服務時使用的最佳做法