定义迭代路径（冲刺 (sprint)）并配置团队迭代

项目
08/10/2022

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

迭代路径（也称为冲刺）支持将工作项分配到时间间隔。在项目级别定义迭代路径，然后每个团队选择要使用的路径。迭代路径是所有选择它们的团队使用的共享资源。可以创建一组平面迭代路径或路径层次结构，以支持发布、子发布和冲刺。

定义迭代路径，并在想要使用以下工具时将其分配给团队：

提示

如果团队未订阅或选择迭代路径，该迭代路径将不会显示在团队视图或工具中。

有关添加迭代路径的命名限制和限制的信息，请参阅关于区域和迭代、命名限制。

提示

如果需要做的就是更改迭代日期，可以快速执行此操作，如更改冲刺日期所示。但是，如果需要定义迭代路径和树结构，请按照本文中提供的指南进行操作。

先决条件

若要向项目添加迭代路径，你必须是 项目管理员 组的成员。如果还没有项目，请立即创建一个项目。默认情况下，创建项目的用户具有这些权限集。
若要在节点下添加、编辑和管理迭代路径，必须将以下一个或多个权限设置为 “允许 管理”节点： 创建子节点、 删除此节点、 编辑此节点和 查看此节点的权限。
若要设置团队迭代路径，必须添加为团队管理员或 项目管理员 组的成员。

有关获取权限的详细信息，请参阅更改项目级权限或设置工作跟踪的权限和访问权限。

入门

新创建的项目包含与项目名称对应的单个根区域路径。在此根目录下添加区域路径。此外，每个项目通常指定一组预定义的迭代路径，以帮助开始跟踪工作。只需指定日期。

如果你不熟悉管理项目和团队，请完成以下步骤。

查看配置和自定义Azure Boards。
按照 “定义区域路径”中提供的指南并分配给团队，定义区域路径和团队。
确定要支持的迭代的长度。建议的做法是让所有团队使用相同的冲刺节奏。有关指导，请查看 “关于区域”和“迭代”。
确定是想要使用短跑和发行版的平面结构或层次结构。
打开 项目设置>项目配置 并定义迭代路径，以支持项目级别的步骤 2 和 3。按照本文后面的步骤操作：打开项目设置、项目配置和添加迭代并设置迭代日期。
打开团队配置，并将默认区域路径和附加区域路径 () 分配给每个团队。按照本文后面的步骤操作：打开团队设置和设置团队默认迭代路径 (s) 。
每个团队应为其工作项分配他们选择的默认迭代路径。为此，这些工作项会显示在其产品积压工作和板上。使用批量修改一次修改多个工作项。另请参阅将积压工作项分配给冲刺。

根据需要，可以随时执行以下任务：

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

团队积压工作迭代与默认迭代

每个团队都可以访问许多敏捷工具，如 “关于团队”和“敏捷”工具中所述。每个工具引用团队的默认区域路径 () 。多个工具引用团队的默认和所选迭代路径或冲刺。大多数团队选择一个区域路径和多个迭代路径来支持其工作跟踪活动。但是，为了支持其他方案，团队可以选择多个区域路径，使其出现在积压工作和板上。

Teams 可以设置与积压工作迭代不同的默认迭代。积压工作迭代确定团队积压工作和板中显示的项。并且，默认迭代确定为从团队上下文创建的工作项分配了哪些值。

从团队上下文创建的所有工作项都会自动分配团队的默认区域路径和默认迭代路径。

重要

从 Azure DevOps 内容版本选择器中选择一个版本。

若要查看可用于你的平台的内容，请确保从目录上方的版本选择器中选择本文的正确版本。功能支持会有所不同，具体取决于你使用的是 Azure DevOps Services 还是本地版本的 Azure DevOps Server。
若要了解正在使用哪个本地版本，请查看我使用的是哪个平台/版本？

打开项目设置，列出项目迭代

从 项目设置 > 板 > 项目配置中为项目定义区域和迭代。

