Azure Boards 中的查詢欄位、運算子和巨集

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

您可以在這裡找到每個欄位資料類型、查詢運算元和查詢宏的詳細描述。 某些數據類型、運算子和宏僅適用於指定的 Azure DevOps 版本。

如需每個數據類型支持的查詢工作和運算元和宏的快速參考，請參閱 查詢快速參考。 另 請參閱建立查詢/最佳做法。

查詢欄位數據類型和值

您為欄位指定的值必須符合該欄位的資料類型。 下表列出支援的資料類型：

注意

針對 Azure Boards 雲端服務，數據類型會對應至 [處理>欄位] 頁面上欄位所列的數據類型。 針對內部部署，數據類型會對應至 type 指派給 FIELD 定義的屬性。 如需詳細資訊，請參閱 工作專案欄位和欄位屬性。

資料類型

說明

布林值

指定採用 True/False 值的欄位。

DateTime 或 Date/Time

您可以在其中指定變數的日期欄位，例如 @Today 或 @Today-1或值，例如 1/1/2023。 在您為個人設定檔設定的日期模式中輸入日期。 （請參閱 設定個人喜好 設定以取得詳細數據。如需查詢範例，請參閱 Query by date or @CurrentIteration。

針對WIQL查詢，您也可以在國際標準時間 （UTC） 模式中指定日期。 如需詳細資訊，請參閱工作專案查詢語言的語法（WIQL）。

Double 或 Decimal

實數，例如0.2或3.5。 如需查詢範例，請參閱 依數值欄位查詢。

GUID

表示唯一標識子的字元字串。

History

用來追蹤歷程記錄資訊的自定義格式化欄位。 此數據類型僅用於支援 [ 歷程記錄 ] 字段。 當全文搜索可供使用時，此字段會自動為全文搜索編製索引。 請參閱 本文稍後所述的全文檢索和部分文字搜尋 。 如需查詢範例，請參閱 記錄和稽核。

HTML

支援格式化描述的文字字串，例如 [描述] 或 [重現步驟] 字段。 當全文搜索可供使用時，這些字段會自動為全文搜索編製索引。 請參閱 本文稍後所述的全文檢索和部分文字搜尋 。 若要查詢 RTF 欄位，請參閱 依標題、標識碼和 RTF 字段查詢。

身分識別

識別使用者身分識別的簡短文字字串。

整數

帶正負號的 32 位整數，例如 0、1、2、34。

純文字或文字欄位 （多行）

支援完整描述的文字字串，例如 [ 應用程式開始資訊 ] 欄位。 當全文搜索可供使用時，這些字段會自動為全文搜索編製索引。 請參閱 本文稍後所述的全文檢索和部分文字搜尋 。 若要查詢純文字欄位，請參閱 依標題、標識碼和 RTF 字段查詢。

picklistDouble¹

定義成包含十進位值的挑選清單的自定義欄位。

picklistInteger¹

定義成包含整數值的挑選清單的自定義欄位。

picklistString¹

定義成包含簡短文字字串 （255 個字元或更少） 值的挑選清單的自定義欄位。

字串 或 文字欄位 （單行）

最多可以包含 255 個 Unicode 字元的簡短文字字串。 字串文字欄位通常用於支援選擇清單或下拉功能表。

TreePath

分支樹狀結構，例如區域路徑或反覆項目路徑。 從有效值清單中選擇專案。 尋找等於、不等於、在樹狀結構下或不在樹狀結構下的工作專案，或使用 In 或 Not In 運算子來指定數個值。 您可以定義專案的樹狀結構—區域路徑 和 反覆專案路徑，然後選取您想要與小組建立關聯的樹狀結構。

如需建構查詢的詳細資訊，請參閱 依區域或反覆專案路徑 查詢，或 依日期或目前反覆項目查詢。

注意

1. picklist... 資料類型只會指派給針對繼承進程定義的自定義欄位。 只有 Azure DevOps Services 和 Azure DevOps Server 2019 才支援繼承的進程模型。

日期和時間模式

您針對 DateTime 字段輸入的日期和時間模式應該符合您透過設定檔選取的日期與時間模式。 若要檢視或變更您的選取範圍，請參閱 設定時間與地區設定的用戶喜好設定。

查詢運算子

