通过在 Azure Boards 中使用托管查询跟踪工作

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

根据你使用查询指定的字段条件列出 bug、用户情景或其他工作项。 然后,你可以与团队一起查看这些列表、会审工作或批量更新工作项。 除了托管查询之外,语义搜索工具还提供一些值得探索的重叠和不同的功能。

使用托管查询支持以下操作:

  • 使用 Web 门户批量更新工作项
  • 会审和更新工作项
  • 查看工作项的层次结构
  • 与团队成员共享工作项列表

可以从 Web 门户或 Visual Studio 团队资源管理器创建查询和查询文件夹。 在一个客户端中所做的更改会反映在其他客户端中,因为所有更改都存储在工作跟踪数据存储中。

查询使用入门

如果你是刚刚接触,请阅读查看、运行或通过电子邮件发送工作项查询。 有关查询编辑器任务和示例查询的快速参考,请参阅查询快速参考

  • 若要查找分配给你的工作项,请在查询子句之一中将 @Me 宏添加为“分配到”字段的值。
  • 所有具有标准访问权限的有效用户都可以在“我的查询”区域下创建查询和文件夹。 若要在“共享查询”下创建查询和查询文件夹,你必须设置“参与”权限。 有关详细信息,请参阅对查询设置权限
  • 可以通过添加条件来修改任何查询,以关注某一产品区域、一个迭代或其他字段。 若要修改查询,请打开查询编辑器
  • 可以在 Excel 中打开任何查询。 还可以更新一个或多个工作项的字段,并将更改发布到数据库用于跟踪工作项。
  • 通过创建饼图、柱形图或用于简单列表查询的趋势图可以可视化状态或进度

查询功能

以下部分概述了支持的用于定义和管理工作项查询的函数。

  • 查询筛选器通过查询编辑器定义。
  • 可以为特定字段选择查询宏以创建查询子句。
  • 查询结果和查询管理功能是通过“查询结果”页提供的功能。

查询筛选器

下表汇总了每个 Azure DevOps 版本支持的查询筛选器函数。

注意

托管查询不支持邻近搜索,但语义搜索支持。 此外,语义搜索还支持 *? 作为通配符,你可以使用多个通配符来匹配多个字符。 有关详细信息,请参阅功能工作项搜索


筛选器函数

查询支持

支持的版本


文本字符串搜索(单一文本、多行文本、富文本)

搜索不区分大小写。

所有版本


通配符 = *

所有版本


根据直接链接或拓扑/分层链接类型查找工作项。
根据MODEWIQL 语法)筛选链接的工作项

所有版本


使用 AND 和 OR 布尔运算符对子句进行分组和嵌套。

所有版本


根据与上一个值匹配的字段查找工作项。 支持的运算符:Was Ever 根据在特定日期定义的值查找工作项。 支持的运算符:ASOFWIQL 语法

所有版本


使用宏创建与日期、其他工具(如团队区域路径、团队迭代等)相关的查询。

所有版本


在组织或集合的一个或多个项目中查找工作项。 默认值为当前项目。 使用“团队项目”字段查询两个或更多项目。

所有版本


根据两个字段相互比较的方式查找工作项。
支持的运算符:=[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]

所有版本


根据工作项是否包含标记来查找工作项。 支持的运算符:Contains, Does Not Contain

所有版本


根据空或非空 HTML/富文本字段查找工作项。
支持的运算符:Is Empty, Is Not Empty

Azure DevOps 2019 至 Azure DevOps Server 2022,Azure DevOps Services


查找其字段值与分隔集中的任何值匹配的工作,例如一组工作项类型、工作流状态或选择列表值。 用列表分隔符分隔值,列表分隔符与为你的客户端计算机定义的区域设置相对应。 例如,可以使用逗号 (,)。

所有版本


根据布尔字段值查找工作项。

所有版本


根据通过讨论添加的关键字或短语查找工作项。

所有版本


根据工作项的列、泳道或“执行/完成”状态查找工作项。

Azure DevOps 2019 至 Azure DevOps Server 2022,Azure DevOps Services


根据关键字或选择字段筛选查询结果。

Azure DevOps 2019 至 Azure DevOps Server 2022,Azure DevOps Services


要批量移动、复制或粘贴查询子句,请安装并使用 WIQL 编辑器

支持的宏

下表汇总了 Azure DevOps 版本支持的查询宏或变量。 可以使用其中一些宏来筛选通知。

注意

只能从 Web 门户使用某些宏。 其中包括 @CurrentIteration、@CurrentIteration +/- n、@Follows、@MyRecentActivity、@RecentMentions、@RecentProjectActivity 和 @TeamAreas 宏。 将查询导出到 Excel、通知筛选器或从团队资源管理器或 REST API 练习时,不支持这些宏。

有关更详细的说明和示例链接,请参阅查询字段、运算符和宏


查询支持

支持的版本


查找任何工作项类型 Work Item Type=[Any],或任何状态 State=[Any]

所有版本


@Me

查找工作,其中 Identity field=logged in user