从项目设置上下文的工作页定义区域和迭代。从用户上下文中，通过选择 “设置” 打开管理员上下文。

浏览器
Azure DevOps CLI

在 Web 门户中打开 “项目设置”。

从 项目设置>板>项目配置中为项目定义区域和迭代。

选择 (1) 项目设置，根据需要展开 Boards ，然后选择 (2) 项目配置 ， (3 个) 迭代。

在 Web 门户中打开 “项目设置”。

从 项目配置 > 迭代中为项目定义区域和迭代。

在 Web 门户中，选择“ 项目设置 ” (1) ，选择“ 项目配置 ” (2) ，然后选择 “迭代 ” (3) 。

在 Web 门户中，选择 “项目设置 ”以打开项目管理页。然后选择 “迭代”。

打开 TFS 2018 及更早版本的项目管理页的屏幕截图。

列出项目迭代路径 | 添加项目迭代 | 列出团队迭代路径 | 设置团队迭代路径 | 删除或更新项目迭代路径

使用 az boards 迭代项目列表列出为项目定义的迭代。若要开始，请参阅 Azure DevOps CLI 入门。

az boards iteration project list [--depth]
                                 [--path]
                                 [--project]

参数

深度：可选。要列出的子节点的深度。示例：--depth 3。
路径：可选。迭代的绝对路径。 \Iteration\ 必须遵循之后 \ProjectName，该路径将它与区域路径区分开来。示例：--path \ProjectName\Iteration\IterationName。如果在节点中使用空格，则用双引号括起来，例如,--path“\Fabrikam Fiber\Iteration\Sprint 1”。如果未指定，请列出根级别的迭代路径。
项目：可选。项目的名称或 ID。示例：--project“Fabrikam Fiber”。

示例

例如，以下命令列出了 Fabrikam Fiber 项目的深度为 3 的区域路径。有关其他输出格式选项的详细信息，请参阅 Azure CLI 命令的输出格式

az boards iteration project list --depth 3 --project "Fabrikam Fiber" --output table
ID     Identifier                            Name            Path                                           Has Children    Start Date            Finish Date
-----  ------------------------------------  --------------  ---------------------------------------------  --------------  --------------------  --------------------
55290  d77820e9-6bda-4deb-8052-cc519bc12ecc  Fabrikam Fiber  \Fabrikam Fiber\Iteration                      True
55292  5938b25d-7235-499e-815f-4fc19d95d24c  Release 1       \Fabrikam Fiber\Iteration\Release 1            True
55297  c7063041-ff3a-4d7f-bb46-c433c7030d59  Sprint 1        \Fabrikam Fiber\Iteration\Release 1\Sprint 1   False           2019-01-01T00:00:00Z  2019-01-18T00:00:00Z
55298  dd10f1bf-bedd-4c6f-926f-b2abea81bb50  Sprint 2        \Fabrikam Fiber\Iteration\Release 1\Sprint 2   False           2019-01-21T00:00:00Z  2019-02-08T00:00:00Z
55340  862e961a-ac7a-4fcc-9ebc-8afd0c12fed5  Sprint 3        \Fabrikam Fiber\Iteration\Release 1\Sprint 3   False           2019-03-11T00:00:00Z  2019-03-29T00:00:00Z
55341  8548898e-4dfd-4515-9d6e-d476d90033a3  Sprint 4        \Fabrikam Fiber\Iteration\Release 1\Sprint 4   False
55342  d130534c-05dc-434b-a7f3-85689d11c36f  Sprint 5        \Fabrikam Fiber\Iteration\Release 1\Sprint 5   False
55343  738f5c0b-c62b-4ba5-96ab-026e606b0cef  Sprint 6        \Fabrikam Fiber\Iteration\Release 1\Sprint 6   False           2018-07-16T00:00:00Z  2018-08-03T00:00:00Z
55299  a0554e98-b1f1-4230-8500-733c739a0113  Release 2       \Fabrikam Fiber\Iteration\Release 2            False
55300  5c3a5d56-f860-4ebc-8838-7701256c88a4  Release 3       \Fabrikam Fiber\Iteration\Release 3            False
55301  ad722430-042b-4c45-87e5-8d67572d4fc1  Release 4       \Fabrikam Fiber\Iteration\Release 4            False
55364  8b738736-fef6-49f5-be2a-31c86add6589  Future          \Fabrikam Fiber\Iteration\Future               False

