福州网站运营,wordpress金币插件,注册企业网站,做360网站快速排名软件Activiti工作流引擎使用 1.简单介工作流引擎与Activiti 对于工作流引擎的解释请参考百度百科#xff1a;工作流引擎 1.1 我与工作流引擎 在第一家公司工作的时候主要任务就是开发OA系统#xff0c;当然基本都是有工作流的支持#xff0c;不过当时使用的工作流引擎是公司一些… Activiti工作流引擎使用 1.简单介工作流引擎与Activiti 对于工作流引擎的解释请参考百度百科工作流引擎 1.1 我与工作流引擎 在第一家公司工作的时候主要任务就是开发OA系统当然基本都是有工作流的支持不过当时使用的工作流引擎是公司一些牛人开发的据说是用一个开源的引擎修改的名称叫CoreFlow功能相对Activiti来说比较弱但是能满足日常的使用当然也有不少的问题所以后来我们只能修改引擎的代码打补丁。 现在是我工作的第二家公司因为要开发ERP、OA等系统需要使用工作流在项目调研阶段我先搜索资料选择使用哪个开源工作流引擎最终确定了Activiti5并基于公司的架构做了一些DEMO。 回到顶部 1.2 Activiti与JBPM5 对于Activiti、jBPM4、jBPM5我们应该如何选择在InfoQ上有一篇文章写的很好从大的层面比较各个引擎之间的差异请参考文章纵观jBPM从jBPM3到jBPM5以及Activiti5 回到顶部 1.3 Activiti资料 官网http://www.activiti.org/ 下载http://www.activiti.org/download.html 版本Activiti的版本是从5开始的因为Activiti是使用jBPM4的源码版本发布两个月发布一次。 Eclipse Plugin: http://activiti.org/designer/update/ Activit中文群5435716 2.初次使用遇到问题收集 因为Activiti刚刚退出不久所以资料比较空缺中文资料更是少的可怜所以开始的时候一头雾水虽然之前用过工作流但是感觉差距很多而且官方的手册还不是很全面所以我把我在学习使用的过程遇到的一些疑问都罗列出来分享给大家以下几点是我遇到和想到的如果你还有什么疑问可以在评论中和我交流再补充。 回到顶部 2.1 部署流程图后中文乱码 乱码是一直缠绕着国人的问题之前各个技术、工具出现乱码的问题写过很多文章这里也不例外……Activiti的乱码问题在流程图中。 流程图的乱码如下图所示 解决办法有两种 2.1.1 修改源代码方式 修改源码 org.activiti.engine.impl.bpmn.diagram.ProcessDiagramCanvas 在构造方法 public ProcessDiagramCanvas(int width, int height) 中有一行代码是设置字体的默认是用 Arial 字体这就是乱码产生的原因把字改为本地的中文字体即可例如 Font font new Font(WenQuanYi Micro Hei, Font.BOLD, 11); 当然如果你有配置文件读取工具那么可以设置在*.properties文件中我就是这么做的 Font font new Font(PropertyFileUtil.get(activiti.diagram.canvas.font), Font.BOLD, 11); 2.1.2 使用压缩包方式部署 Activiti支持部署*.bpmn20.xml、bar、zip格式的流程定义。 使用Activit Deisigner工具设计流程图的时候会有三个类型的文件: .activiti设计工具使用的文件 .bpmn20.xml设计工具自动根据.activiti文件生成的xml文件 .png流程图图片 解决办法就是把xml文件和图片文件同时部署因为在单独部署xml文件的时候Activiti会自动生成一张流程图的图片文件但是这样在使用的时候坐标和图片对应不起来…… 所以把xml和图片同时部署的时候Activiti自动关联xml和图片当需要获取图片的时候直接返回部署时压缩包里面的图片文件而不是Activiti自动生成的图片文件 2.1.2.1 使用工具打包Bar文件 右键项目名称然后点击“Create deployment artifacts”会在src目录中创建deployment文件夹里面包含*.bar文件. 2.1.2.2 使用Ant脚本打包Zip文件 这也是我们采用的办法你可以手动选择xml和png打包成zip格式的文件也可以像我们一样采用ant target的方式打包这两个文件。 ?xml version1.0 encodingUTF-8?
project namefooproperty nameworkflow.definition valuefoo-common-core/src/main/resources/diagrams /property nameworkflow.deployments valuefoo-common-core/src/main/resources/deployments /target nameworkflow.package.oa.leaveecho打包流程定义及流程图::OA-请假/echozip destfile${workflow.deployments}/oa/leave.zip basedir${workflow.definition}/oa/leave updatetrueincludes*.xml,*.png //target
/project 这样当修改流程定义文件后只要运行ant命令就可以打包了 ant workflow.package.oa.leave 现在部署bar或者zip文件查看流程图图片就不是乱码了而是你的压缩包里面的png文件。 回到顶部 2.2 使用引擎提供的Form还是自定义业务Form 2.2.1 引擎提供的Form 定义表单的方式在每个Task标签中定义extensionElements和activiti:formProperty即可到达这个节点的时候可以通过API读取表单元素。 Activiti官方的例子使用的就是在流程定义中设置每一个节点显示什么样的表单哪些字段需要显示、哪些字段只读、哪些字段必填。 但是这种方式仅仅适用于比较简单的流程对于稍微复杂或者页面需要业务逻辑的判断的情况就不适用了。 对于数据的保存都是在引擎的表中不利于和其他表的关联、对整个系统的规划也不利 2.2.2 自定义业务Form 这种方式应该是大家用的最多的了因为一般的业务系统业务逻辑都会比较复杂而且数据库中很多表都会有依赖关系表单中有很多状态判断。 例如我们的系统适用jQuery UI作为UI有很多javascript代码页面的很多操作需要特殊处理例如多个选项的互斥、每个节点根据类型和操作人显示不同的按钮基本每个公司都有一套自己的UI风格要保持多个系统的操作习惯一致只能使用自定义表单才能满足。 回到顶部 2.3 业务和流程的关联方式 这个问题在群里面很多人都问过这也是我刚刚开始迷惑的地方 后来看了以下API发现RuntimeService有两个方法 回到顶部 2.3.1 startProcessInstanceByKey javadoc对其说明 ? 1 2 startProcessInstanceByKey(String processDefinitionKey, Map variabes) Starts a new process instance in the latest version of the process definition with the given key 其中businessKey就是业务ID例如要申请请假那么先填写登记信息然后保存启动流程因为请假是单独设计的数据表所以保存后得到实体ID就可以把它传给processInstanceBusinessKey方法启动流程。当需要根据businessKey查询流程的时候就可以通过API查询: ? 1 runtimeService.createProcessInstanceQuery().processInstanceBusinessKey(processInstanceBusinessKey, processDefinitionKey); 建议数据库冗余设计在业务表设计的时候添加一列PROCESS_INSTANCE_ID varchar2(64)在流程启动之后把流程ID更新到业务表中这样不管从业务还是流程都可以查询到对方 特别说明 此方法启动时自动选择最新版本的流程定义。 回到顶部 2.3.2 startProcessInstanceById javadoc对其说明 ? 1 2 startProcessInstanceById(String processDefinitionId, String businessKey, Map variables) Starts a new process instance in the exactly specified version of the process definition with the given id. processDefinitionId这个参数的值可以通过repositoryService.createProcessDefinitionQuery()方法查询对应数据库ACT_RE_PROCDEF每次部署一次流程定义就会添加一条数据同名的版本号累加。 特别说明 此可以指定不同版本的流程定义让用户多一层选择。 回到顶部 2.3.3 如何选择 建议使用startProcessInstanceByKey特殊情况需要使用以往的版本选择使用startProcessInstanceById。 回到顶部 2.4 同步用户数据 这个问题也是比较多的人询问过Activiti支持对任务分配到指定人、指定组、两者组合而这些人和组的信息都保存在ACT_ID..表中有自己的用户和组(角色)管理让很多人不知所措了原因是因为每个系统都会存在一个权限管理模块维护用户、部门、角色、授权不知道该怎么和Activiti同步。 2.4.1 建议处理方式 Activiti有一个IdentityService接口通过这个接口可以操控Activiti的ACT_ID_*表的数据一般的做法是用业务系统的权限管理模块维护用户数据当进行CRUD操作的时候在原有业务逻辑后面添加同步到Activiti的代码例如添加一个用户时同步Activiti User的代码片段 ? 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 /** * 保存用户信息 并且同步用户信息到activiti的identity.User同时设置角色 * param user * param roleIds */ public void saveUser(User user, ListLong roleIds, boolean synToActiviti) { accountManager.saveEntity(user); String userId user.getId().toString(); if (synToActiviti) { Listorg.activiti.engine.identity.User activitiUsers identityService.createUserQuery().userId(userId).list(); if (activitiUsers.size() 1) { //更新信息 org.activiti.engine.identity.User activitiUser activitiUsers.get(0); activitiUser.setFirstName(user.getName()); activitiUser.setLastName(); activitiUser.setPassword(user.getPassword()); activitiUser.setEmail(user.getEmail()); identityService.saveUser(activitiUser); // 删除用户的membership ListGroup activitiGroups identityService.createGroupQuery().groupMember(userId).list(); for (Group group : activitiGroups) { identityService.deleteMembership(userId, group.getId()); } // 添加membership for (Long roleId : roleIds) { Role role roleManager.getEntity(roleId); identityService.createMembership(userId, role.getEnName()); } } else { org.activiti.engine.identity.User newUser identityService.newUser(userId); newUser.setFirstName(user.getName()); newUser.setLastName(); newUser.setPassword(user.getPassword()); newUser.setEmail(user.getEmail()); identityService.saveUser(newUser); // 添加membership for (Long roleId : roleIds) { Role role roleManager.getEntity(roleId); identityService.createMembership(userId, role.getEnName()); } } } } 删除操作也和这个类似 不管从业务系统维护用户还是从Activiti维护肯定要确定一方然后CRUD的时候同步到对方如果需要同步多个子系统那么可以再调用WebService实现。 回到顶部 2.5 流程图设计工具用什么 Activiti提供了两个流程设计工具但是面向对象不同。 Activiti Modeler面向业务人员使用开源的BPMN设计工具Signavio使用BPMN描述业务流程图 Eclipse Designer面向开发人员Eclipse的插件可以让开发人员定制每个节点的属性ID、Name、Listener、Attr等 2.5.1 我们的方式 可能你会惊讶因为我们没有使用Activiti Modeler我们认为用Viso已经能表达流程图的意思了而且项目经理也是技术出身和开发人员也容易沟通。 目前这个项目是第一个使用Activiti的开始我们在需求调研阶段使用Viso设计流程图利用泳道流程图设计和客户沟通确定后由负责流程的开发人员用Eclipse Designer设计得到bpmn20.xml最后部署。 回到顶部 2.6 Eclipse Designer存在的问题 这个插件有一个很讨厌的Bug一直未修复安装了插件后Eclipse的复制和粘帖快捷键会被更换为(CtrlInsert、ShiftInsert)Bug描述请见 Activit Forums中报告的Bug Jira的登记 所以最后我们只能单独开一个安装了Eclipse Designer的Eclipse专门用来设计流程图这样就不影响正常使用Eclipse JAVAEE了。 3.配置 回到顶部 3.1 集成Spring 对于和Spring的集成Activiti做的不错简单配置一些Bean代理即可实现但是有两个和事务相关的地方要提示 配置processEngineConfiguration的时候属性transactionManager要使用和业务功能的同一个事务管理Bean否则事务不同步。 对于实现了org.activiti.engine.delegate包中的接口的类需要被事务控制的实现类需要被Spring代理并且添加事务的Annotation或者在xml中配置例如: ? 1 2 3 4 5 6 7 8 9 10 /** * 创建缴费流程的时候自动创建实体 * * author HenryYan */ Service Transactional publicclass CreatePaymentProcessListener implementsExecutionListener { .... } ? 4.使用单元测试 单元测试均使用Spring的AbstractTransactionalJUnit4SpringContextTests作为SuperClass并且在测试类添加 ? 1 2 ContextConfiguration(locations { /applicationContext-test.xml}) RunWith(SpringJUnit4ClassRunner.class) ? 虽然Activiti也提供了测试的一些超类但是感觉不好用所以自己封装了一些方法。 代码请转移https://gist.github.com/2182847 回到顶部 4.1 验证流程图设计是否正确 代码请转移https://gist.github.com/2182869 回到顶部 4.2 业务对象和流程关联测试 代码请转移https://gist.github.com/2182973 5.各种状态的任务查询以及和业务对象关联 我们目前分为4中状态未签收、办理中、运行中、已完成。 查询到任务或者流程实例后要显示在页面这个时候需要添加业务数据最终结果就是业务和流程的并集请参考6.2。 回到顶部 5.1 未签收(Task) 此类任务针对于把Task分配给一个角色时例如部门领导因为部门领导角色可以指定多个人所以需要先签收再办理术语抢占式 对应的API查询 ? 1 2 3 4 5 6 7 8 9 10 /** * 获取未签收的任务查询对象 * param userId 用户ID */ Transactional(readOnly true) publicTaskQuery createUnsignedTaskQuery(String userId) { TaskQuery taskCandidateUserQuery taskService.createTaskQuery().processDefinitionKey(getProcessDefKey()) .taskCandidateUser(userId); returntaskCandidateUserQuery; } ? 回到顶部 5.2 办理中(Task) 此类任务数据类源有两种: 签收后的5.1中签收后就应该为办理中状态 节点指定的是具体到一个人而不是角色 对应的API查询 ? 1 2 3 4 5 6 7 8 9 /** * 获取正在处理的任务查询对象 * param userId 用户ID */ Transactional(readOnly true) publicTaskQuery createTodoTaskQuery(String userId) { TaskQuery taskAssigneeQuery taskService.createTaskQuery().processDefinitionKey(getProcessDefKey()).taskAssignee(userId); returntaskAssigneeQuery; } ? 回到顶部 5.3 运行中(ProcessInstance) 说白了就是没有结束的流程所有参与过的人都应该可以看到这个实例但是Activiti的API没有可以通过用户查询的方法这个只能自己用hack的方式处理了我目前还没有处理。 从表ACT_RU_EXECUTION中查询数据。 对应的API查询 ? 1 2 3 4 5 6 7 8 9 10 /** * 获取未经完成的流程实例查询对象 * param userId 用户ID */ Transactional(readOnly true) publicProcessInstanceQuery createUnFinishedProcessInstanceQuery(String userId) { ProcessInstanceQuery unfinishedQuery runtimeService.createProcessInstanceQuery().processDefinitionKey(getProcessDefKey()) .active(); returnunfinishedQuery; } ? 回到顶部 5.4 已完成(HistoricProcessInstance) 已经结束的流程实例。 从表ACT_HI_PROCINST中查询数据。 ? 1 2 3 4 5 6 7 8 9 10 /** * 获取已经完成的流程实例查询对象 * param userId 用户ID */ Transactional(readOnly true) publicHistoricProcessInstanceQuery createFinishedProcessInstanceQuery(String userId) { HistoricProcessInstanceQuery finishedQuery historyService.createHistoricProcessInstanceQuery() .processDefinitionKey(getProcessDefKey()).finished(); returnfinishedQuery; } ? 回到顶部 5.5 查询时和业务关联 提示之前在业务对象添加了PROCESS_INSTANCE_ID字段 思路现在可以利用这个字段查询了不管是Task还是ProcessInstance都可以得到流程实例ID可以根据流程实例ID查询实体然后把流程对象设置到实体的一个属性中由Action或者Controller输出到前台。 代码请参考https://gist.github.com/2183557 6.UI及截图 结合实际业务描述一个业务从开始到结束的过程对于迷惑的同学看完豁然开朗了这里使用请假作为例子。 回到顶部 6.1 单独一个列表负责申请 这样的好处是申请和流程办理分离开处理列表显示未启动流程的请假记录数据库PROCESS_INSTANCE_ID为空。 申请界面的截图 回到顶部 6.2 流程状态 回到顶部 6.3 流程跟踪 图片方式显示当前节点 列表形式显示流程流转过程: 6.3.1 当前节点定位JS Java代码请移步https://gist.github.com/2183712 Javascript思路先通过Ajax获取当前节点的坐标在指定位置添加红色边框然后加载图片。 代码移步https://gist.github.com/2183804 7.开启Logger 添加log4j的jar设置log4j.logger.java.sqlDEBUG 8.结束 之前就想写这篇文章现在终于完成了花费了几个小时希望能节省你几天的时间。 请读者仔细阅读Activiti的用户手册和Javadoc。
