按Azure Boards和 Azure DevOps 中的标题、ID 和富文本字段进行查询

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

如果要基于关键字或短语或 null 文本字段查找工作项,可以通过筛选单行文本 (字符串) 、多行文本 (纯文本) ,以及 HTML) 字段 (格式文本。 如果发现查询返回结果的时间过长,请查看 指南以创建高性能查询

支持的运算符和宏

指定文本或富文本字段的查询子句可以使用下表中列出的运算符和宏。


Data type

支持的运算符和宏


RTF (HTML)
纯文本 (多行文本字符串)

包含单词,不包含单词,为空 (注释 1) ,不为空 (注释 1)


纯文本 (多行文本字符串)

支持的运算符和宏


单个文本 (字符串)

= , , <> , <><> , = , =[Field], [Field], ><>[>Field]<, =[Field], =[Field]<, Contains, Not contains, not contains, not contain, in, not in, not in, in, was Ever, Ever
[Any],对 “工作项类型” 字段有效
@Project (注释 2) ,在 “团队项目 ”字段中有效


GUID

= 、 、 <> 、 <>>= 、 <= 、 In、 In、 Not In
@Follows@MyRecentActivity@RecentMentions@RecentProjectActivityID 字段和In 和 In@Project 运算符有效, (注释 2) ,在团队项目字段中有效


“状态 ”和 “工作项类型” 字段

= , , <> , <><> , = , =[Field], [Field], ><>[>Field]<, =[Field], =[Field]<, Contains, Not contains, not contains, not contain, in, not in, not in, in, was Ever, Ever
[Any] 对两个字段有效


注意

  1. Azure DevOps Server 2019 RC2 及更高版本支持“为空”和“非空”运算符
  2. Azure Boards和 TFS 2015.1 及更高版本支持@Project宏。 系统会自动默认基于当前项目进行筛选。 若要了解详细信息,请参阅 跨项目的查询

用于 Contains words 字符串匹配

如果要筛选字符串匹配项,请尝试使用 Contains Words 运算符而不是 Contains。 该 Contains Words 运算符在指定字段上运行全文搜索,在大多数情况下速度更快。 文本字符串限制为 100 个字符。

Contains虽然操作员运行表扫描,这不仅速度较慢,而且会消耗更多的 CPU 周期。 这些 CPU 周期有助于资源消耗速率限制。

带通配符的关键字或短语查询

使用 ContainsContains Words 列出部分或完全匹配输入的单词或短语的项目。

用于筛选关键字的平面列表查询的编辑器。

选择 “包含 ”或 “不包含 ”可针对单词或短语的确切或部分匹配项进行搜索。 选择 “包含字词 ”或 “不包含单词 ”以针对确切短语搜索或使用通配符 *。 这些运算符使用全文搜索索引。

例如,指定 “包含字词通知” ,以筛选包含 通知信息信息的文本字段。

将通配符与包含字词配合使用。

提示

若要了解如何 AND/OR 对子句进行分组,请参阅 创建和保存托管查询、Group 子句。 若要查看查询的 WIQL 语法,请安装 WIQL 查询编辑器扩展 ,以便查看任何查询编辑器条目的 WIQL 版本。

查询特定字词而不是其他字词

使用 “包含字词 ”和 “不包含单词 ”运算符列出与输入的单词或短语完全匹配的项目,并排除其他字词或短语。 可以将这些运算符与通配符 (*) 结合使用。

在以下示例中,这些运算符筛选包含工作 阶段 但不包含单词 Phasor 的项的工作项。

要包含和排除确切字词的查询编辑器屏幕截图。

未定义的字段值查询

可以使用等于运算符 (=) 并将字段的值留空来查找具有未定义字段值的工作项。 例如,以下筛选器将列出“任务”字段为空的所有工作项。

基于空白条目进行筛选

若要根据非空白字段列出工作项,请使用 not 运算符 (<>) 并将“值”留空。

空或不为空的 HTML 字段查询

可以在未输入 “说明 ”的工作项中找到工作项。 对 HTML 字段使用 “为空 ”或 “不为空 ”支持列出包含空或不为空的富文本字段的工作项。 不使用此运算符指定值。

例如,以下查询筛选器将列出某些条目已进入 “说明 ”字段的所有工作项。

基于筛选器的非空 HTML 字段

注意

查询没有附加到它们的任何标记的工作项的功能不受支持。 如果要对支持此功能的请求进行投票,可以在我们的开发者社区页面上执行此操作,以便能够搜索空标记

基于类别的查询

若要根据工作项所属的类别筛选工作项,请使用 In Group 运算符。 例如,以下筛选条件将返回当前项目中的所有工作项,分配给团队成员,并定义为属于 Bug 类别。

用于按类别查找工作项的查询子句

“要求”或“任务”类别中显示哪些项?

每个流程下面列出了每个类别的工作项类型的默认分配。

进程 要求类别 任务类别
基本 问题 任务
敏捷 用户情景 任务
Scrum 产品积压工作项,Bug 任务
CMMI 要求 任务

每个团队都可以确定 Bug 工作项类型是否显示在“要求”或“任务”类别中。 请参阅 积压工作和板上的“显示 bug”。 可以将自定义工作项类型添加到积压工作。 有关详细信息,请参阅 添加或修改工作项类型,将自定义 WIT 添加到积压工作或板

查询所关注的工作项

可以使用 @Follows 宏根据你关注的工作项和其他查询筛选器筛选列表。

例如,以下查询演示如何跨所有项目查询所关注的活动工作项。 将 ID 字段和 In 运算符与 @Follows宏一 起使用。

查询编辑器,ID In @Follows query 子句

查询最近的工作项活动

可以使用以下宏根据最近的活动列出工作项:

  • @MyRecentActivity:列出最近查看或修改过的项。
  • @RecentMentions:列出在过去 30 天内通过 @mention 添加到的项目。
  • @RecentProjectActivity:列出最近在项目中创建或修改的项。

指定 ID 字段以及 InNot In 运算符。

例如,以下查询演示如何查询最近查看或修改的工作项。

查询编辑器,ID 为 in @MyRecentActivity 查询子句

大多数工作项类型的常见字段

下表介绍了用于筛选查询的常用字段。 ID 字段唯一标识列表中的工作项。 使用 “标题 ”字段可将工作项与同一类型的所有其他项区分开来。 说明和其他富文本 (数据类型=HTML) 字段提供了实现工作和跟踪更改所需的其他信息。 创建工作项后,可以修改 除 ID 之外的所有字段。 添加和保存工作项时,ID 由系统分配,无法更改。

注意

系统会自动为所有长文本字段编制索引,其数据类型为 PlainTextHTML 字段进行全文搜索。 这包括 “标题”、“ 说明”和 “重现步骤” 字段。 有关适用于本地 Azure DevOps 的详细信息和服务器和排序规则要求,请参阅 查询字段、运算符、值和变量 - 全文和部分词搜索

字段名称

说明

工作项类型


接受条件 1

在关闭 Bug 或产品积压工作项之前,需满足的条件说明。

在开始执行 Bug 或产品积压工作 (backlog) 项之前,应尽可能明确地说明客户验收条件。 团队与客户之间的对话定义验收条件将有助于确保团队了解客户的期望。 验收条件可用作验收测试的基础,以便你可以更加高效地评估项目是否圆满完成。

引用名称=Microsoft.VSTS.Common.AcceptanceCriteria, 数据类型=HTML

Bug、Epic、Feature、Product 积压工作项 (Scrum)

说明 1、2

使用此字段提供有关工作项的深入信息。

引用名称=System.Description,数据类型=HTML

全部

ID

分配给工作项的唯一标识符。 工作项 ID 在所有项目和项目集合中都是唯一的。

引用名称=System.Id,数据类型=Integer

全部

重现步骤 (或重现) 1 的步骤

重现意外行为所需的步骤。 捕获足够的信息,以便其他团队成员可以了解问题的总体影响以及他们是否已修复 Bug。 这包括查找或重现 Bug 和预期行为所执行的操作。
引用名称=Microsoft.VSTS.TCM.ReproSteps, 数据类型=HTML

Bug

解决方法

描述如何解决障碍。

引用名称=Microsoft.VSTS.Common.Resolution, 数据类型=HTML

障碍 (Scrum)

系统信息1

与 Bug、代码评审或反馈相关的软件和系统配置的信息。

引用名称=Microsoft.VSTS.TCM.SystemInfo, 数据类型=HTML

Bug、代码评审请求、反馈请求

团队项目

工作项所属的项目。 如果要将列表筛选为一个或多个项目中的项,请将此字段添加到查询中。

注意

  对于Azure Boards或 TFS 2015.1 及更高版本,必须在查询编辑器中检查“跨项目查询”选项,以便此字段显示在下拉列表中。 若要了解详细信息,请参阅 示例查询,跨项目查询

引用名称=System.TeamProject,数据类型=String

全部

Title

总结了工作项的含义以及帮助团队成员将其与列表中其他工作项区分开的简短说明。

引用名称=System.Title,数据类型=String

全部

工作项类型

工作项类型的名称。 基于创建项目时使用的过程定义工作项类型。 有关概述,请参阅 “选择过程”。 若要了解如何添加自定义工作项类型,请参阅 “添加或修改工作项类型”。

若要根据 工作项的类别分配筛选工作项,可以使用 “分组 ”和“ 不在组 ”运算符,并从下拉列表中选择一个类别。

引用名称=System.WorkItemType,数据类型=String

全部

注意

  1. 若要了解有关使用富文本字段的详细信息,请参阅 工作项中的共享信息
  2. 升级到 Team Foundation Server 2012 后,“说明”字段已从纯文本字段类型更改为 HTML。 使用 witadmin changefield 命令可以还原此字段的数据类型。 请参阅 “管理工作项”字段 (witadmin)

REST API

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