依 Azure Boards 和 Azure DevOps 中的數值字段進行查詢

發行項
04/06/2024

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

如何? 決定每位開發人員在小組中已完成多少工作？是否有方法可以總結反覆專案的工作或故事點？

最常見的數值欄位會追蹤 [需求] 類別或 [任務] 類別中項目的預估、剩餘和已完成工作的工作。透過查詢，您可以列出感興趣的工作專案，然後定義顯示工作項目計數或數值字段總和的圖表。

支援的運算子和宏

指定數值欄位的查詢子句可以使用下列運算符。

= 、 <> 、 > 、 < 、 >= 、 <=
=[Field]， <>[Field]， >[Field]， <[Field]， >=[Field]， =[Field]， <=[Field]
在中，不在
曾經

用於開發圖表型查詢的提示

您只能新增一般清單查詢的圖表
圖表選項會參考透過數據行選項顯示的查詢篩選或欄位
新增或修改圖表之前，先儲存您對查詢所做的變更。
若要將一或多個子句分組，請選取它們，然後選擇群組子句圖示。若要取消群組，請在群組子句上選取。

如需建立查詢和以圖表為基礎的查詢的詳細資訊，請參閱使用查詢編輯器來列出和管理查詢和圖表。如果您想要新增自定義欄位來追蹤並產生其他數值的總和，請參閱新增或修改欄位。

有用的篩選

篩選

包含這些查詢子句

用戶劇本或錯誤

Work Item Type In User Story,Bug

工作或 Bug

Work Item Type In Task,Bug

使用中或已關閉的專案

State In Active,Closed

需求類別中的專案

Work Item Type In Group Microsoft.RequirementCategory

未擷取的用戶劇本

Story Points <> (leave Value field blank)

工作專案計數查詢和圖表

當您執行查詢時，所有查詢都會顯示專案計數。在這裡，我們會定義一般清單查詢，以篩選任何狀態中的 Bug。

此外，所有圖表都包含值選取專案，其設計目的是要顯示圖表內的工作項目計數。

每個開發人員的錯誤計數

建立作用中的 Bug 查詢，並修改數據行選項以顯示 [指派給] 和 [狀態]。然後，新增顯示指派和狀態的樞紐分析圖。

依狀態和區域的 Bug 計數

使用篩選上一節中所顯示 Bug 的相同一般清單查詢，您可以根據區域顯示計數。修改資料列選項以顯示區域路徑。然後，新增顯示狀態和區域路徑的樞紐分析圖。

未定義的域值查詢

您可以使用 equals 運算子（=）找到具有未定義域值的工作專案，並將欄位的 Value 保留空白。例如，下列篩選會列出 [用戶劇本] 字段空白之類型的所有工作專案。

若要根據不是空白的欄位列出工作專案，請使用 not 運算元（<>），並將 [值] 保留空白。

工作或故事點查詢和圖表

您可以在敏捷式程式中工作時，將 Story Points 指派給用戶劇本或 Bug。或者，當您在 Scrum 程式中工作時，努力產品待辦專案和 Bug。如需詳細資訊，請參閱基本、敏捷式、Scrum 或 CMMI 工作項目類型和工作流程文章。

故事點及其狀態的總和

建立查詢，篩選 User Story 作為工作項目類型，並修改數據行選項以顯示分鏡點和狀態。

然後，新增堆疊條形圖來加總故事點。

設定圖表對話框、堆疊條形圖、故事點總和

如需系統定義累計流程圖的資訊，請參閱累計流程。

逐一查看使用者劇本的圖表

建立查詢，以篩選 User Story 做為工作項目類型和作用中或已關閉狀態。修改數據行選項以顯示故事點。

然後，新增加總故事點的堆疊區域趨勢圖。

設定圖表對話框、趨勢、故事點的總和

剩餘和已完成的工作查詢和圖表

根據項目參考的程式，您可以將下列欄位指派給工作或 Bug。

處理	可用欄位
敏捷式	原始估計、剩餘工時、已完成工時
Scrum	剩餘工時
Cmmi	原始估計、剩餘工時、已完成工時

每位開發人員剩餘工時的總和

如果您遵循 Scrum 做法並預估工作和 Bug 的剩餘工時，您可以使用下列查詢和圖表，取得每個開發人員剩餘的工作量匯總。藉由使用 In 運算符並同時包含 Task 和 Bug，您就會包含正在追蹤為工作的任何 Bug。

將 [剩餘工時] 作為數據行選項新增至查詢並儲存。若要檢視剩餘工時的總和，請新增樞紐分析圖，如下所示。

如需系統定義短期衝刺燒毀圖表的相關信息，請參閱短期衝刺燒毀。

用來估計和追蹤工作的欄位

下表描述可用來追蹤工作的活動型和數值欄位。如需日期相關欄位的資訊，例如開始日期、完成日期和目標日期，請參閱依日期或目前的反覆項目查詢。

欄位名稱

說明

工作項目類型

活動 ^1、2

完成工作所需的活動類型。若要深入瞭解此欄位的使用方式，請參閱容量規劃。允許的值如下：

部署
設計
部署
文件
需求
測試

[活動] 字段會指派給 Activity ProcessConfiguration 檔案。³

參考名稱=Microsoft.VSTS.Common.Activity，數據類型=String

工作、Bug⁴ （敏捷式和 Scrum）

商業價值

相較於相同類型的其他專案，可擷取產品待辦專案或功能的相對商業價值測量單位。指派較高數位的項目應該視為具有比指派較低數位的專案更多的商業價值。

參考名稱=Microsoft.VSTS.Common.BusinessValue，數據類型=Integer

Epic、功能

已完成的工作

