> For the complete documentation index, see [llms.txt](https://guides-ones.gitbook.io/new/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/new/quickplay/jbbz/xqsj/pzgzx/bjgzx.md).
# 编辑工作项
定义每个工作项专属的特点，这是每个工作正常运转的核心。
更深度的对每个工作项进行定义，学会调用全局的「属性」、「状态」，定义权限、工作流程、通知和提醒。
{% hint style="info" %}
可在全局视角&项目视角进行配置，配置方法一致。
{% endhint %}
### 一、编辑工作项属性
每种类型的工作项都可以很大程度的配置属性以应对各种需要，「需求」、「缺陷」等工作存在于每个项目，故企业负责人可以在全局定义需求的属性参数表单，进而应用到每个新项目中，项目负责人可以在项目配置仅适用于当前项目的工作项属性参数表单。
{% hint style="info" %}
全局视角下更改属性表单设定不会应用到存量项目中，应当回到项目重新配置
{% endhint %}
{% tabs %}
{% tab title="全局配置入口" %}
在 Project 配置中心，选择具体的工作项类型进行编辑，点击“工作项属性”进行编辑
> 配置方法： :point\_right: [定义工作项属性](https://guides-ones.gitbook.io/new/quickplay/jbbz/xqsj/pzgzx#er-ding-yi-gong-zuo-xiang-shu-xing)
{% endtab %}
{% tab title="项目配置入口" %}
项目设置 > 工作项类型 > 具体工作项，如“需求” > 工作项属性
> 配置方法： :point\_right: [定义工作项属性](https://guides-ones.gitbook.io/new/quickplay/jbbz/xqsj/pzgzx#er-ding-yi-gong-zuo-xiang-shu-xing)
{% endtab %}
{% endtabs %}
### 二、工作项权限
支持在全局视角和项目视角下设定工作项权限授权范围。Project 配置中心 > 工作项分组 > 工作项类型 > 选择具体工作项类型 > 编辑 > 工作项权限
{% hint style="info" %}
在 Project 配置中心下修改工作项权限，不会同步到已经应用的项目中。
{% endhint %}
| 权限列表 | 权限描述 | 限制范围 |
| ----------- | ----------------------------------------- | ------------------- |
| 创建工作项 | 允许成员创建工作项 | 项目角色、用户组、部门、特殊角色、成员 |
| 查看工作项 | 允许成员查看工作项 | 项目角色、用户组、部门、特殊角色、成员 |
| 编辑工作项 | 允许成员修改工作项，以及对工作项进行其他变更操作 | 项目角色、用户组、部门、特殊角色、成员 |
| 删除工作项 | 允许成员删除工作项 | 项目角色、用户组、部门、特殊角色、成员 |
| 更新工作项状态 | 允许成员更新工作项状态 | 项目角色、用户组、部门、特殊角色、成员 |
| 编辑关注者 | 允许成员修改工作项的关注者 | 项目角色、用户组、部门、特殊角色、成员 |
| 成为负责人 | 允许成员成为工作项的可选负责人 | 项目角色、用户组、部门、特殊角色、成员 |
| 导出工作项列表 | 允许成员将工作项列表导出为文件 | 项目角色、用户组、部门、特殊角色、成员 |
| 管理预估工时 | 允许成员添加、修改、删除工作项的预估工时 | 项目角色、用户组、部门、特殊角色、成员 |
| 管理所有工时记录 | 允许成员在工作项下添加工时记录，在所有工时记录中修改或删除登记工时和剩余工时 | 项目角色、用户组、部门、特殊角色、成员 |
| 管理自己登记的工时记录 | 允许成员在工作项下添加工时记录，在自己登记的工时记录中修改或删除登记工时和剩余工时 | 项目角色、用户组、部门、特殊角色、成员 |
### 三、工作项工作流
工作流用于定制工作从开始到结束遍历的流程，在工作流中借助自定义状态和步骤完成工作流配置
{% hint style="info" %}
在 Project 配置中心下修改工作项工作流，不会同步到已经应用的项目中。
{% endhint %}
首先需要规划当前工作项的所有阶段和起始状态，也就是状态和初始状态，举个栗子：如果需求从提出需要经历“需求提出-核对需求-调研分析-研发-完成”这样的过程，过程中的每个环节被称为状态，“需求提出”是起始状态。
{% tabs %}
{% tab title="第一步：添加工作项状态" %}
具体工作项类型 > 编辑 > 工作项工作流 > 添加工作项状态，下拉框包含系统所有的工作项状态，选择当前工作项需要的状态。 :bulb: [下拉框中没有我需要的状态怎么办？](https://guides-ones.gitbook.io/new/quickplay/jbbz/xqsj/pzgzx#san-ding-yi-gong-zuo-xiang-zhuang-tai)
{% endtab %}
{% tab title="第二步：设置初始状态" %}
设置初始状态的下拉框中包含了当前工作项的所有状态，工作初始状态设置完成后，完成新建工作后默认处于初始状态。
{% endtab %}
{% tab title="第三步：新建步骤" %}
目标状态的下拉框中同样包含了当前工作项的所有状态，可多选。
{% endtab %}
{% tab title="第四步：编辑步骤" %}
在表格视图下点击 
图标，在详情视图下点击“编辑”，进行①步骤验证 ②步骤属性 ③ 后置动作
* 步骤验证：用于执行步骤时的条件验证，拥有以下条件才可以执行对应步骤
* 步骤属性：操作状态变更时需要填写的参数，可设置必填和默认值
* 后置动作：即工作项状态更新后，系统支持进行状态联动、更新属性、发送邮件通知的后续动作响应当前工作的变更，如：发邮件告知工作状态更新了，变更负责人、更新关联父工作的状态等。
{% hint style="info" %}
1. 后置动作以系统权限执行；
2. 执行顺序按照后置动作列表自上而下执行；
3. 后置动作的执行结果不会影响当前步骤的执行结果。
{% endhint %}
> 后置动作可添加：①状态联动 ②更新属性 ③发送邮件通知 三种。
>
> * 更新属性：更新某属性的参数，如优先级由 P0 改为 P6；
> * 发送邮件通知：当执行步骤后，邮件通知到设定的成员；
> * 状态联动：变更当前任务的父/和关联工作到指定状态，再设定验证条件即可
:exclamation: 以下篇幅较长，主要**`围绕后置动作的状态联动`**展开。
1.工作项支持步骤变更时的状态联动：
* 如「需求」下的子需求全部完成时，「需求」要同步完成，可在某子需求处进行「后置动作」设置；
* 如「需求」关联的研发任务全部完成时，「需求」要同步完成，可在研发任务处进行「后置动作」设置；
2.支持工作项在执行步骤时显示步骤验证、步骤属性以及后置动作的配置情况。
在研发场景中，需求等工作项往往会被拆分或关联到不同的工作项，所以在需求等工作项链出不同的子工作项或关联工作项后，若两者的执行步骤可以联动，团队协作将更加顺畅，也可以缩小管理成本。
### **1️⃣ 目标为“父工作项”，进入其子工作项进行配置**
`注意：工作项及工作项状态为全局选项，完成选择后需核查是否匹配目标工作项的流转场景`
选择目标工作项为父工作项，当前子工作项的父工作项均涉及「状态联动」；
指定目标工作项的变更状态，即完成子工作项后的父工作项预期状态；
「后置动作验证」，当前工作项的父工作项下的所有子工作项状态为完成，才能实现「状态联动」；
### 2️⃣ 目标为“关联工作项”，进入其相关联的工作项进行配置
`注意：工作项及工作项状态为全局选项，完成选择后需核查是否匹配目标工作项的流转场景`
选择目标工作项为关联工作项：目标工作项可通过“关联关系”、“工作项类型”、“工作项状态”筛选变更范围；
指定目标工作项的变更状态；
「后置动作验证」，关联了当前工作项的源工作项下的所有任务全部完成，才能实现「状态联动」；
目标工作项状态的灵活控制主要依赖联动的“后置动作验证”，所以系统为了兼容更多场景，提供了丰富的设置条件，可按照实际场景灵活配置，以上是两种比较常用的配置方法供参考。
### 3️⃣ 执行步骤时步骤验证、步骤属性、后置动作设置条件的提醒
步骤执行的条件将在步骤按钮中以图标形式展示，步骤如新增执行条件相应图标将被点亮，并且会描述条件详情，使用者可以通过描述了解流转条件；
{% endtab %}
{% endtabs %}
工作流配置界面支持多种可视化配置方式，方便配置人员观察工作的流转路径。
{% tabs %}
{% tab title="流程视图" %}
由于各类工作流程复杂多变，为了提高配置效率，工作流支持流程视图。
* 支持全屏模式
* 支持放大缩小
* 支持高亮当前状态流转路径
* 支持拖动当前状态
* 支持显示/隐藏步骤名称
{% endtab %}
{% tab title="表格视图" %}
更加高效的步骤配置方案，所有状态间均可配置流动路径，管理员可以在开始状态栏规划目标状态，勾选添加步骤（取消勾选即删除步骤）
* 支持显示步骤名称
* 支持显示步骤属性
* 支持显示步骤验证
* 支持显示后置动作数量
* 支持编辑步骤
{% endtab %}
{% tab title="详情视图" %}
详情视图下，管理员可以直观地看到每一条状态下的步骤，以及每个步骤的目标状态
* 支持新建步骤
* 支持编辑步骤
* 支持对自定义步骤显示顺序（仅用于变更工作项状态时的状态选项向后顺序）
{% endtab %}
{% endtabs %}
### 四、工作项通知
用于定制哪些成员可以收到工作项动态的通知提醒并设置通知渠道
通知渠道：通知中心、邮件、第三方账号（钉钉、企业微信）
| 通知条件 | 通知描述 | 通知范围 |
| ------------ | ------------------- | ------------------- |
| 创建工作项 | 创建工作项时发送通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 更改负责人 | 更改负责人时发送通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 更改状态 | 更改工作项状态时发送通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 更改优先级 | 更改工作项优先级时发送通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 更改标题 | 更改工作项标题时发送通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 设置截止时间 | 添加/修改工作项截止时间时发送通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 设置所属迭代 | 添加/修改所属迭代时发送通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 新增评论 | 新增评论时发送通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 新增/取消关注工作项 | 成员新增/取消关注工作项时发送通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 设置关联工作项 | 添加/修改关联工作项时发送通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 设置关联执行结果 | 添加/修改关联执行结果时发送通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 设置关联用例库用例 | 添加/修改关联用例库用例时发送通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 设置关联测试计划 | 关联/移除测试计划时发送通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 设置关联 Wiki 页面 | 关联/移除 Wiki 页面时发送通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 上传文件 | 上传工作项文件时发送通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 更新预估工时 | 添加、修改或删除预估工时时发送通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 更新剩余工时 | 添加、修改或删除剩余工时时发送通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 更新登记工时 | 添加、修改或删除登记工时时发送通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 更改自定义属性 | 更改除系统属性外的自定义属性时发送通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 变更工作项类型 | 当工作项类型发生变更时发通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 转为子工作项 | 当转为子工作项时发通知 | 项目角色、用户组、部门、特殊角色、成员 |
| 更改所属产品 | 更改所属产品时发送通知 | 项目角色、用户组、部门、特殊角色、成员 |
### 五、工作项提醒
针对工作项的关键时间推送消息提醒，避免工作延误，在具体的工作项编辑里选择工作项提醒，然后添加提醒规则。
{% tabs %}
{% tab title="第一步：设置提醒时间节点" %}
先选择工作项的创建时间、更新时间、计划开始/结束日期、截止日期，然后针对性的选择提醒节点。
{% endtab %}
{% tab title="第二步：选择通知渠道" %}
可以选择用站内信、邮件、第三方的渠道提醒
{% endtab %}
{% tab title="第三步：工作项限制" %}
当工作项满足以下设置的条件才能触发提醒
{% endtab %}
{% tab title="第四步：设置提醒范围" %}
支持设置角色、用户组、部门、成员
{% endtab %}
{% endtabs %}