您可以使用下表中的查詢運算子來指定 子句中每個值必須如何與工作專案中的對應值產生關聯。 如需指派給工作專案欄位之數據類型的相關信息，請參閱 工作專案字位參考。

若要瞭解如何新增 子句和使用 And/Or 運算符，請參閱 定義查詢。

查詢運算子

如果工作專案中的值符合所列的準則，則傳回工作專案

適用的數據類型

=

符合 子句中的值。

數位-包括 Double、 GUID、 Integer 和 String、 DateTime 和 TreePath

<>

不符合 子句中的值。

Number、 String、 DateTime 和 TreePath

>

大於 子句中的值。

Number、 String 和 DateTime

<

小於 子句中的值。

Number、 String 和 DateTime

>=

大於或等於 子句中的值。

Number、 String 和 DateTime

<=

小於或等於 子句中的值。

Number、 String 和 DateTime

=[欄位]

符合指定欄位中包含的值。

與指定欄位相同數據類型的功能變數名稱

<>[欄位]

不符合指定欄位中包含的值。

與指定欄位相同數據類型的功能變數名稱

>[欄位]

大於指定欄位中包含的值。

與指定欄位相同數據類型的功能變數名稱

<[欄位]

小於指定欄位中包含的值。

與指定欄位相同數據類型的功能變數名稱

>=[欄位]

大於或等於指定欄位中包含的值。

與指定欄位相同數據類型的功能變數名稱

<=[欄位]

小於或等於指定欄位中包含的值。

與指定欄位相同數據類型的功能變數名稱

Contains

包含您選取篩選之欄位中文字字串的精確或部分相符專案。

String

不包含

不包含選取篩選之欄位中文字字串的完全或部分相符專案。

String

包含單字

包含您選取篩選之欄位中的確切文字字串或單字。 您也可以輸入包含通配符的部分單字或片語*。 文字字串限制為100個字元。 如需限制，請參閱 全文搜索 伺服器和定序需求。

針對全文搜索編製索引的長文字欄位，對應至所有 PlainText 和 HTML 欄位，以及 [歷程記錄] 和 [標題] 字段。

不包含單字

不包含您選取篩選之欄位中的確切文字字串或單字。 文字字串限制為100個字元。

將此運算符與 Contains Words 運算子的 子句搭配使用，以包含和排除特定關鍵詞。

針對全文搜索編製索引的文字欄位。

In

比對分隔集中的任何值。 例如，如果您為標識符字段指定這些值，您可以找到標識碼為 100、101 和 102 的工作專案。 將值與清單分隔符分隔，對應至針對用戶端電腦定義的區域設定。 例如，您可以使用逗號（，）。

Number、 String、 DateTime、 TreePath

為空白

列出包含空白 HTML 欄位的工作專案。 您未使用這個運算子指定值。 Azure Boards（雲端服務）、Azure DevOps Server 2019 和更新版本都支援此操作員。

HTML

不是空的

列出 HTML 欄位中包含某些內容的工作專案。 您未使用這個運算子指定值。 Azure Boards（雲端服務）、Azure DevOps Server 2019 和更新版本都支援此操作員。

HTML

不在

不符合分隔集中的任何值。 如果您為 [狀態] 字段指定這些值，則可以排除狀態不是 [解析]、[已完成] 或 [關閉] 的工作專案。 將值與清單分隔符分隔，對應至針對用戶端電腦定義的區域設定。 例如，您可以使用逗號（，）。

Not In 運算符可從 Azure Boards 和 TFS 2018.2 和更新版本取得。

Number、 String、 DateTime、 TreePath

在群組中

符合子句中群組成員的值。 群組會對應至小組、安全組或工作追蹤類別的名稱。 例如，您可以建立查詢來尋找指派給參與者群組成員或小組的所有工作專案。 當您建立小組時，就會建立小組群組。 小組群組的名稱會遵循模式 [Team Project Name]\Team Name。

如需查詢範例，請參閱 依指派或工作流程變更查詢。

符合系統中定義之小組、安全組或類別名稱的字串 。

注意

您只能搭配使用 String 資料類型或 [工作項目類型] 欄位的欄位使用 In Group 運算符。 當您的 Azure Boards 帳戶由 Microsoft Entra ID 支援時，您也可以使用 Microsoft Entra 識別符中定義的群組，或當內部部署伺服器實例受到 Active Directory 支援時，使用 Active Directory 所定義的群組。