本地Azure DevOps Server不支持 Azure DevOps CLI 命令。

添加迭代并设置迭代日期

可以添加迭代的方式与添加区域的方式相同。有关在冲刺节奏中工作的详细信息，请参阅 Scrum 和冲刺规划工具。

浏览器
Azure DevOps CLI

从 项目设置>项目配置>迭代中添加和修改区域路径。

对于基于 Scrum 的项目，你将看到以下一组冲刺。
若要计划团队使用的每个冲刺的开始和结束日期，请突出显示冲刺并选择 “设置日期”。或者，可以选择迭代路径的操作，然后选择“编辑”。
选择日历图标以选择新日期。
完成后，已计划一组冲刺 - 如下图所示：

下一步是选择每个团队使用的冲刺。

在 迭代中，可以添加团队随后可以选择的迭代供其使用。

从项目管理员或设置上下文的 “工作>迭代” 页添加和修改区域路径。

对于基于 Scrum 的项目，你将看到以下一组冲刺。
若要安排团队使用的每个冲刺的开始日期和结束日期，请突出显示冲刺并选择 “设置日期”。或者，可以选择迭代路径的 “操作 ”上下文菜单，然后选择“ 编辑”。

选择日历图标以选择新日期。
完成后，已计划一组冲刺 - 如下所示：

下一步是选择每个团队使用的冲刺。

从项目管理员或设置上下文的 “工作>迭代” 页添加和修改区域路径。

对于基于 Scrum 的项目，你将看到以下一组冲刺。

“项目设置上下文”、“工作”、“迭代”页

若要安排团队使用的每个冲刺的开始日期和结束日期，请突出显示冲刺并选择 “设置日期”。或者，可以选择迭代路径的操作，然后选择“编辑”。

选择日历图标以选择新日期。
完成后，已计划一组冲刺 - 如下所示：

下一步是选择每个团队使用的冲刺。

可以使用 az boards 迭代项目 create 向项目添加迭代路径。若要开始，请参阅 Azure DevOps CLI 入门。

az boards iteration project create --name
                                   [--finish-date]
                                   [--path]
                                   [--project]
                                   [--start-date]

参数

名称：必需。输入迭代路径的名称。
完成日期：可选。完成迭代的日期。示例：“2019-06-21”。
路径：可选。迭代的绝对路径。示例：\ProjectName\Iteration\IterationName。如果未指定，请在根级别添加迭代。
项目：可选。项目的名称或 ID。示例：--project“Fabrikam Fiber”。
开始日期：可选。输入迭代路径的开始日期。示例：“2019-06-03”。必须早于完成日期。

示例

例如，以下命令添加 Sprint 36，该版本从 2019 年 9 月 1 日开始，到 2019 年 9 月 30 日结束，作为根节点上默认项目的迭代路径。

az boards iteration project create --name "Sprint 36" --start-date 2019-09-01 --finish-date 2019-09-30
{
  "attributes": {
    "finishDate": "2019-09-30T00:00:00Z",
    "startDate": "2019-09-01T00:00:00Z"
  },
  "children": null,
  "hasChildren": false,
  "id": 55411,
  "identifier": "af3ef6a7-6551-451b-8f9f-63af7a60fc55",
  "name": "Sprint 36",
  "path": "\\Fabrikam Fiber\\Iteration\\Sprint 36",
  "structureType": "iteration",
  "url": "https://dev.azure.com/fabrikam/56af920d-393b-4236-9a07-24439ccaa85c/_apis/wit/classificationNodes/Iterations/Sprint%2036"
}

