# 迭代组件

## 1. 迭代组件简介

迭代是敏捷开发中概念，一次迭代可能发布某个或某几个功能特性，一次迭代过程即包含这些新功能所需的所有开发工作项及其他工作项。一般情况下，一个迭代周期为 2-4 周。

通过「迭代」组件可规划迭代，管理迭代内的需求、缺陷和任务，追踪迭代进度等，帮助团队实现敏捷开发。

![「迭代」组件图示](/files/-MSbL81kE9cCVdlw08Mr)

## 2. 功能特性

### 2.1 迭代配置

#### 2.1.1 迭代功能设置

迭代组件的所有功能都可以由项目管理员自主决定是否开启，在**`项目设置>项目组件`**下，选中「迭代」组件，点击**`功能设置`**即可进行设置。

除迭代概览、敏捷看板、规划、全部工作项、流水线运行、代码这几个迭代的常规功能外，项目内已配置的工作项类型组件也会自动添加为对应的迭代功能，用来展示已被规划为迭代的工作项。

![](/files/-Mcwf-Ri26imFLq5yVib)

#### 2.1.2 迭代属性

迭代属性显示在迭代概览中，项目管理员可在**`项目设置>迭代配置>迭代属性`**下，自定义新建/修改迭代属性、设置属性默认值，或调整迭代属性展示的顺序。与工作项属性类似，系统支持单选菜单、单行文本、多行文本、日期、时间、单选成员、整数、浮点数等多种属性类型。

其中迭代名称支持系统自动累加，即在最近一个添加的迭代名称后+1，如：示例迭代 -> 示例迭代1；若该名称本身以整数结尾，则该整数+1，如：示例迭代5 -> 示例迭代6。

#### 2.1.3 迭代阶段

管理员可以自定义迭代阶段，帮助设置迭代中的重要节点，更高效地管理迭代进度。在「项目设置-迭代配置-迭代阶段」下可进行迭代阶段的设置。可以新建迭代阶段，调整已有阶段的排序、名称，删除阶段。其中未开始和已完成为迭代固定阶段，不支持编辑和删除。

#### 2.1.4 迭代关联流水线运行

通过迭代关联流水线运行，您可以在迭代中追踪和分析流水线运行情况。系统支持通过脚本的方式批量将「当前项目的迭代」和「项目已关联流水线」的运行情况关联起来：

* 如果当前项目暂未关联流水线，你可以前往流水线组件关联；
* 如果当前项目已关联流水线，你可以继续配置以下迭代关联流水线运行的规则。

### 2.2 新建迭代

在「迭代」组件下，点击左侧迭代列表上方的**`新建迭代`** ，打开新建迭代页。

![](/files/-MdFVZofqQsZHrvQd0Uq)

输入迭代名称，选择所属项目、迭代负责人，设置迭代周期，点击确定即可。

![新建迭代页图示](/files/-MU6lNOMoO8_qsV1cae_)

### 2.3 规划迭代

迭代管理员可以使用以下两种方式将工作项批量规划到目标迭代中。

* 在左侧栏点击**`未规划工作项`**  ，点击勾选需要规划的工作项，勾选完成后点击「规划至迭代」，选择目标迭代点击确定即可。

![未规划工作项/所有工作项列表入口图示](/files/-MU6n-aTSyGpKIWdMWBe)

* 选中目标迭代，点击**`规划`** ，面板左侧显示当前迭代内的工作项，面板右侧显示项目内未规划的工作项，迭代管理员可以勾选工作项，将工作项快速规划至当前迭代，或是将已规划的工作项移出本迭代。

![规划入口及规划页图示](/files/-MU6oAnTPMjVyJ8TP-WU)

### 2.4 迭代概览

「迭代概览」主要展示当前迭代的基本信息、完成情况以及一些关联信息。主要分为以下几个板块：

#### 2.4.1 迭代信息

在此处可以查看迭代的基本信息，包括迭代负责人、状态任务数量、迭代周期、迭代工时统计、迭代进度。（迭代管理员可以直接在此处修改信息）

