按区域或迭代路径查询
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
“区域路径”和“迭代路径”是所有工作项类型的工作跟踪表单上显示的两个字段。 针对项目对其进行定义（区域路径和迭代路径），然后选择要与团队关联的路径。
若要更好地了解如何使用区域和迭代路径，请参阅关于团队和敏捷工具。
先决条件
| 类别 | 要求 |
|---|---|
| 访问级别 | - 若要查看和运行共享查询：项目成员。 - 要添加和保存共享查询：至少需要 基本 访问权限。 |
| 权限 | 对于要添加查询的文件夹，请将“参与”权限设置为“允许”。 默认情况下，“参与者”组没有此权限。 |
注意
具有 持有利益者 访问权限的用户在公共项目中对查询功能拥有与 基本 访问权限用户相同的完全访问权限。 有关详细信息，请参阅利益干系人访问快速参考。
| 类别 | 要求 |
|---|---|
| 访问级别 | - 若要查看和运行共享查询：项目成员。 - 若要添加并保存共享查询：至少具有“基本”访问权限。 |
| 权限 | 对于要添加查询的文件夹，请将“参与”权限设置为“允许”。 默认情况下，“参与者”组没有此权限。 |
注意
以下宏仅在 Web 门户中受支持：@CurrentIteration、@CurrentIteration +/- n、@Follows、@MyRecentActivity、@RecentMentions、@RecentProjectActivity 以及 @TeamAreas。 在 Visual Studio/团队资源管理器、Microsoft Excel 或 Microsoft Project 中打开时，包含这些宏的查询将不起作用。
支持的运算符和宏
创建查询并指定“区域路径”和“迭代路径”字段时，可以使用以下运算符：
| 操作员 | 在你想要完成以下事项时使用... |
|---|---|
= |
指定一个特定区域或迭代路径 |
<> |
筛选出一个特定区域或迭代路径。 |
In |
筛选一组区域或迭代路径。 |
Not In |
排除分配到一组区域或迭代路径的项。 |
Under |
指定选择区域或迭代路径下的所有路径。 |
Not Under |
排除在特定区域或迭代路径下分配的项。 |
除了这些运算符，还可以在选择迭代路径时使用以下宏。 有关示例，请参阅按日期或当前迭代进行查询。
| Macro | 在你想要完成以下事项时使用... |
|---|---|
@CurrentIteration |
指定与所选团队上下文关联的当前迭代。 |
@CurrentIteration +/- n |
根据与所选团队上下文关联的冲刺 (sprint) 滑动窗口的分配筛选项。 |
@TeamAreas |
根据分配到特定团队的区域路径筛选项。 |
注意
Azure DevOps Server 2019 及更高版本支持 @CurrentIteration +/- n 和 @TeamAreas 宏。 这些宏仅在 Web 门户中受支持。 在 Visual Studio/团队资源管理器、Microsoft Excel 或 Microsoft Project 中打开时，包含这些宏的查询将不起作用。
区域路径查询
可以使用 In 运算符筛选分配给多个区域路径的工作项，如以下示例所示。
节点名称和基于关键字的查询
使用节点名称字段，以使用 Contains 运算符根据关键字筛选分配到区域路径的工作项。 节点名称指定区域路径的最后一个节点，该节点对应于树层次结构中的最后一个节点。
以下查询生成的结果与上一示例相同。
在此示例中，筛选器返回分配给一个区域路径的任何工作项，且该路径的最后一个节点包含“Azure”这个词。
下面是使用节点名称和 In 运算符的另一个示例。
团队区域路径查询
使用 @TeamAreas 宏快速查找分配到区域路径（分配到特定团队）的项。 指定 = 运算符。 查询编辑器会自动提示你输入团队的名称。 可通过输入团队名称并选择搜索筛选条件中显示的团队值来添加该团队。
的区域路径
分类字段引用
| 字段名称 | 描述 | 引用名称 |
|---|---|---|
| 区域路径 | 将工作项分组到产品功能或团队领域。 区域必须是项目层次结构中的有效节点。 | System.AreaPath |
| 迭代路径 | 按指定的冲刺或时间段对工作项进行归类。 迭代必须是项目层次结构中的有效节点。 | System.IterationPath |
对于每个字段，data path=TreePath、reportable type=Dimension、index attribute=True。
如果定义的路径名超过 256 个字符，则将无法在 Microsoft Project 中将其指定。 若要避免此问题，请定义不超过 10 个字符的路径名，并且嵌套的节点不超过 14 层。
不可将大部分字段规则应用到 system 字段，如 System.AreaPath 和 System.IterationPath 字段。 有关详细信息，请参阅规则和规则评估。
以下字段不会出现在工作项表单上，但仍会针对每个工作项类型进行跟踪。 这些字段为针对某项目定义的每个分类值提供一个数值。 可以使用这些字段筛选查询并创建报告。
| 字段名称 | 描述 | 引用名称 | 数据类型 |
|---|---|---|---|
| 区域 ID | 分配有此工作项的区域的唯一 ID。 | System.AreaId | Integer |
| 迭代 ID | 分配有此工作项的迭代的唯一 ID。 | System.IterationId | Integer |
| 节点名称 | 区域路径的最后一个节点的名称。 例如，如果区域路径是 Project\A1\B2\C3，则节点名是 C3。 | System.NodeName | 字符串 |
默认的可报告类型为无。 区域 ID 和迭代 ID 已编制索引，节点名称未编制索引。 要了解有关字段属性的详细信息，请参阅工作项字段和属性。
相关文章
REST API
要以编程方式与查询交互，请参阅以下 REST API 资源之一：