本地Azure DevOps Server不支持 Azure DevOps CLI 命令。

打开团队设置，列出团队迭代

可以从团队设置设置中设置团队默认值。如果你不是团队管理员，请将其添加为一个。只有团队或项目管理员可以更改团队设置。

注意

最多可以分配 300 个 迭代路径。若要了解详细信息，请参阅工作跟踪、流程和项目限制。

浏览器
Azure DevOps CLI

从 项目设置 > 板 > 团队配置中定义区域和迭代。可以从团队工作跟踪积压工作、板或仪表板快速导航到它。

打开团队积压工作或板，然后选择 “团队配置文件>团队设置”。

在这里，我们打开 Web 团队的板，并从那里打开团队配置文件。
选择 迭代和区域。
如果需要切换团队上下文，请使用痕迹导航中的团队选择器。

从上部导航栏打开团队设置。选择所需的团队，然后选择 “团队设置 ”。有关切换团队焦点的详细信息，请参阅“切换项目”、“存储库”、“团队”

打开团队设置

可以使用 az boards 区域团队列表列出为团队定义的迭代路径。若要开始，请参阅 Azure DevOps CLI 入门。

az boards iteration team list --team
                              [--project]
                              [--timeframe]

参数

团队：必需。团队的名称或 ID。
项目：可选。项目的名称或 ID。
时间范围：可选。基于相对时间返回迭代的筛选器。仅支持 Current 。

示例

例如，以下命令列出了服务交付团队的区域路径。有关其他输出格式选项，请参阅 Azure CLI 命令的输出格式

az boards iteration team list  --team "Service Delivery"  --project "Fabrikam Fiber" --output table
ID                                    Name       Start Date                 Finish Date                Time Frame    Path
------------------------------------  ---------  -------------------------  -------------------------  ------------  ---------------------------------
c7063041-ff3a-4d7f-bb46-c433c7030d59  Sprint 1   2019-01-01T00:00:00+00:00  2019-01-18T00:00:00+00:00  past          Fabrikam Fiber\Release 1\Sprint 1
dd10f1bf-bedd-4c6f-926f-b2abea81bb50  Sprint 2   2019-01-21T00:00:00+00:00  2019-02-08T00:00:00+00:00  past          Fabrikam Fiber\Release 1\Sprint 2
862e961a-ac7a-4fcc-9ebc-8afd0c12fed5  Sprint 3   2019-03-11T00:00:00+00:00  2019-03-29T00:00:00+00:00  current       Fabrikam Fiber\Release 1\Sprint 3

本地Azure DevOps Server不支持 Azure DevOps CLI 命令。

选择团队冲刺并设置默认迭代路径

为项目定义冲刺，然后选择要对每个团队处于活动状态的冲刺。分配创建新工作项时要使用的默认迭代。

浏览器
Azure DevOps CLI

打开 团队的项目设置 > 板 > 团队配置 > 迭代 。

在这里，我们导航到 Fabrikam 光纤团队。
积压工作迭代。只有分配给等于或低于此积压工作迭代的迭代的工作项才会显示在团队的积压工作和板中。

此外，通过团队积压工作或板添加的所有工作项都分配积压工作迭代。
默认迭代。默认迭代定义从团队积压工作项或看板创建工作项时使用的迭代。可以指定 积压工作迭代 路径下定义的任何迭代。若要将新工作项分配给当前迭代，请指定 @CurrentIteration。使用查询中使用的相同宏列出分配给团队当前活动迭代的工作项。

例如，你可能希望将所有新的工作项添加到将来的迭代路径，以便按周期间隔对特定冲刺进行会审和分配。

注意

