目录
三、候选人和候选人组
3.1、候选人
3.1.1、定义流程图
3.1.2、部署和启动流程实例
3.1.3、任务的查询
3.1.4、任务的拾取
3.1.5、任务的归还
3.1.6、任务的交接
3.1.7、任务的完成
3.2、候选人组
3.2.1、管理用户和组
用户管理
Group管理
为用户分配组
3.2.2、候选人组应用
创建流程图
流程的部署运行
任务的拾取和完成
四、网关
4.1、排他网关
4.2、并行网关
4.3、包含网关
4.4、事件网关
4.5、总结
三、候选人和候选人组
在流程定义中在任务结点的 assignee 固定设置任务负责人,在流程定义时将参与者固定设置在.bpmn 文件中,如果临时任务负责人变更则需要修改流程定义,系统可扩展性差。针对这种情况可以给任务设置多个候选人或者候选人组,可以从候选人中选择参与者来完成任务。
3.1、候选人
3.1.1、定义流程图
定义流程图,同时指定候选人。
第一步:创建流程
第二步:为两个节点分配用户和候选人
第三步:流程下载复制到resources下
3.1.2、部署和启动流程实例
部署流程,并且在启动流程实例的时候对UEL表达式赋值。
/*** 部署流程*/
@Test
public void testDeploy(){ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();RepositoryService repositoryService = processEngine.getRepositoryService();repositoryService.createDeployment().addClasspathResource("请假流程-候选人.bpmn20.xml").name("请假流程-候选人").deploy();
}/*** 启动流程实例*/
@Test
public void runProcess(){// 获取流程引擎对象ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();// 启动流程实例通过 RuntimeService 对象RuntimeService runtimeService = processEngine.getRuntimeService();// 设置流程变量Map<String,Object> variables = new HashMap<>();// 设置候选人的值variables.put("candidate1","苏格拉底");variables.put("candidate2","柏拉图");// 启动流程实例,第一个参数是流程定义的idruntimeService.startProcessInstanceById("holiday-candidate:1:4",variables); //启动流程实例
}
在对应的表结构中我们可以看到流程变量已经有了,但是对于的Task的Assignee还是为空。
3.1.3、任务的查询
根据当前登录的用户,查询对应的候选任务。
/*** 根据登录的用户查询对应的可以拾取的任务**/
@Test
public void queryTaskCandidate(){ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();TaskService taskService = processEngine.getTaskService();List<Task> list = taskService.createTaskQuery()//.processInstanceId("2501").processDefinitionId("holiday-candidate:1:4").taskCandidateUser("苏格拉底").list();for (Task task : list) {System.out.println("task.getId() = " + task.getId());System.out.println("task.getName() = " + task.getName());}
}
3.1.4、任务的拾取
知道了我有可拾取的任务后,拾取任务。
/*** 拾取任务* 一个候选人拾取了这个任务之后其他的用户就没有办法拾取这个任务了* 所以如果一个用户拾取了任务之后又不想处理了,那么可以退还*/
@Test
public void claimTaskCandidate(){ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();TaskService taskService = processEngine.getTaskService();Task task = taskService.createTaskQuery()//.processInstanceId("2501").processDefinitionId("holiday-candidate:1:4").taskCandidateUser("苏格拉底").singleResult();if(task != null){// 拾取对应的任务taskService.claim(task.getId(),"苏格拉底");System.out.println("任务拾取成功");}
}
发现苏格拉底已经拾取了这个任务,以前“创建请假单”是个没人要的孩子,现在被苏格拉底拾取了。
3.1.5、任务的归还
拾取任务后不想操作那么就归还任务。
/*** 退还任务* 一个候选人拾取了这个任务之后其他的用户就没有办法拾取这个任务了* 所以如果一个用户拾取了任务之后又不想处理了,那么可以退还*/
@Test
public void unclaimTaskCandidate(){ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();TaskService taskService = processEngine.getTaskService();Task task = taskService.createTaskQuery()//.processInstanceId("2501").processDefinitionId("holiday-candidate:1:4").taskAssignee("苏格拉底").singleResult();if(task != null){// 拾取对应的任务taskService.unclaim(task.getId());System.out.println("归还拾取成功");}
}
3.1.6、任务的交接
拾取任务后如果不想操作也不想归还可以直接交接给另外一个人来处理。
/*** 任务的交接* 如果我获取了任务,但是不想执行,那么我可以把这个任务交接给其他的用户*/
@Test
public void taskCandidate(){ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();TaskService taskService = processEngine.getTaskService();Task task = taskService.createTaskQuery()//.processInstanceId("2501").processDefinitionId("holiday-candidate:1:4").taskAssignee("苏格拉底").singleResult();if(task != null){// 任务的交接taskService.setAssignee(task.getId(),"柏拉图");System.out.println("任务交接给了柏拉图");}
}
3.1.7、任务的完成
正常的任务处理。
/*** 完成任务*/
@Test
public void completeTask(){ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();TaskService taskService = processEngine.getTaskService();Task task = taskService.createTaskQuery()//.processInstanceId("2501").processDefinitionId("holiday-candidate:1:4").taskAssignee("柏拉图").singleResult();if(task != null){// 完成任务taskService.complete(task.getId());System.out.println("完成Task");}
}
3.2、候选人组
当候选人很多的情况下,我们可以分组来处理。先创建组,然后把用户分配到这个组中。
3.2.1、管理用户和组
用户管理
我们需要先单独维护用户信息。后台对应的表结构是ACT_ID_USER。
/*** 维护用户*/
@Test
public void createUser(){ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();// 通过 IdentityService 完成相关的用户和组的管理IdentityService identityService = processEngine.getIdentityService();User user = identityService.newUser("莫言");user.setFirstName("莫");user.setLastName("言");user.setEmail("moyan@qq.com");identityService.saveUser(user);
}
注意:我们在真实的开发中,肯定有我们自己的用户表,比如t_user,那么当用户注册的时候,我们不但要往t_user表里添加数据,同时也要往act_id_user表添加相同的数据,符合原子操作即可。
Group管理
维护对应的Group信息,后台对应的表结构是`ACT_ID_GROUP
`。
/*** 创建用户组*/
@Test
public void createGroup(){ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();IdentityService identityService = processEngine.getIdentityService();// 创建Group对象并指定相关的信息Group group = identityService.newGroup("group1");group.setName("开发组");group.setType("type1");// 创建Group对应的表结构数据identityService.saveGroup(group);
}
为用户分配组
用户和组是一个多对多的关联关联,我们需要做相关的分配,后台对应的表结构是`ACT_ID_MEMBERSHIP
`。
/*** 将用户分配给对应的Group*/
@Test
public void userGroup(){ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();IdentityService identityService = processEngine.getIdentityService();// 根据组的编号找到对应的Group对象Group group = identityService.createGroupQuery().groupId("group1").singleResult();List<User> list = identityService.createUserQuery().list();for (User user : list) {// 将用户分配给对应的组identityService.createMembership(user.getId(),group.getId());}
}
3.2.2、候选人组应用
搞清楚了用户和用户组的关系后我们就可以来使用候选人组的应用了。
创建流程图
流程的部署运行
然后我们把流程部署和运行,注意对UEL表达式赋值,关联上Group。
/*** 部署流程*/
@Test
public void deploy(){ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();RepositoryService repositoryService = processEngine.getRepositoryService();Deployment deploy = repositoryService.createDeployment().addClasspathResource("请假流程-候选人组.bpmn20.xml").name("请求流程-候选人").deploy();
}/*** 启动流程实例*/
@Test
public void runProcess(){ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();IdentityService identityService = processEngine.getIdentityService();Group group = identityService.createGroupQuery().groupId("group1").singleResult();RuntimeService runtimeService = processEngine.getRuntimeService();// 给流程定义中的UEL表达式赋值Map<String,Object> variables = new HashMap<>();// variables.put("g1","group1");variables.put("g1",group.getId()); // 给流程定义中的UEL表达式赋值runtimeService.startProcessInstanceById("holiday-group:1:17504",variables);
}
对应表结构中就有对应的体现:
任务的拾取和完成
然后完成任务的查询拾取和处理操作。
/*** 根据登录的用户查询对应的可以拾取的任务**/
@Test
public void queryTaskCandidateGroup(){ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();// 根据当前登录的用户找到对应的组IdentityService identityService = processEngine.getIdentityService();// 当前用户所在的组Group group = identityService.createGroupQuery().groupMember("莫言").singleResult();TaskService taskService = processEngine.getTaskService();List<Task> list = taskService.createTaskQuery()//.processInstanceId("2501").processDefinitionId("holiday-group:1:17504").taskCandidateGroup(group.getId()).list();for (Task task : list) {System.out.println("task.getId() = " + task.getId());System.out.println("task.getName() = " + task.getName());}
}/*** 拾取任务* 一个候选人拾取了这个任务之后其他的用户就没有办法拾取这个任务了* 所以如果一个用户拾取了任务之后又不想处理了,那么可以退还*/
@Test
public void claimTaskCandidate(){String userId = "莫言";ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();// 根据当前登录的用户找到对应的组IdentityService identityService = processEngine.getIdentityService();// 当前用户所在的组Group group = identityService.createGroupQuery().groupMember(userId).singleResult();TaskService taskService = processEngine.getTaskService();Task task = taskService.createTaskQuery()//.processInstanceId("2501").processDefinitionId("holiday-group:1:17504").taskCandidateGroup(group.getId()).singleResult();if(task != null) {// 任务拾取taskService.claim(task.getId(),userId);System.out.println("任务拾取成功");}
}/*** 完成任务*/
@Test
public void completeTask(){ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();TaskService taskService = processEngine.getTaskService();Task task = taskService.createTaskQuery()//.processInstanceId("2501").processDefinitionId("holiday-group:1:17504").taskAssignee("莫言").singleResult();if(task != null){// 完成任务taskService.complete(task.getId());System.out.println("完成Task");}
}
四、网关
网关用来控制流程的流向。
4.1、排他网关
排他网关(exclusive gateway)(也叫异或网关 XOR gateway,或者更专业的,基于数据的排他网关 exclusive data-based gateway),用于对流程中的决策建模。当执行到达这个网关时,会按照所有出口顺序流定义的顺序对它们进行计算。选择第一个条件计算为true的顺序流(当没有设置条件时,认为顺序流为true)继续流程。
请注意这里出口顺序流的含义与BPMN 2.0中的一般情况不一样。一般情况下,会选择所有条件计算为true的顺序流,并行执行。而使用排他网关时,只会选择一条顺序流。当多条顺序流的条件都计算为true时,会且仅会选择在XML中最先定义的顺序流继续流程。如果没有可选的顺序流,会抛出异常。
图示
排他网关用内部带有’X’图标的标准网关(菱形)表示,'X’图标代表异或的含义。请注意内部没有图标的网关默认为排他网关。BPMN 2.0规范不允许在同一个流程中混合使用有及没有X的菱形标志。
案例:
设置条件:
部门经理审批和总经理审批分别是lisi和wangwu,人事审批是zhaoliu。
/*** 部署流程*/
@Test
public void deploy(){ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();RepositoryService repositoryService = processEngine.getRepositoryService();Deployment deploy = repositoryService.createDeployment().addClasspathResource("请假流程-排他网关.bpmn20.xml").name("请求流程-排他网关").deploy();
}/*** 启动流程实例*/
@Test
public void runProcess(){ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();RuntimeService runtimeService = processEngine.getRuntimeService();// 给流程定义中的UEL表达式赋值Map<String,Object> variables = new HashMap<>();// variables.put("g1","group1");variables.put("num",2); // 给流程定义中的UEL表达式赋值runtimeService.startProcessInstanceById("holiday-exclusive:1:4",variables);
}/*** 完成任务*/
@Test
public void completeTask(){ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();TaskService taskService = processEngine.getTaskService();Task task = taskService.createTaskQuery()//.processInstanceId("2501").processDefinitionId("holiday-exclusive:1:4").taskAssignee("zhangsan").singleResult();if(task != null){// 完成任务taskService.complete(task.getId());System.out.println("完成Task");}
}
当我们使用zhangsan完成任务时:
因为我们设置的num为2,满足num<3的条件,所以走部门经理审批。
注意:我们当时设置的条件是num<3和num>3,那么如果我设置num=3,会发现什么效果呢?
前面我们可以直接在连接线上定义条件,那为什么还要有排他网关呢?直接在线上的情况,如果条件都不满足,流程就结束了,是异常结束!!但是有了排他网关,尽管你条件都不满足,也只是给你抛出异常,并不会结束流程,你可以重新设置变量就行了。
4.2、并行网关
并行网关允许将流程分成多条分支,也可以把多条分支汇聚到一起,并行网关的功能是基于进入和外出顺序流的:
-
fork分支:并行后的所有外出顺序流,为每个顺序流都创建一个并发分支。
-
join汇聚: 所有到达并行网关,在此等待的进入分支, 直到所有进入顺序流的分支都到达以后, 流程就会通过汇聚网关。
注意,如果同一个并行网关有多个进入和多个外出顺序流, 它就同时具有分支和汇聚功能。 这时,网关会先汇聚所有进入的顺序流,然后再切分成多个并行分支。
与其他网关的主要区别是,并行网关不会解析条件。 即使顺序流中定义了条件,也会被忽略。
案例:
当我们执行了创建请假单后,到并行网关的位置的时候,在ACT_RU_TASK表中就有两条记录。
然后同时在ACT_RU_EXECUTION中有三条记录,一个任务对应的有两个执行实例。
如果我们使用lisi审批一下,task表中lisi的记录就没了,只剩下wangwu的。
4.3、包含网关
包含网关可以看做是排他网关和并行网关的结合体。 和排他网关一样,你可以在外出顺序流上定义条件,包含网关会解析它们。 但是主要的区别是包含网关可以选择多于一条顺序流,这和并行网关一样。
包含网关的功能是基于进入和外出顺序流的:
-
分支: 所有外出顺序流的条件都会被解析,结果为true的顺序流会以并行方式继续执行, 会为每个顺序流创建一个分支。
-
汇聚:所有并行分支到达包含网关,会进入等待状态, 直到每个包含流程token的进入顺序流的分支都到达。 这是与并行网关的最大不同。换句话说,包含网关只会等待被选中执行了的进入顺序流。 在汇聚之后,流程会穿过包含网关继续执行。
4.4、事件网关
事件网关允许根据事件判断流向。网关的每个外出顺序流都要连接到一个中间捕获事件。 当流程到达一个基于事件网关,网关会进入等待状态:会暂停执行。与此同时,会为每个外出顺序流创建相对的事件订阅。
事件网关的外出顺序流和普通顺序流不同,这些顺序流不会真的"执行", 相反它们让流程引擎去决定执行到事件网关的流程需要订阅哪些事件。 要考虑以下条件:
-
事件网关必须有两条或以上外出顺序流;
-
事件网关后,只能使用intermediateCatchEvent类型(activiti不支持基于事件网关后连接ReceiveTask)
-
连接到事件网关的中间捕获事件必须只有一个入口顺序流。
4.5、总结
排他:两条路径只取其中一条走。
并行:两条路径同时走。
包含:只要条件为true的都走。