通过

按区域或迭代路径查询

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

每个工作项类型的所有工作项窗体上都显示区域路径和迭代路径字段。 为项目定义这些路径（区域路径 和 迭代路径），然后选择要与团队关联的路径。

若要了解如何使用区域和迭代路径，请参阅 “关于团队”和“敏捷”工具。

Prerequisites

Category Requirements
访问级别 - 若要查看和运行共享查询：项目成员。
- 要添加和保存共享查询：至少需要 基本 访问权限。
Permissions 对于要添加查询的文件夹，请将参与权限设置为允许。 默认情况下，“参与者”组没有此权限。

Note

具有 持有利益者 访问权限的用户在公共项目中对查询功能拥有与 基本 访问权限用户相同的完全访问权限。 有关详细信息，请参阅利益干系人访问快速参考。

Category Requirements
访问级别 - 若要查看和运行共享查询：项目成员。
- 要添加并保存共享查询：至少具有基本访问权限。
Permissions 对于要添加查询的文件夹，请将参与权限设置为允许。 默认情况下，“参与者”组没有此权限。

Note

以下宏仅在 Web 门户中受支持：@CurrentIteration、@CurrentIteration +/- n、@Follows、@MyRecentActivity、@RecentMentions、@RecentProjectActivity 以及 @TeamAreas。 在 Visual Studio/团队资源管理器、Microsoft Excel 或 Microsoft Project 中打开时，包含这些宏的查询将不起作用。

支持的运算符和宏

创建查询并指定区域路径和迭代路径字段时，可以使用以下运算符：

Operator 在你想要完成以下事项时使用...
= 指定一个特定区域或迭代路径
<> 筛选掉一个特定区域或迭代路径
In 筛选一组区域或迭代路径
Not In 排除分配给一组区域或迭代路径的项
Under 指定所选区域或迭代路径下的所有路径
Not Under 排除在特定区域或迭代路径下分配的项

选择“迭代路径”字段时，可以使用以下宏。 有关示例，请参阅此页面上的查询示例。

Macro 在你想要完成以下事项时使用...
@CurrentIteration 指定与所选团队上下文关联的当前迭代
@CurrentIteration +/- n 根据分配给选定团队上下文相关迭代的滑动窗口来筛选项目。
@TeamAreas 根据分配给特定团队的区域路径筛选项目

Note

Azure DevOps Web 门户评估宏，例如 @CurrentIteration、@CurrentIteration +/- n 和 @TeamAreas（服务和服务器）。 非 Web 客户端（Visual Studio/Team Explorer、Excel、Project）和直接 WIQL/REST 调用需要显式区域/迭代路径，并且不接受原始宏令牌。 在 Web UI 中保存查询时，门户通常会将宏扩展到存储的 WIQL 中的具体值，如果需要在 Web UI 外部使用查询，请在环境中验证此行为。

区域路径查询

可以使用 In 运算符筛选分配给多个区域路径的工作项，如以下示例所示。

显示多个区域的“区域路径”查询的屏幕截图。

节点名称和基于关键字的查询

使用 “节点名称 ”字段根据使用 Contains 运算符的关键字筛选分配给区域路径的工作项。 节点名称指定区域路径的最后一个节点，该节点对应于树层次结构中的最后一个节点。

以下查询生成与上一个示例相同的结果。

显示多个区域的节点名称查询的屏幕截图。

在此示例中，筛选器返回分配给区域路径的工作项，其最后一个节点包含“Azure”一词。

显示多个冲刺查询的屏幕截图。

下面是使用节点名称和 In 运算符的另一个示例。

显示多个区域的节点名称查询的屏幕截图。

团队区域路径查询

使用 @TeamAreas 宏查找分配给特定团队使用的区域路径的项目。 指定 = 运算符。 查询编辑器会提示输入团队名称;从建议列表中选择团队。

显示对分配给团队的区域路径的查询的屏幕截图。

分类字段引用

字段名称 Description 引用名称
区域路径 将工作项分组到产品功能或团队领域。 区域必须是项目层次结构中的有效节点。 System.AreaPath
迭代路径 按指定的冲刺或时间段对工作项进行归类。 迭代必须是项目层次结构中的有效节点。 System.IterationPath

对于每个字段，data path=TreePath、reportable type=Dimension、index attribute=True。

如果定义的路径名称超过 256 个字符，则无法在 Microsoft Project 中指定它。 若要避免此问题，请定义不超过 10 个字符的路径名，并且嵌套的节点不超过 14 层。

不可将大部分字段规则应用到 system 字段，如 System.AreaPath 和 System.IterationPath 字段。 有关详细信息，请参阅规则和规则评估。

以下字段不会显示在工作项窗体上，但 Azure DevOps 会跟踪每个工作项类型的字段。 这些字段为为项目定义的每个分类值提供数值。 可以使用这些字段筛选查询并创建报告。

字段名称 Description 引用名称 数据类型
区域 ID 分配这个工作项所在区域之唯一 ID。 System.AreaId Integer
迭代 ID 分配此工作项的迭代的唯一 ID。 System.IterationId Integer
节点名称 区域路径的最后一个节点的名称。 例如，如果区域路径是 Project\A1\B2\C3，则节点名是 C3。 System.NodeName String

默认的可报告类型为无。 区域 ID 和迭代 ID 具有索引。 节点名称不存在。 要了解有关字段属性的详细信息，请参阅工作项字段和属性。

相关内容

REST API

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