通过

关于区域和迭代路径

  • 项目

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

区域路径按团队、产品或功能区域对工作项进行分组。 迭代路径将工作分组到冲刺、里程碑或其他与时间相关的时间段。 这两个字段都支持分层路径。

定义项目的区域和迭代路径，团队可以选择用于积压工作和敏捷工具的路径。 了解敏捷工具如何在依赖于区域和迭代的敏捷工具中使用这些路径。

注意

区域路径和迭代路径也称为 分类节点。 可以使用分类节点（REST API）或 Azure DevOps CLI 命令 az boards 迭代以编程方式管理它们。

注意

区域路径和迭代路径也称为 分类节点。 可以通过 分类节点 (REST API) 以编程方式管理它们。

区域和迭代取决于用于创建项目的过程。 此示例显示了 Scrum 进程的默认设置。 默认情况下不设置日期;需要设置日期以匹配冲刺或发布计划。

迭代 Areas
默认迭代、Scrum 流程 一组示例区域路径

重要

  • 删除 区域路径 或重新配置 迭代路径 会导致不可逆的数据丢失。 例如，具有已更改 区域路径 的团队的冲刺烧毁和速度图表不会显示准确的数据。 历史趋势图引用 区域路径 和 迭代路径 ，因为它们是在每次为工作项定义的。 删除后，无法检索这些路径的历史数据。
  • 只能删除任何工作项不再使用的区域和迭代路径。

定义和分配区域路径

如果你不熟悉管理项目和团队，请执行以下步骤来配置项目和团队：

  1. 确定对工作进行分类所需的区域路径的数量和名称。 至少为定义的每个团队添加一个区域路径。
  2. 确定要支持的团队的数量和名称。 有关详细信息，请参阅 关于团队和敏捷工具。
  3. 打开 “项目设置 > ”“项目配置 ”，并定义区域路径以支持项目级别的步骤 1 和 2。 按照以下步骤操作： 打开项目设置、项目配置 和 添加区域路径。
  4. 定义支持步骤 2 所需的团队。 有关详细信息，请参阅 “添加团队”，从一个默认团队移动到多个团队。
  5. 打开团队配置，并向每个团队分配默认和其他区域路径。 按照以下步骤操作： 打开团队设置 并 设置团队默认区域路径。
  6. 将工作项分配给定义的区域路径。 使用 批量修改 一次修改多个工作项。

注意

每个项目最多可以定义 10,000 个区域路径 ，并向单个团队分配最多 300 个区域路径 。 有关详细信息，请参阅 工作跟踪、流程和项目限制。

可以将同 一区域路径 分配给多个团队，但如果两个团队声称拥有同一组工作项，则可能会导致问题。 有关详细信息，请参阅 多团队板视图的限制。

可以随时执行以下操作：

  • 添加更多子节点
  • 重命名区域路径 (，根区域路径)
  • 将子节点移到另一个节点下
  • 删除子节点
  • 重命名团队
  • 更改对团队进行的区域路径分配

有关详细信息，请参阅配置团队层次结构。

团队应定义多少区域？

添加区域以支持团队的可跟踪性和安全性要求。 使用区域来表示逻辑组件或物理组件，并创建子区域来表示特定特征。

在需要以下情况下添加区域：

  • 基于产品或功能区域筛选查询
  • 按团队或子团队组织或分组工作项
  • 根据工作项的区域限制对工作项的访问。

每个团队都可以创建一个区域层次结构，以组织积压工作项、用户情景、要求、任务和 bug。

避免创建过于复杂的区域结构。 虽然可以使用区域来对工作项的权限进行分区，但复杂的树需要大量的权限管理开销。 复制其他项目中的结构和权限可能会变得过于繁琐。

定义和分配迭代路径

按照以下步骤为项目和团队配置 迭代路径 ：

  1. 使用“定义区域路径”中的 指导定义区域路径和团队并分配给团队。
  2. 确定要支持的迭代的长度。 我们建议所有团队使用相同的短跑节奏。
  3. 确定是想要平面结构还是冲刺和发布层次结构。
  4. 打开 “项目设置 > ”“项目配置 ”，并定义迭代路径以支持项目级别的步骤 2 和 3。 按照以下步骤操作： 打开项目设置、项目配置 和添加迭代并 设置迭代日期。
  5. 打开团队配置，并向每个团队分配默认、积压工作和其他迭代路径。 按照以下步骤操作： 打开团队设置 并 设置团队默认迭代路径。
  6. 每个团队都应为其工作项分配一个迭代路径，该路径属于 积压工作迭代 路径。 这些工作项显示在产品积压工作和板上。 使用 批量修改 一次修改多个工作项。 另请参阅 将积压工作项分配到冲刺。

注意

每个项目最多可以定义 10,000 个迭代路径 ，并向单个团队分配最多 300 个迭代路径 。 有关详细信息，请参阅 工作跟踪、流程和项目限制。

可以随时执行以下操作：

  • 添加更多子迭代节点
  • 重命名迭代路径 (，根路径) 除外
  • 将子迭代路径移到另一个节点下
  • 删除子迭代路径
  • 更改分配给团队的默认和所选迭代路径

团队应定义多少次迭代？

根据需要定义任意数量的子迭代来反映项目生命周期。 这些路径表示一系列事件，例如冲刺、预测试版和 beta 版结果以及其他发布里程碑。 如果尚未安排工作或发布，Teams 通常会将分配给团队的默认迭代的工作项保留。

添加迭代以支持以下要求：

  • 为 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 级。