Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020
区域路径按团队、产品或功能区域对工作项进行分组。 迭代路径将工作分组到冲刺、里程碑或其他与时间相关的时间段。 这两个字段都支持分层路径。
定义项目的区域和迭代路径，团队可以选择用于积压工作和敏捷工具的路径。 了解敏捷工具如何在依赖于区域和迭代的敏捷工具中使用这些路径。
注意
区域路径和迭代路径也称为分类节点。 可以使用分类节点 (REST API) 或 Azure DevOps CLI 命令 az boards 迭代以编程方式管理它们。
注意
区域路径和迭代路径也称为 分类节点。 可以通过 分类节点 (REST API) 以编程方式管理它们。
区域和迭代取决于用于创建项目的过程。 此示例显示了 Scrum 进程的默认设置。 默认情况下不设置日期；需要设置日期以匹配冲刺或发布计划。
| 迭代 | 区域 |
|---|---|
|
|
重要说明
删除 区域路径 值或重新配置 迭代路径 值会导致以下图表中不可逆的数据丢失：
- 燃尽图和燃起图控件
- 冲刺燃尽图表
- 更改了区域路径的团队的速度图表
- 引用每个工作项时定义的 区域路径 和 迭代路径 值的历史趋势图
仅当任何工作项不再使用区域和迭代路径时，才能删除它们。 删除这些路径时，无法再检索其历史数据。
定义和分配区域路径
如果您不熟悉项目和团队管理，请执行以下步骤来配置项目和团队：
- 确定区域路径：定义对工作进行分类所需的区域路径的数量和名称。 至少为您定义的每个团队添加一个区域路径。
- 决定团队：确定要支持的团队的数量和名称。 有关详细信息，请参阅 关于团队和敏捷工具。
- 定义区域路径：定义区域路径以支持项目级别的步骤 1 和 2。 按照以下步骤操作：添加区域路径。
- 定义团队：定义支持步骤 2 所需的团队。 有关详细信息，请参阅“添加团队”，从一个默认团队移动到多个团队。
- 配置团队设置：使用以下步骤将默认区域路径和其他区域路径分配给每个团队。
- 分配工作项：将工作项分配您定义的区域路径。 使用 批量修改 一次修改多个工作项。
注意
每个项目最多可以定义 10,000 个区域路径，并向单个团队分配最多 300 个区域路径。 有关详细信息，请参阅 工作跟踪、流程和项目限制。
您可以将同一区域路径分配给多个团队，但如果两个团队声称拥有同一组工作项，则可能会导致问题。 有关更多信息，请参阅多团队面板视图的限制。
您可以随时执行以下操作：
- 添加更多子节点
- 重命名区域路径 (，根区域路径)
- 将子节点移到另一个节点下
- 删除子节点
- 重命名团队
- 更改对团队进行的区域路径分配
有关详细信息，请参阅配置团队层次结构。
团队应定义多少区域？
添加区域以支持团队的可跟踪性和安全性要求。 使用区域来表示逻辑组件或物理组件，并创建子区域来表示特定特征。
需要执行以下任一任务时添加区域：
- 基于产品或功能区域筛选查询
- 按团队或子团队组织或分组工作项
- 根据工作项的区域限制对工作项的访问
每个团队都可以创建一个区域层次结构，以组织积压工作项、用户情景、要求、任务和 Bug。
避免创建过于复杂的区域结构。 虽然可以使用区域来对工作项的权限进行分区，但复杂的树需要大量的权限管理开销。 复制其他项目中的结构和权限可能会变得繁琐。
定义和分配迭代路径
按照以下步骤为项目和团队配置迭代路径：
- 使用“定义区域路径并分配给团队”中的指导，定义区域路径和团队。
- 确定要支持的迭代的长度。 我们建议所有团队使用相同的冲刺节奏。
- 确定是想要平面结构还是冲刺和发布层次结构。
- 定义迭代路径，以支持项目级别的步骤 2 和 3。 按照以下步骤操作：添加迭代并设置迭代日期。
- 打开团队配置，并向每个团队分配默认、积压工作和其他迭代路径。 按照以下步骤操作：打开团队设置并设置团队默认迭代路径。
- 每个团队都应为其工作项分配一个迭代路径，该路径属于 积压工作迭代 路径。 这些工作项显示在产品积压工作和板上。 使用 批量修改 一次修改多个工作项。 另请参阅 将积压工作项分配到冲刺。
注意
每个项目最多可以定义 10,000 个迭代路径，并向单个团队分配最多 300 个迭代路径。 有关详细信息，请参阅 工作跟踪、流程和项目限制。
您可以随时执行以下操作：
- 添加更多子迭代节点
- 重命名迭代路径 (，根路径) 除外
- 将子迭代路径移到另一个节点下
- 删除子迭代路径
- 更改分配给团队的默认和所选迭代路径
团队应定义多少次迭代？
根据需要定义任意数量的子迭代来反映项目生命周期。 这些迭代可以表示各种事件，例如冲刺、prebeta 和 beta 阶段和其他发布里程碑。 如果尚未安排工作或发布，团队通常会将分配给团队的默认迭代的工作项保留。
添加迭代以支持以下要求：
- 为 Scrum 团队定义冲刺以规划和执行其冲刺
- 设置更复杂的多发布和冲刺周期
- 根据项目的冲刺、里程碑或周期时间筛选查询
- 支持尚未准备好分配到目标发布周期的未来工作。
在以下示例中，为 MyApplication 项目定义了 Beta 1、Beta 2、版本 1.0 和版本 2.0。
创建积压产品功能和任务时，请根据团队完成这些功能和任务的时间将其分配给里程碑。 随着需求的变化，可以在每个主要里程碑下添加事件，以反映团队如何安排和管理其工作。
例如，Beta 1 迭代现在包含三个子节点，一个用于 Beta 1 时间段中的每个冲刺。
迭代不强制实施任何规则。 例如，可以将任务分配给迭代，而无需在该迭代期间关闭或完成它。 在迭代结束时，确定保持活动或打开状态的所有工作项，并采取适当的措施。 可以将它们移动到其他迭代，或将它们返回到积压工作。
您可以运行查询来查找分配给特定迭代或一组迭代的功能和工作项，然后批量修改工作项以更改其迭代路径。 有关详细信息，请参阅按日期或当前迭代进行查询
命名限制
“区域路径”和“迭代路径”字段（数据类型=TreePath）由多个节点项组成，这些项由反斜杠 (\) 字符分隔。 最小化节点名称，并确保在添加子节点时符合以下限制。
| 限制类型 | 限制 |
|---|---|
| 节点长度 | 不能包含超过 255 个字符。 |
| 保留名称 | - 不能只包含一个或两个 . 句点 ..。- 不得是系统保留名称，例如 PRN、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、COM10、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、NUL、CON 或 AUX。 有关保留名称的详细信息，请参阅 文件名、路径和命名空间。 |
| 节点的特殊字符 | - 不得包含 Unicode 控制字符。 - 不得包含以下任何一个字符： \ / : * ? " < > | # $ & * +。- 不得包含本地文件系统禁止的字符。 有关 Windows 字符限制的详细信息，请参阅 命名文件、路径和命名空间。 |
| 路径长度 | 不能包含超过 4，000 个 Unicode 字符。 |
| 路径层次深度 | 深度必须小于 14 级。 |