查詢欄位、運算子和巨集

Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

本文說明您在查詢編輯器中使用的欄位資料類型、查詢運算子和查詢巨集。 某些類型、運算子和宏僅適用於特定的 Azure DevOps 版本。

如需快速範例和編輯器工作，請參閱 查詢快速參考 和 管理和組織查詢。

先決條件

類別	要求
存取層級	- 若要查看和執行共享查詢：專案成員。 - 若要新增和儲存共享查詢：至少需要 基本 存取。
權限	貢獻權限已設定為允許，用於您要新增查詢的資料夾。 根據預設，參與者 群組沒有此許可權。

注意

具有 項目關係人 公用專案存取權的使用者，可以完整存取查詢功能，就像具有 Basic 存取權的使用者一樣。 如需詳細資訊，請參閱 項目關係人存取快速參考。

查詢欄位數據類型和值

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

注意

針對 Azure Boards （雲端） ，資料類型符合 [ 處理欄位 > ] 頁面上顯示的欄位。 對於內部部署，資料類型會與定義上的type屬性對應。 如需詳細資訊，請參閱 工作專案欄位和欄位屬性。

資料類型

說明

布林值

儲存 True/False 值。

DateTime 或 Date/Time

使用日期變數 （例如 @Today@Today-1或 ） 或明確日期 （例如 01/01/2025）。 在您的個人資料中設置的模式中輸入日期。 如需查詢範例，請參閱 Query by date or @CurrentIteration。
針對 WIQL 查詢，您也可以以 UTC 指定日期。 請參閱 工作專案查詢語言 （WIQL） 的語法。

Double 或 Decimal

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

GUID

儲存唯一識別碼字串。

History

用於歷史資訊的自訂格式欄位（ 歷史記錄 欄位）。 當全文檢索搜尋可用時，會為全文檢索查詢編製此欄位索引。 請參閱 歷程記錄和稽核。

HTML

儲存格式化的文字 （例如， 描述 或 重現步驟）。 當全文檢索搜尋可用時，會為這些欄位編製索引。 若要查詢 RTF 欄位，請參閱 依標題、標識碼和 RTF 字段查詢。

身分識別

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

整數

儲存有符號的 32 位整數 （例如 0、1、2、34）。

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

儲存長文字值 （例如， 應用程式啟動資訊）。 這些欄位在支援的情況下會被編入全文檢索索引。 請參閱 依標題、ID 和 RTF 欄位查詢。

picklistDouble

包含十進位值挑選清單的自訂欄位。

picklistInteger

包含整數值挑選清單的自訂欄位。

picklistString

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

字串 或 文字欄位 （單行）

儲存最多 255 個 Unicode 字元的短文字。 團隊經常將這些欄位用於選項清單或下拉式功能表。

TreePath

代表分支樹狀結構 （例如，區域路徑或疊代路徑）。 選擇有效的節點值。 您可以過濾相等、不等式、「低於」/「不低於」，或使用運算子 In / Not In 指定多個值。 定義專案的樹狀結構 （區域路徑 和 疊代路徑），並選取要與小組相關聯的節點。 如需查詢範例，請參閱 依區域或反覆專案路徑查詢 和 依日期或目前反覆專案查詢。

注意

這些 picklist... 類型僅適用於為繼承程序定義的自訂欄位。

日期和時間模式

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

查詢運算子

使用運算子來定義子句中的值必須如何與工作項目的欄位的值相關。 如需欄位資料類型，請參閱 工作專案欄位參考。 如需建置查詢的協助，請參閱 定義查詢。

查詢運算子

當運算子傳回相符的工作專案時

適用的數據類型

=

符合條件值。

數字 （double/decimal/GUID/Integer）、字串、DateTime、TreePath

<>

不符合條件值。

數字、字串、日期時間、樹狀路徑

>

大於子句值。

數字、字串、日期時間

<

價值小於該條件值。

數字、字串、日期時間

>=

大於或等於條件值。

數字、字串、日期時間

<=

小於或等於子句值。

數字、字串、日期時間

=[欄位]

符合另一個指定欄位中的值 （必須是相同的資料類型）。

相同資料類型的欄位名稱 （布林值欄位會比較相等性與其他欄位）。

<>[欄位]

與另一個指定欄位中的值不符。

相同資料類型的欄位名稱。

>[欄位]

大於另一個指定欄位中的值。

相同資料類型的欄位名稱。

<[欄位]

小於另一個指定欄位中的值。

相同資料類型的欄位名稱。

>=[欄位]

大於或等於另一個指定欄位中的值。

相同資料類型的欄位名稱。

<=[欄位]

小於或等於另一個指定欄位中的值。

相同資料類型的欄位名稱。

Contains

包含完全或部分文字相符。

繩子

不包含

不包含精確或部分文字匹配。

繩子

包含單字

可以匹配精確的片語或單字（支援使用尾端通配符 *）。 限制：100 個字元。 此運算子使用全文檢索索引;如需伺服器和定序需求，請參閱本文中的全文檢索區段。

為全文檢索建立索引的長文字欄位（純文字、HTML、歷史和標題）。

不包含單字

排除包含指定片語或單字的項目。 限制：100 個字元。 在配套子句中使用 with Contains Words 來包含或排除關鍵字。

編製索引的文字字段，用於全文檢索。

