使用索引來查詢 Azure Boards 和 Azure DevOps 中的快速參考數據

  • 發行項

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

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

範例查詢

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

關鍵詞、通配符查詢

以標記為基礎的查詢

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

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

連結和附件計數查詢

身分識別型查詢

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

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

小組焦點查詢

建置和測試欄位查詢

其他

查詢工作

每個數據類型支持的運算子和宏

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

注意

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

資料類型

說明

支援的運算子和宏

布林值

支援 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 2019 Update 1 和更新版本支援的其他宏：：
@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 WordsIs Empty2、2 Is Not Empty

身分識別

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

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever宏：@me所有 [身分識別] 字段都有效。

整數

也包含 picklistInteger1。 帶正負號的 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

也包含 picklistString1。 短單行文字，最多可包含 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

宏：@TeamAreas3，使用 [區域路徑] 字段有效
@CurrentIteration和 @CurrentIteration+/- n4 有效與 [反復項目路徑] 欄位

注意

  1. picklist... 資料類型只會指派給針對繼承進程定義的自定義欄位。 只有 Azure DevOps Server 2019 和更新版本才支援繼承的進程模型。
  2. Is Empty Azure DevOps Server 2019 RC2 和更新版本支援 和 Is Not Empty 運算符。
  3. Azure @TeamAreas Boards 和 Azure DevOps Server 2019 和更新版本支持宏。
  4. @CurrentIteration +/- n Azure DevOps Server 2019 和更新版本支援宏，而且只有在從入口網站執行時才支援。

日期和時間模式

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

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

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

選取欄位的範例查詢

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

A

B

C

D-E-F

H-P

R

S

T

V-W