审批通过、不通过、驳回

相关视频：

* [16、如何实现我的待办任务列表？(opens new window)](https://t.zsxq.com/04QZzjAme)
* [17、如何实现我的已办任务列表？(opens new window)](https://t.zsxq.com/04uj6AQJE)
* [18、如何实现任务的审批通过？(opens new window)](https://t.zsxq.com/04Q7UbqBM)
* [19、如何实现任务的审批不通过？(opens new window)](https://t.zsxq.com/04BQvJM7y)
* [20、如何实现流程的审批记录？(opens new window)](https://t.zsxq.com/04Ie2v7m2)

本文，我们围绕 [审批中心] 菜单下的 [待办任务]、[已办任务] 两个子菜单，讲解审批通过、审批不通过、驳回的操作流程。

## [#](https://doc.iocoder.cn/bpm/task-todo-done/#_1-%E5%BE%85%E5%8A%9E%E4%BB%BB%E5%8A%A1)1. 待办任务

待办任务，仅展示需要我审批的任务，对应 [审批中心 -> 待办任务] 菜单，如下图所示：

![待办任务](/media/202404/2024-04-26_0109460.25570834292233346.png)

* 后端，对应 BpmTaskController 的 `#getTaskTodoPage(...)` 提供接口
* 前端，对应 `/views/bpm/task/todo/index.vue` 实现界面

### [#](https://doc.iocoder.cn/bpm/task-todo-done/#_1-1-%E8%A1%A8%E7%BB%93%E6%9E%84)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` 字段，表示任务状态，如下图所示：

![TASK_STATUS](/media/202404/2024-04-26_0109460.455834872460815.png)

### [#](https://doc.iocoder.cn/bpm/task-todo-done/#_1-2-%E4%BB%BB%E5%8A%A1%E7%8A%B6%E6%80%81)1.2 任务状态

任务状态，由 [BpmTaskStatusEnum **(opens new window)**](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-bpm/yudao-module-bpm-api/src/main/java/cn/iocoder/yudao/module/bpm/enums/task/BpmTaskStatusEnum.java) 目前有 8 种，如下图所示：

![任务状态](/media/202404/2024-04-26_0109460.850207168296116.png)

### [#](https://doc.iocoder.cn/bpm/task-todo-done/#_1-3-%E5%AE%A1%E6%89%B9%E9%80%9A%E8%BF%87)1.3 审批通过

审批通过，由 BpmTaskController 的 `#approveTask(...)` 提供接口，如下图所示：

![审批通过](/media/202404/2024-04-26_0109460.4111797696324033.png)

最核心的，就是调用 Flowable 的 `TaskService#complete(...)` 方法，完成任务。同时因为 Flowable 自身没有任务状态，所以需要我们自己维护任务状态。如下图所示：

![更新任务状态](/media/202404/2024-04-26_0109460.2604907780988598.png)

### [#](https://doc.iocoder.cn/bpm/task-todo-done/#_1-4-%E5%AE%A1%E6%89%B9%E4%B8%8D%E9%80%9A%E8%BF%87)1.4 审批不通过

审批不通过，由 BpmTaskController 的 `#rejectTask(...)` 提供接口，如下图所示：

![审批不通过](/media/202404/2024-04-26_0109460.8646996188776442.png)

注意，任务只要审批不通过，整个流程都会被中止（审批不通过），即使在或签场景下！

### [#](https://doc.iocoder.cn/bpm/task-todo-done/#_1-5-%E9%A9%B3%E5%9B%9E)1.5 驳回

驳回（退回），将审批重置发送给某节点，重新审批。如下图所示：

![驳回](/media/202404/2024-04-26_0109460.11773872165893962.png)

① 获得可驳回的节点，由 BpmTaskController 的 `#getTaskListByReturn(...)` 提供接口，如下图所示：

![获取可驳回的节点](/media/202404/2024-04-26_0109460.29479512810328723.png)

② 发起驳回，由 BpmTaskController 的 `#returnTask(...)` 提供接口，如下图所示：

![发起驳回](/media/202404/2024-04-26_0109460.9814925187462102.png)

核心还是 Flowable 提供的 `#moveActivityIdsToSingleActivityId(...)` 方法，它是 Activiti 没有内置的方法，所以在 Activiti 实现驳回就略微麻烦一些。

## [#](https://doc.iocoder.cn/bpm/task-todo-done/#_2-%E5%B7%B2%E5%8A%9E%E4%BB%BB%E5%8A%A1)2. 已办任务

已办任务，仅展示我审批过的任务，对应 [审批中心 -> 已办任务] 菜单，如下图所示：

![已办任务](/media/202404/2024-04-26_0109460.9105293811311337.png)

* 后端，对应 BpmTaskController 的 `#getTaskDonePage(...)` 提供接口
* 前端，对应 `/views/bpm/task/done/index.vue` 实现界面

### [#](https://doc.iocoder.cn/bpm/task-todo-done/#_2-1-%E8%A1%A8%E7%BB%93%E6%9E%84)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` 表查询到。这当然也是是一种“冷热分离”的设计思想~

## [#](https://doc.iocoder.cn/bpm/task-todo-done/#_3-%E6%B5%81%E7%A8%8B%E4%BB%BB%E5%8A%A1)3. 流程任务

流程任务，展示系统中所有的任务，一般用于管理员查询，对应 [流程管理 -> 流程任务] 菜单，如下图所示：

![流程任务](/media/202404/2024-04-26_0109460.43347520876193524.png)

* 后端，对应 BpmTaskController 的 `#getTaskManagerPage(...)` 提供接口
* 前端，对应 `/views/bpm/task/manager/index.vue` 实现界面

由于它查询的是所有任务，所以读取的是 `ACT_HI_TASKINST` 表，而不是 `ACT_RU_TASK` 表。