In

符合分隔集中的任何值 （使用您的 OS 區域清單分隔符號，通常是逗號）。

數字、字串、日期時間、樹狀路徑

為空白

比對 HTML 欄位不包含任何內容 （未指定值） 的項目。 支援 Azure Boards 和 Azure DevOps Server。

HTML

不是空的

比對 HTML 欄位包含內容的項目。 支援 Azure Boards 和 Azure DevOps Server。

HTML

不在

排除在一組以分隔符號隔開的值中（使用區域清單分隔符號）。 支援 Azure Boards 和 Azure DevOps Server。

數字、字串、日期時間、樹狀路徑

在群組中

比對具名群組 （小組、安全性群組或類別） 成員的值。 例如，使用 [參與者] 群組或模式 [Project Name]\Team Name中命名的小組群組。 如需範例，請參閱 依指派或工作流程變更查詢 。

字串 （符合群組或小組名稱） 或工作專案類型

注意

僅將 [ 在群組中 ] 與字串類型欄位或工作專案類型搭配使用。 當您的帳戶使用 Microsoft Entra ID 時，您可以使用 Microsoft Entra ID 群組，或內部部署的 Active Directory 群組。 ：：：列結束：：：

不在群組中

排除具名群組的成員。

符合使用者群組或專案類別的字串。

不在底下

排除等於或包含在指定樹狀結構節點下的項目。

TreePath

下

比對等於或包含在指定樹節點下的項目。

TreePath

曾經

符合欄位在過去某段時間所保留的值。

字串、日期時間

注意

查詢編輯器目前不支援 Was Ever 日期欄位;針對這些情況使用直接 WIQL。 ：：：列結束：：：

提示

您可以針對其他資料類型（例如反覆項目路徑）使用運算子（例如 Was Ever）建構 WIQL 查詢。 如需範例，請參閱 列出從短期衝刺移出的工作專案。

查詢巨集和變數

使用下列巨集來動態篩選查詢。

注意

只有透過入口網站支援下列巨集：@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

搭配 疊代路徑 使用，以包含相對於目前疊代的衝刺（例如 @CurrentIteration-1 或 @CurrentIteration+2）。 支援 Azure Boards 和 Azure DevOps Server 的入口網站。

---

@Follows

搭配 識別碼 和 In 運算子使用，以列出您在專案中追蹤的工作項目。 請參閱 追蹤工作專案或拉取請求。 此巨集只能從網頁入口運作。

---

@Me

搭配身分欄位使用，以篩選連結至您帳戶的項目 （例如 Created By=@Me）。 請參閱 依指派、工作流程或面板變更查詢。

---

@MyRecentActivity

搭配 識別碼 和 In 使用，以列出您在過去大約 30 天內檢視或更新的工作項目。 請參閱 [工作專案] 頁面的 我的活動 樞紐檢視，來查看相同的清單。

---

@Project

搭配 Team Project 來篩選目前專案中的工作專案 （例如 Team Project=@Project）。 請參閱跨專案查詢。

---

@RecentMentions

使用 ID 和 In 來列出您在討論中提及的工作項目。 請查看 [工作專案] 頁面的 「提及」項目。

---

@RecentProjectActivity

搭配 ID 和 In，列出專案中最近更新的工作項目。 巨集最多傳回 5,000 個項目;實際時段取決於專案活動。

---

@StartOfDay

搭配 DateTime 欄位使用，以相對於今天進行篩選 （例如 Closed Date>=@StartOfDay-7）。

---

@StartOfMonth

搭配 DateTime 欄位使用，以相對於月初進行篩選 （例如 Created Date>=@StartOfMonth-3）。

---

@StartOfWeek

搭配 DateTime 欄位使用，以相對於一週的開始進行篩選 （例如 Changed Date>=@StartOfWeek-2）。

---

@StartOfYear

與 DateTime 欄位搭配使用，以相對於年份開始進行篩選 （例如 Target Date>=@StartOfYear）。

---

@TeamAreas

僅與 「區域路徑」 和 = 運算子搭配使用，以尋找指派給小組區域路徑的項目 （例如 Area Path=@TeamAreas [Fabrikam Fiber]\Web）。 在 Azure DevOps Server 的入口網站中支援。

---

@Today

搭配 DateTime 欄位使用，以相對於今天進行篩選 （例如 Created Date>=@Today-7）。 請參閱 依日期或目前迭代查詢。

---

全文檢索和部分單字搜尋

使用 Contains 或 Does Not Contain 來搜尋長文字欄位的精確或部分相符 （這些運算子使用查詢索引）。 使用 Contains Words 或 Does Not Contain Words 來搜尋精確的片語，或使用尾端萬用字元（*），這些運算子需要全文索引。

您只能在部分單字或片語的結尾使用萬用字元。 如需範例，請參閱工作項目查詢範例和使用 [歷程記錄] 欄位來查詢工作項目。

注意

並非所有部署都支援全文檢索搜尋。 例如，SQL Express 和某些雲端 SQL 設定不支援全文檢索搜尋。 在這些部署中，只有 Contains 和 Does Not Contain 運算子可見。

相關內容

• 使用查詢快速參考
• 瞭解受控查詢
• 存取工作專案欄位索引
• 瞭解 WIQL 語法

REST API

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

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