# 迭代组件
URL: https://docs.ones.cn/on-premises/7.33/product-manual/ones-project/projects/scrum-components/sprint-component
## 迭代组件简介
迭代是敏捷开发中概念，一次迭代可能发布某个或某几个功能特性，一次迭代过程即包含这些新功能所需的所有开发工作项及其他工作项。一般情况下，一个迭代周期为 2-4 周。
通过「迭代」组件可规划迭代，管理迭代内的需求、缺陷和任务，追踪迭代进度等，帮助团队实现敏捷开发。
## 功能特性
### 2.1 迭代配置
#### 2.1.1 迭代功能设置
迭代组件的所有功能都可以由项目管理员自主决定是否开启，在「项目设置」-「项目组件」下，选中「迭代」组件，点击「功能设置」即可进行设置。
除概览、敏捷看板、筛选器、流水线运行、代码这几个迭代的常规功能外，项目内已配置的工作项类型组件也会自动添加为对应的迭代功能，用来展示已被规划为迭代的工作项。
#### 2.1.2 迭代属性
迭代属性显示在迭代概览中，项目管理员可在「项目设置」-「迭代配置」-「迭代属性」下，自定义新建/修改迭代属性、设置属性默认值，或调整迭代属性展示的顺序。与工作项属性类似，系统支持单选菜单、单行文本、多行文本、日期、时间、单选成员、整数、浮点数等多种属性类型。迭代自定义属性支持必填设置。
其中迭代名称支持系统自动累加，即在最近一个添加的迭代名称后+1，如：示例迭代 → 示例迭代1；若该名称本身以整数结尾，则该整数+1，如：示例迭代5 → 示例迭代6。
#### 2.1.3 迭代阶段
「迭代阶段模式」提供「简单模式」、「自定义模式」，提供不同的迭代阶段管理模式。在「项目设置」-「迭代配置」-「迭代阶段」下可设置迭代阶段。推荐使用「简单模式」更为简易地管理迭代进度
##### 2.1.3.1 迭代阶段简单模式
「迭代阶段简单模式」固定为未完成、进行中、已完成三个迭代阶段。通过点击「开始迭代」、「完成迭代」流转迭代阶段，流畅管理迭代阶段。
##### 2.1.3.2 迭代阶段自定义模式
「迭代阶段自定义模式」可以自定义迭代阶段，帮助设置迭代中的重要节点。在「项目设置」-「迭代配置」-「迭代阶段」下可以新建迭代阶段，调整已有阶段的排序、名称，删除阶段。其中 **未开始** 和 **已完成** 为迭代固定阶段，不支持编辑和删除。
##### 2.1.3.3 切换迭代阶段模式
推荐使用「迭代阶段简单模式」更为简易地管理迭代进度，不推荐随意切换迭代阶段模式，请谨慎切换！
#### 2.1.4 迭代关联流水线运行
通过迭代关联流水线运行，您可以在迭代中追踪和分析流水线运行情况。系统支持通过脚本的方式批量将「当前项目的迭代」和「项目已关联流水线」的运行情况关联起来：
- 如果当前项目暂未关联流水线，你可以前往流水线组件关联；
- 如果当前项目已关联流水线，你可以继续配置以下迭代关联流水线运行的规则。
#### 2.1.5 迭代排序
1. 支持迭代面板/迭代列表，按照迭代属性排序
1. 支持的排序条件包含：迭代的系统属性、与自定义迭代属性
- 默认按照"创建时间"排序
| **条件类型** | **条件** | **简单模式** | **自定义模式** | **正序排序** | **倒序排序** |
| **系统条件** | **创建时间** | 迭代的创建时间 | 时间从最旧到最新 | 时间从最新到最旧 |
| **迭代开始日期** | / | 计划开始日期 |
| **迭代完成日期** | / | 计划完成日期 |
| **迭代名称** | / | Name 拼音 A-Z 排序 | Name 拼音 Z-A 排序 |
| **迭代状态** | 未开始
进行中
已完成 | 未开始
进行中1
进行中N
已完成 | **简单模式**
- 未开始
- 进行中
- 已完成
**自定义模式**
- 未开始
- 进行中1
- 进行中N
- 已完成 | **简单模式**
- 已完成
- 进行中
- 未开始
**自定义模式**
- 已完成
- 进行中N
- 进行中1
- 未开始 |
| **迭代负责人** | / | Name 拼音 A-Z 排序 | Name 拼音 Z-A 排序 |
| **自定义迭代属性** | **日期** | 时间从最旧到最新 | 时间从最新到最旧 |
| **时间** |
| **整数** | 从小到大 | 从大到小 |
| **浮点数** | 从小到大 | 从大到小 |
| **单选成员** | Name 拼音 A-Z 排序 | Name 拼音 Z-A 排序 |
| **单选菜单** | 迭代属性配置：
从上到下
 | 迭代属性配置：
