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

相关视频：

11、[如何实现流程的发起？](http://https://wx.zsxq.com/dweb2/index/topic_detail/184582218111122 "如何实现流程的发起？")
12、[如何实现我的流程列表？](http://https://wx.zsxq.com/dweb2/index/topic_detail/585182248442544 "如何实现我的流程列表？")
13、[如何实现流程的取消？](http://https://wx.zsxq.com/dweb2/index/topic_detail/812815541418222 "如何实现流程的取消？")

本文的内容比较简单，主要围绕 [审批中心] 菜单下的 [我的流程]、[发起流程] 子菜单，讲解流程的发起、取消、重新发起的操作流程。
## 1. 发起流程
发起流程，对应 [审批中心 -> 发起流程] 菜单，如下图所示：

![](/media/202408/2024-08-28_091929_145502.png)

### 1.1 表结构
① 流程实例表，由 Flowable 提供的 ACT_RU_EXECUTION 表实现，如下所示：

![](/media/202408/2024-08-28_092037_584801.png)

② 流程参数表，由 Flowable 提供的 ACT_RU_VARIABLE 表实现，如下所示：

![](/media/202408/2024-08-28_092057_477488.png)
在 Flowable 中，如果想给 Task 增加拓展字段，无法通过 ACT_RU_TASK 实现，而是通过 ACT_RU_VARIABLE 表实现。

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

![](/media/202408/2024-08-28_093711_413229.png)
### 1.2 流程状态
流程状态，由 BpmProcessInstanceStatusEnum (opens new window)目前有 4 种，如下图所示：

![](/media/202408/2024-08-28_093727_351346.png)

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

![](/media/202408/2024-08-28_093747_148833.png)

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

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

![](/media/202408/2024-08-28_093820_054924.png)

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

![](/media/202408/2024-08-28_093847_912802.png)

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

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

② 流程历史参数表，由 Flowable 提供的 ACT_HI_VARINST 表实现，如下所示：

![](/media/202408/2024-08-28_093858_211851.png)

在 Flowable 中，如果 ProcessInstance 被完成（全部审批通过、不通过、取消等）时候，会从 ACT_RU_VARIABLE 表中删除，只能在 ACT_HI_VARINST 表查询到。这当然也是是一种“冷热分离”的设计思想~

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

![](/media/202408/2024-08-28_093929_093978.png)

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

![](/media/202408/2024-08-28_093956_469651.png)
后端由 BpmProcessInstanceController 的 #cancelProcessInstance(...) 提供接口，如下图所示：

![](/media/202408/2024-08-28_094008_917186.png)

最核心的，就是调用 Flowable 的 RuntimeService#deleteProcessInstance(...) 方法，取消流程实例。
可能你会有疑问，哪里将流程状态更新为 CANCEL 已取消呢？答案在 BpmProcessInstanceEventListener (opens new window)监听器，它会监听到流程实例变更为取消，然后调用 BpmProcessInstanceController 的 #updateProcessInstanceWhenCancel(...) 方法，进行更新。如下图所示：

![](/media/202408/2024-08-28_094024_671805.png)

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

![](/media/202408/2024-08-28_094106_300521.png)

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

![](/media/202408/2024-08-28_094137_757484.png)

因此，它最终调用的还是「1. 发起流程」小节的发起流程接口，再次（重新）发起一个流程。
## 3. 流程实例
流程实例，展示系统中所有的流程，一般用于管理员查询，对应 [流程管理 -> 流程实例] 菜单，如下图所示：

![](/media/202408/2024-08-28_094213_089309.png)

后端，对应 BpmProcessInstanceController 的 #getProcessInstanceManagerPage(...) 提供接口
前端，对应 /views/bpm/processInstance/manager/index.vue 实现界面
由于它查询的是所有流程，所以读取的是 ACT_HI_PROCINST 表，而不是 ACT_RU_EXECUTION 表。