如需類別群組的相關信息，請參閱 使用類別來群組工作項目類型。

不在群組中

不符合 子句中群組成員的值。

符合 Team Foundation Server 中使用者群組名稱的字串 ，或為專案定義的類別群組。

注意

您只能搭配使用 String 資料類型或 [工作項目類型] 欄位的欄位使用 Not In Group 運算符。 當您的 Azure Boards 帳戶由 Microsoft Entra ID 支援時，您也可以使用 Microsoft Entra 識別符中定義的群組，或當內部部署伺服器實例受到 Active Directory 支援時，使用 Active Directory 所定義的群組。

不在底下

不符合 子句中的值，而且不包含在 子句中的節點底下。

TreePath

下

比對 子句中的值，或 包含在 子句中的節點底下。

TreePath

曾經

比對子句中任何先前點的值。

字串 、 DateTime

注意

使用 查詢編輯器 時，目前不支援日期欄位為 Ever。 只有在執行直接 WIQL 時，才支持它們。

提示

對於列出的其他數據類型欄位，可以使用WIQL語法來串連查詢，例如 Was Ever等運算符。 例如，您可以使用反覆項目路徑在 子句中使用 Was Ever。 如需範例，請參閱 依日期或目前的反覆項目查詢、列出已移出短期衝刺的工作專案。

查詢宏或變數

您可以使用下表所述的宏，根據特定欄位篩選查詢。

注意

只有入口網站支援下列宏：@CurrentIteration、@CurrentIteration +/- n、@Follows、@MyRecentActivity、@RecentMentions、@RecentProjectActivity和@TeamAreas。 在 Visual Studio/Team Explorer、Microsoft Excel 或 Microsoft Project 中開啟時，包含這些宏的查詢將無法運作。

---

宏觀

說明

---

[任何]

與 [ 工作項目類型 ] 或 [狀態 ] 字段搭配使用，以搜尋所有工作項目類型或跨所有狀態。 例如， Work Item Type=[Any] 不會根據工作項目類型放置任何篩選。

---

@CurrentIteration

使用 [反復項目路徑] 字段，根據目前的小組焦點或內容，自動篩選指派給目前短期衝刺的工作專案。 如需特定範例，請參閱 依日期或目前的反覆項目查詢。
@CurrentIteration宏只能在從入口網站執行時運作。 複製或複製測試套件和測試案例、定義警示或使用 REST API 時，您無法使用宏。

---

@CurrentIteration +/- n

使用 [反復項目路徑] 字段，根據目前的小組焦點或內容篩選指派給目前短期衝刺 +/- n 個短期衝刺的工作專案集。 如需特定範例，請參閱 依日期或目前的反覆項目查詢。
Azure Boards、Azure DevOps Server 2019 和更新版本支援 @CurrentIteration +/- n 宏，而且只有在從入口網站執行時才支援。

---

@Follows

搭配 標識符 欄位和 In 運算子使用，列出您在專案中追蹤的所有工作專案。 若要深入了解追蹤功能，請參閱 追蹤工作專案或提取要求。 您可以從 [ 工作專案] 頁面檢視此相同的清單， 遵循 樞紐檢視。
只有在從入口網站執行時，才支援@Follows宏。

---

@Me

搭配身分識別或用戶帳戶欄位使用，自動搜尋與您使用者或帳戶名稱相關聯的專案。 例如，您可以尋找您使用 子句 Created By=@Me開啟的工作專案。 如需更多範例，請參閱 依指派、工作流程或工作流程看板變更進行查詢。

---

^{@MyRecentActivity 1}

搭配 標識符 欄位和 In 運算元使用，列出過去 30 天內已在專案中檢視或更新的工作專案。 您可以從 [ 工作專案] 頁面[ 我的活動 樞紐檢視] 檢視這個相同的清單。

---

@Project

與 [ 小組專案 ] 欄位搭配使用，以篩選其他專案中的工作專案。 例如，您可以使用 子句 Team Project=@Project，在目前選取的專案中找到所有工作專案。 系統會根據目前的項目自動預設為篩選。 如需詳細資訊，請參閱 定義查詢、跨項目查詢。

