activiti参考文档
版本信息
当前版本为activiti6.0,与之前版本区别
数据库表变化:job表拆成了 job, timer job, suspended job 和 dead letter job表。
在6.0中org.activiti.engine.impl.pvm整个包被移除,意味着所有ActivitiImpl, ProcessDefinitionImpl, ExecutionImpl, TransitionImpl 都不可用了。所有的流程定义有关的信息都可以通过BpmnModel来获得,获得 BpmnModel的方式可以通过org.activiti.engine.impl.util.ProcessDefinitionUtil来拿到。
ProcessDefinitionUtil.getBpmnModel(String processDefinitionId);
ProcessDefinitionUtil.getProcess(String processDefinitionId);ActivityExecution 被 DelegateExecution 替换。
边界事件
定时边界事件:用于当前环节超时未处理
错误边界事件:子流程异常处理
信息边界事件:业务信号全局实例捕捉
assignee、candidateUsers、candidateGroups
assignee:任务执行人,设置系统中的“登录名”(loginName)。
candidateUsers:任务执行人,可以填写多个。
candidateGroups:任务执行组,可以填写多个,设置系统中的“角色英文名(enname)”。
assignee和candidateUsers的区别是:assignee不需要签收任务,直接可执行任务;candidateUsers为竞争方式分配任务,被指定人待办中都有一条任务,谁先签收谁就获得任务的执行权。
setAssgine()、SetClaim()、SetOwner()区别
taskService.setAssignee(String taskId, String userId);
taskService.claim(String taskId, String userId);
taskService.setOwner(String taskId, String userId);
关于上面三个方法的区别:
setAssignee和claim两个的区别是在认领任务时,claim会检查该任务是否已经被认领,如果被认领则会抛出ActivitiTaskAlreadyClaimedException 而setAssignee不会进行这样的检查。其他方面两个方法效果一致。
setOwner和setAssignee的区别在于
setOwner实在代理任务时使用,代表着任务的归属者,而这时,setAssignee代表的时代理办理者,
举个例子来说,公司总经理现在有个任务taskA,去核实一下本年度的财务报表,他现在又很忙没时间,于是将该任务委托给其助理进行办理,此时,就应该这么做:
taskService.setOwner(taskA.getId(), 总经理.getId());
taskService.setAssignee/claim(taskA.getId(), 助理.getId());
任务分配设置
- 直接设置用户或者角色ID
- 利用UEL-value表达式设置动态用户或者角色
任务委托delgegate
act_hi_taskinst表两个字段:
DELEGATION_和OWENER_
DELEGATION_值变化为PENDING,表示此任务为正在执行的委托任务;
DELEGATION_值变化为 RESOLVED,表示此任务为被解决的委托任务;
所以任务在被委托人执行时必须
taskService.resolveTask(task.getId(),taskVariables);//解决委托
taskService.complete(task.getId(), taskVariables);//完成任务
否则容易报错A delegated task cannot be completed, but should be resolved instead.
OWENR_字段设置用于查询委任人的委托任务
任务批注
在执行taskService.addComment前,需要设置批注的所属人Authentication.setAuthenticatedUserId(userId);
流程启动者
在流程启动实例之前,设置启动者identityService.setAuthenticatedUserId(userId);
然后流程设计模型可在流程开始节点设置变量,以供之后的环节使用
流程定义删除
级联删除会把流程实例流程历史全部物理清空。
非级联删除,必须保证没有流程实例
HistoryService、TaskService
二者虽然都能查询到任务实例。但是前者只能查询历史环节,就算act_hi_taskinst有数据未完成当前环节也不能查出