使用索引來查詢快速參考數據

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

使用此索引快速存取範例查詢，以及開啟、定義及處理查詢的相關信息。若要瞭解如何使用查詢編輯器，請參閱定義查詢。如果您發現查詢傳回結果的時間太長，請參閱定義查詢/最佳做法。

範例查詢

您可以根據下列準則列出工作專案...

關鍵詞、通配符查詢

以標記為基礎的查詢

狀態、原因或工作流程變更查詢

以日期和反覆項目為基礎的查詢

連結和附件計數查詢

身分識別型查詢

工作項目計數和數值欄位查詢

歷程記錄、討論和修訂變更查詢

小組焦點查詢

建置和測試欄位查詢

Other

查詢任務

每個數據類型支援的運算子和巨集

下表指出可用於不同欄位數據類型的運算元和巨集。每個欄位都與資料類型相關聯。您可以在每個欄位的描述中找到列出的數據類型，您可以使用 [工作專案] 欄位索引來查閱。可用來定義查詢子句的運算符取決於您選取的欄位數據類型。如需數據類型、運算符和巨集的詳細描述，請參閱查詢欄位、運算符和巨集。

Note

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

資料類型

Description

支援的運算子和巨集

Boolean

支援 True/False 值。查詢範例：依指派或工作流程變更進行查詢。

= , <> , =[Field] , <>[Field]

DateTime

您可以在其中指定變數的日期欄位，例如 @Today 或 @Today-1或值，例如 2012/1/1。在您為個人設定檔設定的日期模式中輸入日期。如需詳細資訊，請參閱設定個人喜好設定。

如需查詢範例，請參閱依日期or@CurrentIteration查詢。

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
巨集：@Today，任何 DateTime 欄位都有效

在 Azure DevOps 2020 及更高版本中支援的新增巨集有：
@StartOfDay、 @StartOfWeek、 @StartOfMonth和 @StartOfYear，任何 DateTime 欄位都有效

Double

也稱為十進位，並包含picklistDouble1。實數，例如0.2或3.5。

查詢範例：依數值欄位查詢。

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

GUID

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

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

History

用來追蹤歷程記錄資訊的自定義格式化欄位，並只指派給 [歷程記錄 ] 字段。

查詢範例：歷程記錄和稽核。

包含單字，不包含單字

HTML

支援格式化描述的文字字串，例如 [描述] 或 [重現步驟] 字段。當全文檢索搜尋可用時，這些欄位會自動編製全文檢索搜尋的索引。查詢範例：依標題、標識碼和 RTF 欄位進行查詢。

Contains Words、、Does Not Contain Words^{Is Empty2}、2 Is Not Empty

Identity

保存使用者身分的字串欄位。查詢範例：依指派或工作流程變更進行查詢。

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever 巨集：@me所有 [身分識別] 欄位都有效。

Integer

也包含 picklistInteger¹。帶正負號的 32 位整數，例如 0、1、2、34。

查詢範例：依數值欄位查詢

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

巨集：@Follows、@MyRecentActivity、 @RecentMentions和 @RecentProjectActivity，與標識符字段搭配使用時有效。

PlainText

支援長描述的多行文字字串，當全文檢索可用時，自動編製索引以供檢索。
查詢範例：依標題、標識碼和 RTF 欄位進行查詢。

Contains Words、、 Does Not Contain Words、 Is EmptyIs Not Empty

String

也包含 picklistString¹。短單行文字，最多可包含 255 個 Unicode 字元。字串欄位支援 [ 標題 ] 欄位、選擇清單（下拉功能表）、用戶帳戶、標籤和其他欄位。

查詢範例：依標題、標識碼和 RTF 字段進行查詢，以及依選擇清單值查詢。

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever

巨集：[Any]，有效的 [工作項目類型] 字段 @Project，有效於 [小組專案] 字段。

TreePath

支援 [區域路徑] 和 [反復項目路徑] 欄位的欄位類型。您可以定義項目的樹狀結構—區域路徑和反覆項目路徑。

查詢範例：依區域或反覆專案路徑查詢，以及依日期或目前反覆項目查詢。

Under、、Not Under=、<>、、In、Not In

巨集：@TeamAreas³，使用 [區域路徑] 欄位有效
@CurrentIteration和 @CurrentIteration+/- n4 有效與 [^{反復項目路徑]} 欄位

Note

系統只會將 選項清單... 資料類型指派給為繼承程序定義的自訂欄位。繼承的程式模型支援 Azure DevOps Services 和 Azure DevOps Server 2020 和更新版本。
Azure DevOps Services 和 Azure DevOps Server 2020 和更新版本支援 Is Empty 和 Is Not Empty 運算子。
Azure DevOps Services 和 Azure DevOps Server 2020 和更新版本支援 @TeamAreas 巨集。
Azure DevOps Services 和 Azure DevOps Server 2020 及更新版本支援 @CurrentIteration +/- n 巨集功能，而且僅限於您從網頁入口執行時。

日期和時間模式

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

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

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

選取欄位的範例查詢

下表列出提供範例查詢的常見查詢欄位及其數據類型。若要判斷欄位的數據類型，請參閱工作專案欄位和屬性、清單欄位屬性。

A

接受準則（HTML）
啟用者（身分識別）
Activated Date （DateTime）
活動（字串）
區域路徑（TreePath）
指定給（身分識別）
附加的檔案計數（整數）
自動化測試名稱（字串）
自動化測試類型（字串）

B

封鎖（字串）
面板資料列（字串）
面板列完成（布林值）
板巷（字串）
商業價值（字串）

C

變更者（身分識別）
已變更日期（DateTime）
關閉者（身分識別）
關閉日期（日期時間）
註計數（整數）
已提交（字串）
已完成工時（十進位）
建立者（身分識別）
建立日期（DateTime）

D-E-F

紀律（字串）
說明（HTML）
到期日（日期時間）
努力（十進制）
外部連結計數（整數）
完成日期（DateTime）
在組建中找到（字串）

H-P

歷史（歷史）
超連結計數（整數）
ID （整數）
整合在組建中（字串）
反復項目路徑（TreePath）
連結註記（整數）
節點名稱（字串）
原始估計值（十進位）
參數（HTML）
優先順序（整數）

R

原因（字串）
相關連結計數（整數）
剩餘工時（十進位）
重現步驟（HTML）
解決者（身分識別）
已解決日期（DateTime）
已解決的原因（字串）
Rev （整數）
修訂日期（日期時間）

S

嚴重性（字串）
大小（十進位）
堆疊排名（十進位）
開始日期（DateTime）
狀態（字串）
狀態變更日期（DateTime）
步驟（HTML）
重現步驟（HTML）
故事點（十進位）
系統資訊（HTML）

T

標籤（字串）
目標日期（日期時間）
工作型態（字串）
Team Project （字串）
Test Suite 型態（字串）
標題（系統）
分類（字串）

V-W

值區域（字串）
工作項目類型（字串）

意見反應

此頁面對您有幫助嗎？

Last updated on 2025-12-17

共用方式為

使用索引來查詢快速參考數據

範例查詢

查詢任務

每個數據類型支援的運算子和巨集

日期和時間模式

選取欄位的範例查詢

A

B

C

D-E-F

H-P

R

S

T

V-W

相關內容

意見反應

其他資源