# 工作项状态与工作流

## 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)


---

# 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/guan-li-gong-zuo-xiang/gong-zuo-xiang-zhuang-tai-yu-gong-zuo-liu.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.