![迭代信息图示](/files/-MU6pRcU_JCKPrwY-aMh)

#### 2.4.2 燃尽图

燃尽图是用于体现剩余工作量的工作图表，由横轴（X）和纵轴（Y）组成，横轴表示时间，纵轴表示剩余工作量，其中虚线为基线，表示期望的工作进度。

当剩余工作量高于基线时，则表示进度偏紧急，可能无法准时完成目标。当剩余工作量低于基线时，则表示进度较为乐观，甚至可能于周期内提前完成工作量。

目前支持两种燃尽方式：工作项燃尽和剩余工时燃尽。

![](/files/-MdFVpBpbTEhXq8mmY4w)

![](/files/-MdFVfZKhVgrjnyID6bT)

#### 2.4.3 当前阶段

展示了迭代的阶段划分、计划周期与实际周期，迭代管理员可点击进度条更改迭代阶段。

迭代管理员可以点击「自定义阶段」来设置迭代阶段；点击「修改日期」即可进行迭代计划日期的设置，实际周期会根据阶段的流转进行自动记录，也可以在此进行手动调整。

![](/files/-MdFW-OTns9AgLRvrdTb)

![迭代阶段日期设置页图示](/files/-MU6sngmEgahkmWQp9Nv)

#### 2.4.4 阶段描述

迭代管理员可在此处对已定义好的每个阶段进行描述，比如介绍每个阶段的目标等信息。

![](/files/-MdFW8OARArvtWOpvKY1)

#### 2.4.5 迭代属性、关联内容、迭代描述

**迭代属性** 展示了当前迭代已配置好的属性字段，迭代管理员也可以点击「属性设置」对其进行排序和调整。

**关联内容** 展示了本迭代关联的计划或计划组。

**迭代描述** 支持富文本编辑迭代的信息，可由迭代管理员进行设置。

![](/files/-MdFWMeG8ehpdfnwhVdQ)

![迭代属性、关联内容、迭代描述图示](/files/-MU6uk6BtLE6lIGl7G-i)

#### 2.4.6 成员剩余工时统计

查看成员剩余工时的统计表，支持按照成员或剩余工时排序，支持导出 .CSV 格式的文件。

查看当前迭代的资源使用情况，合理分配成员工时，提前预判工时不足的风险，做出相应处理。

![成员剩余工时统计表图示](/files/-MU6xjgf4IXvGpwKlCVN)

#### 2.4.7 代码统计

汇总统计当前迭代的代码提交情况，帮助迭代负责人评估开发贡献量。 目前支持统计和分析代码提交次数、代码提交次数趋势、代码提交影响行数的情况。

![](/files/-McOSr0L79zp-maLzdar)

### 2.5 敏捷看板

迭代下的敏捷看板支持基于关联工作项&父子工作项划分泳道，方便直观地了解任务的从属关系以及任务的状态，帮助研发经理、项目经理等在具体迭代中更高效地查阅迭代进展*。*

当泳道以父子工作项划分时，泳道的第一列会显示父工作项（父工作项的工作项类型可在看板设置中筛选），子工作项会显示在该泳道的不同状态列里。

当泳道以关联工作项划分时，可以通过**泳道工作项筛选**控制每个泳道的第一列显示的工作项类型。例如，想要显示迭代内需求的实现情况，则可以在泳道工作项筛选中选择需求，研发人员拆分任务时关联需求；则敏捷看板中会清楚地展现每一条需求所关联的研发任务的实现情况。

![](/files/-McxPwFg8Sb2jqtyDIfy)

#### 2.5.1 新建/编辑看板

一个迭代下支持新建多个敏捷看板，点击敏捷看板右上角的「看板管理」，在敏捷看板管理页面点击「新建看板」即可新建看板。点击敏捷看板左上角看板名称，可以搜索或切换敏捷看板。

点击泳道列右上侧的+，可以快速新建泳道支持的工作项类型；或是在迭代下相应的工作项类型下新建工作项，则也会出现在敏捷看板下。

