按区域或迭代路径查询

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	排除在特定区域或迭代路径下分配的项。

除了这些运算符，还可以在选择迭代路径时使用以下宏。 有关示例，请参阅按日期或当前迭代进行查询。

宏	在你想要完成以下事项时使用...
@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
迭代路径	将工作项按照指定的冲刺 (sprint) 或时间段分组。 迭代必须是项目层次结构中的有效节点。	System.IterationPath

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

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

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

以下字段不显示在工作项表单中，但系统会针对每种类型的工作项来跟踪它们。 这些字段为针对某项目定义的每个分类值提供一个数值。 可以使用这些字段筛选查询并创建报告。

字段名称	说明	引用名称	Data type
区域 ID	分配有此工作项的区域的唯一 ID。	System.AreaId	Integer
迭代 ID	分配有此工作项的迭代的唯一 ID。	System.IterationId	Integer
节点名称	区域路径的最后一个节点的名称。 例如，如果区域路径是 Project\A1\B2\C3，则节点名是 C3。	System.NodeName	String

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

相关文章

• 查询快速参考
• 定义区域路径并分配给团队
• 定义迭代路径（冲刺 (sprint)）并配置团队迭代
• 设置工作跟踪的权限和访问权限

REST API

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

• Azure DevOps Services REST API 参考
• 查询
• 工作项查询语言
• 使用查询以编程方式提取工作项