Azure Boards 中的查詢欄位、運算子和巨集
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
本文提供每個欄位數據類型、查詢運算元和查詢巨集的描述。 某些數據類型、運算符和巨集僅適用於指定的 Azure DevOps 版本。
查詢欄位數據類型和值
您為欄位指定的值必須符合該欄位的資料類型。 下表列出支援的資料類型：
注意
針對 Azure Boards 雲端服務，數據類型會對應至 [處理>欄位] 頁面上欄位所列的數據類型。 針對內部部署，數據類型會對應至 type 指派給 FIELD 定義的屬性。 如需詳細資訊，請參閱 工作專案欄位和欄位屬性。
Data 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。
純文字或文字欄位 （多行）
支援完整描述的文字字串，例如 [ 應用程式開始資訊 ] 欄位。 當全文搜索可供使用時，這些字段會自動為全文搜索編製索引。 請參閱 本文稍後所述的全文檢索和部分文字搜尋 。 若要查詢純文字欄位，請參閱 依標題、標識碼和 RTF 字段查詢。
picklistDouble
定義成包含十進位值的挑選清單的自定義欄位。
picklistInteger
定義成包含整數值的挑選清單的自定義欄位。
picklistString
定義成包含簡短文字字串 （255 個字元或更少） 值的挑選清單的自定義欄位。
字串 或 文字欄位 （單行）
最多可以包含 255 個 Unicode 字元的簡短文字字串。 字串文字欄位通常用於支援選擇清單或下拉功能表。
TreePath
分支樹狀結構，例如區域路徑或反覆項目路徑。 從有效值清單中選擇專案。 尋找等於、不等於、在樹狀結構下或不等於的工作專案。 您也可以使用 In 或 Not In 運算子來指定多個值。 定義專案的樹狀結構—區域路徑 和 反覆專案路徑，然後選取您想要與小組建立關聯的樹狀結構。
如需建構查詢的詳細資訊，請參閱 依區域或反覆專案路徑 查詢，或 依日期或目前反覆項目查詢。
注意
picklist... 資料類型只會指派給針對繼承進程定義的自定義欄位。
日期和時間模式
您針對 DateTime 字段輸入的日期和時間模式應該符合您透過設定檔選取的日期與時間模式。 若要檢視或變更您的選取範圍，請參閱 設定用戶喜好設定。
![顯示 [時間和地區設定] 窗格上 [日期模式] 下拉式清單選項的螢幕快照。](../../organizations/settings/media/user-preferences/date-patterns.png?view=azure-devops)
![顯示 [時間與地區設定] 窗格上 [時間模式] 下拉式清單選項的螢幕快照。](../../organizations/settings/media/user-preferences/time-pattern.png?view=azure-devops)
![顯示 [時間] 和 [地區設定] 窗格的螢幕快照，其中包含 [日期模式] 和 [時間模式] 字段。](../../organizations/settings/media/user-preferences/jamalh-locale-settings-server.png?view=azure-devops)
查詢運算子
使用下表中的查詢運算符來指定 子句中每個值必須如何與工作專案中的對應值產生關聯。 如需指派給工作專案欄位之數據類型的相關信息，請參閱 工作專案字位參考。
如需詳細資訊，請參閱 定義查詢。
查詢運算子
如果工作專案中的值符合所列的準則，則傳回工作專案
適用的數據類型
=
符合 子句中的值。
數位-包括 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 支援此操作員。
HTML
不是空的
列出 HTML 欄位中包含某些內容的工作專案。 您未使用這個運算子指定值。 Azure Boards 和 Azure DevOps Server 支援此操作員。
HTML
Not In
不符合分隔集中的任何值。 如果您為 [狀態] 字段指定這些值，則可以排除狀態不是 [解析]、[已完成] 或 [關閉] 的工作專案。 將值與清單分隔符分隔，對應至針對用戶端電腦定義的區域設定。 例如，您可以使用逗號 ,。
Azure Boards 和 Azure DevOps Server 支援 Not In 操作員。
Number、 String、 DateTime、 TreePath
在群組中
符合子句中群組成員的值。 群組會對應至小組、安全組或工作追蹤類別的名稱。 例如，您可以建立查詢來尋找指派給參與者群組成員或小組的所有工作專案。 當您建立小組時，就會建立小組群組。 小組群組的名稱會遵循模式 [Team Project Name]\Team Name。
如需查詢範例，請參閱 依指派或工作流程變更查詢。
符合系統中定義之小組、安全組或類別名稱的字串 。
注意
您只能搭配使用 String 資料類型或 [工作項目類型] 欄位的欄位使用 In Group 運算符。 當您的 Azure Boards 帳戶由 Microsoft Entra ID 支援，或內部部署伺服器實例受到 Active Directory 支援時，您也可以使用 Microsoft Entra 識別符中定義的群組。
如需詳細資訊，請參閱 使用類別將工作項目類型分組。
不在群組中
不符合 子句中群組成員的值。
符合 Azure DevOps Server 中使用者群組名稱的字串 ，或為專案定義的類別群組。
注意
您只能搭配使用 String 資料類型或 [工作項目類型] 欄位的欄位使用 Not In Group 運算符。 當您的 Azure Boards 帳戶由 Microsoft Entra ID 支援，或內部部署伺服器實例受到 Active Directory 支援時，您也可以使用 Microsoft Entra 識別符中定義的群組。
不在底下
不符合 子句中的值，而且不包含在 子句中的節點底下。
TreePath
下
比對 子句中的值，或 包含在 子句中的節點底下。
TreePath
曾經
比對子句中任何先前點的值。
字串 、 DateTime
注意
使用 查詢編輯器 時，目前不支援日期欄位。 只有在執行直接 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 支援 @CurrentIteration +/- n 巨集。
@Follows
搭配 標識符 欄位和 In 運算子使用，列出您在專案中追蹤的所有工作專案。 如需詳細資訊，請參閱 遵循工作專案或提取要求。 您可以從 [ 工作專案] 頁面檢視此相同的清單， 遵循 樞紐檢視。
只有在從入口網站執行時，才支援@Follows巨集。
@Me
搭配身分識別或用戶帳戶欄位使用，自動搜尋與您使用者或帳戶名稱相關聯的專案。 例如，您可以尋找您使用 子句 Created By=@Me開啟的工作專案。 如需更多範例，請參閱 依指派、工作流程或面板變更進行查詢。
@MyRecentActivity
搭配 標識符 欄位和 In 運算子使用，列出您在過去 30 天內在專案中檢視或更新的工作專案。 您可以從 [ 工作專案] 頁面[ 我的活動 樞紐檢視] 檢視這個相同的清單。
@Project
與 [ 小組專案 ] 欄位搭配使用，以篩選其他專案中的工作專案。 例如，您可以使用 子句 Team Project=@Project，在目前選取的專案中找到所有工作專案。 系統會根據目前的項目自動預設為篩選。 如需詳細資訊，請參閱 定義查詢、跨項目查詢。
@RecentMentions
搭配 [標識符 ] 欄位和 [In 運算符] 來列出您在 [討論] 區段中提及的工作專案。 您可以從 [ 工作專案] 頁面[ 提及 ] 樞紐檢視中檢視此相同的清單。
@RecentProjectActivity
搭配標識符欄位和 In 運算子使用，以列出最近更新的工作專案。 列出的工作項目數目取決於專案的工作追蹤活動。 對於高度使用中的專案，巨集會列出過去 30 天內在專案中更新的工作專案。 不過，對於較不活躍的專案，此清單可能包含超過30天的工作專案。 您可以從 [ 工作專案] 頁面檢視類似的清單， [最近建立]、[ 最近更新 ] 和 [最近完成 ] 樞紐檢視。 傳回的工作項目數目上限為 5000。
@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找到指派給 Web 小組區域路徑的所有專案。 如需更多範例，請參閱 依區域或反覆專案路徑查詢。
只有在從入口網站執行時，Azure DevOps Server 才支援@TeamAreas巨集。
@Today
搭配 DateTime 欄位使用，篩選與目前日期或較舊日期相關的工作專案。 您也可以藉由減去天數來 修改@Today 巨集。 例如，您可以使用 子句 Created Date>=@Today-7來尋找上周建立的所有專案。 如需更多範例，請參閱 依日期或目前的反覆項目查詢。
全文檢索和部分文字搜尋
指定 Contains 或 Not Not Contain 來搜尋單字或片語的確切或部分相符專案。 這些運算子會根據針對長文字欄位建立的全文搜索索引來篩選專案。 指定 Contains Words 或 Not Contain Words 來搜尋確切的片語，或使用通配符 。 * 這些運算子會使用全文搜索索引。 您只能在部分單字或片語結尾使用通配符。
如需範例，請參閱使用 [歷程記錄] 字段來查詢工作項目和查詢工作專案。
注意
並非所有部署都支援全文搜索。 例如，支援雲端服務的 SQL Express 和 SQL Azure 不支援全文搜索。 在這些實例中，您只會看到 Contains 和 Not Contain 運算符。
Azure DevOps Server 會自動為純文字和 HTML 數據類型的所有長文字欄位編制索引，以及全文搜尋的 [標題] 字段。 只有在支援 Azure DevOps Server 的 SQL Server 支援全文搜索時，才能使用索引和運算符。
全文搜索需要對應至已向 SQL Server 註冊斷詞工具的語言的 SQL 定序。 如果用於 Azure DevOps Server 實例的專案集合資料庫定序設定未對應至支援的語言，您的搜尋結果可能不符合您的預期。 在這些情況下，您可能會嘗試使用 Contains 或 Not Contain 運算符。
如需詳細資訊，請參閱 全文搜索查詢和定序設定。
相關文章
REST API
若要以程式設計方式與查詢互動，請參閱下列其中一個 REST API 資源：