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