从下到上
 |
### 2.2 新建迭代
在「迭代」组件下，点击左侧迭代列表上方的「新建迭代」，打开新建迭代页。
#### 2.2.1 「迭代阶段简单模式」下新建迭代
支持轻量的新建迭代，输入迭代名称，选择迭代负责人即可新建迭代。
#### 2.2.2 「迭代阶段自定义模式」下新建迭代
输入迭代名称，选择所属项目、迭代负责人，设置迭代周期，点击确定即可
### 2.3 规划迭代
#### 2.3.1 规划迭代方式
迭代管理员可以使用以下三种方式将工作项规划到目标迭代中。
**规划方式一：迭代组件-未规划工作项**
此规划方式适合单项目规划迭代的场景，即在【未规划工作项】列表下规划迭代时，仅可规划到当前项目下的迭代。
勾选需要规划的工作项后，点击「规划至迭代」，选择目标迭代点击确定即可。
**规划方式二：规划组件**
规划组件除了支持"跨项目"规划迭代外，还支持通过不同维度规划迭代，包括按迭代规划，按发布规划等。（具体介绍详见【规划组件】页面）
勾选需要规划的工作项后，直接拖拽到目标迭代，或点击底部的「规划至迭代」，选择目标迭代点击确定即可。
**规划方式三：修改"所属迭代"**
通过修改工作项的「所属迭代」属性，选择目标迭代即可。
#### 2.3.1 规划迭代权限
需要拥有对应项目的「规划迭代」权限，才允许将任意工作项规划至该项目下的迭代；同理，若需从某项目下的迭代中移除工作项，也需要拥有该项目的「规划迭代」权限。
如果没有对应项目的「规划迭代」权限，编辑工作项的「所属迭代」属性时，无法查看到该项目下的迭代。
### 2.4 「迭代阶段简单模式」流转迭代阶段
#### 2.4.1 开始迭代
「迭代阶段简单模式」通过「开始迭代」完善迭代周期，将迭代阶段流转到「进行中」。规划好迭代后，点击「迭代」组件页面右上角的「开始迭代」，设置迭代周期，点击确认即可。
#### 2.4.2 完成迭代
「迭代阶段简单模式」支持通过「完成迭代」将迭代阶段从「进行中」流转到「已完成」。点击「迭代」组件页面右上角的「完成迭代」。若有未完成工作项，移出未完成工作项后完成迭代。
### **2.5 迭代概览**
「迭代概览」主要展示当前迭代的基本信息、完成情况以及一些关联信息。主要分为以下几个板块：
#### 2.5.1 迭代信息
在此处可以查看迭代的基本信息，包括迭代负责人、状态任务数量、迭代周期、迭代工时统计、迭代进度。（「迭代阶段自定义模式」下，迭代管理员可以直接在此处修改信息）
#### 2.5.2 当前阶段
「迭代阶段自定义模式」下展示了迭代的阶段划分、计划周期与实际周期，迭代管理员可点击进度条更改迭代阶段。
迭代管理员可以点击「自定义阶段」来设置迭代阶段；点击「修改日期」即可进行迭代计划日期的设置，实际周期会根据阶段的流转进行自动记录，也可以在此进行手动调整。
#### 2.5.3 阶段描述
「迭代阶段自定义模式」下，迭代管理员可在此处对已定义好的每个阶段进行描述，比如介绍每个阶段的目标等信息。
#### 2.5.4 迭代属性、关联内容、迭代描述
**迭代属性** 展示了当前迭代已配置好的属性字段，迭代管理员也可以点击「属性设置」对其进行排序和调整。
**关联内容** 展示了本迭代关联的计划或计划组。
**迭代描述** 支持富文本编辑迭代的信息，可由迭代管理员进行设置。
#### 2.5.5 成员剩余工时统计
查看成员剩余工时的统计表，支持按照成员或剩余工时排序，支持导出 .CSV 格式的文件。
查看当前迭代的资源使用情况，合理分配成员工时，提前预判工时不足的风险，做出相应处理。
#### 2.5.6 代码统计
汇总统计当前迭代的代码提交情况，帮助迭代负责人评估开发贡献量。 目前支持统计和分析代码提交次数、代码提交次数趋势、代码提交影响行数的情况。
### 2.6 敏捷看板
迭代下的敏捷看板支持 **基于层级结构 或 基于关联工作项** 划分泳道，方便直观地了解任务的从属关系以及任务的状态，帮助研发经理、项目经理等在具体迭代中更高效地查阅迭代进展。
- 当泳道以层级结构划分时，泳道的第一列会显示父层级工作项（父层级工作项的工作项类型可在看板设置中筛选），子层级工作项会显示在该泳道的不同状态列里。
- 当泳道以关联工作项划分时，可以通过泳道工作项筛选控制每个泳道的第一列显示的工作项类型。例如，想要显示迭代内需求的实现情况，则可以在泳道工作项筛选中选择需求，研发人员拆分任务时关联需求；则敏捷看板中会清楚地展现每一条需求所关联的研发任务的实现情况。
#### 2.6.2 筛选/泳道筛选
看板内容筛选：设置看板内容筛选条件，仅对看板的内容进行生效，对泳道不生效。
泳道筛选：仅针对泳道下的工作项进行筛选，支持筛选的属性包含：所属项目、标题、创建者、负责人、工作项类型、ID、描述、优先级、状态、工作项类型、状态类型。
#### 2.6.3 敏捷看板设置
敏捷看板由项目管理员管理。点击敏捷看板右上角的「看板管理」即可进入到敏捷看板管理页面，可以新建/删除/编辑敏捷看板。
泳道工作项筛选
可以设置迭代下的哪些工作项显示在敏捷看板的泳道工作项内。
- 支持配置跨项目的数据范围
##### 泳道工作项排序
为提高敏捷看板在早会场景下的易用性，例如：已经完成的工作项排序默认置底，可以通过设置泳道工作项排序来实现。
默认排序规则为状态类型（ **未开始** 、 **进行中** 、 **已完成** ）；也可以设置排序规则为状态（默认从A-Z排序）点击编辑按钮，可对状态进行自定义排序。设置完成后，迭代中对应的看板排序将会按照设置的规则显示。
##### 看板工作项设置
可以设置迭代下哪些工作项可以显示在看板中。例如，看板工作项类型选择任务，则泳道工作项的关联工作项/子层级工作项中，只有任务类型的才会出现在敏捷看板中。
- 支持配置跨项目的数据范围
##### 看板栏设置
可以设置删除、新增、重命名栏，以及管理每个栏下面的工作项状态，符合状态的工作项会显示在对应栏里。
#### 2.6.4 全屏展示
点击图标按钮，全屏展示敏捷看板。
### 2.7 迭代筛选器
筛选器展示了迭代下的所有工作项，可以对迭代下所有类型的工作项进行筛选。工作项列表功能特性与工作项类型组件功能相同。
### 2.8 流水线运行
迭代支持「流水线运行」功能，用于展示迭代关联的流水线运行数据，你可以在此功能中追踪和分析流水线运行情况。 通常的协作流程为：
1.项目管理员需提前为项目关联流水线（在「流水线」组件 -「关联已有流水线」）;
2.迭代管理员需咨询技术人员配置"迭代关联流水线运行的规则" ；
- 系统支持通过脚本的方式批量将「当前项目的迭代」和「项目已关联流水线」的运行情况关联起来，请根据团队需要调整。
- 默认规则「string.len(branch) > 0 and string.find(sprint_name, branch, 1, true)」表示：如果流水线运行时的分支名称包含迭代的数据，则建立关联关系。
3.迭代管理员根据配置的"迭代关联流水线运行的规则"，修改迭代名称。
- 你需要在迭代名称中加入流水线运行的"分支名称"或"代码仓名称"；
- 以使用默认规则为例，如果期望在迭代中关联和 F2003分支 相关的流水线运行，则可以把迭代名称改成"F2003-XXX"
4.迭代成员进入「流水线运行」功能后，可以查看和迭代相关的流水线运行记录。
### 2.9 代码
在 **代码** 中，展示代码提交历史，包括Commit ID、Commit Message、提交人、提交时间、代码仓库、所属分支、运行状态
