查询字段、运算符、宏和变量 - Azure Boards

查询字段数据类型和值

为字段指定的值必须符合该字段的数据类型。下表列出支持的数据类型：

对于Azure Boards云服务，数据类型对应于“ 进程>字段”页上为字段列出的数据类型。对于本地部署，数据类型对应于 type 分配给 FIELD 定义的属性。有关详细信息，请参阅工作项字段和字段属性。

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

对于 WIQL 查询，还可以在协调世界时 (UTC) 模式中指定日期。有关详细信息，请参阅工作项查询语言的语法 (WIQL) 。

一个分支树结构，如“区域路径”或“迭代路径”。从有效值列表中选择一项。在树结构下查找等于、不等于、下或不等于的工作项，或使用 In 或 Not In 运算符指定多个值。定义项目的树结构（区域路径和迭代路径），然后选择要与团队关联的树结构。

有关构造查询的详细信息，请参阅按区域或迭代路径查询或按日期或当前迭代查询。

picklist... 数据类型仅分配给为继承进程定义的自定义字段。继承的进程模型仅支持 2019 Azure DevOps Services 和 Azure DevOps Server。

日期和时间模式

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

查询运算符

可使用下表中的查询运算符指定子句中的每个值必须如何与工作项中的对应值相关。有关分配给工作项字段的数据类型的信息，请参阅工作项字段引用。

若要了解如何添加子句和使用 And/Or 运算符，请参阅定义查询和/或逻辑表达式。

查询运算符

如果工作项中的值与列出的条件匹配，则返回工作项

适用的数据类型

在你为筛选而选定的字段内包含准确的文本字符串或字。也可输入包含通配符“*”的部分单词或短语。文本字符串限制为 100 个字符。有关限制，请参阅全文搜索服务器和排序规则要求。

为全文搜索编制索引的长文本字段，对应于所有 PlainText 和 HTML 字段，以及 历史记录 和标题字段。

与分隔的集合中的任何值匹配。例如，如果为 ID 字段指定值 100、101 和 102，则可查找 ID 为这些值的工作项。用列表分隔符分隔值，列表分隔符与为你的客户端计算机定义的区域设置相对应。例如，可以使用逗号 (,)。

Number 、 String 、 DateTime 、 TreePath

列出 HTML 字段中包含某些内容的工作项。不使用此运算符指定值。 Azure Boards (云服务) 、Azure DevOps Server 2019 及更高版本支持此运算符。

与带分隔符的集中的任何值都不匹配。如果为“状态”字段指定了这些值，则可以从查询结果中排除状态不是“已解决”、“已完成”或“已关闭”的工作项。用列表分隔符分隔值，列表分隔符与为你的客户端计算机定义的区域设置相对应。例如，可以使用逗号 (,)。

Azure Boards 和 TFS 2018.2 及更高版本中提供了 Not In 运算符。

Number 、 String 、 DateTime 、 TreePath

与作为子句中组的成员的值匹配。组对应于团队、安全组或工作跟踪类别的名称。例如，你可以创建一个查询，用来查找分配给 Contributors 组成员或分配给团队的所有工作项。在创建团队时创建团队组。团队组的名称遵循模式 [ 团队项目名称 ]\ 团队名称 。

有关示例查询，请参阅按分配或工作流更改进行查询。

与系统中定义的团队、安全组或类别的名称匹配的 字符串 。

只能将 In Group 运算符用于使用 String 数据类型或 “工作项类型” 字段的字段。当Azure Boards帐户受 Azure AD 支持时，还可以使用 Azure Active Directory (Azure AD) 中定义的组;如果本地服务器实例受 Active Directory 支持，则使用 Active Directory。

有关类别组的信息，请参阅使用类别对工作项类型进行分组。

将与 ID 字段和 In 运算符一起使用，以列出项目中要关注的所有工作项。若要了解有关“关注”功能的详细信息，请参阅关注工作项或拉取请求。可以从 “工作项”页的“ 关注透视视图”查看此同一列表。
仅当从 Web 门户运行时，才支持 @Follows 宏。

仅与“ 区域路径” 字段一起使用，以筛选其区域路径对应于分配给特定团队的工作项。要求使用 = 运算符。例如，可以使用子句 Area Path=@TeamAreas [Fabrikam Fiber]\Web 查找分配给 Web 团队的区域路径的所有项。有关更多示例，请参阅按区域或迭代路径查询。
Azure DevOps Server 2019 及更高版本支持 @TeamAreas 宏，并且仅当从 Web 门户运行时。

全文和部分单词搜索

指定 Contains 或 Not Contain 可搜索字词或短语的完全或部分匹配项。这些运算符根据为长文本字段创建的全文搜索索引筛选项。指定 “包含字词 ”或“ 不包含单词 ”，以针对确切短语进行搜索或使用通配符 * 。这些运算符使用全文搜索索引。只能在部分单词或短语的末尾使用通配符。

有关示例，请参阅示例工作项查询和使用历史记录字段查询工作项。

并非所有部署都支持全文搜索。例如，支持云服务的 SQL Express 和 SQL Azure 不支持全文搜索。在这些实例中，将只看到 Contains 和 Does not Contain 运算符。

Azure DevOps Server 和 Team Foundation Server 自动为数据类型为 PlainText 和 HTML 的所有长文本字段编制索引，以及用于全文搜索的 Title 字段。仅当支持 Team Foundation Server 的SQL Server支持全文搜索时，索引和运算符才可用。

全文搜索需要 SQL 排序规则，该排序规则对应于已注册到 SQL Server 的断字符的语言。如果用于 Team Foundation Server 实例的项目集合数据库的排序规则设置与支持的语言不对应，则搜索结果可能与预期不符。在这些情况下，可以尝试使用 Contains 或 Does Not Contain 运算符。

有关详细信息，请参阅全文搜索查询和排序规则设置。

查询快速参考

关于托管查询

工作项字段索引

工作项查询语言 (WIQL) 的语法

REST API

若要以编程方式与查询交互，请参阅以下 REST API 资源之一：

Azure DevOps Services REST API 参考

工作项查询语言

使用查询以编程方式提取工作项