在 Azure Boards 中使用托管查询跟踪工作
Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018
根据使用查询指定的字段条件列出 bug、用户情景或其他工作项。 然后，可以使用团队查看这些列表、会审工作或批量更新工作项。 除了托管查询，语义搜索工具还提供一些值得探索的重叠和不同的功能。
使用托管查询支持以下操作：
- 使用 Web 门户批量更新工作项
- 会审和更新工作项
- 查看工作项的层次结构
- 与团队成员共享工作项列表
可以从 Web 门户或受支持的客户端（例如 Visual Studio 团队资源管理器和 Team Explorer Everywhere）创建查询和查询文件夹，这是 Eclipse 插件。 在一个客户端中所做的更改反映在其他客户端中，因为所有更改都存储在工作跟踪数据存储中。
开始使用查询
如果刚开始，请阅读 “视图”、“运行”或“通过电子邮件发送工作项查询”。 有关查询编辑器任务和示例查询的快速参考，请参阅 查询快速参考。
- 若要查找分配给你的工作项， 请将@Me 宏添加为其中一个查询子句中 “已分配给 ”字段的值。
- 具有标准访问权限的所有有效用户都可以在 “我的查询” 区域下创建查询和文件夹。 若要在 共享查询下创建查询和查询文件夹，必须具有“参与”权限集。 有关详细信息，请参阅 设置对查询的权限。
- 可以通过添加条件来修改任何查询，以专注于产品区域、迭代或其他字段。 若要修改查询， 请打开查询编辑器。
- 可以在 Excel 中打开任何查询。 还可以更新一个或多个工作项的字段，并将更改发布到数据库以跟踪工作项。
- 可以通过为平面列表查询创建饼图、柱形图或趋势图 来可视化状态或进度 。
查询功能
以下部分概述了定义和管理工作项查询支持的函数。
- 查询筛选器通过查询编辑器定义。
- 可以为特定字段选择查询宏以创建查询子句。
- 查询结果和查询管理功能是通过“查询结果”页提供的。
查询筛选器
下表汇总了每个 Azure DevOps 版本支持的查询筛选器函数。
注意
托管查询不支持邻近搜索，但语义搜索确实支持邻近搜索。 此外，语义搜索支持通 * 配符和 ? 通配符，你可以使用多个通配符来匹配多个字符。 若要了解详细信息，请参阅 功能工作项搜索。
筛选器函数
查询支持
支持的版本
文本字符串搜索 (单文本、多行文本、格式文本)
搜索不区分大小写。
所有版本
通配符 = *
所有版本
根据直接链接或拓扑/分层链接类型查找工作项。
根据 MODE (WIQL 语法 筛选链接的工作项)
所有版本
使用 AND 和 OR 布尔运算符对子句进行分组和嵌套。
所有版本
根据与上一个值的字段匹配查找工作项。
支持的运算符： Was Ever 根据特定日期定义的值查找工作项。
支持的运算符： ASOF (WIQL 语法)
所有版本
使用宏创建相对于日期、其他工具（例如团队区域路径、团队迭代等）的查询。
所有版本
在组织或集合中的一个或多个项目中查找工作项。 默认值为当前项目。 使用 “团队项目” 字段查询两个或多个项目。
TFS 2015-TFS 2018、Azure DevOps 2019-2020、Azure DevOps Services
根据两个字段相互比较的方式查找工作项。
支持的运算符： =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]
所有版本
根据工作项是否包含或不包含标记来查找工作项。
支持的运算符： Contains, Does Not Contain
所有版本
根据空或非空 HTML/格式文本字段查找工作项。
支持的运算符： Is Empty, Is Not Empty
Azure DevOps 2019-2020，Azure DevOps Services
查找字段值与分隔集中的任何值匹配的工作，例如一组工作项类型、工作流状态或选取列表值。 用列表分隔符分隔值，列表分隔符与为你的客户端计算机定义的区域设置相对应。 例如，可以使用逗号 (,)。
TFS 2018、Azure DevOps 2019-2020、Azure DevOps Services
根据布尔字段值查找工作项。
TFS 2017-TFS 2018、Azure DevOps 2019-2020、Azure DevOps Services
根据通过讨论添加的关键字或短语查找工作项。
TFS 2017.2-TFS 2018、Azure DevOps 2019-2020、Azure DevOps Services
根据看板栏、泳道或“完成”状态查找工作项。
Azure DevOps 2019-2020，Azure DevOps Services
根据关键字或选择字段筛选查询结果。
Azure DevOps 2019-2020，Azure DevOps Services
若要批量移动、复制或粘贴查询子句，请安装和使用 WIQL 编辑器。 若要了解详细信息，请参阅 跨服务和增强型查询操作
支持的宏
下表汇总了 Azure DevOps 版本支持的查询宏或变量。 可以使用其中一些宏来筛选通知。
注意
只能从 Web 门户使用某些宏。 其中包括@CurrentIteration、@CurrentIteration +/- n、@Follows、@MyRecentActivity、@RecentMentions、@RecentProjectActivity和@TeamAreas宏。 将查询导出到 Excel、通知筛选器或从团队资源管理器或 REST API 练习时，不支持这些宏。
有关示例的更详细说明和链接，请参阅 查询字段、运算符和宏。
宏
查询支持
支持的版本
查找任何工作项类型， Work Item Type=[Any]或任何状态 State=[Any]。
所有版本
查找工作位置 Identity field=logged in user。
所有版本
查找工作位置 Date-Time field=today。
所有版本
查找在一个或多个项目中定义的工作。
TFS 2015-TFS 2018、Azure DevOps 2019-2020、Azure DevOps Services
查找团队当前迭代中定义的工作。
所有版本
查找在团队当前迭代的 +/- n 中定义的工作。
Azure DevOps 2019-2020，Azure DevOps Services
查找当前登录用户正在关注的工作。 ID In @Follows
TFS 2017-TFS 2018、Azure DevOps 2019-2020、Azure DevOps Services
查找最近更改的工作项， ID In @MyRecentActivity 另请参阅 “查看和添加工作项”，“工作项”页。
TFS 2018、Azure DevOps 2019-2020、Azure DevOps Services
查找所选日期时间字段在当前日期、月、周或年份内以及加/减偏移量的工作，例如： Closed Date>=@StartOfDay-7
Azure DevOps 2019-2020，Azure DevOps Services
查找分配给指定团队的区域路径或迭代路径的工作，例如，请参阅 按区域或迭代路径进行查询。
Azure DevOps 2019-2020，Azure DevOps Services
查询结果和查询管理功能
以下功能支持使用查询结果、保存和共享查询等。
- (csv) 导入/导出查询
- 导入/导出查询 (.wiq)
- 打开并运行查询
- (Excel) 发布/刷新查询
- 运行 REST API 查询
- 保存查询
- 设置查询权限
- 会审查询结果
不支持的功能
工作项查询仅支持查询链接到其他工作项的工作项和工作项。 下面是托管查询不支持的一些任务：
- Test Plans、测试套件和测试用例的分层视图。 这些项不使用父子链接类型链接在一起。 相反，可以通过“测试>”页查看层次结构Test Plans。
- 显示链接对象的视图，例如生成、发布、代码或其他非工作项对象。
- 列出从一个项目链接到另一个项目的工作项。
- 将跨项目查询导出到 Excel。 将查询作为平面列表导出到 Excel 的直接链接。
查询类型 (平面、直接链接、树)
Azure Boards支持三种查询类型。 每个查询旁边的图标指示查询类型。 使用以下指南根据要完成的查询类型来选择查询类型。
查询类型
用法指南
工作项简单列表
- 列出要对字段进行批量更新的项目
- 会审工作项列表
- 创建查询图表并将其添加到仪表板
- 创建图表以获取项计数或求和字段
- 将项目列表导出到 Excel 以更新字段
工作项和直接链接
- 列出依赖于其他工作项的项目
- 查找相关项或依赖于其他工作项
- 列出链接的工作项以对字段进行批量更新
- 会审链接的工作项列表
- 列出与测试相关的链接工作项
- 查找孤立积压工作项、没有父项的工作项
注意
工作项和直接链接 查询以平面列表的形式导出到 Excel。 直接链接查询作为平面列表导入，因为修改多种类型的链接在 Excel 中不受支持。
工作项树
- 列出Parent-Child相关工作项或其他树拓扑链接类型的树
- 会审工作项的分层列表
- 将项的分层列表导出到 Excel 以更新字段或修改层次结构
若要了解有关链接类型的详细信息，请参阅 链接类型引用。
我的查询、共享查询和收藏夹
只能查看并运行使用查询目录在 “我的查询 ”下保存的查询。 此外，还可以收藏其中一个查询，使其显示在查询选择器中。
你和其他人在 共享查询 下保存的查询可由有权访问该项目的每个人都查看。 共享查询可以组织在文件夹内，由你或团队收藏。 此外，还可以设置文件夹和查询的权限，以防止其他人移动或编辑它们。
有关详细信息，请参阅：
查询目录、查询文件夹和痕迹导航
“ 查询 ”页包含一个以目录为中心的视图，可用于筛选以查找感兴趣的特定查询。 在 查询 页中工作时，可以导航到子文件夹、文件夹或页面。
此外，还可以从选择器菜单中选择你喜欢的查询。 或者，可以选择浏览返回“ 所有查询 ”页的所有查询。
有关详细信息，请参阅 查询常见问题解答、导航和文件夹。
查询图表和小组件
可以从平面列表查询快速创建饼图、条形图、透视图和趋势图。 查询必须是平面列表，并且返回 1000 个或更少的工作项。 可以将查询图表添加到仪表板、重新设置和重新配置它们。
基于查询的小组件支持在仪表板上显示查询信息。 例如，可以与之交互的活动 bug 数或工作项列表。 若要了解查询图表和小组件，请参阅以下文章：
添加自定义字段以支持查询
若要添加自定义字段以支持查询需求，请参阅 自定义工作跟踪体验。
任务板与查询列表项
你可能会注意到并想知道为什么任务板的内容与其创建的查询中列出的内容不同？ 若要了解详细信息，请参阅 任务板项与查询列表项。
全文搜索查询和排序规则设置
为了支持全文搜索查询，SQL Server数据库的排序规则设置应对应于一种语言，该语言具有注册到SQL Server的断字符。 如果使用不受支持的语言，则运行包含或包含文本字符串的包含字词运算符的工作项查询时，可能会收到意外结果。
若要了解更多信息，请参阅下列文章：
REST API
若要以编程方式与查询交互，请参阅以下 REST API 资源之一：