依Azure Boards和 Azure DevOps 中的標題、識別碼和 RTF 欄位進行查詢

  • 發行項

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

當您想要根據關鍵字或片語或 Null 文字欄位尋找工作專案時，可以透過篩選單行文字 (String) 、多行文字 (PlainText) ，以及 RTF (HTML) 欄位。 如果您發現查詢需要太長的時間才能傳回結果，請檢閱 指引以建立高效能的查詢。

支援的運算子和宏

指定文字或 RTF 欄位的查詢子句可以使用下表所列的運算子和宏。

Data type

支援的運算子和宏

RTF (HTML)
純文字 (多行文字字串)

Contains Words、、 Does Not Contain WordsIs Empty1、 Is Not Empty1

單一文字 (字串)

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever宏：有效的 [Any] [工作專案類型]欄位和 @Project2，有效于[Team Project]欄位。

識別碼

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever宏： @Follows 、、 @MyRecentActivity@RecentMentions 、 @RecentProjectActivity 有效且識別碼欄位和InNot In 運算子 @Project2有效，有效于Team Project欄位。

[狀態 ] 和 [工作專案類型] 欄位

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains , not contain , in not in , , , Group Not in Group was , Ever **Macros**: [Any]' valid with both fields.

注意

  1. Is EmptyAzure DevOps Server 2019 RC2 和更新版本支援 和 Is Not Empty 運算子
  2. 系統會根據目前的專案自動預設為篩選。 若要深入瞭解，請參閱 跨專案查詢。

用於 Contains words 字串比對

當您想要篩選字串比對時，請嘗試使用 Contains Words 運算子，而不是 Contains 。 運算子 Contains Words 會在指定的欄位上執行全文檢索搜尋，在大部分情況下會比較快。 文字字串限制為 100 個字元。

雖然運算子執行 Contains 資料表掃描，但不只會變慢，也會耗用更多 CPU 週期。 這些 CPU 週期有助於資源耗用速率限制。

具有萬用字元的關鍵字或片語查詢

使用 Contains 或 Contains Words 列出部分或完全符合您輸入之單字或片語的專案。

用於篩選關鍵字的一般清單查詢編輯器。

選擇 [包含] 或 [ 不包含 ] 來搜尋單字或片語的確切或部分相符專案。 選擇 [包含單字 ] 或 [ 不包含單字 ] 來搜尋確切片語，或使用萬用字元 *。 這些運算子會使用全文檢索搜尋索引。

例如，指定Contains Words and inform*來篩選包含inform或 information 或informational的文字欄位。

搭配 Contains 文字使用萬用字元。

提示

若要瞭解子句的分組方式 AND/OR ，請參閱 建立及儲存 Managed 查詢、群組子句。 若要檢視查詢的 WIQL 語法，請安裝 WIQL 查詢編輯器延伸模組 ，可讓您查看任何查詢編輯器專案的 WIQL 版本。

查詢特定單字，而非其他字組

使用 Contains Words 和 Not Contain Words 運算子來列出完全符合您輸入之單字或片語的專案，並排除其他單字或片語。 您可以將這些運算子與萬用字元 (*) 搭配使用。

在下列範例中，這些運算子會篩選包含工作 階段 但不包含 Phasor這個字的專案工作專案。

要包含和排除確切字組的查詢編輯器螢幕擷取畫面。

未定義的域值查詢

您可以使用 equals 運算子 (=) 尋找具有未定義域值的工作專案，並將欄位的 Value 保留空白。 例如，下列篩選會列出 [活動] 欄位空白之 [工作] 類型的所有工作專案。

根據空白項目篩選

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

空白或非空白 HTML 欄位查詢

您可以找到未輸入 描述 的工作專案。 使用 [空白] 或 [ 非空白 ] 與 HTML 欄位支援列出空白或空白 RTF 欄位的工作專案。 您未使用此運算子指定值。

例如，下列查詢篩選會列出某些專案已進入 [描述 ] 欄位的所有工作專案。

以篩選為基礎的非空白 HTML 欄位

注意

查詢沒有附加任何標籤的工作專案的能力不是支援的功能。 如果您想要投票要求以支援此功能，您可以在我們的開發人員社群頁面上執行這項操作，以便搜尋空的標記。

以類別為基礎的查詢

若要根據工作專案所屬的類別來篩選工作專案，請使用 In Group 運算子。 例如，下列篩選準則會傳回目前專案中的所有工作專案、指派給小組成員，並定義為屬於 Bug 類別目錄。

依分類搜尋工作項目的查詢子句

哪些專案會出現在需求或任務類別中？

每個程式的預設工作專案類型指派如下所列。

流程 需求類別 工作類別
基本 問題 Task
敏捷 使用者劇本 Task
Scrum 產品待辦專案、Bug Task
CMMI 需求 Task

每個小組都可以判斷 Bug 工作專案類型是否出現在 [需求] 或 [任務] 類別中。 請參閱 在待辦專案和麵板上顯示 Bug。 您可以將自訂工作專案類型新增至待辦專案。 如需詳細資訊，請參閱 新增或修改工作專案類型、將自訂 WIT 新增至待辦專案或面板。

