流程发起、取消、重新发起

相关视频：

* [11、如何实现流程的发起？(opens new window)](https://t.zsxq.com/04jyvNfqj)
* [12、如何实现我的流程列表？(opens new window)](https://t.zsxq.com/046UFqRzz)
* [13、如何实现流程的取消？(opens new window)](https://t.zsxq.com/04aM72rzv)

本文的内容比较简单，主要围绕 [审批中心] 菜单下的 [我的流程]、[发起流程] 子菜单，讲解流程的发起、取消、重新发起的操作流程。

## [#](https://doc.iocoder.cn/bpm/process-instance/#_1-%E5%8F%91%E8%B5%B7%E6%B5%81%E7%A8%8B)1. 发起流程

发起流程，对应 [审批中心 -> 发起流程] 菜单，如下图所示：

![发起流程](/media/202404/2024-04-26_0108510.8055438738269572.png)

### [#](https://doc.iocoder.cn/bpm/process-instance/#_1-1-%E8%A1%A8%E7%BB%93%E6%9E%84)1.1 表结构

① 流程实例表，由 Flowable 提供的 `ACT_RU_EXECUTION` 表实现，如下所示：

| 字段                  | 类型           | 主键 | 说明               | 备注 |
| ----------------------- | ---------------- | ------ | -------------------- | ------ |
| ID_                   | NVARCHAR2(64)  | Y    | 主键               |      |
| REV_                  | INTEGER        | N    | 数据版本           |      |
| PROC_INST_ID_         | NVARCHAR2(64)  | N    | 流程实例 ID        |      |
| BUSINESS_KEY_         | NVARCHAR2(255) | N    | 业务主键 ID        |      |
| PARENT_ID_            | NVARCHAR2(64)  | N    | 父执行流的 ID      |      |
| PROC_DEF_ID_          | NVARCHAR2(64)  | N    | 流程定义的数据 ID  |      |
| SUPER_EXEC_           | NVARCHAR2(64)  | N    |                    |      |
| ROOT_PROC_INST_ID_    | NVARCHAR2(64)  | N    |                    |      |
| ACT_ID_               | NVARCHAR2(255) | N    | 节点实例 ID        |      |
| IS_ACTIVE_            | NUMBER(1)      | N    | 是否存活           |      |
| IS_CONCURRENT_        | NUMBER(1)      | N    | 执行流是否正在并行 |      |
| IS_SCOPE_             | NUMBER(1)      | N    |                    |      |
| IS_EVENT_SCOPE_       | NUMBER(1)      | N    |                    |      |
| IS_MI_ROOT_           | NUMBER(1)      | N    |                    |      |
| SUSPENSION_STATE_     | INTEGER        | N    | 流程终端状态       |      |
| CACHED_ENT_STATE_     | INTEGER        | N    |                    |      |
| TENANT_ID_            | NVARCHAR2(255) | N    |                    |      |
| NAME_                 | NVARCHAR2(255) | N    |                    |      |
| START_TIME_           | TIMESTAMP(6)   | N    | 开始时间           |      |
| START_USER_ID_        | NVARCHAR2(255) | N    |                    |      |
| LOCK_TIME_            | TIMESTAMP(6)   | N    |                    |      |
| IS_COUNT_ENABLED_     | NUMBER(1)      | N    |                    |      |
| EVT_SUBSCR_COUNT_     | INTEGER        | N    |                    |      |
| TASK_COUNT_           | INTEGER        | N    |                    |      |
| JOB_COUNT_            | INTEGER        | N    |                    |      |
| TIMER_JOB_COUNT_      | INTEGER        | N    |                    |      |
| SUSP_JOB_COUNT_       | INTEGER        | N    |                    |      |
| DEADLETTER_JOB_COUNT_ | INTEGER        | N    |                    |      |
| VAR_COUNT_            | INTEGER        | N    |                    |      |
| ID_LINK_COUNT_        | INTEGER        | 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_EXECUTION` 实现，而是通过 `ACT_RU_VARIABLE` 表实现。

该表是一种 Key-Value 的形式，可以存储任意类型的数据。例如说，项目中给 ProcessInstance 增加了一个 `PROCESS_STATUS` 字段，表示流程状态，如下图所示：

![PROCESS_STATUS](/media/202404/2024-04-26_0108510.022979011194229515.png)

### [#](https://doc.iocoder.cn/bpm/process-instance/#_1-2-%E6%B5%81%E7%A8%8B%E7%8A%B6%E6%80%81)1.2 流程状态

流程状态，由 [BpmProcessInstanceStatusEnum **(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/BpmProcessInstanceStatusEnum.java) 目前有 4 种，如下图所示：

![流程状态](/media/202404/2024-04-26_0108510.986759095947753.png)

### [#](https://doc.iocoder.cn/bpm/process-instance/#_1-3-%E5%85%B7%E4%BD%93%E5%AE%9E%E7%8E%B0)1.3 具体实现

* 前端，对应 `/views/bpm/processInstance/create/index.vue` 实现界面
* 后端，对应 BpmProcessInstanceController 的 `#createProcessInstance(...)` 提供接口

![发起流程的实现](/media/202404/2024-04-26_0108510.9045132263307849.png)

最核心的，就是调用 Flowable 的 `RuntimeService#createProcessInstanceBuilder().start()` 方法，创建流程实例。同时因为 Flowable 自身没有流程状态，所以需要我们自己维护任务状态。

## [#](https://doc.iocoder.cn/bpm/process-instance/#_2-%E6%88%91%E7%9A%84%E6%B5%81%E7%A8%8B)2. 我的流程

我的流程，对应 [审批中心 -> 我的流程] 菜单，如下图所示：

![我的流程](/media/202404/2024-04-26_0108510.3554366953791106.png)

### [#](https://doc.iocoder.cn/bpm/process-instance/#_2-1-%E8%A1%A8%E7%BB%93%E6%9E%84)2.1 表结构

① 历史流程实例表，由 Flowable 提供的 `ACT_HI_PROCINST` 表实现，如下所示：

| 字段                       | 类型            | 主键 | 说明          | 备注 |
| ---------------------------- | ----------------- | ------ | --------------- | ------ |
| ID_                        | NVARCHAR2(64)   | Y    | 主键          |      |
| PROC_INST_ID_              | NVARCHAR2(64)   | N    | 流程实例 ID   |      |
| BUSINESS_KEY_              | NVARCHAR2(255)  | N    | 业务主键      |      |
| PROC_DEF_ID_               | NVARCHAR2(64)   | N    | 属性 ID       |      |
| START_TIME_                | TIMESTAMP(6)    | N    | 开始时间      |      |
| END_TIME_                  | TIMESTAMP(6)    | N    | 结束时间      |      |
| DURATION_                  | NUMBER(19)      | N    | 耗时          |      |
| START_USER_ID_             | NVARCHAR2(255)  | N    | 起始人        |      |
| START_ACT_ID_              | NVARCHAR2(255)  | N    | 起始节点      |      |
| END_ACT_ID_                | NVARCHAR2(255)  | N    | 结束节点      |      |
| SUPER_PROCESS_INSTANCE_ID_ | NVARCHAR2(64)   | N    | 父流程实例 ID |      |
| DELETE_REASON_             | NVARCHAR2(2000) | N    | 删除原因      |      |
| TENANT_ID_                 | NVARCHAR2(255)  | N    |               |      |
| NAME_                      | NVARCHAR2(255)  | N    | 名称          |      |

在 Flowable 中，如果 ProcessInstance 被完成（全部审批通过、不通过、取消等）时候，会从 `ACT_RU_EXECUTION` 表中删除，只能在 `ACT_HI_PROCINST` 表查询到。这是一种“冷热分离”的设计思想，因为进行的任务访问比较频繁，数据量越小，性能会越好。

而 [我的流程] 需要查询进行中、已完成的流程，所以需要查询 `ACT_HI_PROCINST` 表，而不能使用 `ACT_RU_EXECUTION` 表。

② 流程历史参数表，由 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 中，如果 ProcessInstance 被完成（全部审批通过、不通过、取消等）时候，会从 `ACT_RU_VARIABLE` 表中删除，只能在 `ACT_HI_VARINST` 表查询到。这当然也是是一种“冷热分离”的设计思想~

### [#](https://doc.iocoder.cn/bpm/process-instance/#_2-2-%E5%85%B7%E4%BD%93%E5%AE%9E%E7%8E%B0)2.2 具体实现

* 前端，对应 `/views/bpm/processInstance/index.vue` 实现界面
* 后端，对应 BpmProcessInstanceController 的 `#getProcessInstanceMyPage(...)` 提供接口

![我的流程的实现](/media/202404/2024-04-26_0108510.9444486441712916.png)

### [#](https://doc.iocoder.cn/bpm/process-instance/#_2-1-%E5%8F%96%E6%B6%88%E6%B5%81%E7%A8%8B)2.1 取消流程

可点击某个流程的「取消」按钮，进行流程的取消，如下图所示：

![取消流程](/media/202404/2024-04-26_0108510.558364877703935.png)

后端由 BpmProcessInstanceController 的 `#cancelProcessInstance(...)` 提供接口，如下图所示：

![取消流程的实现](/media/202404/2024-04-26_0108510.9014456353366143.png)

* 最核心的，就是调用 Flowable 的 `RuntimeService#deleteProcessInstance(...)` 方法，取消流程实例。

可能你会有疑问，哪里将流程状态更新为 `CANCEL` 已取消呢？答案在 [BpmProcessInstanceEventListener **(opens new window)**](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/framework/flowable/core/listener/BpmProcessInstanceEventListener.java) 监听器，它会监听到流程实例变更为取消，然后调用 BpmProcessInstanceController 的 `#updateProcessInstanceWhenCancel(...)` 方法，进行更新。如下图所示：

![更新流程为已取消](/media/202404/2024-04-26_0108510.669297914257857.png)

### [#](https://doc.iocoder.cn/bpm/process-instance/#_2-2-%E9%87%8D%E6%96%B0%E5%8F%91%E8%B5%B7%E6%B5%81%E7%A8%8B)2.2 重新发起流程

流程结束后，可点击它的「重新发起」按钮，进行流程的重新发起，如下图所示：

![重新发起](/media/202404/2024-04-26_0108510.14200575381778968.png)

它的效果是，跳转到 [发起流程] 页面，然后将之前的流程参数，填充到表单中，如下图所示：

![重新发起](/media/202404/2024-04-26_0108510.8120955751929793.png)

因此，它最终调用的还是「1. 发起流程」小节的发起流程接口，再次（重新）发起一个流程。

## [#](https://doc.iocoder.cn/bpm/process-instance/#_3-%E6%B5%81%E7%A8%8B%E5%AE%9E%E4%BE%8B)3. 流程实例

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

![流程实例](/media/202404/2024-04-26_0108510.909626777054396.png)

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

由于它查询的是所有流程，所以读取的是 `ACT_HI_PROCINST` 表，而不是 `ACT_RU_EXECUTION` 表。