共用方式為

查詢欄位、運算子和巨集

  • 發行項

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

本文提供每個欄位數據類型、查詢運算元和查詢巨集的描述。 某些數據類型、運算符和巨集僅適用於指定的 Azure DevOps 版本。

如需詳細資訊，請參閱 查詢快速參考 和 管理和組織查詢。

先決條件

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

注意

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

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

查詢欄位數據類型和值

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

注意事項

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

資料類型

說明

布林值

指定採用 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

表示唯一ID的字符串。

History

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

HTML

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

身分識別

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

整數

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

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

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

picklistDouble

自定義欄位被定義為包含十進位值的選擇列表。

picklistInteger

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

picklistString

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

字串 或 文字欄位 （單行）

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

TreePath

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

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

注意

picklist... 資料類型只會指派給針對繼承進程定義的自定義欄位。

日期和時間模式

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

顯示 [時間和地區設定] 窗格上 [日期模式] 下拉式清單選項的螢幕快照。 顯示 [時間與地區設定] 窗格上 [時間模式] 下拉式清單選項的螢幕快照。

顯示 [時間] 和 [地區設定] 窗格的螢幕快照，其中包含 [日期模式] 和 [時間模式] 字段。

查詢運算子

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

如需詳細資訊，請參閱 定義查詢。

查詢運算子

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

適用的數據類型

=

符合句子中的值。

數位-包括 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

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

Not In 運算子適用於 Azure Boards 和 Azure DevOps Server。

Number、 String、 DateTime、 TreePath

在群組中

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

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

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

注意

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

如需詳細資訊，請參閱 使用類別將工作項目類型分組。

不在群組中

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

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

注意

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

不在底下

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

TreePath

下

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

TreePath

曾經

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

字串 、 DateTime

注意

Was 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 在從網頁入口執行時支援 @CurrentIteration +/- n 巨集。

@Follows

與 ID 欄位及 運算符搭配使用，以列出您在專案中追蹤的所有工作項目。 如需詳細資訊，請參閱 追蹤工作專案或拉取要求。 您可以在 工作專案 頁面的 追蹤 視圖中查看這個相同的清單。
只有在從網頁入口執行時，@Follows巨集才受支援。

@Me

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

@MyRecentActivity

使用 ID 欄位和 In 運算子，列出您於過去 30 天內在專案中檢視或更新的工作項目。 您可以從工作專案頁面的我的活動樞紐檢視中查看這個相同的清單。

@Project

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

@RecentMentions

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

@RecentProjectActivity

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

@StartOfDay

搭配 DateTime 欄位使用，篩選與當前日期或正負偏移相關的工作專案。 例如，您可以使用子句 Closed Date&gt;=@StartOfDay-7 找到上週所有已結束的專案。 如需更多範例，請參閱 依日期或當前迭代查詢。

@StartOfMonth

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

@StartOfWeek

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

@StartOfYear

使用DateTime 欄位，以篩選與目前年份或具有正/負差異的工作項目相關的資料。 例如，您可以使用子句 Target Date&gt;=@StartOfYear來尋找在當前年度內排定目標日期的所有特徵。 如需更多範例，請參閱 依日期或當前迭代查詢。

@TeamAreas

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

@Today

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

全文檢索和部分文字搜尋

指定 Contains 或 不包含 來搜尋單字或片語的精確或部分符合。 這些運算子會根據針對長文字欄位建立的全文搜索索引來篩選專案。 指定 Contains Words 或 Does 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 資源：