审批通过、不通过、驳回
相关视频：
本文，我们围绕 [审批中心] 菜单下的 [待办任务]、[已办任务] 两个子菜单，讲解审批通过、审批不通过、驳回的操作流程。
# 1. 待办任务
待办任务，仅展示需要我审批的任务，对应 [审批中心 -> 待办任务] 菜单，如下图所示：
- 后端，对应 BpmTaskController 的
#getTaskTodoPage(...)提供接口 - 前端，对应
/views/bpm/task/todo/index.vue实现界面
# 1.1 表结构
① 流程任务表，由 Flowable 提供的 ACT_RU_TASK 表实现，如下所示：
| 字段 | 类型 | 主键 | 说明 | 备注 |
|---|---|---|---|---|
| ID_ | NVARCHAR2(64) | Y | 主键 | |
| REV_ | INTEGER | N | 数据版本 | |
| EXECUTION_ID_ | NVARCHAR2(64) | N | 任务所在的执行流 ID | |
| PROC_INST_ID_ | NVARCHAR2(64) | N | 流程实例 ID | |
| PROC_DEF_ID_ | NVARCHAR2(64) | N | 流程定义数据 ID | |
| NAME_ | NVARCHAR2(255) | N | 任务名称 | |
| PARENT_TASK_ID_ | NVARCHAR2(64) | N | 父任务 ID | |
| DESCRIPTION_ | NVARCHAR2(2000) | N | 说明 | |
| TASK_DEF_KEY_ | NVARCHAR2(255) | N | 任务定义的 ID 值 | |
| OWNER_ | NVARCHAR2(255) | N | 任务拥有人 | |
| ASSIGNEE_ | NVARCHAR2(255) | N | 被指派执行该任务的人 | |
| DELEGATION_ | NVARCHAR2(64) | N | ||
| PRIORITY_ | INTEGER | N | ||
| CREATE_TIME_ | TIMESTAMP(6) | N | 创建时间 | |
| DUE_DATE_ | TIMESTAMP(6) | N | 耗时 | |
| CATEGORY_ | NVARCHAR2(255) | N | ||
| SUSPENSION_STATE_ | INTEGER | N | 是否挂起 | 1 代表激活 2 代表挂起 |
| TENANT_ID_ | NVARCHAR2(255) | N | ||
| FORM_KEY_ | NVARCHAR2(255) | N | ||
| CLAIM_TIME_ | TIMESTAMP(6) | N |
② 流程参数表，由 Flowable 提供的 ACT_RU_VARIABLE 表实现，如下所示：
| 字段 | 类型 | 主键 | 说明 | 备注 |
|---|---|---|---|---|
| ID_ | NVARCHAR2(64) | Y | 主键 | |
| REV_ | INTEGER | N | 数据版本 | |
| TYPE_ | NVARCHAR2(255) | N | 参数类型 | 可以是基本的类型，也可以用户自行扩展 |
| NAME_ | NVARCHAR2(255) | N | 参数名称 | |
| EXECUTION_ID_ | NVARCHAR2(64) | N | 参数执行 ID | |
| PROC_INST_ID_ | NVARCHAR2(64) | N | 流程实例 ID | |
| TASK_ID_ | NVARCHAR2(64) | N | 任务 ID | |
| BYTEARRAY_ID_ | NVARCHAR2(64) | N | 资源 ID | |
| DOUBLE_ | NUMBER(*,10) | N | 参数为 double，则保存在该字段中 | |
| LONG_ | NUMBER(19) | N | 参数为 long，则保存在该字段中 | |
| TEXT_ | NVARCHAR2(2000) | N | 用户保存文本类型的参数值 | |
| TEXT2_ | NVARCHAR2(2000) | N | 用户保存文本类型的参数值 |
在 Flowable 中，如果想给 Task 增加拓展字段，无法通过 ACT_RU_TASK 实现，而是通过 ACT_RU_VARIABLE 表实现。
该表是一种 Key-Value 的形式，可以存储任意类型的数据。例如说，项目中给 Task 增加了一个 TASK_STATUS 字段，表示任务状态，如下图所示：
# 1.2 任务状态
任务状态，由 BpmTaskStatusEnum (opens new window) 目前有 8 种，如下图所示：
图片纠错：最新版本不区分 yudao-module-bpm-api 和 yudao-module-bpm-biz 子模块，代码直接合并到 yudao-module-bpm 模块的 src 目录下，更适合单体项目
# 1.3 审批通过
审批通过，由 BpmTaskController 的 #approveTask(...) 提供接口，如下图所示：
图片纠错：最新版本不区分 yudao-module-bpm-api 和 yudao-module-bpm-biz 子模块，代码直接合并到 yudao-module-bpm 模块的 src 目录下，更适合单体项目
最核心的，就是调用 Flowable 的 TaskService#complete(...) 方法，完成任务。同时因为 Flowable 自身没有任务状态，所以需要我们自己维护任务状态。如下图所示：
图片纠错：最新版本不区分 yudao-module-bpm-api 和 yudao-module-bpm-biz 子模块，代码直接合并到 yudao-module-bpm 模块的 src 目录下，更适合单体项目
# 1.4 审批不通过
审批不通过，由 BpmTaskController 的 #rejectTask(...) 提供接口，如下图所示：
图片纠错：最新版本不区分 yudao-module-bpm-api 和 yudao-module-bpm-biz 子模块，代码直接合并到 yudao-module-bpm 模块的 src 目录下，更适合单体项目
注意，任务只要审批不通过，整个流程都会被中止（审批不通过），即使在或签场景下！
# 1.5 驳回
驳回（退回），将审批重置发送给某节点，重新审批。如下图所示：
① 获得可驳回的节点，由 BpmTaskController 的 #getTaskListByReturn(...) 提供接口，如下图所示：
图片纠错：最新版本不区分 yudao-module-bpm-api 和 yudao-module-bpm-biz 子模块，代码直接合并到 yudao-module-bpm 模块的 src 目录下，更适合单体项目
② 发起驳回，由 BpmTaskController 的 #returnTask(...) 提供接口，如下图所示：
图片纠错：最新版本不区分 yudao-module-bpm-api 和 yudao-module-bpm-biz 子模块，代码直接合并到 yudao-module-bpm 模块的 src 目录下，更适合单体项目
核心还是 Flowable 提供的 #moveActivityIdsToSingleActivityId(...) 方法，它是 Activiti 没有内置的方法，所以在 Activiti 实现驳回就略微麻烦一些。
# 2. 已办任务
已办任务，仅展示我审批过的任务，对应 [审批中心 -> 已办任务] 菜单，如下图所示：
- 后端，对应 BpmTaskController 的
#getTaskDonePage(...)提供接口 - 前端，对应
/views/bpm/task/done/index.vue实现界面
# 2.1 表结构
① 流程历史任务表，由 Flowable 提供的 ACT_HI_TASKINST 表实现，如下所示：
| 字段 | 类型 | 主键 | 说明 | 备注 |
|---|---|---|---|---|
| 字段 | 类型 | 主键 | 说明 | 备注 |
| ID_ | NVARCHAR2(64) | Y | 主键 | |
| PROC_DEF_ID_ | NVARCHAR2(64) | N | 流程定义 ID | |
| TASK_DEF_KEY_ | NVARCHAR2(255) | N | 任务定义的 ID 值 | |
| PROC_INST_ID_ | NVARCHAR2(64) | N | 流程实例 ID | |
| EXECUTION_ID_ | NVARCHAR2(64) | N | 执行 ID | |
| PARENT_TASK_ID_ | NVARCHAR2(64) | N | 父任务 ID | |
| NAME_ | NVARCHAR2(255) | N | 名称 | |
| DESCRIPTION_ | NVARCHAR2(2000) | N | 说明 | |
| OWNER_ | NVARCHAR2(255) | N | 实际签收人 任务的拥有者 | 签收人（默认为空，只有在委托时才有值） |
| ASSIGNEE_ | NVARCHAR2(255) | N | 被指派执行该任务的人 | |
| START_TIME_ | TIMESTAMP(6) | N | 开始时间 | |
| CLAIM_TIME_ | TIMESTAMP(6) | N | 提醒时间 | |
| END_TIME_ | TIMESTAMP(6) | N | 结束时间 | |
| DURATION_ | NUMBER(19) | N | 耗时 | |
| DELETE_REASON_ | NVARCHAR2(2000) | N | 删除原因 | |
| PRIORITY_ | INTEGER | N | 优先级别 | |
| DUE_DATE_ | TIMESTAMP(6) | N | 过期时间 | |
| FORM_KEY_ | NVARCHAR2(255) | N | 节点定义的 formkey | |
| CATEGORY_ | NVARCHAR2(255) | N | 类别 | |
| TENANT_ID_ | NVARCHAR2(255) | N |
在 Flowable 中，如果 Task 被完成（审批通过、不通过、取消等）时候，会从 ACT_RU_TASK 表中删除，只能在 ACT_HI_TASKINST 表查询到。这是一种“冷热分离”的设计思想，因为进行的任务访问比较频繁，数据量越小，性能会越好。
② 流程历史参数表，由 Flowable 提供的 ACT_HI_VARINST 表实现，如下所示：
| 字段 | 类型 | 主键 | 说明 | 备注 |
|---|---|---|---|---|
| ID_ | NVARCHAR2(64) | Y | 主键 | |
| PROC_INST_ID_ | NVARCHAR2(64) | N | 流程实例 ID | |
| EXECUTION_ID_ | NVARCHAR2(64) | N | 指定 ID | |
| TASK_ID_ | NVARCHAR2(64) | N | 任务 ID | |
| NAME_ | NVARCHAR2(255) | N | 名称 | |
| VAR_TYPE_ | NVARCHAR2(100) | N | 参数类型 | |
| REV_ | INTEGER | N | 数据版本 | |
| BYTEARRAY_ID_ | NVARCHAR2(64) | N | 字节表 ID | |
| DOUBLE_ | NUMBER(*,10) | N | 存储 double 类型数据 | |
| LONG_ | NUMBER(*,10) | N | 存储 long 类型数据 | |
| TEXT_ | NVARCHAR2(2000) | N | ||
| TEXT2_ | NVARCHAR2(2000) | N | ||
| CREATE_TIME_ | TIMESTAMP(6)(2000) | N | ||
| LAST_UPDATED_TIME_ | TIMESTAMP(6)(2000) | N |
在 Flowable 中，如果 Task 被完成（审批通过、不通过、取消等）时候，会从 ACT_RU_VARIABLE 表中删除，只能在 ACT_HI_VARINST 表查询到。这当然也是是一种“冷热分离”的设计思想~
# 3. 流程任务
流程任务，展示系统中所有的任务，一般用于管理员查询，对应 [流程管理 -> 流程任务] 菜单，如下图所示：
- 后端，对应 BpmTaskController 的
#getTaskManagerPage(...)提供接口 - 前端，对应
/views/bpm/task/manager/index.vue实现界面
由于它查询的是所有任务，所以读取的是 ACT_HI_TASKINST 表，而不是 ACT_RU_TASK 表。