Activiti工作流开发指南（springboot 2.x iview admin vue 前后端分离 模型设计器 动态数据权限 权限按钮显示 spring security）

• 宣传官网 http://xb.exrick.cn
• 在线Demo http://xboot.exrick.cn
• 开源版Github地址 https://github.com/Exrick/x-boot
• 开发文档 https://www.kancloud.cn/exrick/xboot/1009234
• 获取完整版 http://xpay.exrick.cn/pay?xboot
  
  在这里插入图片描述

---

集成Activiti 5.22，考虑到文档资料较多未选用新版本（模型设计器改动较大）或Flowable

集成的工作流编辑器在后台静态资源中，记得在系统配置中设置访问域名，开发时直接填后台请求地址前缀 http://localhost:8888 即可

几大常用接口

1. RepositoryService：提供一系列管理流程部署和流程定义的API
2. RuntimeService：在流程运行时对流程实例进行管理与控制
3. TaskService：对流程任务进行管理，例如任务提醒、任务完成和创建任务等
4. IdentityService：提供对流程角色数据进行管理的API，这些角色数据包括用户组、用户及它们之间的关系
5. HistoryService：对流程的历史数据进行操作，包括查询、删除这些历史数据

25张表

image

1、act_ge_ 通用数据表，ge是general的缩写
2、act_hi_ 历史数据表，hi是history的缩写，对应HistoryService接口
3、act_id_ 身份数据表，id是identity的缩写，对应IdentityService接口
4、act_re_ 流程存储表，re是repository的缩写，对应RepositoryService接口，存储流程部署和流程定义等静态数据
5、act_ru_ 运行时数据表，ru是runtime的缩写，对应RuntimeService接口和TaskService接口，存储流程实例和用户任务等动态数

XBoot扩展基本开发指南

• 通用流程状态表t_act_bussiness，其中table_id字段存储关联的表单ID

• 后台仅需开发相应表单增删改接口，存储至单张表中，如t_leave，唯一需注意的地方为新增接口（添加新数据时）需关联业务act_buniess表，向其添加流程和表ID等信息，参考LeaveController

• 前台仅需开发相应单个表单页面（可以通过路由传参实现相应按钮显示），参考leave.vue（以菜单中配置的该路由名name跳转），记得在src/router/router.js中添加路由

• 最后记得在系统中配置相应流程信息

  • 数据字典"业务表"中添加相应业务表名，如"t_leave"；"业务表单路由"中添加相应前端表单组件路由名，如"leave"
  • 流程管理中编辑填写关联刚开发的表单信息，业务表的作用主要为用户删除申请时关联删除相应表单数据，表单路由名作用为跳转显示刚前端开发的表单页面
  QQ截图20190113212518.png

• 流程节点审批人可根据角色、部门负责人、人员设置多个，设置后默认勾选，为或签（任意一人审批，流程进入下一步，即先到先审）

• 如何实现会签？

  • 请增加审批节点！
  image

• 分支网关设定

  • 注意：暂仅支持互斥(排他)网关设置。为保证工作流简单性，建议仅使用开始、结束、任务节点和单向连线，设置分支后流程将变得不灵活，用户容易编辑出错。

若部署后流程图中文字符无法显示，是因为服务器环境jdk中无相应中文字体，百度安装即可（配置文件已配置微软雅黑，若未配置默认宋体）

互斥（排他）网关设定

顾名思义，当出现多个分支时仅选择一个满足条件的分支流转

[email protected]

• 点击互斥网关后的连线设置流转条件的条件UEL表达式 https://www.activiti.org/userguide/#apiExpressions
  

  [email protected]

• 注意勾选默认网关后不得设置流转条件，否则无法部署成功

  
  
  [email protected]

• 启动流程时或完成一个任务节点时务必加入该变量（否则配置了流转条件变量的流程会报错），示例：

// 启动流程时添加变量，详见ActBusinessController的apply或start方法，在ActBusiness中设置params
actBusiness.getParams().put("duration", 36);

// 或者完成任务节点时加入变量
Map params = new HashMap<>(16);
taskService.complete(id, params);

绑定监听器示例

常见的业务需求需要完成一个审批流程后改变原数据状态、通知审批结果消息或执行其他操作，在结束节点上绑定监听器即可，一旦结束说明流程全部通过，触发自定义业务。

• 绘制流程图填写定义的监听器类

image

image

image

• 监听器示例代码

@Slf4j
public class MyListener implements ExecutionListener {

    @Override
    public void notify(DelegateExecution delegateExecution) throws Exception {

        // 获取关联业务表ID变量(启动流程代码里已存入tableId，此处直接获取即可)
        String tableId = (String) delegateExecution.getVariable("tableId");
        log.info(tableId);
        LeaveService leaveService = SpringContextUtil.getBean(LeaveService.class);
        Leave leave = leaveService.get(tableId);
        ... ...
    }
}

使用发起流程组件示例

• 前端vue示例，注意各状态下仅能显示的各操作按钮