Skip to content

审批通过、不通过、驳回 ​

相关视频:

# 1. 待办任务 ​

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

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

# 1.1 表结构 ​

① 流程任务表,由 Flowable 提供的 ACT_RU_TASK 表实现,如下所示:

字段类型主键说明备注
ID_NVARCHAR2(64)Y主键
REV_INTEGERN数据版本
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_INTEGERN
CREATE_TIME_TIMESTAMP(6)N创建时间
DUE_DATE_TIMESTAMP(6)N耗时
CATEGORY_NVARCHAR2(255)N
SUSPENSION_STATE_INTEGERN是否挂起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_INTEGERN数据版本
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

# 1.2 任务状态 ​

任务状态,由 BpmTaskStatusEnum 目前有 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_INTEGERN优先级别
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_INTEGERN数据版本
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 表。

# 666. 更多功能 ​

最近更新