本文内容
Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019 |TFS 2018
迭代路径(也称为 冲刺 )支持按时间间隔分配工作项。 在项目级别定义迭代路径,然后每个团队选择要使用的路径。 迭代路径是选择迭代路径的所有团队使用的共享资源。 可以创建一组平面迭代路径或路径层次结构,以支持版本、子版本和冲刺。
若要使用以下工具,请定义迭代路径并将其分配给团队:
提示
如果团队尚未订阅或未选择迭代路径,该迭代路径将不会显示在团队视图或工具中。
有关添加迭代路径的命名限制和限制的信息,请参阅 关于区域和迭代,命名限制 。
提示
如果只需更改迭代日期,则可以快速执行此操作,如 更改冲刺日期 中所示。 但是,如果需要定义迭代路径和树结构,请按照本文中提供的指南进行操作。
先决条件
若要向项目添加迭代路径,您必须是 项目管理员 组的成员。 如果还没有项目, 请立即创建一个项目 。 默认情况下,创建项目的用户具有这些权限集。
若要在节点下添加、编辑和管理迭代路径,必须对要管理的节点将以下一个或多个权限设置为 “允许 ”: 创建子节点 、 删除此节点 、 编辑此节点 和 查看此节点的权限 。
若要设置团队迭代路径,必须 添加为团队管理员 或 项目管理员 组的成员。
有关获取权限的详细信息,请参阅 更改项目级权限 或 设置工作跟踪的权限和访问权限 。
入门
新创建的项目包含对应于项目名称的单个根区域路径。 在此根目录下添加区域路径。 此外,每个项目通常指定一组预定义的迭代路径,以帮助你开始跟踪工作。 只需指定日期。
如果你不熟悉管理项目和团队,请完成以下步骤。
查看配置和自定义Azure Boards 。
按照定义区域路径并分配给团队中提供的指南定义 区域路径和团队 。
确定要支持的迭代的长度。 建议的做法是让所有团队使用相同的冲刺节奏。 有关指导,请查看 关于区域和迭代 。
确定需要冲刺和发布的平面结构还是层次结构。
打开 “项目设置>”“项目配置 ”,并定义迭代路径以支持项目级别的步骤 2 和 3。 按照本文稍后提供的步骤进行操作: 打开项目设置、项目配置 和 添加迭代并设置迭代日期 。
打开团队配置,将默认和其他区域路径 () 分配给每个团队。 按照本文后面提供的步骤进行操作: 打开团队设置 , 并将团队默认迭代路径 () 。
每个团队都应为其工作项分配他们选择的默认迭代路径。 这样做是为了这些工作项显示在其产品积压工作和板上。 使用 批量修改 一次修改多个工作项。 另请参阅 将积压工作项分配到冲刺 。
根据需要,可以随时执行以下任务:
添加其他子迭代节点
重命名迭代路径 (,根路径) 除外
将子迭代路径移到另一个节点下
删除子迭代路径
更改分配给团队的默认和所选迭代路径
团队积压工作迭代与默认迭代
每个团队都可以访问许多敏捷工具,如 关于团队和敏捷工具 中所述。 每个工具引用团队的默认区域路径 () 。 多个工具引用团队的默认和选定的迭代路径或冲刺。 大多数团队选择一个区域路径和多个迭代路径来支持其工作跟踪活动。 但是,为了支持其他方案,团队可以选择多个区域路径显示在积压工作和板上。
团队可以设置不同于积压工作迭代的默认迭代。 积压工作迭代确定哪些项显示在团队的积压工作和板上。 并且,默认迭代确定分配给从团队上下文创建的工作项的值。
从团队上下文创建的所有工作项都会自动分配团队的默认区域路径和默认迭代路径。
重要
若要查看可用于你的平台的内容,请确保从目录上方的版本选择器中选择本文的正确版本。 功能支持会有所不同,具体取决于你使用的是 Azure DevOps Services 还是本地版本的 Azure DevOps Server。
若要了解所使用的本地版本,请参阅 查找 Azure DevOps 平台和版本
打开“项目设置”,列出项目迭代
从项目 设置 > 板 > 项目配置 中为项目定义区域和迭代。
从“项目设置” 上下文的“工作 ”页定义区域和迭代。 在用户上下文中,通过选择 “设置” 打开管理员上下文。
在 Web 门户中,打开“项目设置”。
从项目设置 >板 >项目配置中为项目 定义区域和迭代。
选择“ (1) 项目设置” ,根据需要展开“ 版块 ”,然后选择“ (2) 项目配置 和 (3) 迭代 ”。
在 Web 门户中,打开“项目设置”。
通过项目配置> 迭代为项目定义区域和迭代。
在 Web 门户中,选择“ 项目设置 (1) ”,选择“ 项目配置 (2) ”,然后选择“ 迭代 (3) ”。
在 Web 门户中,选择 “项目设置” 以打开项目管理页面。 然后,选择 “迭代 ”。
列出项目迭代路径 | 添加项目迭代 | 列出团队迭代路径 | 设置团队迭代路径 | 删除或更新项目迭代路径
使用 az boards iteration project list 列出为项目定义的迭代。 若要开始,请参阅 Azure DevOps CLI 入门 。
az boards iteration project list [--depth]
[--path]
[--project]
参数
depth :可选。 要列出的子节点的深度。 示例:--depth 3。
path :可选。 迭代的绝对路径。 \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 和冲刺规划工具 。
从项目设置 项目配置 >>迭代 中添加和修改区域路径。
对于基于 Scrum 的项目,你将看到以下一组冲刺。
若要为团队使用的每个冲刺计划开始和结束日期,请突出显示冲刺并选择 “设置日期 ”。 或者,可以为迭代路径选择 “操作” ,然后选择 “编辑 ”。
选择日历图标以选择新日期。
完成后,计划了一组冲刺 - 如下图所示:
下一步是 选择每个团队使用的冲刺 。
在 “迭代”中 ,可以添加团队随后可以选择以供其使用的迭代。
从项目管理员或设置上下文的“ 工作 >迭代 ”页添加和修改区域路径。
对于基于 Scrum 的项目,你将看到以下一组冲刺。
若要为团队使用的每个冲刺计划开始和结束日期,请突出显示冲刺并选择 “设置日期 ”。 或者,可以选择迭代路径的 “操作 ”上下文菜单,然后选择 “编辑 ”。
选择日历图标以选择新日期。
完成后,计划了一组冲刺 - 如下所示:
下一步是 选择每个团队使用的冲刺 。
从项目管理员或设置上下文的“ 工作 >迭代 ”页添加和修改区域路径。
对于基于 Scrum 的项目,你将看到以下一组冲刺。
若要为团队使用的每个冲刺计划开始和结束日期,请突出显示冲刺并选择 “设置日期 ”。 或者,可以为迭代路径选择 “操作” ,然后选择 “编辑 ”。
选择日历图标以选择新日期。
完成后,计划了一组冲刺 - 如下所示:
下一步是 选择每个团队使用的冲刺 。
可以使用 az boards iteration project create 向项目添加迭代路径。 若要开始,请参阅 Azure DevOps CLI 入门 。
az boards iteration project create --name
[--finish-date]
[--path]
[--project]
[--start-date]
参数
名称 :必需。 输入迭代路径的名称。
finish-date :可选。 迭代的完成日期。 示例:“2019-06-21”。
path :可选。 迭代的绝对路径。 示例:\ProjectName\Iteration\IterationName。 如果未指定,请在根级别添加迭代。
项目 :可选。 项目的名称或 ID。 示例:--project “Fabrikam Fiber”。
start-date :可选。 输入迭代路径的开始日期。 示例:“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 命令。
打开团队设置,列出团队迭代
可以从团队设置中设置团队默认值。 如果你不是团队管理员, 请将其添加为一个 管理员。 只有团队或项目管理员可以更改团队设置。
可以从 项目设置 > 板 > 团队配置 定义区域和迭代。 可以从团队工作跟踪积压工作、板或仪表板快速导航到它。
打开团队的积压工作或板,选择“团队配置文件 ”,然后选择“团队设置”。
在这里,我们打开 Web 团队的板,并从那里打开团队配置文件。
选择 “迭代和区域 ”。
如果需要切换团队上下文,请在痕迹导航中使用团队选择器。
从上部导航栏打开团队设置。 选择所需的团队,然后选择 “团队设置 ”。 有关切换团队重点的详细信息,请参阅 切换项目、存储库、团队
可以使用 az boards area team list 列出为团队定义的迭代路径。 若要开始,请参阅 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 命令。
选择团队冲刺并设置默认迭代路径
为 项目定义冲刺 ,然后选择每个团队处于活动状态的冲刺。 分配创建新工作项时要使用的默认迭代。
打开 团队的“项目设置 > 板 > ”团队配置 > 迭代 。
在这里,我们导航到 Fabrikam Fiber 团队。
积压工作迭代 。 只有分配给等于或低于此积压工作迭代的迭代的工作项才会显示在团队的积压工作和板中。
此外,通过团队积压工作或板添加的所有工作项都分配积压工作迭代。
默认迭代 。 默认迭代定义从团队积压工作或看板创建工作项时使用的迭代。 可以指定 在积压工作 迭代路径下定义的任何迭代。 若要将新工作项分配给当前迭代,请指定 @CurrentIteration 。 使用查询中使用的相同宏 ,用于列出分配给当前活动迭代的工作项分配给团队 。
例如,你可能希望所有新工作项都添加到将来的迭代路径,以便定期对特定冲刺进行会审和分配。
注意
通过团队仪表板上的“ 工作项 ”页或“ 新建工作项” 小组件添加的新工作项不会引用分配给团队 的默认迭代路径 。 而是为新工作项分配用户选择的最后一个 迭代路径 。 始终为通过团队的 冲刺 积压工作或任务板添加的新工作项分配与所选冲刺关联的 迭代路径 。
活动冲刺 。 为想要为团队激活的每个冲刺积压工作添加迭代。 通过从菜单中选择每个冲刺,逐个添加。
完成后,应会看到冲刺列表,如下所示。
如果没有看到所需的冲刺或日期,则可以添加或编辑项目的迭代,前提是你具有所需的权限。 有关详细信息,请参阅 定义迭代 (冲刺) 路径 。
若要查看新激活的冲刺积压工作,请刷新团队 的产品积压工作页面 。
为团队打开 工作 >迭代 。
在这里,我们导航到 Fabrikam Fiber 团队。
积压工作迭代 。 只有分配给等于或低于此积压工作迭代的迭代的工作项才会显示在团队的积压工作和板中。
此外,通过团队积压工作或板添加的所有工作项都分配积压工作迭代。
默认迭代 。 默认迭代定义从团队仪表板和查询页创建工作项时使用的迭代。 可以使用显式值或使用 @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 命令。
重命名或移动迭代
重命名迭代或移动树层次结构中的节点时,系统会自动更新引用现有路径的工作项和查询 () 。
若要重命名迭代路径,请选择节点的 上下文菜单,然后选择 “编辑 ”。
在打开的对话框中,输入新名称。
若要在层次结构中移动节点,请更改“位置”字段。
若要删除节点,请从操作菜单中选择 “删除” 选项。
注意
删除迭代节点时,系统会使用在删除提示符下输入的节点自动更新现有工作项。
可以使用以下 az boards 迭代项目 命令重命名、移动或删除项目的迭代路径。 若要开始,请参阅 Azure DevOps CLI 入门 。
重命名或移动项目迭代路径
若要重命名或移动项目迭代路径,请使用 az boards area project update
命令。
az boards iteration project update --path
[--child-id]
[--finish-date]
[--name]
[--project]
[--start-date]
参数
path :必需。 迭代的绝对路径。 示例:\ProjectName\Iteration\IterationName。
child-id :可选。 移动现有迭代路径,并将其添加为指定路径名称或路径 ID 的子节点。
name :可选。 迭代路径的新名称。
项目 :可选。 项目的名称或 ID。 示例:--project“Fabrikam Fiber”。
finish-date :可选。 完成迭代的日期。 示例:“2019-06-21”。
start-date :可选。 迭代路径的开始日期。 示例:“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 命令。
删除迭代路径
重要
删除 区域路径 或重新配置 迭代路径 可能会导致数据丢失,并且无法还原。 例如,区域 路径 发生更改的团队的燃尽或烧毁小组件图表、冲刺燃尽和速度图表不会反映正确的数据。 历史趋势图引用每个工作项在过去某个时间点定义的 区域路径 和 迭代路径 。 删除 区域路径 或 迭代路径 时,无法检索其历史数据。
删除 迭代路径 时,必须提供 迭代路径 ,以用于更新分配给要删除的 迭代路径 的工作项。
若要删除 迭代路径 ,请打开 Web 门户 “项目设置>”“项目配置>迭代” 页。
选择 节点的上下文菜单,然后选择 “删除 ”或“ 删除 ”。
在打开的对话框中,选择要重新分配工作项的 迭代路径 ,然后选择 删除路径 。
若要删除项目迭代路径,请使用 az boards area project delete
命令。 若要开始,请参阅 Azure DevOps CLI 入门 。
az boards iteration project delete --path
[--project]
[--yes]
参数
path :必需。 迭代的绝对路径。 示例:\ProjectName\Iteration\IterationName。
项目 :可选。 项目的名称或 ID。 示例:--project“Fabrikam Fiber”。
是 :可选。 不提示确认。
本地Azure DevOps Server不支持 Azure DevOps CLI 命令。
导出/导入迭代路径
无法导出或导入树路径结构,以便一个项目用于另一个项目。
但是,使用 az boards iteration
命令可以列出为一个项目定义的迭代,然后将其添加到另一个项目。 添加它们后,可以使用 az boards iteration team
命令将它们添加到团队,并为团队设置默认和积压工作迭代路径。 使用 分类节点 (REST API) 和 Teams (REST API) ,可以执行类似的操作。
存档迭代路径
一段时间后,你可能想要存档用于一年或一年以上过期的冲刺的迭代路径。 为此,可以在标记为“存档”的节点下移动迭代路径。 使用移动的迭代路径更新所有工作项。 此外,团队可以取消选择过去的冲刺。 所有数据都通过新的迭代路径分配在数据存储中维护。
在存档迭代之前,请考虑是否捕获了可能需要的所有报表。
按迭代绘制进度图
可以快速生成 查询 来查看这些方面的进度。 例如,可以 可视化分配给冲刺的工作项的进度 ,如以下堆积条形图所示。
问题解答
问:是否必须向团队分配迭代路径?
答: 如果你的团队不使用冲刺来计划和跟踪工作,则不可以。 可以将分配给团队的默认值保留为原样。 然后,可以使用产品和项目组合积压工作和板,但无法充分利用冲刺规划工具。
相关文章
编程资源
区域路径和迭代路径也称为 分类节点 。