所有版本


查找其中 Date-Time field=today 的工作。

所有版本


查找在一个或多个项目中定义的工作。

所有版本


查找在团队的当前迭代中定义的工作。

所有版本


查找在团队当前迭代的 +/- n 中定义的工作。

Azure DevOps 2019 至 Azure DevOps Server 2022,Azure DevOps Services


查找当前登录用户正在关注的工作,ID In @Follows

所有版本


查找最近更改的工作项,ID In @MyRecentActivity 另请参阅查看和添加工作项,工作项页面

所有版本


查找所选日期时间字段在当前日期、月份、周或年份内且具有 +/- 偏移量的工作,例如:Closed Date>=@StartOfDay-7

Azure DevOps 2019 至 Azure DevOps Server 2022,Azure DevOps Services


查找分配给指定团队的区域路径或迭代路径的工作,有关示例,请参阅按区域或迭代路径查询

Azure DevOps 2019 至 Azure DevOps Server 2022,Azure DevOps Services


查询结果和查询管理功能

以下功能支持使用查询结果、保存和共享查询等。



不支持的功能

工作项查询仅支持查询工作项和链接到其他工作项的工作项。 下面是托管查询不支持的一些任务:

  • 测试计划、测试套件和测试用例的分层视图。 这些项不会使用“父-子”链接类型链接在一起。 而是,可以通过“测试”>“测试计划”页面查看层次结构
  • 显示链接对象(如生成、发布、代码或其他非工作项对象)的视图。
  • 列出从一个项目链接到另一个项目的工作项。
  • 将跨项目查询导出到 Excel。 直接链接查询以简单列表的形式导出到 Excel。

Azure Boards 支持三种查询类型。 每个查询旁边的图标指示查询类型。 使用以下指南根据要完成的查询任务来选择查询类型。

查询类型图标列表


查询类型

用法指南


工作项简单列表

  • 列出要对字段进行批量更新的项
  • 会审工作项列表
  • 创建查询图表并将其添加到仪表板
  • 创建图表以获取项计数或对字段求和
  • 将项列表导出到 Excel 以更新字段

工作项和直接链接

  • 列出依赖于其他工作项的项
  • 查找相关或依赖于其他工作项的项
  • 列出要对字段进行批量更新的链接工作项
  • 会审已链接的工作项的列表
  • 列出与测试相关的链接工作项
  • 查找孤立的积压工作项、没有父级的工作项

注意

工作项和直接链接查询以简单列表的形式导出到 Excel。 直接链接查询以简单列表的形式导入,因为 Excel 中不支持修改多种类型的链接。


工作项树

  • 列出“父-子”相关工作项或其他树拓扑链接类型的树
  • 会审工作项的分层列表
  • 将项分层列表导出到 Excel 以更新字段或修改层次结构

若要了解有关链接类型的详细信息,请参阅链接类型参考

我的查询、共享查询和收藏夹

只有你才能使用查询目录查看和运行在“我的查询”下保存的查询。 此外,还可以收藏其中一个查询,使其显示在查询选择器中。

你和其他人在“共享查询”下保存的查询可由有权访问该项目的所有人查看。 共享查询可以在文件夹中进行组织,由你或为团队收藏。 此外,还可以设置对文件夹和查询的权限,以防止其他人移动或编辑文件夹。

有关详细信息,请参阅:

查询目录、查询文件夹和痕迹导航

“查询”页包含一个以目录为中心的视图,你可以筛选该视图以查找感兴趣的特定查询。 在“查询”页中操作时,可以转到子文件夹、文件夹或页面。

查询痕迹导航

此外,还可以从选择器菜单中选择收藏的查询。 或者,可以选择浏览使你返回到“所有查询”页的所有查询。

查询、查询选择器的屏幕截图。

有关详细信息,请参阅查询常见问题解答、导航和文件夹

查询图表和小组件

可以通过简单列表查询快速创建饼图、条形图、透视图和趋势图。 查询必须是简单列表,并返回 1000 个或更少的工作项。 可以将查询图表添加到仪表板,重新命名和重新配置。

示例饼图。 示例数据透视图。示例条形图。 示例趋势图。

基于查询的小组件支持在仪表板上显示查询信息。 例如,活动 bug 的数量或你可以与之交互的工作项列表。 若要了解查询图表和小组件,请参阅以下文章:

添加自定义字段以支持查询

若要添加自定义字段以支持查询需求,请参阅自定义工作跟踪体验

任务板项与查询列表项

你可能会注意到并想知道为什么任务板的内容与其创建的查询中列出的内容不同? 有关详细信息,请参阅任务面板项与查询列表项

全文搜索查询和排序规则设置

若要支持全文搜索查询,SQL Server 数据库的排序规则设置应对应于具有注册到 SQL Server 的分词系统的语言。 如果使用不受支持的语言,则运行指定包含文本字符串的 Contains 或 Contains Words 运算符的工作项查询时,可能会收到意外结果。

有关详细信息,请参阅以下文章:

REST API

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