Foxbpm任务命令扩展介绍
Foxbpm对中国式流程(如:退回、转发、跳转等)封装成了各种任务命令按钮,这种方式得到了用户的一致认可,foxbpm的最新版本也对这一功能做了更好的封装和完善,使用户能更好的使用和扩展任务命令,这篇文章主要介绍foxbpm的任务命令体系,以及如何扩展属于自己的任务命令。
任务命令介绍
从foxbpm.cfg.xml或5.2版本的fixflowconfig.xml文件可以看出,每一个任务命令都有3个类组成,分别为**Command、**Cmd、**Filter,其中:
- **Command定义了命令有哪些特殊参数,如“退回节点”命令中的rollbackNodeId等等
- **Cmd:命令的真正处理类,execute方法中对taskEntity,processInstanceEntity,tokenEntity等实体操作,最终完成命令的执行逻辑。
- **Filter:命令过滤器,api中获取任务命令是通过taskService.getTaskCommandByTaskId(taskId),其中会通过taskId获取当前taskEntity,根据taskEntity的状态来确定当前按钮是否应该显示。如:对于“还回”按钮,只有当taskEntity为转办状态时,该access(taskEntity)方法才会返回True,才会显示该按钮。
任务命令扩展
综上,如果想要扩展一个自己的任务命令,只需要实现上述三个类,然后在对应的配置文件中注册即可。
当然,上面的做法是兼容fixflow5.2版本和最新的foxbpm版本的,既然说了foxbpm对于扩展有了优化,那就肯定要有些新的提升。
对于foxbpm的最新6.0版本,是不推荐随意修改foxbpm.cfg.xml文件,也不建议随意修改engine的jar包,因为这样才能平缓升级内核的版本。为了保证升级方便和灵活扩展,6.0版本在多个功能点上使用了开源框架经常使用的技术,java spi,该机制可以让用户在不修改Engine代码和foxbpm.cfg.xml文件的基础上,注册自己的任务命令,下面总结下新版本任务命令扩展步骤:
- 新建上面的**Command,**Cmd,**Filter类,并实现
- 新建类如:MyTaskCommandDefintionImpl 实现TaskCommandDefintion接口
- 在项目META-INF/services文件夹下新建文件:org.foxbpm.engine.task.TaskCommandDefinition,内容是2步骤中类的全名
原理:foxbpm在引擎加载时,会通过java spi服务发现机制,注册用户自己的任务命令,这段可参考java spi机制
附:TaskCommandDefintion接口定义
package org.foxbpm.engine.task; import java.util.List; public interface TaskCommandDefinition { /** * 按钮编号,如startandsubmit * @return */ String getId(); /** * 按钮名称 * @return */ String getName(); /** * command类全名 org.foxbpm.task**** * @return */ String getCommandClass(); /** * cmd类全名 * @return */ String getCmdClass(); /** * filter类全名 * @return */ String getFilterClass(); /** * 按钮描述 * @return */ String getDescription(); /** * 按钮参数 * @return */ List<CommandParam> getCommandParam(); }
任务命令前端介绍
想扩展一个完整的任务命令,只靠后台代码往往是实现不了的,需要前端处理一下参数,如:转发按钮,需要弹出选人界面,并将transferUserId作为参数回传给引擎,这里顺便介绍前端的扩展。
6.0版本对于任务命令的前端也做了封装,集成表单时,只需要引用几个具体的js即可,关于 表单集成,这期我不多说,后面会有专门的文章来介绍表单集成部分,这里只介绍扩展任务命令时自定义参数问题,打开flowCommandHander.js,会发现这里定义了转发,退回等按钮的前端操作,如转发:
Foxbpm.commandHandler.transfer = function(){ var userId = showDialog(_bpmFilePath+"/selectUser.html"); if(userId == null || userId === undefined){ return null; } return {transferUserId:userId}; };
所以这里只需要定义自己的实现即可,举例:自己扩展命令 mytaskcommand,需要参数,orgid,则所需代码如下:
Foxbpm.commandHandler.mytaskcommand = function(){ var tmpOrgId = ""; /** * 这里自己的逻辑,弹出选部门界面,或其他逻辑处理 */ if(tmpOrgId == null || tmpOrgId === undefined){ return null; } return {orgid:tmpOrgId}; };
这样结合上面的后端Java部分扩展,就完整的实现了自己任务命令,另外,可以将这段js单独抽取出来,放到一个单独的js中,后端代码也可以单独打成jar包,如果在配合完整的文档介绍,就可以贡献给其他foxbpm的用户进行使用。而其他用户,只需要将你的jar包放到自己项目中,js引用到自己的页面上,就可以使用你的命令了,做到了对最终用户完全透明,而且最重要的一点是完全没有修改foxbpm的代码,如果引擎升级,还是可以直接覆盖原有jar包和对应的js文件。
FoxBPM目前尚未发布6.0的稳定版本,敬请期待.....
相关推荐
FoxBPM连接器详解 FoxBPM是一款开源的工作流管理系统,它为企业提供了强大的流程建模、执行和管理功能。在企业信息化建设中,流程管理扮演着至关重要的角色,而FoxBPM通过其丰富的连接器机制,能够灵活地与其他系统...
FoxBPM(6.0版本开始fixflow改名为FoxBPM)是一款开源的基于BPMN2.0标准的工作流引擎,引擎底层直接支持BPMN2.0国际标准, 吸纳了 jBPM3 、 Activiti5、BonitaBPM 等国际开源流程引擎的精髓, 同时提供了强大的中国式流程...
#分支介绍 develop 最新开发版 master 最新稳定版 release-* 发布分支为准备新的产品版本发布做支持 hotfix-* 当产品版本的重大bug需要立即解决的时候,我们从对应版本的标签创建出一个热补丁分支。 feature-* 特性...
Python项目开发实战:影视作品分析小程序,案例教程编程实例课程详解.pdf
hive外部表使用语句
ROS
SVM(支持向量机)案例&项目源码
该资源为scikit_learn-1.4.2-cp310-cp310-macosx_10_9_x86_64.whl,欢迎下载使用哦!
场景化落地应用推进制造企业数字化转型.pptx
该程序为labview2018版,使用ni-daqmax采集卡,pd控制程序,传感器为激光位移传感器
基于BIM智能建造实施方案[44页PPT]
电子科技大学数学实验3:数值计算实验
云实训平台QCOW2的Rocky9镜像资源
2024java面试题 通过对基础知识、面向对象编程、高级主题、分布式系统、微服务架构、安全性和实践问题的深入解析,帮助你在Java面试中脱颖而出,成功拿到理想的Offer。
算法
CONTENTS CHAPTER 1 MCS 51 Family of Microcontrollers Architectural Overview 1-1 CHAPTER 2 MCS 51 Programmer's Guide and Instruction Set 2-1 CHAPTER 3 8051,8052 and 80C51 Hardware Description 3-1 CHAPTER 4 8XC52154/58 Hardware Description 4-1 CHAPTERS 8XC51 FX Hardware Description 5-1 CHAPTER 6 87C51GB Hardware Description 6-1 CHAPTER 7 83C152 Hardware Description 7-1
电子科技大学计算机组成原理实验课1——实验2:中小规模组合逻辑设计
行李包安检门设计.doc
MongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMongoDB的相关案例.txtMong