通过 “工作项 ”页或团队仪表板上的 “新建工作项 ”小组件添加的新工作项不会引用分配给团队 的默认迭代路径 。而是为新工作项分配用户选择的最后一个 迭代路径 。始终为通过团队的 冲刺积压 工作或任务板添加的新工作项分配与所选冲刺关联的 迭代路径 。
活动冲刺。为团队希望处于活动状态的每个冲刺积压工作添加迭代。通过从菜单中选择每个冲刺，逐个添加。

完成后，应会看到一个短跑列表，如下所示。

如果看不到所需的冲刺或日期，则可以为项目添加或编辑迭代，前提是你具有所需的权限。有关详细信息，请参阅定义迭代 (冲刺) 路径。
若要查看新激活的冲刺积压工作，请刷新团队的产品积压工作页。

为团队打开工作>迭代。

在这里，我们导航到 Fabrikam 光纤团队。
积压工作迭代。只有分配给等于或低于此积压工作迭代的迭代的工作项才会显示在团队的积压工作和板中。

此外，通过团队积压工作或板添加的所有工作项都分配积压工作迭代。
默认迭代。默认迭代定义从团队仪表板和查询页创建工作项时使用的迭代。可以使用显式值或使用 @CurrentIteration 将新工作项分配给团队的当前迭代。使用查询中使用的相同宏列出分配给团队当前活动迭代的工作项。

例如，你可能希望将所有新的工作项添加到将来的迭代路径，以便按周期间隔对特定冲刺进行会审和分配。
活动冲刺。为团队希望处于活动状态的每个冲刺积压工作添加迭代。通过从菜单中选择每个冲刺，逐个添加。

完成后，应会看到一个短跑列表，如下所示。

如果未看到所需的冲刺或日期，请返回到项目管理上下文并在那里定义它们。
若要查看新激活的冲刺积压工作，请刷新团队的产品积压工作页。

添加迭代路径、设置默认迭代路径，或使用以下 az boards 迭代团队 Azure DevOps CLI 命令之一为团队设置积压工作迭代路径。若要开始，请参阅 Azure DevOps CLI 入门。

az boards iteration team add --id --team
                             [--project]

az boards iteration team set-default-iteration --team
                                               [--default-iteration-macro]
                                               [--id]
                                               [--project]

az boards iteration team set-backlog-iteration --id --team
                                               [--project]

参数

团队：必需。团队的名称或 ID。
default-iteration-macro：可选。默认迭代宏，唯一有效的条目是 @CurrentIteration。
id：可选。输入迭代路径的 ID。若要确定 ID，请使用 az boards 迭代项目列表列出迭代路径。
项目：可选。项目的名称或 ID。示例：--project“Fabrikam Fiber”。

示例

例如，以下命令将 \Fabrikam Fiber\Iteration\Release 2 路径添加到 Fabrikam Fiber 项目的服务交付团队。

az boards iteration team add --id a0554e98-b1f1-4230-8500-733c739a0113 --team "Service Delivery" --project "Fabrikam Fiber"
{
  "attributes": {
    "finishDate": null,
    "startDate": null,
    "timeFrame": "future"
  },
  "id": "a0554e98-b1f1-4230-8500-733c739a0113",
  "name": "Release 2",
  "path": "Fabrikam Fiber\\Release 2",
  "url": "https://dev.azure.com/fabrikam/56af920d-393b-4236-9a07-24439ccaa85c/43e6bd2e-696f-492c-bbf7-9cde9cd420ea/_apis/work/teamsettings/iterations/a0554e98-b1f1-4230-8500-733c739a0113"
}

本地Azure DevOps Server不支持 Azure DevOps CLI 命令。

重命名、移动或删除迭代

重命名迭代或移动树层次结构中的节点时，系统会自动更新引用现有路径的工作项和查询 () 。

浏览器
Azure DevOps CLI

若要重命名迭代路径 ，请选择 节点的操作，然后选择“ 编辑”。
在打开的对话框中，输入新名称。
若要移动层次结构中的节点，请更改“位置”字段。
若要删除节点，请从操作菜单中选择 “删除 ”选项。

