查詢快速參考

Azure Boards |Azure DevOps Server 2020 |Azure DevOps Server 2019 |TFS 2018-TFS 2013

您可以使用此索引來快速存取範例查詢,以及有關開啟、定義和使用查詢的資訊。 若要瞭解如何使用查詢編輯器,請參閱 定義查詢。 如果您發現查詢花費的時間太長,無法傳回結果,請參閱 指導方針來建立高效能的查詢。

查詢範例

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



查詢工作



每種資料類型都支援運算子和宏

下表指出適用于不同欄位資料類型的運算子和宏。 每個欄位都與資料類型相關聯。 您可以在每個欄位的描述中找到所列的資料類型,您可以使用 工作專案欄位索引來查閱。 可用來定義查詢子句的運算子取決於您選取之欄位的資料類型。 如需資料類型、運算子和宏的詳細說明,請參閱 查詢欄位、運算子和宏

資料類型

描述

支援的運算子和宏

布林值 1

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

=、 < > 、= [Field]、 < > [Field]

Datetime

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

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

=、、、、 < > > < > =、 < =、= [Field]、 < > [field]、 > [field]、 < [field]、 > = [field]、 < = [field]、In、Not In、Was

@Today ,適用于任何 DateTime 欄位

Azure DevOps 2019 Update 1 和更新版本支援的其他宏:
@StartOfDay@StartOfWeek@StartOfMonth@StartOfYear ,適用于任何 DateTime 欄位

也稱為 Decimal ,並且包含 picklistDouble2。 實際數字,例如 0.2 或 3.5。

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

=、、、、 < > > < > =、 < =、= [Field]、 < > [field]、 > [field]、 < [field]、 > = [field]、 < = [field]、In、Not In、Was
Guid

字元字串,表示唯一 ID。 =、、、、 < > > < > =、 < =、= [Field]、 < > [field]、 > [field]、 < [field]、 > = [field]、 < = [field]、In、Not In、Was

歷史

自訂格式化的欄位,用來追蹤歷程記錄資訊,而且只會指派給 [ 記錄 ] 欄位。

查詢範例:歷程 記錄和審核

包含單字,不包含單字

Html

支援格式化描述的文字字串,例如 [ 描述 ] 或 [ 重現步驟 ] 欄位。 當全文檢索搜尋可用時,這些欄位會自動索引以供全文檢索搜尋之用。 查詢範例: 依標題、識別碼和 rich text 欄位進行查詢

包含單字、不包含單字、空白3、不是空的3
身分識別 用來保存使用者識別的字串欄位。

查詢範例: 依指派或工作流程變更進行查詢

=、、、、 < > > < > =、 < =、= [Field]、 < > [field]、 > [field]、 < [field]、 > = [field]、 < = [field]、Contains、不包含、In、Not in、group、not in group、Was

@me 適用于所有識別欄位

整數 也包含 picklistInteger2。 32 位元帶正負號的整數,例如 0、1、2、34。

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

=、、、、 < > > < > =、 < =、= [Field]、 < > [field]、 > [field]、 < [field]、 > = [field]、 < = [field]、In、Not In、Was

@Follows 4@MyRecentActivity 5@RecentMentions 5,搭配 @RecentProjectActivity ID欄位使用時有效

明文 當全文檢索搜尋可用時,支援長描述的多行文字字串會自動編制索引以供全文檢索搜尋使用。

查詢範例: 依標題、識別碼和 rich text 欄位進行查詢

包含單字、不包含單字、空白3、不是空的3
字串 也包含 picklistString2。 最多可包含255個 Unicode 字元的簡短單行文字。 字串欄位支援 標題 欄位、挑選清單 (下拉式功能表) 、使用者帳戶、 標記和其他欄位。

查詢範例: 依標題、識別碼和 rich text 欄位進行查詢 ,並 依挑選清單值查詢

=、、、、 < > > < > =、 < =、= [Field]、 < > [field]、 > [field]、 < [field]、 > = [field]、 < = [field]、Contains、不包含、In、Not in、group、not in group、Was

[Any],與 工作專案類型 欄位有效
@Project6,適用于 Team 專案 欄位

TreePath

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

查詢範例: 依區域或反復專案路徑進行查詢 ,以及 依日期或目前反復專案查詢

低於、不在

@TeamAreas 7,使用區域路徑欄位有效
@CurrentIteration具有 [反復專案路徑] 欄位的8 @CurrentIteration +/-n9有效

注意:

  1. TFS 2017 和更新版本支援 [ 布林 資料類型] 欄位。
  2. 挑選 清單 ... 資料類型只會指派給針對繼承進程定義的自訂欄位。 只有 Azure DevOps Services 和 Azure DevOps Server 2019 支援繼承的進程模型。
  3. 是空 的,而且不支援 AZURE DEVOPS SERVER 2019 RC2 和更新版本的 空白 運算子。
  4. @Follows TFS 2017 和更新版本支援宏。
  5. @MyRecentActivity @RecentMentions @RecentProjectActivity Azure Boards 和 TFS 2018.2 和更新版本支援、和宏。
  6. @Project TFS 2015.1 和更新版本支援宏。 系統會自動預設為根據目前專案進行篩選。 若要深入瞭解,請參閱 跨專案查詢
  7. @TeamAreas Azure Boards 和 Azure DevOps Server 2019 和更新版本都支援宏。
  8. @CurrentIteration TFS 2015 和更新版本支援宏,而且只有在從入口網站執行時才支援。
  9. Azure Boards 和 Azure DevOps Server 2019 和更新版本,以及從入口網站執行時,都支援 @CurrentIteration +/-n 宏。

注意

以下是只有入口網站支援的宏: @CurrentIteration@遵循@MyRecentActivity@RecentMentions@RecentProjectActivity @TeamAreas。 在 Visual Studio/Team Explorer、Microsoft Excel 或 Microsoft Project 中開啟時,包含這些宏的查詢將無法運作。

選取欄位的查詢範例

下表列出提供範例查詢的一般查詢欄位和其資料類型。 若要判斷欄位的資料類型,請參閱 工作專案欄位和屬性、列出欄位屬性

A

B

C

D-E-F

H-P

R

S

T

V W

注意:

  1. TFS 2017 和更新版本支援 [ 批註計數 ] 欄位。