查詢您正在追蹤的工作專案

您可以使用 @Follows 宏，根據您追蹤的工作專案和其他查詢篩選準則來篩選清單。

例如，下列查詢示範如何查詢所有專案是否有您追蹤的作用中工作專案。 您可以使用識別碼欄位和 In 運算子搭配 @Follows 宏。

查詢編輯器，識別碼為 In @Follows 查詢子句

查詢最近的工作專案活動

您可以使用下列宏，根據最近的活動列出工作專案：

  • @MyRecentActivity：列出您最近檢視或修改的專案。
  • @RecentMentions：過去 30 天內透過 @mention 新增至的專案。
  • @RecentProjectActivity：列出最近在專案中建立或修改的專案。

指定 ID 欄位和 In 或 Not In 運算子。

例如，下列查詢示範如何查詢最近檢視或修改的工作專案。

查詢編輯器，識別碼為 In @MyRecentActivity 查詢子句

大部分工作專案類型的常見欄位

下表描述用來篩選查詢的一般欄位。 識別碼欄位可唯一識別清單中的工作專案。 使用 [ 標題] 欄位，將工作專案與相同類型的所有其他專案區別。 [描述] 和其他 RTF (資料類型=HTML) 欄位會提供實作工作和追蹤變更所需的其他資訊。 建立工作專案之後，您可以修改識別碼以外的所有欄位。 當您新增並儲存工作專案時，系統會指派識別碼，且無法變更。

注意

系統會自動為所有長文字欄位編制索引，其資料類型為 PlainText 和 HTML 欄位，以進行全文檢索搜尋。 這包括 [標題]、[ 描述] 和 [重現步驟] 欄位。 如需適用于內部部署 Azure DevOps 的詳細資訊和伺服器和定序需求，請參閱 查詢欄位、運算子、值和變數 - 全文檢索和部分字搜尋。

欄位名稱

說明

工作項目類型

接受準則 1

在可對 Bug 或產品待處理項目結案之前，必須滿足的準則描述。

開始處理 Bug 或產品待處理項目之前，應盡可能清楚地描述客戶驗收準則。 小組與客戶之間的交談，以定義接受準則有助於確保您的小組瞭解客戶的期望。 驗收準則可以用來做為接受度測試的基準，讓您能夠更有效地評估項目是否圓滿完成。

參考名稱=Microsoft.VSTS.Common.AcceptanceCriteria， 資料類型=HTML

Bug、Epic、Feature、Product 待辦專案 (Scrum)

描述 1，2

使用此欄位提供工作專案的深入資訊。

參考名稱=System.Description，資料類型=HTML

全部

ID

指派給工作項目的唯一識別項。 工作專案識別碼在所有專案和專案集合內都是唯一的。

參考名稱=System.Id，資料類型=Integer

全部

重現步驟 (或重現) 1的步驟

重新產生非預期行為所需的步驟。 擷取足夠的資訊，讓其他小組成員了解問題的完整影響以及他們是否已修正 Bug。 這包括尋找或重現 Bug 和預期行為所採取的動作。
參考名稱=Microsoft.VSTS.TCM.ReproSteps， 資料類型=HTML

Bug

解決方法

描述如何解決障礙。

參考名稱=Microsoft.VSTS.Common.Resolution， 資料類型=HTML

阻礙 (Scrum)

系統資訊1

與 Bug、程式碼檢閱或意見相關之軟體及系統組態的相關資訊。

參考名稱=Microsoft.VSTS.TCM.SystemInfo，資料類型=HTML

Bug、程式碼檢閱要求、意見反應要求

團隊專案

工作專案所屬的專案。 當您想要將清單篩選為一或多個專案中的專案時，請將此欄位新增至查詢。 若要深入瞭解，請參閱 範例查詢、跨專案查詢。

參考名稱=System.TeamProject，資料類型=String

全部

標題

一個簡短描述，可總結工作項目為何並協助小組成員將其與清單中的其他工作項目區分開來。

Reference name=System.Title， Data type=String

全部

工作項目類型

工作項目類型的名稱。 工作專案類型會根據您建立專案時所使用的程式來定義。 如需概觀，請參閱 選擇程式。 若要瞭解如何新增自訂工作專案類型，請參閱 新增或修改工作專案類型。

若要根據其 類別指派來篩選工作專案，您可以使用 [ 群組 ] 和 [ 不在群組] 運算子，然後從下拉式清單中選取類別。

Reference name=System.WorkItemType， Data type=String

全部

注意

  1. 若要深入瞭解如何使用 RTF 欄位，請參閱 在工作專案中共用資訊。
  2. 升級至 Team Foundation Server 2012 時，[描述] 欄位已從純文字的欄位類型變更為 HTML。 使用 witadmin changefield 命令，您可以還原此欄位的資料類型。 請參閱 (witadmin) 管理工作專案欄位 。

REST API

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