使用索引查询 Azure Boards 和 Azure DevOps 中的快速参考数据

  • 项目

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

使用此索引可以快速访问示例查询以及有关打开、定义和使用查询的信息。 若要了解如何使用查询编辑器，请参阅定义查询。 如果发现查询返回结果的时间过长，请参阅定义查询/最佳做法。

查询示例

可以基于以下条件列出工作项...

关键字、通配符查询

基于标记的查询

状态、原因或工作流更改查询

基于日期和迭代的查询

链接和附件计数查询

基于标识的查询

工作项计数和数值字段查询

历史记录、讨论和修订更改查询

团队焦点查询

生成和测试字段查询

其他

查询任务

每种数据类型支持的运算符和宏

下表指示了可用于不同字段数据类型的运算符和宏。 每个字段都与一个数据类型相关联。 可以在每个字段的说明中找到列出的数据类型，并可以使用工作项字段索引查找该数据类型。 可用于定义查询子句的运算符取决于所选字段的数据类型。 有关数据类型、运算符和宏的更详细说明，请参阅查询字段、运算符和宏。

注意

以下宏仅在 Web 门户中受支持：@CurrentIteration、@CurrentIteration +/- n、@Follows、@MyRecentActivity、@RecentMentions、@RecentProjectActivity 以及 @TeamAreas。 在 Visual Studio/团队资源管理器、Microsoft Excel 或 Microsoft Project 中打开时，包含这些宏的查询将不起作用。

数据类型

描述

支持的运算符和宏

布尔值

支持 True/False 值。 查询示例：按分配或工作流更改进行查询。

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

DateTime

一个日期字段，可在其中指定变量（例如 @Today 或 @Today-1）或值（例如 1/1/2012）。 在为个人资料设置的日期模式中输入日期。 有关详细信息，请参阅设置个人首选项。

有关查询示例，请参阅按日期或 @CurrentIteration 进行查询。

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
宏：@Today，对任何日期时间字段都有效

Azure DevOps 2019 Update 1 及更高版本支持的其他宏：
@StartOfDay、@StartOfWeek、@StartOfMonth 和 @StartOfYear，对任何日期时间字段都有效

双精度

也称为 Decimal，包括 picklistDouble1。 一个实数，如 0.2 或 3.5。

查询示例：按数值字段进行查询。

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

GUID

一个表示唯一 ID 的字符串。

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

History

用于跟踪历史信息的自定义格式的字段，仅分配给历史记录字段。

查询示例：历史记录和审核。

包含字词，不包含字词

HTML

支持格式化说明的文本字符串，如说明或重现步骤字段。 当全文搜索可用时，这些字段在进行全文搜索时可自动创建索引。 查询示例：按标题、ID 和富文本字段进行查询。

Contains Words、Does Not Contain Words、Is Empty2、Is Not Empty2

标识

用于保留用户标识的字符串字段。 查询示例：按分配或工作流更改进行查询。

= , <> , > , < , >= , <= , =[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，与 ID 字段一起使用时有效。

PlainText

支持长说明的多行文本字符串，在全文搜索可用时自动针对全文搜索编制索引。
查询示例：按标题、ID 和富文本字段进行查询。

Contains Words, Does Not Contain Words, Is Empty, Is Not Empty

字符串

还包括 picklistString1。 最多包含 255 个 Unicode 字符的单行短字符串。 字符串字段支持标题字段、选择列表（下拉菜单）、用户帐户、标记和其他字段。

查询示例：按标题、ID 和富文本字段进行查询和按选择列表值进行查询。

= , <> , > , < , >= , <= , =[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. Azure DevOps Server 2019 RC2 及更高版本支持 Is Empty 和 Is Not Empty 运算符。
  3. Azure Boards 和 Azure DevOps Server 2019 及更高版本支持 @TeamAreas 宏。
  4. 仅当从 Web 门户运行时，Azure DevOps Server 2019 及最高版本才支持 @CurrentIteration +/- n 宏。

日期和时间模式

为日期/时间字段输入的日期和时间模式应与通过配置文件选择的日期和时间模式匹配。 若要查看或更改选择，请参阅设置时间和区域设置的用户首选项。

显示“时间和区域设置”窗格上的“日期模式”下拉列表选项的屏幕截图。显示“时间和区域设置”窗格上的“时间模式”下拉列表选项的屏幕截图。

显示“时间和区域设置”窗格以及“日期”模式和“时间模式”字段的屏幕截图。

选定的字段的示例查询

下表列出了常见的查询字段及其数据类型，并为其提供了示例查询。 若要确定字段的数据类型，请参阅工作项字段和属性、列出字段属性。

A

B

C

D-E-F

H-P

R

S

T

V-W