> For the complete documentation index, see [llms.txt](https://guides-ones.gitbook.io/guides/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides-ones.gitbook.io/guides/usage-guide/ones-project/guan-li-gong-zuo-xiang/gong-zuo-xiang-zhuang-tai-yu-gong-zuo-liu.md).

# 工作项状态与工作流

## 1. 什么是工作项状态及工作流？

**工作项状态**是指工作项在某个特定时间点的状态，是工作项工作流的重要组成部分。

**工作流**是指工作项在其生命周期过程中将不同的状态以一定顺序串联，按照步骤流转，从开始到结束的过程。

ONES Project 支持不同工作项类型的工作流定制，让不同的工作项类型，在不同的项目中可以有不同的流转过程，帮助团队规范流程的同时兼具灵活性。

![](/files/-MdBEOU3k5TW3zunHZDU)

## 2. 管理工作项状态

### 2.1 新建工作项状态 

在`项目管理配置中心`>`工作项状态` ，点击`新建工作项状态`在弹窗内填写状态名称，并选择状态类型后，点击`确定`，即可完成创建。

### 2.2修改工作项状态 

在`项目管理配置中心`>`工作项状态` ，选择任一工作项状态，点击 ![](https://help.ones.pro/img/manual/%e7%bc%96%e8%be%91-3.png)，可修改工作项状态的名称和状态类型。修改后的工作项状态，将会同步到所有已经应用了该状态的项目中。

### 2.3  删除工作项状态

在`项目管理配置中心`>`工作项状态` ，选择任一工作项状态，点击 ![](https://help.ones.pro/img/manual/%e5%88%a0%e9%99%a4-16*16.png)，即可删除该工作项状态。如果该状态被应用到某个项目的工作项中，需要先移除再进行删除操作。

## 3. 配置工作流

在系统出厂设置中，每一种工作项类型都有默认的工作流，可直接使用，也可以在此基础上进行调整。在工作流配置界面，系统提供 3 种视图：

* 流程视图
* 表格视图
* 详情视图

下面以自定义工作项工作流的表格视图为例讲解如何配置工作流。在自定义工作项的工作流中，默认包含未开始、进行中、已完成 3 种状态，可以实现如下工作流流转：

![](/files/-MbJtDIDSP4I6sQC520s)

如需要对工作流进行调整时，可参照以下方法：

### 3.1  添加工作项状态

点击`添加工作项状态`，在弹窗内选择当前工作项需要流转的状态，并点击`确定`。新增加的状态会显示在表格的最后一行和最后一列。

### 3.2 设置初始状态

初始状态为工作项创建时状态的默认值，一个工作流有且只有一个初始状态。点击`设置初始状态`，在弹窗内选择工作项状态，设置完成后，对应的状态将会带有初始状态的标签。

### 3.3 新建步骤

步骤是两个工作项状态之间的连接，使工作项从一个状态转换到另一个状态的过程，在工作项状态流转时使用。在表格视图中，可以通过勾选表格上的复选框，可以建立一条从“开始状态”到“目标状态”的步骤，默认步骤名称为“目标状态”的名称。

也可以点击`新建步骤`，在弹窗内选择开始状态和目标状态，来新建步骤。

### 3.4 编辑步骤

在表格视图中，点击步骤旁的编辑图标，进入步骤编辑界面。在该界面中可以设置步骤验证、步骤属性、后置动作、重命名步骤或者删除步骤。

![](/files/-MdBEj63qt1TQ9Qpyryd)

#### 3.4.1 设置步骤验证

步骤验证用于执行步骤时的验证条件，比如设置哪些成员域可以执行当前步骤。可以在下方的成员域选择框中项目角色、成员或者用户组。

#### 3.4.2  设置步骤属性

步骤属性用于执行状态流转时，需要提交的字段，比如设置属性值、上传文件或者关联 Wiki 页面。

#### 3.4.3  设置后置动作

后置动作用于步骤执行成功后，执行修改属性、发送通知、更新工作项状态等操作。存在多条后置动作时，按照列表的顺序从上到下执行。后置动作以系统权限执行，其执行结果不会影响当前步骤的执行结果。

## 4. 工作项状态联动

在研发场景中，需求等工作项往往会被拆分或关联到不同的工作项，所以在需求等工作项关联不同的子工作项或关联工作项后，若两者的执行步骤可以联动，团队协作将更加顺畅，也可以缩小管理成本。

### 4.1 应用场景

* 如「需求」下的子需求全部完成时，「需求」要同步完成，可在某子需求处进行「后置动作」设置；
* 如「需求」关联的研发任务全部完成时，「需求」要同步完成，可在研发任务处进行「后置动作」设置；

### 4.2 配置案例

{% hint style="info" %}
状态联动不可在目标工作项处配置，需在其相关联的工作项处或其子工作项处进行配置。
{% endhint %}

#### 4.2.1 配置入口

进入当前工作项的**工作流步骤**中，在后置动作中选择“状态联动”。

![](/files/-MdBEytVEoWq-z4FkIcS)

#### 4.2.2  当目标工作项为“父工作项”，进入其子工作项进行配置

**工作项及工作项状态为全局选项，完成选择后需核查是否匹配目标工作项的流转场景**

:digit\_one: 选择目标工作项为父工作项，当前子工作项的父工作项均涉及「状态联动」。

![目标工作项为“父工作项”](/files/-MdGlgTYxc-979UnNo4o)

:digit\_two: 设置指定目标工作项的变更状态，即完成子工作项后的父工作项预期状态。

![父工作项“流转到指定状态”](/files/-MdGlikFCg2pm2mdO4Ms)

:digit\_three: 设置后置动作验证，即设置需要满足什么条件，才会执行此后置动作。当前工作项的父工作项下的所有子工作项状态为完成，才能实现「状态联动」

![父工作项的「后置动作验证」](/files/-MdGllMWpHOvoHImf1Zd)

#### 4.2.3 目标为“关联工作项”，进入其相关联的工作项进行配置

**工作项及工作项状态为全局选项，完成选择后需核查是否匹配目标工作项的流转场景**

:digit\_one: 选择目标工作项为关联工作项：目标工作项可通过“关联关系”、“工作项类型”、“工作项状态”筛选变更范围。

![关联工作项选择目标工作项](/files/-MdGlo_A3yIpsn3k0DpA)

:digit\_two: 指定目标工作项的变更状态。

![关联工作项“流转到指定状态”](/files/-MdGlrjWLwji2Dj5I7EB)

:digit\_three: 设置后置动作验证，关联了当前工作项的源工作项下的所有任务全部完成，才能实现「状态联动」

![设置后置动作验证条件](/files/-MdGltv4VdEsVNFfizLA)

#### 4.2.3 执行步骤时步骤验证、步骤属性、后置动作设置条件的提醒 

步骤执行的条件将在步骤按钮中以图标形式展示，步骤如新增执行条件相应图标将被点亮，并且会描述条件详情，使用者可以通过描述了解流转条件。

![执行步骤对「步骤验证」「步骤属性」「后置动作」的设置提醒](/files/-MdGm3-yRxOi_Y6l7rxr)