点击泳道工作项右侧的+，可以快速新建该工作项的子工作项/关联工作项。

#### 2.5.2 筛选/快捷筛选/泳道筛选

可以使用筛选功能，设置筛选条件对看板的所有内容进行筛选；也支持「快捷筛选」，可用于快捷筛选的属性包含：负责人、创建人、优先级、工作项类型、子工作项类型。

泳道筛选是只针对泳道工作项的筛选，支持筛选的属性包含：标题、创建者、负责人、工作项类型、ID、描述、优先级、状态、子工作项类型、状态类型。

![](/files/-McxQL3HDUygcTL9Nrj6)

#### 2.5.3 敏捷看板设置

敏捷看板由项目管理员管理。点击敏捷看板右上角的「看板管理」即可进入到敏捷看板管理页面，可以新建/删除/编辑敏捷看板。

#### 泳道工作项筛选

可以设置迭代下的哪些工作项显示在敏捷看板的泳道工作项内。

#### 泳道工作项排序

为提高敏捷看板在早会场景下的易用性，例如：已经完成的工作项排序默认置底，可以通过设置泳道工作项排序来实现。

默认排序规则为状态类型（未开始、进行中、已完成）；也可以设置排序规则为状态（默认从A-Z排序）点击编辑按钮，可对状态进行自定义排序。设置完成后，迭代中对应的看板排序将会按照设置的规则显示。

#### 看板工作项设置

可以设置迭代下哪些工作项可以显示在看板中。例如，看板工作项类型选择任务，则泳道工作项的关联工作项/子工作项中，只有任务类型的才会出现在敏捷看板中。

#### 看板栏设置

可以设置删除、新增、重命名栏，以及管理每个栏下面的工作项状态，符合状态的工作项会显示在对应栏里。

#### 2.5.4 全屏展示

点击图标按钮，全屏展示敏捷看板。

![全屏展示入口图示](/files/-MU7VFSb8jXfgJwiyhQs)

### 2.6 迭代工作项列表

展示了迭代下的所有工作项，可以对迭代下所有类型的工作项进行筛选。工作项列表功能特性与工作项类型组件功能相同。前往了解

![迭代下全部工作项列表图示](/files/-MU7gpYsS1bbGPQp4VAi)

### 2.7 流水线运行

迭代支持「流水线运行」功能，用于展示迭代关联的流水线运行数据，你可以在此功能中追踪和分析流水线运行情况。 通常的协作流程为：

1、项目管理员需提前为项目关联流水线（在「流水线」组件 > 关联已有流水线）;

2、迭代管理员需咨询技术人员配置“迭代关联流水线运行的规则” ；

* 系统支持通过脚本的方式批量将「当前项目的迭代」和「项目已关联流水线」的运行情况关联起来，请根据团队需要调整。
* 默认规则「string.len(branch) > 0 and string.find(sprint\_name, branch, 1, true)」表示：如果流水线运行时的分支名称 包含迭代的数据，则建立关联关系。

3、迭代管理员根据配置的“迭代关联流水线运行的规则”，修改迭代名称。

* 你需要在迭代名称中加入流水线运行的“分支名称”或“代码仓名称”；
* 以使用默认规则为例，如果期望在迭代中关联和 F2003分支 相关的流水线运行，则可以把迭代名称改成“F2003-XXX”

4、迭代成员进入「流水线运行」功能后，可以查看和迭代相关的流水线运行记录。

![](/files/-McO_OZzTSPbb6XqN8LT)

![](/files/-McO_Rb-P01uZDPvXP4o)

### 2.8 代码

在**代码**中，展示代码提交历史，包括Commit ID、Commit Message、提交人、提交时间、代码仓库、所属分支、运行状态

![](/files/-McO_p3fQuoC-qgfg7p9)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides-ones.gitbook.io/guides/usage-guide/ones-project/pei-zhi-xiang-mu-zu-jian/die-dai-zu-jian.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.