依數值欄位查詢

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

瞭解如何根據 Azure Boards 和 Azure DevOps 中的工作、排程、故事點或時間追蹤欄位，依數值欄位進行查詢。

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

使用運算子和宏

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

• = 、、 <> > 、 < 、、 >= 、 <=
• =[Field]、、<>[Field]>[Field]、<[Field]、、>=[Field]、<=[Field]
• In, Not In
• Was Ever

開發以圖表為基礎的查詢

下列秘訣可協助您開發查詢：

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

如需詳細資訊，請參閱 使用查詢編輯器來列出及管理查詢 及 圖表 及 新增或修改欄位。

使用篩選器

下表顯示查詢的實用篩選。

篩選

包含這些查詢子句

用戶劇本或錯誤

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、Data type=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 程式）

注意

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

下一步

自訂您的工作追蹤體驗

相關文章

• 建立待辦專案
• 規劃短期衝刺
• 規劃容量
• 定義工作項目查詢
• 查詢欄位、運算子和宏
• 支援工作和其他欄位的匯總
• 使用 Power BI 建立匯總圖表

REST API

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

• Azure DevOps Services REST API 參考
• 查詢
• 工作項目查詢語言
• 以程序設計方式擷取具有查詢的工作專案