注意

删除迭代节点时，系统会使用在删除提示符处输入的节点自动更新现有工作项。

可以使用以下 az boards 迭代项目命令重命名、移动或删除项目的迭代路径。若要开始，请参阅 Azure DevOps CLI 入门。

重命名或移动项目迭代路径

若要重命名或移动项目迭代路径，请使用 az boards area project update 命令。

az boards iteration project delete --path
                                   [--project]
                                   [--yes]

az boards iteration project update --path
                                   [--child-id]
                                   [--finish-date]
                                   [--name]
                                   [--project]
                                   [--start-date]

参数

路径：必需。迭代的绝对路径。示例：\ProjectName\Iteration\IterationName。
child-id：可选。移动现有迭代路径，并将其添加为指定路径名称或路径 ID 的子节点。
名称：可选。迭代路径的新名称。
项目：可选。项目的名称或 ID。示例：--project“Fabrikam Fiber”。
完成日期：可选。完成迭代的日期。示例：“2019-06-21”。
开始日期：可选。迭代路径的开始日期。示例：“2019-06-03”。必须早于完成日期。
是：可选。不提示确认。

示例

例如，以下命令更新 Fabrikam Fiber 项目的 Sprint 3 迭代路径的开始和结束日期。

az boards iteration project update --path "\Fabrikam Fiber\Iteration\Release 1\Sprint 3" --finish-date 2019-08-31 --start-date 2019-08-01 --project "Fabrikam Fiber" --output table
ID     Identifier                            Name      Start Date            Finish Date           Path                                          Has Children
-----  ------------------------------------  --------  --------------------  --------------------  --------------------------------------------  --------------
55340  862e961a-ac7a-4fcc-9ebc-8afd0c12fed5  Sprint 3  2019-08-01T00:00:00Z  2019-08-31T00:00:00Z  \Fabrikam Fiber\Iteration\Release 1\Sprint 3  False

本地Azure DevOps Server不支持 Azure DevOps CLI 命令。

导出/导入迭代路径

不能导出或导入一个项目用于另一个项目的树路径结构。

但是，使用 az boards iteration 命令可以列出为一个项目定义的迭代，然后将其添加到另一个项目。添加 az boards iteration team 这些命令后，可以使用命令将它们添加到团队，并为团队设置默认和积压工作迭代路径。使用分类节点 (REST API) 和 Teams (REST API) ，可以执行类似的操作。

存档迭代路径

一段时间后，你可能想要存档用于一年或更多过期的冲刺的迭代路径。可以通过在标签为“存档”的节点下移动迭代路径来执行此操作。所有工作项都使用移动迭代路径进行更新。此外，团队还可以取消选择过去的冲刺。所有数据都使用新的迭代路径分配保留在数据存储中。

在存档迭代之前，请考虑是否捕获了可能需要的所有报表。

按迭代绘制进度图表

可以快速生成查询以查看这些区域的进度。例如，可以将分配给冲刺的工作项的进度可视化，如以下堆积条形图所示。

按区域排列的堆积条形图

问题解答

问：是否必须向团队分配迭代路径？

答：如果你的团队不使用冲刺来计划和跟踪工作，则不。可以保留分配给团队的默认值。然后，可以使用产品和项目组合积压工作和板，但无法充分利用冲刺规划工具。

编程资源

区域路径和迭代路径也称为 分类节点。

定义迭代路径（冲刺 (sprint)）并配置团队迭代

先决条件

入门

团队积压工作迭代与默认迭代

打开项目设置，列出项目迭代

添加迭代并设置迭代日期

打开团队设置，列出团队迭代

选择团队冲刺并设置默认迭代路径

重命名、移动或删除迭代

导出/导入迭代路径

存档迭代路径

按迭代绘制进度图表

问题解答

问：是否必须向团队分配迭代路径？

相关文章

编程资源