---

@RecentMentions¹

搭配 [標識符 ] 欄位和 [In 運算符] 來列出您在 [討論] 區段中提及的工作專案。 您可以從 [ 工作專案] 頁面[ 提及 ] 樞紐檢視中檢視此相同的清單。

---

^{@RecentProjectActivity 1}

搭配標識符欄位和 In 運算子使用，以列出最近更新的工作專案。 列出的工作項目數目取決於專案的工作追蹤活動。 對於高度使用中的專案，宏會列出過去 30 天內在專案中更新的工作專案。 不過，對於較不活躍的專案，此清單可能包含超過30天的工作專案。 您可以從 [ 工作專案] 頁面檢視類似的清單， [最近建立]、[ 最近更新 ] 和 [最近完成 ] 樞紐檢視。 傳回的工作項目數目上限為 5000。

---

^{@StartOfDay 2}

搭配 DateTime 欄位使用，篩選與目前日期或加減位移相關的工作專案。 例如，您可以使用 子句 Closed Date>=@StartOfDay-7，在上周找到關閉的所有專案。 如需更多範例，請參閱 依日期或目前的反覆項目查詢。

---

^{@StartOfMonth 2}

搭配 DateTime 欄位使用，篩選與目前月份或加減位移相關的工作專案。 例如，您可以使用 子句 Created Date>=@StartOfMonth-3尋找過去三個月中建立的所有專案。 如需更多範例，請參閱 依日期或目前的反覆項目查詢。

---

^{@StartOfWeek 2}

使用欄位 DateTime 來篩選與目前周或加減位移相關的工作專案。 例如，您可以使用 子句 Changed Date>=@StartOfWeek-2，在最近兩周內找到所有已變更的專案。 如需更多範例，請參閱 依日期或目前的反覆項目查詢。

---

@StartOfYear²

使用欄位 DateTime 來篩選與目前年份或加/減位移相關的工作專案。 例如，您可以使用 子句 Target Date>=@StartOfYear來尋找在目前年份內排程目標日期的所有功能。 如需更多範例，請參閱 依日期或目前的反覆項目查詢。

---

@TeamAreas

僅搭配 [ 區域路徑 ] 字段使用，篩選區域路徑對應至指派給特定小組的工作專案。 您必須使用 = 運算子。 例如，您可以使用 子句 Area Path=@TeamAreas [Fabrikam Fiber]\Web找到指派給 Web 小組區域路徑的所有專案。 如需更多範例，請參閱 依區域或反覆專案路徑查詢。
Azure DevOps Server 2019 和更新版本支援@TeamAreas宏，而且只有在從入口網站執行時才支援。

---

@Today

搭配 DateTime 欄位使用，篩選與目前日期或較舊日期相關的工作專案。 您也可以藉由減去天數來 修改@Today 宏。 例如，您可以使用 子句 Created Date>=@Today-7來尋找上周建立的所有專案。 如需更多範例，請參閱 依日期或目前的反覆項目查詢。

---

注意

1. TFS 2018.2 和更新版本支援@MyRecentActivity、@RecentMentions和@RecentProjectActivity宏。
2. Azure DevOps Server 2019 Update 1 和更新版本支援@StartOfDay、@StartOfWeek、@StartOfMonth和@StartOfYear宏。

全文檢索和部分文字搜尋

指定 Contains 或 Not Not Contain 來搜尋單字或片語的確切或部分相符專案。 這些運算子會根據針對長文字欄位建立的全文搜索索引來篩選專案。 指定 Contains Words 或 Not Contain Words 來搜尋確切的片語，或使用通配符 。 * 這些運算子會使用全文搜索索引。 您只能在部分單字或片語結尾使用通配符。

如需範例，請參閱使用 [歷程記錄] 字段來查詢工作項目和查詢工作專案。

注意

並非所有部署都支援全文搜索。 例如，支援雲端服務的 SQL Express 和 SQL Azure 不支援全文搜索。 在這些實例中，您只會看到 Contains 和 Not Contain 運算符。

相關文章

• 查詢快速參考
• 關於受控查詢
• 工作項目欄位索引
• 工作項目查詢語言的語法 （WIQL）

REST API

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

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