按区域或迭代路径查询

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

区域路径和迭代路径是所有工作项类型的工作跟踪窗体上显示的两个字段。 为项目(区域路径迭代路径)定义它们,然后选择要与团队关联的项目。

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

注意

Web 门户仅支持以下宏:@CurrentIteration@CurrentIteration +/- n、@Follows@MyRecentActivity@RecentMentions@RecentProjectActivity@TeamAreas。 在 Visual Studio/Team Explorer、Microsoft Excel 或 Microsoft Project 中打开时,包含这些宏的查询将不起作用。

支持的运算符和宏

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

操作员 想要...
= 指定一个特定区域或迭代路径
<> 筛选出一个特定的区域或迭代路径。
位于 筛选一组区域或迭代路径。
不位于 排除分配给一组区域或迭代路径的项目。
指定选择区域或迭代路径下的所有路径。
不小于 排除在特定区域或迭代路径下分配的项。

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

想要...
@CurrentIteration 指定与所选团队上下文关联的当前迭代。
@CurrentIteration +/- n    根据分配给与所选团队上下文关联的短跑滑动窗口筛选项目。
@TeamAreas 根据分配给特定团队的区域路径 () 筛选项。

注意

TFS 2015 及更高版本支持 @CurrentIteration 宏。 Azure DevOps Server 2019 及更高版本支持 @CurrentIteration +/n@TeamAreas 宏。 这些宏仅受 Web 门户支持。 在 Visual Studio/Team Explorer、Microsoft Excel 或 Microsoft Project 中打开时,包含这些宏的查询将不起作用。

区域路径查询

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

查询多个区域的区域路径

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

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

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

针对多个区域的节点名称进行查询

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

查询多个冲刺

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

针对多个区域的节点名称进行查询

团队区域路径查询

使用 @TeamAreas 宏快速查找分配给特定团队的区域路径的项目。 =指定运算符。 查询编辑器会自动提示输入团队的名称。 可以通过键入团队的名称并选择显示在搜索筛选器条件中的团队值来添加它。

查询分配给团队的区域路径

分类字段参考

字段名称 说明 引用名称
区域路径 将工作项分组为产品功能或团队区域。 区域必须是项目层次结构中的有效节点。 System.AreaPath
迭代路径 将工作项按照指定的冲刺 (sprint) 或时间段分组。 迭代必须是项目层次结构中的有效节点。 System.IterationPath

对于每个字段,数据路径=TreePath、可报告类型=Dimension、索引属性=True

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

不能将大多数字段规则应用于系统字段,例如 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 已编制索引,节点名称不编制索引。 若要了解有关字段属性的详细信息,请参阅 “工作项”字段和属性

REST API

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