實作工作所花費的工作量。您可以指定以小時或天為單位的工作。沒有與此欄位相關聯的固有時間單位。

參考名稱=Microsoft.VSTS.Scheduling.CompletedWork，數據類型=Double

工作，Bug⁴

專業領域 ^{1， 2}

指派給工作的活動或專業領域類型。若要深入瞭解此欄位的使用方式，請參閱容量規劃。允許的值如下：

分析
部署
測試
使用者教育
使用者體驗

[專業領域] 字段會指派給 Activity ProcessConfiguration 檔案中。³

參考名稱=Microsoft.VSTS.Common.Discipline，數據類型=String

工作，錯誤 ⁴ （CMMI）

投入

測量的主觀單位，可擷取 Bug 或產品待辦專案的大小。如果您為專案指派更多工作，表示實作專案需要更多工作。

此欄位 ³ 也用來計算小組的速度和預測。它會在 ProcessConfiguration 檔案中指派給 Effort 。

參考名稱=Microsoft.VSTS.排程.Effort，數據類型=Double

產品待辦專案，Bug ⁴ （Scrum）

功能、Epic

故事點數

可擷取用戶劇本大小的主觀度量單位。如果您將更多點指派給用戶劇本，表示實作需要更多工作。

此欄位 ³ 也用來計算小組的速度和預測。它會在 ProcessConfiguration 檔案中指派給 Effort 。

參考名稱=Microsoft.VSTS。排程.StoryPoints，數據類型=Double

使用者劇本，Bug ⁴ （敏捷式）

大小

可擷取需求大小的主觀量值單位。大小越大，實作所需的工作就越多。

此欄位³ 也用來計算小組的速度和預測。它會在 ProcessConfiguration 檔案中指派給 Effort 。

參考名稱=Microsoft.VSTS。排程.Size、數據類型=Double

需求，錯誤 ⁴ （CMMI）

原始估計值

完成工作所需的工作量。您可以指定以小時或天為單位的工作。沒有與此欄位相關聯的固有時間單位。

參考名稱=Microsoft.VSTS.Scheduling.OriginalEstimate，數據類型=Double

工作、Bug ⁴ （敏捷式和 CMMI）

剩餘工時

要完成工作的剩餘工時量。您可以指定以小時或天為單位的工作。沒有與此欄位相關聯的固有時間單位。此欄位 ³ 也用來計算燒毀。它會在 ProcessConfiguration 檔案中指派給 type="RemainingWork" 。

注意

針對 Azure Boards，工作面板一律會顯示與剩餘工時關係中的小時「h」。針對 TFS，您可以修改 [剩餘工時類型] 欄位的 ProcessConfiguration 檔案，以指定天數或其他慣用卷標的 “d”。

參考名稱=Microsoft.VSTS.Scheduling.RemainingWork，數據類型=Double

工作，Bug⁴

需要檢閱

表示工作需要檢閱。您可以指定 [是 ] 或 [否 ] （預設值）。

參考名稱=Microsoft.VSTS.CMMI.RequiresReview，資料類型=String

工作（CMMI）

需要測試

指出工作需要測試。您可以指定 [是 ] 或 [否 ] （預設值）。

參考名稱=Microsoft.VSTS.CMMI.RequiresTest，數據類型=String

工作（CMMI）

任務類型¹

指定要實作的工作類型。允許的值如下：

更正動作
緩和動作
計劃

參考名稱=Microsoft.VSTS.CMMI.TaskType，數據類型=String

工作，錯誤⁴ （CMMI 程式）

注意

若要變更功能表選取專案：針對雲端服務或繼承的程式，請參閱新增和管理欄位;以及針對內部部署 XML 程式，請參閱新增或修改欄位、自定義選擇清單。
活動（Agile 或 Scrum）或 Discipline （CMMI）的 [容量] 頁面中所顯示的值會反映專案集合實例內所有專案中針對欄位所定義的所有值聯集。因此，若要限制在短期衝刺待辦專案頁面上針對 Capacity 顯示的值，您必須讓值符合指派給 type="Activity"之字段的所有專案中。
若要變更 ProcessConfiguration 欄位指派（僅限內部部署），請參閱處理組態 XML 元素參考。
每個小組都可以設定其敏捷式工具，以判斷錯誤是否被視為類似需求或工作。因為 Bug 可以隨需求或工作一起出現，所以用來估計需求層級和工作層級的欄位會包含在工作專案表單中。

如需新增自定義欄位的資訊，請參閱自定義您的工作追蹤體驗。

您用來規劃和追蹤工作的主要工具如下所述：

如需使用工作項目和查詢的詳細資訊，請參閱：

跨工作專案類型匯總數值

匯總會針對父系的所有子工作專案，提供選取欄位的加總值。 Azure Boards 原生會針對工作面板上的工作提供剩餘工時匯總。如需其他匯總需求，請參閱下列文章：

需求或工作類別中會出現哪些專案？

每個程式都會列出工作項目類型的預設指派。

處理	需求類別	工作類別
敏捷式	使用者劇本	Task
Scrum	產品待辦專案	Task
Cmmi	需求	Task

不過，每個小組都可以判斷 Bug 工作專案類型是否出現在 [需求] 或 [工作] 類別中。請參閱在待辦專案和面板上顯示 Bug。

您可以將自訂工作項目類型新增至待辦專案。如需詳細資訊，請參閱新增或修改工作專案類型、將自定義WIT新增至待辦專案或面板。

REST API

若要以程式設計方式與查詢互動，請參閱下列其中一個 REST API 資源：

依 Azure Boards 和 Azure DevOps 中的數值字段進行查詢

支援的運算子和宏