bboss版activiti 5.12扩展动态
程序员文章站
2022-03-30 22:58:22
...
继扩展Activiti-5.12轻松实现流程节点间*跳转和任意驳回/撤回功能之后,bboss最近对Activiti-5.12这个版本做了以下功能扩展:
1.如果人工任务节点没有设置处理人,则自动完成当前节点跳转到下一环节,如果对应人工任务节点(没有设置处理人的人工任务节点节点)设置了自动处理类(实现org.activiti.engine.delegate.JavaDelegate接口)参数,则会执行自动处理类的接口方法:
例如:流程中有a,b,c,d四个人工任务节点,其中b节点没有设置处理人,那么当a节点任务完成后,如果b节点没有设置自动处理类,那么直接忽略掉b,直接运行到c节点;如果b节点设置了自动处理类,那么流程引擎执行该处理类后再运行到c节点。
2.org.activiti.engine.impl.TaskServiceImpl组件增加一组带完成原因的completeTask接口,完成原因会直接填写到工作流的act_hi_task表的完成原因字段中。
例如:
public void completeWithDestReason(String taskId,String destinationTaskKey,String completeReason,String bussinessop,String bussinessRemark)
详情参考组件:
https://github.com/yin-bp/activiti-engine-5.12/blob/master/src/main/java/org/activiti/engine/impl/TaskServiceImpl.java
三个任务完成原因相关字段:
completeReason:流程引擎自身会填充的说明字段,业务程序也可自己填写这个字段,一般流程引擎会在字段中记录任务处理任意跳转,驳回等系统信息
bussinessop:由业务程序记录完成任务时的填写的业务操作码,可以填写,也可以不填写,流程引擎不会修改这个字段
bussinessRemark:由业务程序记录完成任务时填写的业务处理日志,可以填写,也可以不填写,流程引擎不会修改这个字段
同样也提供了一组带三个原因字段的驳回接口。
3.为了便于记录操作日志和提升系统性能,对流程活动历时表和任务历时表做了相应的扩展:
工作流任务表ACT_HI_ACTINST表中增加任务处理原因,任务业务操作类型,任务业务操作日志,签收时间,任务owner5个子段,同时ACT_HI_ACTINST记录任务kpi数据以及任务的节假日策略
工作流任务表ACT_HI_TASKINST表中增加任务业务操作类型,任务业务操作日志字段,同时ACT_HI_TASKINST记录任务kpi数据以及任务的节假日策略。
4.增加一组驳回接口,可以指定驳回的历史节点,驳回时可以指定驳回后,任务处理完毕可忽略后续节点直接跳转到驳回节点:
处理完毕后,按照正常的流程流转到驳回点,例如:流程中有a,b,c,d四个节点,由d节点驳回到a节点,当a处理完毕后,还要流转b,c两个节点再到达d.
处理完毕后,直接回到驳回点,例如:流程中有a,b,c,d四个节点,由d节点驳回到a节点,当a处理完毕后,直接流转到d节点,忽略b,c两个节点.
5.改造单实例人工任务节点(非Multi Instance的UseTask节点,设置多个处理人时只产生一个任务,这个任务只能被其中的一个人处理)逻辑,可以根据控制变量在流程实例开启和运行阶段改变单实例人工任务节点的处理节点为多实例任务节点(也就是说,如果单实例人工任务节点设置了多个处理人,会为每个人生成一个任务,此时,这个在建模时被定义为单实例人工任务的节点的行为已经和多实例人工任务节点的行为一致),这样不仅可以大大降低我们流程建模的复杂度(画多实例人工任务节点是比较复杂的),同时可以在流程实例运行过程中灵活控制单实例人工任务节点的行为(在设置了多个处理人时,可以根据控制变量改变其到底是按单实例任务跑,还是按多实例任务跑)。具体工作原理看下图:
6.改变流程变量的校验规则。在流程运行过程中,如果变量没有设置值时,不抛出Exception,只在log4j日志文件中输出相应的警告日志。
7.userTask 类型节点的activiti:assignee属性也可以设置多个处理人,以逗号分隔,例如:
<userTask id="usertask2" name="单实例" activiti:assignee="zhangsan,lisi,wangwu"></userTask>
改造版的bboss中要求流程处理人变量必须是以下命名格式:
活动id+_+users
例如:
<userTask id="usertask2" name="单实例" activiti:assignee="${usertask2_users}"></userTask>
8.单实例人工任务节点,当只设置了一个处理人时,不再需要签收任务,任务直接被assignee个指定的这个人
9.在流程引擎级别记录驳回操作,撤销操作,驳回后回到驳回点操作,任意跳转操作日志,以便在处理任务时进行相应的处理操作
常量:
org.activiti.engine.TaskService定义了四个常量与上述四个操作对应
10.定义了扩展归档机制,当流程实例结束时,用户可以在归档接口方法中将需要归档的实例运行时数据进行归档,流程引擎默认对流程引擎级别驳回操作、撤销操作、驳回后回到驳回点操作、任意跳转操作日志进行归档。
归档组件必须实现接口方法:
在流程引擎配置文件中增加以下注入配置即可:
11.由于我们可以直接在任务历史表和活动历史表中记录任务和活动处理日志和业务处理日志和业务处理操作,为了解决mysql下这些处理日志的排序问题,为ACT_HI_ACTINST 和ACT_HI_TASKINST 两个表分别增加了以下long形的排序时间字段:START_TIME_LONG, END_TIME_LONG
12.提供抄送/通知任务类型,支持抄送到人和部门,抄送任务不影响流程的正常流转,比如最后一个任务节点被设置为抄送任务节点后,抄送任务产生后流程立即结束,但是抄送任务仍然存在,知道相关人员阅读完抄送任务后结束
13.可自动跳过相同处理人的节点,为了便于业务逻辑的处理,可以在自动过的时候指定自动业务处理回调类。
14.最新的bboss版activiti 5.12对流程引擎数据库做了相应的调整,如果要升级需要执行的sql脚本如下:
mysql:
oracle:
15.最新的bboss版activiti 5.12下载地址:
https://github.com/yin-bp/activiti-engine-5.12
1.如果人工任务节点没有设置处理人,则自动完成当前节点跳转到下一环节,如果对应人工任务节点(没有设置处理人的人工任务节点节点)设置了自动处理类(实现org.activiti.engine.delegate.JavaDelegate接口)参数,则会执行自动处理类的接口方法:
void execute(DelegateExecution execution) throws Exception;.
例如:流程中有a,b,c,d四个人工任务节点,其中b节点没有设置处理人,那么当a节点任务完成后,如果b节点没有设置自动处理类,那么直接忽略掉b,直接运行到c节点;如果b节点设置了自动处理类,那么流程引擎执行该处理类后再运行到c节点。
2.org.activiti.engine.impl.TaskServiceImpl组件增加一组带完成原因的completeTask接口,完成原因会直接填写到工作流的act_hi_task表的完成原因字段中。
例如:
public void completeWithDestReason(String taskId,String destinationTaskKey,String completeReason,String bussinessop,String bussinessRemark)
详情参考组件:
https://github.com/yin-bp/activiti-engine-5.12/blob/master/src/main/java/org/activiti/engine/impl/TaskServiceImpl.java
三个任务完成原因相关字段:
completeReason:流程引擎自身会填充的说明字段,业务程序也可自己填写这个字段,一般流程引擎会在字段中记录任务处理任意跳转,驳回等系统信息
bussinessop:由业务程序记录完成任务时的填写的业务操作码,可以填写,也可以不填写,流程引擎不会修改这个字段
bussinessRemark:由业务程序记录完成任务时填写的业务处理日志,可以填写,也可以不填写,流程引擎不会修改这个字段
同样也提供了一组带三个原因字段的驳回接口。
3.为了便于记录操作日志和提升系统性能,对流程活动历时表和任务历时表做了相应的扩展:
工作流任务表ACT_HI_ACTINST表中增加任务处理原因,任务业务操作类型,任务业务操作日志,签收时间,任务owner5个子段,同时ACT_HI_ACTINST记录任务kpi数据以及任务的节假日策略
工作流任务表ACT_HI_TASKINST表中增加任务业务操作类型,任务业务操作日志字段,同时ACT_HI_TASKINST记录任务kpi数据以及任务的节假日策略。
4.增加一组驳回接口,可以指定驳回的历史节点,驳回时可以指定驳回后,任务处理完毕可忽略后续节点直接跳转到驳回节点:
public boolean rejecttoTask(String taskId, Map<String, Object> variables,String desttaskkey )//处理完毕后,按照正常的流程流转到驳回点
处理完毕后,按照正常的流程流转到驳回点,例如:流程中有a,b,c,d四个节点,由d节点驳回到a节点,当a处理完毕后,还要流转b,c两个节点再到达d.
public boolean rejecttoTask(String taskId, Map<String, Object> variables, String desttaskkey, boolean returntoreject)//增加了处理任务后直接回到驳回点的控制变量
处理完毕后,直接回到驳回点,例如:流程中有a,b,c,d四个节点,由d节点驳回到a节点,当a处理完毕后,直接流转到d节点,忽略b,c两个节点.
5.改造单实例人工任务节点(非Multi Instance的UseTask节点,设置多个处理人时只产生一个任务,这个任务只能被其中的一个人处理)逻辑,可以根据控制变量在流程实例开启和运行阶段改变单实例人工任务节点的处理节点为多实例任务节点(也就是说,如果单实例人工任务节点设置了多个处理人,会为每个人生成一个任务,此时,这个在建模时被定义为单实例人工任务的节点的行为已经和多实例人工任务节点的行为一致),这样不仅可以大大降低我们流程建模的复杂度(画多实例人工任务节点是比较复杂的),同时可以在流程实例运行过程中灵活控制单实例人工任务节点的行为(在设置了多个处理人时,可以根据控制变量改变其到底是按单实例任务跑,还是按多实例任务跑)。具体工作原理看下图:
6.改变流程变量的校验规则。在流程运行过程中,如果变量没有设置值时,不抛出Exception,只在log4j日志文件中输出相应的警告日志。
7.userTask 类型节点的activiti:assignee属性也可以设置多个处理人,以逗号分隔,例如:
<userTask id="usertask2" name="单实例" activiti:assignee="zhangsan,lisi,wangwu"></userTask>
改造版的bboss中要求流程处理人变量必须是以下命名格式:
活动id+_+users
例如:
<userTask id="usertask2" name="单实例" activiti:assignee="${usertask2_users}"></userTask>
8.单实例人工任务节点,当只设置了一个处理人时,不再需要签收任务,任务直接被assignee个指定的这个人
9.在流程引擎级别记录驳回操作,撤销操作,驳回后回到驳回点操作,任意跳转操作日志,以便在处理任务时进行相应的处理操作
常量:
org.activiti.engine.TaskService定义了四个常量与上述四个操作对应
public static final int op_rejected = 3;//驳回操作 public static final int op_withdraw = 1;//撤销操作 public static final int op_jump = 2;//任意跳转操作 public static final int op_returntorejected = 0;//驳回后回到驳回点操作
10.定义了扩展归档机制,当流程实例结束时,用户可以在归档接口方法中将需要归档的实例运行时数据进行归档,流程引擎默认对流程引擎级别驳回操作、撤销操作、驳回后回到驳回点操作、任意跳转操作日志进行归档。
归档组件必须实现接口方法:
package org.activiti.engine /** * 工作流 * @author yinbp * */ public interface KPIService { //计算任务超时时间和任务预警时间接口方法 public KPI buildKPI(DelegateExecution execution,Collection<String> candiates,Date taskCreateTime) throws ActivitiException; //获取任务处理节点控制变量方法 public ControlParam getControlParam(DelegateExecution currentexecution,String taskKey) throws ActivitiException; //获取任务处理节点控制变量方法 public ControlParam getControlParam(String processInstanceId,String activieKey) throws ActivitiException; /** * 流程实例结束后,对实例相关的外围扩展信息实时归档操作 * @param currentexecution * @param processInstanceID * @throws ActivitiException */ public void archiveProcessRuntimedata(DelegateExecution currentexecution,String processInstanceID) throws ActivitiException; }
在流程引擎配置文件中增加以下注入配置即可:
<property name="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration"> .... <property name="KPIService" class="com.bboss.workflow.service.impl.PlatformKPIServiceImpl"/> .... </property>
11.由于我们可以直接在任务历史表和活动历史表中记录任务和活动处理日志和业务处理日志和业务处理操作,为了解决mysql下这些处理日志的排序问题,为ACT_HI_ACTINST 和ACT_HI_TASKINST 两个表分别增加了以下long形的排序时间字段:START_TIME_LONG, END_TIME_LONG
12.提供抄送/通知任务类型,支持抄送到人和部门,抄送任务不影响流程的正常流转,比如最后一个任务节点被设置为抄送任务节点后,抄送任务产生后流程立即结束,但是抄送任务仍然存在,知道相关人员阅读完抄送任务后结束
13.可自动跳过相同处理人的节点,为了便于业务逻辑的处理,可以在自动过的时候指定自动业务处理回调类。
14.最新的bboss版activiti 5.12对流程引擎数据库做了相应的调整,如果要升级需要执行的sql脚本如下:
mysql:
-- Create table create table td_wf_rejectlog ( newtaskid varchar(64) not null, rejecttaskid varchar(64) not null, rejectnode varchar(100) not null, primary key (newtaskid) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE utf8_bin; ALTER TABLE ACT_RU_TASK ADD COLUMN DURATION_NODE decimal(19) NULL DEFAULT 0; ALTER TABLE ACT_RU_TASK ADD COLUMN ADVANCESEND decimal(1) NULL DEFAULT 0; ALTER TABLE ACT_RU_TASK ADD COLUMN OVERTIMESEND decimal(1) NULL DEFAULT 0; ALTER TABLE ACT_RU_TASK ADD COLUMN (ALERTTIME TIMESTAMP NULL DEFAULT NULL); ALTER TABLE ACT_RU_TASK ADD COLUMN (OVERTIME TIMESTAMP NULL DEFAULT NULL); ALTER TABLE ACT_HI_ACTINST ADD COLUMN DURATION_NODE decimal(19) NULL DEFAULT 0; ALTER TABLE ACT_HI_ACTINST ADD COLUMN ADVANCESEND decimal(1) NULL DEFAULT 0; ALTER TABLE ACT_HI_ACTINST ADD COLUMN OVERTIMESEND decimal(1) NULL DEFAULT 0; ALTER TABLE ACT_HI_ACTINST ADD COLUMN (ALERTTIME TIMESTAMP NULL DEFAULT NULL); ALTER TABLE ACT_HI_ACTINST ADD COLUMN (OVERTIME TIMESTAMP NULL DEFAULT NULL); ALTER TABLE ACT_HI_TASKINST ADD COLUMN DURATION_NODE decimal(19) NULL DEFAULT 0; ALTER TABLE ACT_HI_TASKINST ADD COLUMN ADVANCESEND decimal(1) NULL DEFAULT 0; ALTER TABLE ACT_HI_TASKINST ADD COLUMN OVERTIMESEND decimal(1) NULL DEFAULT 0; ALTER TABLE ACT_HI_TASKINST ADD COLUMN (ALERTTIME TIMESTAMP NULL DEFAULT NULL); ALTER TABLE ACT_HI_TASKINST ADD COLUMN (OVERTIME TIMESTAMP NULL DEFAULT NULL); ALTER TABLE ACT_HI_ACTINST ADD COLUMN (NOTICERATE decimal(8)); ALTER TABLE ACT_HI_TASKINST ADD COLUMN (NOTICERATE decimal(8)); ALTER TABLE ACT_RU_TASK ADD COLUMN (NOTICERATE decimal(8)); ALTER TABLE ACT_HI_ACTINST ADD COLUMN (IS_CONTAIN_HOLIDAY decimal(1)); ALTER TABLE ACT_HI_TASKINST ADD COLUMN (IS_CONTAIN_HOLIDAY decimal(1)); ALTER TABLE ACT_RU_TASK ADD COLUMN (IS_CONTAIN_HOLIDAY decimal(1) ); ALTER TABLE ACT_HI_ACTINST ADD COLUMN IS_AUTO_COMPLETE decimal(1) NULL DEFAULT 0; ALTER TABLE ACT_HI_ACTINST ADD COLUMN (AUTO_HANDLER varchar(255)); ALTER TABLE ACT_HI_TASKINST ADD COLUMN (BUSSINESS_OP varchar(255)); ALTER TABLE ACT_HI_TASKINST ADD COLUMN (BUSSINESS_REMARK varchar(2000)); ALTER TABLE ACT_HI_ACTINST ADD COLUMN (BUSSINESS_OP VARCHAR(255)); ALTER TABLE ACT_HI_ACTINST ADD COLUMN (BUSSINESS_REMARK VARCHAR(2000)); ALTER TABLE ACT_HI_ACTINST ADD COLUMN (DELETE_REASON_ VARCHAR(2000)); ALTER TABLE ACT_HI_ACTINST ADD COLUMN (OWNER_ VARCHAR(255)); ALTER TABLE ACT_HI_ACTINST ADD COLUMN (CLAIM_TIME_ TIMESTAMP NULL DEFAULT NULL); ALTER TABLE td_wf_rejectlog ADD COLUMN (optype decimal(1) NULL DEFAULT 0); ALTER TABLE TD_WF_REJECTLOG ADD (PROCESS_ID VARCHAR(100)); create table td_wf_hi_rejectlog ( newtaskid varchar(64) not null, rejecttaskid varchar(64) not null, rejectnode varchar(100) not null, BACKUPTIME TIMESTAMP NULL DEFAULT NULL, optype decimal(1) NULL DEFAULT 0, PROCESS_ID VARCHAR(100), primary key (newtaskid) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE utf8_bin; ALTER TABLE ACT_HI_ACTINST ADD COLUMN (START_TIME_LONG bigint ); ALTER TABLE ACT_HI_ACTINST ADD COLUMN (END_TIME_LONG bigint ); ALTER TABLE ACT_HI_TASKINST ADD COLUMN (START_TIME_LONG bigint ); ALTER TABLE ACT_HI_TASKINST ADD COLUMN (END_TIME_LONG bigint );
oracle:
-- Create table create table td_wf_rejectlog ( newtaskid nvarchar2(64), rejecttaskid nvarchar2(64), rejectnode nvarchar2(100) ) ; -- Create/Recreate primary, unique and foreign key constraints alter table td_wf_rejectlog add constraint rejectlog_pk primary key (NEWTASKID); --流程引擎扩展表字段 ALTER TABLE ACT_RU_TASK ADD (DURATION_NODE NUMBER(19)); ALTER TABLE ACT_RU_TASK ADD (ADVANCESEND NUMBER(1) DEFAULT 0); ALTER TABLE ACT_RU_TASK ADD (OVERTIMESEND NUMBER(1)); ALTER TABLE ACT_RU_TASK MODIFY(DURATION_NODE DEFAULT 0); ALTER TABLE ACT_RU_TASK MODIFY(OVERTIMESEND DEFAULT 0); ALTER TABLE ACT_RU_TASK ADD (ALERTTIME TIMESTAMP(7)); ALTER TABLE ACT_RU_TASK ADD (OVERTIME TIMESTAMP(7)); ALTER TABLE ACT_HI_ACTINST ADD (DURATION_NODE NUMBER(19)); ALTER TABLE ACT_HI_ACTINST ADD (ADVANCESEND NUMBER(1) DEFAULT 0); ALTER TABLE ACT_HI_ACTINST ADD (OVERTIMESEND NUMBER(1)); ALTER TABLE ACT_HI_ACTINST MODIFY(DURATION_NODE DEFAULT 0); ALTER TABLE ACT_HI_ACTINST MODIFY(OVERTIMESEND DEFAULT 0); ALTER TABLE ACT_HI_ACTINST ADD (ALERTTIME TIMESTAMP(7)); ALTER TABLE ACT_HI_ACTINST ADD (OVERTIME TIMESTAMP(7)); ---------------------------------------------------- ALTER TABLE ACT_HI_TASKINST ADD (DURATION_NODE NUMBER(19)); ALTER TABLE ACT_HI_TASKINST ADD (ADVANCESEND NUMBER(1) DEFAULT 0); ALTER TABLE ACT_HI_TASKINST ADD (OVERTIMESEND NUMBER(1)); ALTER TABLE ACT_HI_TASKINST MODIFY(DURATION_NODE DEFAULT 0); ALTER TABLE ACT_HI_TASKINST MODIFY(OVERTIMESEND DEFAULT 0); ALTER TABLE ACT_HI_TASKINST ADD (ALERTTIME TIMESTAMP(7)); ALTER TABLE ACT_HI_TASKINST ADD (OVERTIME TIMESTAMP(7)); --------------------- ALTER TABLE ACT_HI_ACTINST ADD (NOTICERATE NUMBER(8)); ALTER TABLE ACT_HI_TASKINST ADD (NOTICERATE NUMBER(8)); ALTER TABLE ACT_RU_TASK ADD (NOTICERATE NUMBER(8)); ------------------------- ALTER TABLE ACT_HI_ACTINST ADD (IS_CONTAIN_HOLIDAY NUMBER(1)); ALTER TABLE ACT_HI_TASKINST ADD (IS_CONTAIN_HOLIDAY NUMBER(1)); ALTER TABLE ACT_RU_TASK ADD (IS_CONTAIN_HOLIDAY NUMBER(1) ); ALTER TABLE ACT_HI_ACTINST ADD (IS_AUTO_COMPLETE NUMBER(1) DEFAULT 0); ALTER TABLE ACT_HI_ACTINST ADD (AUTO_HANDLER NVARCHAR2(255)); ALTER TABLE ACT_HI_TASKINST ADD (BUSSINESS_OP NVARCHAR2(255)); ALTER TABLE ACT_HI_TASKINST ADD (BUSSINESS_REMARK NVARCHAR2(2000)); ALTER TABLE ACT_HI_ACTINST ADD (BUSSINESS_OP NVARCHAR2(255)); ALTER TABLE ACT_HI_ACTINST ADD (BUSSINESS_REMARK NVARCHAR2(2000)); ALTER TABLE ACT_HI_ACTINST ADD (DELETE_REASON_ NVARCHAR2(2000)); ALTER TABLE ACT_HI_ACTINST ADD (OWNER_ NVARCHAR2(255)); ALTER TABLE ACT_HI_ACTINST ADD (CLAIM_TIME_ TIMESTAMP(6)); ALTER TABLE td_wf_rejectlog ADD (optype NUMBER(1) DEFAULT 0); ALTER TABLE TD_WF_REJECTLOG ADD (PROCESS_ID NVARCHAR2(100)); -- Create table create table td_wf_hi_rejectlog ( newtaskid nvarchar2(64), rejecttaskid nvarchar2(64), rejectnode nvarchar2(100), BACKUPTIME TIMESTAMP(6), optype NUMBER(1) DEFAULT 0, PROCESS_ID NVARCHAR2(100) ) ; -- Create/Recreate primary, unique and foreign key constraints alter table td_wf_hi_rejectlog add constraint hi_rejectlog_pk primary key (NEWTASKID); ALTER TABLE ACT_HI_ACTINST ADD (START_TIME_LONG NUMBER(19) ); ALTER TABLE ACT_HI_ACTINST ADD (END_TIME_LONG NUMBER(19) ); ALTER TABLE ACT_HI_TASKINST ADD (START_TIME_LONG NUMBER(19) ); ALTER TABLE ACT_HI_TASKINST ADD (END_TIME_LONG NUMBER(19) );
15.最新的bboss版activiti 5.12下载地址:
https://github.com/yin-bp/activiti-engine-5.12