首先是因为自己目前的项目中需要用到工作流,因为来公司之前就已经选好了:Flowable。这一次也是对自己这两天学习flowable的记录。希望也能帮助到有需要的朋友们。
因为之前自己学习的时候在网上找的资料都比较杂,要么这篇文章缺这个,要么那篇文章却那个,导致自己很多东西不理解,只看到别人贴出的结果图,却不知道怎么做出来的。
1. 我用的IDEA创建SpringBoot项目,我的项目版本是:2.2.0.RELEASE,这一步我就不贴出来了,
2. 然后在pom文件中引入jar包:
3. 添加一个数据源,我这里添加的mysql,Flowable需要持久化数据。这个是我的配置文件 application.yml:
4. 启动项目,可以看到数据库中创建了很多flowable默认的表,其中有flowable历史流程相关的(eg: ACT_HI开头的...),运行中相关的(eg: ACT_RU开头的....),用户用户组信息相关(eg: ACT_ID开头的...):
5. 将springboot与flowable整合完成之后,就可以进行工作流的开发了,
flowable建议采用业界标准BPMN2.0的XML来描述需要定义的工作流。所以我们需要在项目中创建一个流程定义,下面这个是我创建的一个xml定义, 截图不全,源码中有:
看到这里是不是觉得这个文件很复杂,至少对于之前没有用过工作流的我来说看着很复杂的,看不懂。然后在晚上一系列搜索,有的说可以用eclipse的自带插件生成,我用的又是IDEA,
所以找到一篇文章:flowable+tomcat部署flowable项目,在线画流程图。原文链接:https://www.wandouip.com/t5i212543/
在我们下载安装好tomcat之后,可以通过:https://github.com/flowable/flowable-engine/releases/download/flowable-6.4.0/flowable-6.4.0.zip 下载flowable的zip文件
下载下来解压之后,我们把flowable-6.4.0/wars 下的所有war包复制到tomcat/webapps下面:
复制过去之后,启动tomcat,上面红线圈起来的文件夹是tomcat启动之后自动解压生成的:
启动过程可能有点慢,要全部启动flowable的这几个服务,看到下面这个就启动完成了:
启动成功之后,可以登陆创建流程:http://localhost:8080/flowable-modeler :
可以开始创建:
这个就是我创建的一个流程:
审批流程:1.创建流程->ApproveRequest->通过审批->执行SuccessService业务->流程到firstApproveTask节点........结束。 ApproveRequest->审批不通过->执行失败业务->结束
创建完成之后:可以导出BPMN2:
可以打开下载的文件,自动转成xml格式,是不是很方便,不用自己全部写:
然后再把这个下载文件拷贝项目中: resources/processes/ 目录下:
然后可以在Controller文件中创建接口测试这个工作流:
这些是我引入的flowable相关的,接下来创建流程:
userId: 创建人id, days:请假天数 , reason:请假原因。
方法里边把这些参数传入map中的key就是流程变量,后面的方法可以取出来使用。holidayRequest: 就是xml文件中<process>标签的id,就是之前创建的流程定义。
接下来可以在postman中测试一下:
可以看到postman测试成功,数据库表中有了相应数据。
然后可以创建显示流程图的接口:
在postman中传入流程id测试一下:
大家可以看到查询出了之前在flowable中创建的流程定义,并且可以看到当前流程在Approverequest这个节点(红线圈起来的),因为之前只是用户提交了审批流程。所以现在到了第二个节点。
接着创建审批通过接口:
可以看到接口中的approved,就是流程定义中${approved}变量,画流程图的时候可以定义。如果传入的为true则执行上面的流程逻辑,false则执行下面的。
接着我们再测试一下,可以看到审批通过:
再看一下流程图:
可以看到同一个流程实例,流程又到了下一个节点。
我们可以查询一个指定用户/用户组的任务列表:
xml中的flowable:candidateGroups = "first" 说明这个任务只有用户组为first的用户才可以执行、查询。
上面可以看到流程已经到了firstApprovedTask节点,说明只有first用户组才可以查询或执行。我们再测试一下:
大家可以看到当传入 managers的时候,是查不出来任务数据的,传入first的时候就可以查询出来了。说明是正确的。
Controller中还有一些其他方法,我就没有全部贴出来:
包括:1. 查询历史流程记录,2. 驳回流程实例 , 3. 终止流程实例 ,4. 挂起流程实例
5. 恢复(唤醒)被挂起的流程实例, 6. 判断传入流程实例在运行中是否存在
7. 判断流程实例在历史记录中是否存在
其他的功能还在探索,以上就是我学习flowable这两天的一些收获。如果某些地方不对的,还请大家指出来,谢谢。