Activiti工作流笔记

1 概要介绍

1)什么是流程定义 ?

         流程定义是按照bpmn2.0标准定义业务流程,将流程定义的文件(.bpmn和.png(不是必须的))部署到activiti中,activiti就可以管理该业务流程。

 

2)什么是流程实例 ?

         参与者(可以用户,也可以程序)按照流程定义发起一个流程,这个流程就是一个流程实例 。流程定义的内容就是一个静态文件(.bpmn),流程实例的内容是该 流程的执行过程(动态)。

 

3)如何启动一个流程实例 ?

         常用方式:启动一个流程实例时指定一个业务标识。

// 业务标识 ,如果 是采购流程就是采购单id      
String businessKey = "001";
 // 启动流程实例时指定业务标识
 String processDefinitionKey = "purchasingflow";
 ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey, businessKey);

  businessKey:业务标识,作用:通过activiti的api查询activiti的流程数据时,可以通过businessKey关联查询业务系统 的数据,通常业务标识记录业务系统表的主键,比如:如果采购流程,businesskey就是采购单id,如果是请假流程,businessKey就是请假单(请假信息表)的id。

 

启动一个流程实例 后,该流程运行到第一个结点,activiti需要给该 任务结点分配任务负责人。

任务分配三种方式:

第一种:采用固定分配方法,设置task结点的assignee(任务负责人)属性,不常用。 

第二种:采用UEL表达式,表达使用流程变量设置任务负责人,在企业开发中常用。

第三种:采用监听器(自定义监听器实现 TaskListener接口),可以在监听器中扩展代码,在企业开发中常用。

 

查询待办任务:

查询待办任务中如果包括 业务系统 数据,如果查询?

通过Taskid得到任务所属的流程实例id

通过流程实例id得到流程实例对象ProcessInstance。

从ProcessInstance获取businessKey

通过businessKey关联查询业务数据

 

4)Activiti开发步骤:

1、  在需求阶段,分析出业务流程

2、  设计阶段,确定哪些业务流程由activiti管理,对工作流管理的流程进行流程定义

流程定义时和功能设计同步进行:

1》  确定流程启动所对应的功能

2》  确定流程执行中哪些功能和流程结点对应,哪个功能可以将流程向后推进一步

 

Activiti开发遵循原则:

1、  角色分工明确,activiti负责流程管理 ,业务系统 负责业务功能。

2、  业务系统 中通常在service层将activiti和控制层、持久层进行隔离(解耦),比如在业务功能中需要查询activiti的流程数据,需要自定义一个对象存储activiti的数据。

3、  数据共享问题,在activiti中存储businesskey(业务标识),通过businesskey查询业务系统 数据,在业务系统 中存储activiti的标识(比如在采购单中存储流程实例 的id),在查询业务数据时通过此流程实例 id查询activiti的数据。达到目标:activiti和业务系统 能互相关联查询。 

办理任务(完成任务):

需要参数:任务id(activiti的api要求),用户id(进行权限校验使用)

在完成任务之前需要校验该 用户是否有该 任务的完成权限。

 

2 流程变量

2.1  什么是流程变量

在activiti在管理流程中,可能需要通过流程变量控制流程的执行。

注意:流程变量只是用于控制流程的执行,而不是存储业务数据!!

2.2  流程变量作用域

Activiti的流程变量包括 global全局变量和local局部变量。

Activiti常用全局变量进行流程控制,因为local局部变量作用域小一般不用,可以查询历史的局部变量。

global全局变量:作用域是整体流程实例,如果流程实例结束,变量无效。

local局部变量: 作用域小,可以是一个任务(task)也可以是一个执行分支(execution)。任务或执行分支结束,local局部变量无效。

通过historyService查询历史流程变量值。

不同的流程实例,global全局变量互不影响。

同一个流程实例,无法设置两个相同名称 global全局变量,后设置的相同名称 global全局变量会覆盖前边的变量值 。

任务中local变量,不同任务的local变量互不影响。Local变量名称可以和global全局变量相同。

2.3  流程变量的类型

注意:如果将pojo对象存储到流程变量中,必须实现序列化接口serializable,为了防止由于新增字段无法反序列化,需要生成serialVersionUID,如下:

注意:由于OrderCustom也继承了PurBusOrder类,PurBusOrder也必须实现序列化接口,否则 PurBusOrder中的属性无法反序列化。

总结:

1、如果需要将pojo中的属性从流程变量获取(activiti进行反序列化),需要将属性所在pojo实现serializable接口。

2、需要在pojo中设置serialVersionUID,如果不设置该版本id,日后在pojo中新增字段,如果之前将未新增字段的pojo对象存储在activiti的流程变量中,如果从流程变量中获取之前 的pojo对象,将报错。

2.4  流程变量的使用方法

第一步:设置流程变量

第二步:使用流程变量控制流程的执行

例子:

1) 在task结点的assignee通过UEL表达式使用流程变量

${assignee}:assignee就是一个流程变量名称

Activiti获取UEL表达式的值 ,即流程变量assignee的值 ,将assignee的值作为任务的负责人进行任务分配.

2)在连线上的candition条件上通过UEL表达式使用流程变量

${price>=10000}和${price<10000}: price就是一个流程变量名称,uel表达式结果类型为布尔类型

如果UEL表达式是true,要决定 流程执行走向。

比如:如果采购金额大于10000元由总经理审核,否则由财务直接审核。

2.5 设置全局变量

2.5.1 可以流程启动时设置流程变量(常用)

  由于设置了全局变量,该流程启动后,在下边每个结点都可以使用该变量。

在task结点的assignee通过UEL表达式使用流程变量。

代码:

// 得到runtimeService
RuntimeService runtimeService = processEngine.getRuntimeService();
// 根据流程定义的key(标识 )来启动一个实例,activiti找该key下版本最高的流程定义
// 一般情况下为了方便开发使用该方法启动一个流程实例。
String processDefinitionKey = "purchasingflow";
// 在流程启动时设置全局变量,第二个参数variables存储流程变量 
Map<String, Object> variables = new HashMap<String, Object>();
// 流程 变更名称是assignee,流程变量值是"张三"
variables.put("assignee", "张三");
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey, variables);

2.5.2 在完成任务时设置流程变量(常用)

  在完成任务时设置流程变量,在该 任务的后续结点可以使用该 变量,变量的作用域还是整个流程实例 。

//完成任务时设置流程变量
Map<String, Object> variables = new HashMap<String, Object>();
// 流程 变更名称是assignee,流程变量值是"张三"
variables.put("assignee", "李四");
taskService.complete(taskId, variables); 

测试发现,在同一个流程实例下,同名的全局变量,后设置的会覆盖前边设置的。

2.5.3 通过当前流程实例 id设置

  通过此方法可以在流程实例未结束时任意设置流程变量。

RuntimeService runtimeService  = processEngine.getRuntimeService();    

      //设置单个 变量

      //第一个参数:executionId是流程实例 的执行 id,通常使用流程实例 id,必须是当前正在运行的流程实例 id

      //第二个参数:变量名

      //第三个参数:变量值

      runtimeService.setVariable("2001", "price", 10000);

      //一次设置多个变量,第二个参数是map

      //runtimeService.setVariables(executionId, variables)

注意:第一个参数executionId是流程实例 的执行 id,通常使用流程实例 id,必须是当前正在运行的流程实例 id 

获取变量:

runtimeService.getVariable(executionId, variableName)

2.5.4 通过当前待办任务id设置

  通过此方法可以在流程实例未结束时任意设置流程变量。

TaskService taskService = processEngine.getTaskService(); 

      //设置单个 变量

      //第一个参数:taskId是当前待办任务id,在act_ru_task存在

      //第二个参数:变量名

      //第三个参数:变量值

      //activiti根据 任务id查询所属流程实例 id,存储act_ru_variable表。

      taskService.setVariable("2902", "price", 10000);

      //一次设置多个变量,第二个参数是map

      //taskService.setVariables(taskId, variables)

 

activiti根据 任务id查询所属流程实例 id,将流程变量值存储act_ru_variable表,不管使用什么任务id,找到流程实例 id相同就会覆盖原来的变量。

获取变量方法:

System.out.println(taskService.getVariable("3302", "price"));

3  全局变量测试

  什么时候设置流程变量?

采购流程中,在提交采购单时设置流程变量,因为提交采购单后采购单信息不再修改了。

使用完成提交采购单任务时设置流程变量。

// 完成任务时设置流程变量,使用pojo

         OrderCustom orderCustom = new OrderCustom();

         orderCustom.setPrice(10000f);

         Map<String, Object> varaibles = new HashMap<String, Object>();

         varaibles.put("order", orderCustom);

         taskService.complete(taskId, varaibles);

4  设置局部变量

4.1 在任务完成设置局部变量

  在任务完成时设置局部变量,任务完成后,后续结点无法使用局部变量。

 // 完成任务时设置流程变量,使用pojo

            OrderCustom orderCustom = new OrderCustom();

            orderCustom.setPrice(10000f);

            Map<String, Object> varaibles = new HashMap<String, Object>();

            varaibles.put("order", orderCustom);

            //设置局部变量

            taskService.setVariablesLocal(taskId, varaibles);

            //完成任务

            taskService.complete(taskId);

 当局部变量消失后,再使用该变量会报错。

4.2 查询历史任务时查询流程变量

//查询历史 任务查询流程变量

historicTaskInstanceQuery.includeTaskLocalVariables(); 

 //从activiti的流程变量取出pojo对象 ,经过反序列化

OrderCustom orderCustom = (OrderCustom) historicTaskInstance.getTaskLocalVariables().get("order");    

         System.out.println("历史 流程变量采购单信息:"+orderCustom.getPrice());

注意:使用流程变量不建议存储业务数据,因为通过activiti的api查询流程变量,特别是pojo变量,速度很慢。

流程变量要用于流程控制。

4.3 通过当前任务id设置变量

//通过当前任务id设置局部变量

   @Test

   public void setVariableByTaskId(){

      TaskService taskService = processEngine.getTaskService();

      //设置单个 局部变量

      taskService.setVariableLocal("5305", "price", 50000);

      //一次设置多个局部变量

      //taskService.setVariablesLocal(taskId, variables)

   }

注意:任务id为当前待办理的任务id。

4.4  流程变量数据表跟踪

SELECT * FROM act_ru_variable #当前流程变量表

记录当前流程实例使用的流程变量

Type_:变量类型

Name_:变量名称

Execution_id_:流程实例执行id(global和local变量存储)

Proc_inst_id_:流程实例 id(global和local变量存储)

Task_id_:流程变量所属的任务id(local变量存储)

BYTEARRAY_ID_:如果流程变量为pojo,字段存储引用act_ge_bytearray表的主键,在资源表act_ge_bytearray存储pojo流程变量的序列化信息。

Long_和text_:根据变量类型存储变量值

SELECT * FROM act_hi_varinst #历史 流程变量表

记录流程执行所创建的所有流程变量

5 案例1

5.1 需求

  员工创建采购单,由部门经理审核,部门经理审核通过后一万元以下由财务直接审核,一万元以上先由总经理审核,总经理审核通过再由财务审核。

5.2    流程定义

5.3    开发

采购流程中,在提交采购单时设置流程变量,因为提交采购单后采购单信息不再修改了。

使用完成提交采购单任务时设置流程变量。

修改提交 采购单service,在完成任务时设置流程变量。

修改orderService中saveOrderSubmitStauts提交采购单方法:

if (task != null) {

         // 说明assignee是该任务的办理人,有权限完成

         OrderCustom orderCustom = new OrderCustom();

         // 采购信息获取

         // 根据 任务对象 获取流程实例 id

         String processInstanceId = task.getProcessInstanceId();

         // 查询流程实例 对象

         ProcessInstance processInstance = runtimeService

                .createProcessInstanceQuery()

                .processInstanceId(processInstanceId).singleResult();

         // 从流程实例 对象 中获取businessKey

         String businessKey = processInstance.getBusinessKey();

         // 根据 businessKey查询采购单信息

         PurBusOrder purBusOrder = purBusOrderMapper.selectByPrimaryKey(businessKey);      

         BeanUtils.copyProperties(purBusOrder, orderCustom);      

         //流程变量,值 为orderCustom即采购单信息

         Map<String, Object> variables = new HashMap<String, Object>();

         variables.put("order", orderCustom);

         // 设置流程变量,值 为采购单信息

         taskService.complete(taskId,variables);

         // System.out.println("完成任务:" + taskId);

      }

6  案例2

6.1  需求

在上边的基础上添加审核不通过的连线。

需求如下:

在采购系统中实现流程审核不通过分支,功能如下:

1  部门经理审核不通过由员工重新修改采购单

2  总经理审核不通过由员工重新修改采购单再提交

3  财务审核不通过由员工重新审核

6.2   流程定义

6.2.1 对审核不通的由流程发起人再提交采购单

设置流程发起人:

在开始结点,设置initiator(发起人)。

设置创建采购单的任务负责人为:

修改orderService中的saveOrder方法,在启动流程时设置任务发起人:

注意:

任务发起人设置在启动流程实例之前设置。

6.2.2 增加审核不通过的连线

部门经理审核 :

 

审核通过candition:

${order.price>=10000 && firstAudit. status==’1’} 部门经理审核通过且采购金额大于等于10000元由总经理审核

${order.price<10000 && firstAudit. status==’1’}部门经理审核通过且采购金额小于10000元由财务审核

firstAudit和order都是流程变量名称

 

审核 不通过candition :

${ firstAudit. status==’0’}:部门经理审核不通过由流程发起人重新修改采购单再提交

 

总经理审核 :

审核通过candition:${ secondAudit. status==’1’} 总经理审核通过

审核 不通过candition : ${ secondAudit. status==’0’}总经理审核不通过

 

财务审核 :

审核通过candition:${ thirdAudit. status==’1’} 财务审核通过

审核 不通过candition : ${ third Audit. status==’0’}财务审核不通过 

注意:上边的firstAudit、secondAudit、thirdAudit分别存储三级审核信息。

6.3  开发

修改orderService中saveOrderSubmitStauts提交采购单方法:

if (task != null) {

         // 说明assignee是该任务的办理人,有权限完成

         OrderCustom orderCustom = new OrderCustom();

         // 采购信息获取

         // 根据 任务对象 获取流程实例 id

         String processInstanceId = task.getProcessInstanceId();

         // 查询流程实例 对象

         ProcessInstance processInstance = runtimeService

                .createProcessInstanceQuery()

                .processInstanceId(processInstanceId).singleResult();

         // 从流程实例 对象 中获取businessKey

         String businessKey = processInstance.getBusinessKey();

         // 根据 businessKey查询采购单信息       

         PurBusOrder purBusOrder = purBusOrderMapper.selectByPrimaryKey(businessKey);        

         BeanUtils.copyProperties(purBusOrder, orderCustom);       

         //流程变量,值 为orderCustom即采购单信息

         Map<String, Object> variables = new HashMap<String, Object>();

         variables.put("order", orderCustom);

         // 设置流程变量,值 为采购单信息

         taskService.complete(taskId,variables);

         // System.out.println("完成任务:" + taskId);

      }

 

修改 service中采购单审核方法:

设置流程变量:firstAudit、secondAudit、thirdAudit

 

if (task != null) {

         // 说明assignee是该任务的办理人,有权限完成

         Map<String,Object> variables = new HashMap<String,Object>();

         //根据 auditType判断是几级审核

         if(auditType.equals("firstAudit")){

            //部门经理审核

            variables.put("firstAudit", orderAuditCustom);

         }else if(auditType.equals("secondAudit")){

            //总经理审核

            variables.put("secondAudit", orderAuditCustom);

         }else if(auditType.equals("thirdAudit")){

            //财务审核

            variables.put("thirdAudit", orderAuditCustom);

         }

         //提交审核时,设置流程变量,变量值就是审核 信息

         taskService.complete(taskId,variables);

         // System.out.println("完成任务:" + taskId);

      }

 

7  Candidate-user候选人

7.1  什么是候选人

  采用固定分配方法给任务指定负责人,如果任务负责人出现变更,需要修改流程定义,就可以采用候选人分配方式,先给任务分配多个候选人,候选人通过拾取组任务进行个人任务办理。

给任务分配候选人,如果分配多个候选人中间使用半角逗号分隔。 

7.2  什么是组任务

多个候选人有资格完成该 任务,这个任务叫做组任务。

组任务具备条件:

         任务没有设置assignee任务负责人

         任务具有候选人 

7.3   候选人办理任务过程

第一步:给任务设置候选人(多个, 中间使用半角逗号分隔)

候选人是无法办理任务

第二步:候选人查询组任务

使用taskService查询,指定candidate候选人。

第三步:候选人拾取(claim)组任务

候选人拾取组任务后,该 候选人变为任务的负责人,该任务变为个人任务

如果候选人拾取组任务后,不想办理该 任务,可以将个人任务归还,该个人任务变为组任务 

第四步:查询待办个人任务

第五步:办理任务 

第六步:流程结束

7.4   Candidate-user办理任务api

7.4.1 候选人查询组任务

使用taskService指定candidateUser候选人查询组任务。

//任务查询对象

      TaskQuery taskQuery = taskService.createTaskQuery();     

      //候选人

      String candidateUser = "zhangsan";   

      taskQuery.taskCandidateUser(candidateUser);     

      //流程定义key

      String processDefinitionKey = "purchasingflow";     

      taskQuery.processDefinitionKey(processDefinitionKey);   

      List<Task> list = taskQuery.list();

注意:查询组任务,必须指定 candidateUser候选人,查询该候选人有资格办理的组任务。

7.4.2 拾取组任务

通过taskService,指定任务id和候选人拾取任务:

TaskService taskService = processEngine.getTaskService();   

      //组任务id

      String taskId = "5604";

      //任务候选人,claim拾取后该 候选人变为任务负责人

      String userId = "zhangsan";

      //任务拾取

      taskService.claim(taskId, userId);

注意:如果拾取人不是该任务的候选人也可以拾取成功,在拾取之前需要校验,该 候选人是否有资格拾取该 任务.

// 组任务id

      String taskId = "6004";

      // 任务候选人,claim拾取后该 候选人变为任务负责人

      String candidateUser = "zhangsan4"; 

      //根据候选人和组任务id查询,如果有记录说明该 候选人有资格拾取该 任务

      Task task = taskService.createTaskQuery().taskId(taskId)

            .taskCandidateUser(candidateUser).singleResult();     

      if(task!=null){

         // 任务拾取

         taskService.claim(taskId, candidateUser);       

         System.out.println("任务拾取成功");

      }

7.4.3 组任务归还

// 归还组任务,由个人任务变为组任务,还可以进行任务交接

   @Test

   public void setAssignee() {

      // 查询任务使用TaskService

      TaskService taskService = processEngine.getTaskService();

      // 当前待办任务

      String taskId = "6004";

      // 任务负责人

      String userId = "zhangsan2";   

      //校验userId是否是taskId的负责人,如果是负责人才可以归还组任务

      Task task = taskService.createTaskQuery().taskId(taskId).taskAssignee(userId).singleResult();    

      if(task!=null){

         //如果设置为null,归还组任务,该 任务没有负责人

         taskService.setAssignee(taskId, null);

      }         

   }

7.4.4 任务交接

任务负责人也可以将任务交给其它候选人办理该任务

代码如下:

@Test

   public void setAssigneeToCandidateUser() {

      // 查询任务使用TaskService

      TaskService taskService = processEngine.getTaskService();

      // 当前待办任务

      String taskId = "6004";

      // 任务负责人

      String userId = "zhangsan2"; 

      // 校验userId是否是taskId的负责人,如果是负责人才可以归还组任务

      Task task = taskService.createTaskQuery().taskId(taskId)

            .taskAssignee(userId).singleResult(); 

      if (task != null) {

         // 将此任务交给其它候选人办理该 任务

         String candidateuser = "zhangsan";

         // 根据候选人和组任务id查询,如果有记录说明该 候选人有资格拾取该 任务

         Task task2 = taskService.createTaskQuery().taskId(taskId)

                .taskCandidateUser(candidateuser).singleResult();

         if (task2 != null) {

            // 才可以交接

            taskService.setAssignee(taskId, candidateuser);

         }

      }

   }

8  Candidate-group候选组

8.1   什么候选组

  即使给任务指定了多个候选人,多个候选人都有办理任务资格,但是候选的人数有限,无法动态扩展,如果需要添加或删除候选,需要修改流程定义 文件,不利于系统 扩展。

采用候选组方式解决上边的问题。 

给任务设置候选组,在组中有多个用户并且可以动态扩展用户,组中的用户都是候选人,候选人先拾取组任务,将组任务变为自己的个人任务,进行个人任务办理。

8.2   候选组办理任务过程

第一步:Activiti会自动从候选组中找用户,将这些用户作为该 任务的候选人。 

下边的流程同候选人办理任务过程!!

第二步:给任务设置候选人(多个, 中间使用半角逗号分隔)

候选人是无法办理任务

第三步:候选人查询组任务

使用taskService查询,指定candidate候选人。

第四步:候选人拾取(claim)组任务

候选人拾取组任务后,该 候选人变为任务的负责人,该任务变为个人任务

如果候选人拾取组任务后,不想办理该 任务,可以将个人任务归还,该个人任务变为组任务

第五步:查询待办个人任务 

第六步:办理任务

第七步:流程结束

8.3  设置候选组

8.4  设置组和用户信息

Activiti中采用以下表记录组信息、用户信息、组和用户关系 信息

SELECT * FROM act_id_group #组信息 

SELECT * FROM act_id_user #用户信息

SELECT * FROM act_id_membership #组和用户关系信息

8.4.1 Api设置方法

以下设置的信息和业务系统的用户信息、角色信息保存一致。

先设置组信息

再设置用户信息

再设置组和用户关系信息

代码如下: 

//设置组和用户信息

   @Test

   public void setUserGroup(){   

      IdentityService identityService = processEngine.getIdentityService();   

      //设置组信息

      //添加之前应该校验组信息是否存在,不存在再进行添加

      if(identityService.createGroupQuery().groupId("10").singleResult()==null){

         //添加新组

         GroupEntity groupEntity = new GroupEntity();

         groupEntity.setId("10");

         groupEntity.setName("员工");

         identityService.saveGroup(groupEntity);

      }

      if(identityService.createGroupQuery().groupId("11").singleResult()==null){

         //添加新组

         GroupEntity groupEntity = new GroupEntity();

         groupEntity.setId("11");

         groupEntity.setName("部门经理");

         identityService.saveGroup(groupEntity);

      }

      if(identityService.createGroupQuery().groupId("12").singleResult()==null){

         //添加新组

         GroupEntity groupEntity = new GroupEntity();

         groupEntity.setId("12");

         groupEntity.setName("总经理");

         identityService.saveGroup(groupEntity);

      }

      if(identityService.createGroupQuery().groupId("13").singleResult()==null){

         //添加新组

         GroupEntity groupEntity = new GroupEntity();

         groupEntity.setId("13");

         groupEntity.setName("财务");

         identityService.saveGroup(groupEntity);

      }     

      //设置用户信息

      //添加之前应该校验用户信息是否存在,不存在再进行添加

      if(identityService.createUserQuery().userId("zhangsan").singleResult()==null){

         //添加新用户

         UserEntity userEntity = new UserEntity();

         userEntity.setId("zhangsan");

         userEntity.setFirstName("张三");

         identityService.saveUser(userEntity);

      }

      if(identityService.createUserQuery().userId("lisi").singleResult()==null){

         //添加新用户

         UserEntity userEntity = new UserEntity();

         userEntity.setId("lisi");

         userEntity.setFirstName("李四");

         identityService.saveUser(userEntity);

      }

      if(identityService.createUserQuery().userId("wangwu").singleResult()==null){

         //添加新用户

         UserEntity userEntity = new UserEntity();

         userEntity.setId("wangwu");

         userEntity.setFirstName("王五");

         identityService.saveUser(userEntity);

      }

      if(identityService.createUserQuery().userId("zhaoliu").singleResult()==null){

         //添加新用户

         UserEntity userEntity = new UserEntity();

         userEntity.setId("zhaoliu");

         userEntity.setFirstName("赵六");

         identityService.saveUser(userEntity);

      }    

      //设置用户和组的关系信息

      //采用先删除再添加

      identityService.deleteMembership("zhangsan", "10");

      identityService.createMembership("zhangsan", "10"); 

  

      identityService.deleteMembership("lisi", "11");

      identityService.createMembership("lisi", "11");

     

      identityService.deleteMembership("wangwu", "12");

      identityService.createMembership("wangwu", "12");

     

      identityService.deleteMembership("zhaoliu", "13");

      identityService.createMembership("zhaoliu", "13");

   }

 

8.4.2 与业务系统同步方法(常用)

方法1 :

数据库触发器方法

企业中在进行数据同步的常用方法,一般在一个数据库中采用此方法。

业务系统 用户表----》activiti的act_id_user

        在业务系统 用户表添加触发器:新增、删除、修改

注意:如果act_id_user有外键关系,需要先删除依赖关系。 

业务系统 角色表----》activiti的act_id_group

业务系统 角色和用户关系表—》activiti的act_id_membership

 

方法2 :

采用即时触发java程序。

 用户角色同步:

     在操作业务系统 用户角色表时执行以下操作:

业务系统添加角色-àactiviti添加角色

业务系统修改角色àactiviti修改角色

业务系统删除角色àactiviti删除角色,删除之前将用户角色关系表先删除(根据角色删除)

 

 用户信息同步

在操作业务系统 用户表时执行以下操作

业务系统添加用户----》activiti添加用户,添加用户与角色关系表

业务系统修改用户---》activiti修改用户,先删除原来用户与角色关系表,再添加用户与角色关系

业务系统删除用户—》activiti删除用户,删除之前将用户角色关系表删除(根据用户删除)

8.5  组任务办理过程api

8.5.1 设置组和用户信息

参考上边设置组和用户api

正式开发时,需要将业务系统 用户和角色信息同步到activiti中。

8.5.2 候选人查询组任务

参考candidate-user的api

注意:

在activiti的用户、组、用户和组关系表中随时添加数据,不受流程启动先后顺序影响。

9  网关

9.1   排他网关

9.1.1 什么排他网关

  排他网关用于决策,选择分支执行流程,分支上需要设置condition条件,如果分支的条件结果为true,那么该分支会通过排他网关。排他网关只会选择一条分支去执行。

9.1.2 定义方法

图标:

流程定义:

 

 

9.1.3 排他网关测试

第一步:流程定义部署

第二步:启动流程实例

  设置price流程变量值,因为price 在排他网关的两分支使用 

第三步:查询待办任务

      也可以在部门经理审核后设置price流程变量值,因为price 在排他网关的两分支使用

第四步:办理任务 

  如果分支上的条件都不满足,没有一条线经过排他网关,activiti会抛出异常:

org.activiti.engine.ActivitiException: No outgoing sequence flow of the exclusive gateway 'exclusivegateway1' could be selected for continuing the process at org.activiti.engine.impl.bpmn.behavior.ExclusiveGatewayActivityBehavior.leave(ExclusiveGatewayActivityBehavior.java:85) 

如果多条分支都满足,只会有一条线经过排他网关。

上边两种情况必须在开发避免!!!

9.2  并行网关

9.2.1 什么并行网关

  并行网关(parallelGateway),包括分支和汇聚两个结点,所有的分支不判断条件都经过分支结点,所有经过分支结点的分支都要进行汇聚,所有的分支全部执行完成,并行网关执行完成。

Fork(分支)

         所有的分支不判断条件都经过分支结点

Join(汇聚)

         所有经过分支结点的分支都要进行汇聚

分支的数量等于汇聚数量!

9.2.2 流程定义

图标:

 

 

 

注意:经过并行网关的分支结点,不需要设置condition条件。

9.2.3 并行网关测试

当流程执行到并行的分支结点时,

向act_ru_execution #流程实例执行表执行并行分支(结算,入库)

Execution表中8501的记录数等于分支数+1

只有一条记录的流程实例 id和流程实例执行id相等的,这一条为流程执行主线。

向当前任务表中插入两条记录(结算、入库)

9.3   包含网关

9.3.1 什么是包含网关

包含网关是排他网关和并行网关的结合体。

包含网关(IncluesiveGateway),包括分支和汇聚两个结点,经过分支结点需要判断条件,满足条件经过分支结点,所有经过分支结点的线边最终会进行汇聚。

Fork(分支)

         所有的分支需要判断条件,满足条件的经过分支结点

Join(汇聚)

         所有满足条件的分支都要进行汇聚

10   案例

10.1      需求

将采购流程改为组任务(使用候选组)实现 

在采购流程中实现排他网关

在采购流程中实现并行网关

 

需求描述:

员工创建采购单

经过部门经理审核

         审核通过:

部门经理审核通过,如果采购金额大于等于1万元,由总经理审核

部门经理审核通过,如果采购金额小于1万元,由财务审核

         审核不通过:

         部门经理审核不通过,由员工重新修改采购单进行提交

 

总经理审核

         总经理审核通过由财务审核通过

         总经理审核不通过,由员工重新修改采购单进行提交

 

财务审核

         财务审核通过并行执行财务结算和入库

         财务审核不通过,由员工重新修改采购单进行提交

 

财务结算和入库两个操作可以并行执行。

10.2   流程定义

部门经理审核通过后,通过排他网关决定走总经理审核还是财务审核。

财务审核通过后,经过并行网关,财务结算和入库并行执行。

 

审核分支设置condition 条件:

部门经理审核 :

 

审核通过candition:

${order.price>=10000 && firstAudit. status==’1’} 部门经理审核通过且采购金额大于等于10000元由总经理审核

${order.price<10000 && firstAudit. status==’1’}部门经理审核通过且采购金额小于10000元由财务审核

firstAudit和order都是流程变量名称

 

审核 不通过candition :

${ firstAudit. status==’0’}:部门经理审核不通过由流程发起人重新修改采购单再提交

 

总经理审核 :

审核通过candition:${ secondAudit. status==’1’} 总经理审核通过

审核 不通过candition : ${ secondAudit. status==’0’}总经理审核不通过

 

财务审核 :

审核通过candition:${ thirdAudit. status==’1’} 财务审核通过

审核 不通过candition : ${ third Audit. status==’0’}财务审核不通过

10.3  分析

10.3.1 需要开发结算和入库功能

真正的结算和入库很复杂,确定一个功能将流程向后推进一步。

为了教学方便,开发结算和入库功能实现activiti任务完成。

10.3.2 候选人查询组任务

由于任务结点改变  候选组方式分配任务,实现候选人查询组任务。

实现 方法:

调用taskService,指定candidateUser候选人查询组任务。

10.4   开发

接口功能:候选人查询组任务

接口参数:候选人candidateUserId,(实际开发需要查询条件)

接口实现 :

调用taskService,指定candidateUser候选人查询组任务

public List<OrderCustom> findOrderGroupTaskList(String userId)

         throws Exception {

      // 任务查询对象

      TaskQuery taskQuery = taskService.createTaskQuery();

 

      // 候选人,在act_id_user表中存在,从act_id_membership通过group_id_查询出用户

      String candidateUser = userId;

      // 指定候选人

      taskQuery.taskCandidateUser(candidateUser);

 

      // 流程定义key

      String processDefinitionKey = ResourcesUtil.getValue(

            "diagram.purchasingflow", "purchasingProcessDefinitionKey");

 

      taskQuery.processDefinitionKey(processDefinitionKey);

 

      List<Task> list = taskQuery.list();

 

      List<OrderCustom> orderList = new ArrayList<OrderCustom>();

      for (Task task : list) {

 

         OrderCustom orderCustom = new OrderCustom();

        

         //下边的代码同采购单处理列表代码...

        

         // 流程实例id

         String processInstanceId = task.getProcessInstanceId();

         // 根据流程实例id找到流程实例对象

         ProcessInstance processInstance = runtimeService

                .createProcessInstanceQuery()

                .processInstanceId(processInstanceId).singleResult();

         // 从流程实例对象中获取businessKey

         String businessKey = processInstance.getBusinessKey();

         // 根据businessKey查询业务系统

         // 采购单id

         String orderId = businessKey;

         PurBusOrder purBusOrder = purBusOrderMapper

                .selectByPrimaryKey(orderId);

         // 获取采购单名称、采购金额等采购单信息

         // 将purBusOrder内容拷贝到orderCustom

         BeanUtils.copyProperties(purBusOrder, orderCustom);

 

         // 下边向orderCustom开始设置任务信息

         // 任务id、任务标识 、任务名称

         // 任务id

         orderCustom.setTaskId(task.getId());

         // 任务标识

         orderCustom.setTaskDefinitionKey(task.getTaskDefinitionKey());

         // 任务名称

         orderCustom.setTaskName(task.getName());

 

 

         orderList.add(orderCustom);

      }

 

      return orderList;

   }

  

查询组任务方法:

代码基本上同采购单处理列表的代码:

 

// 采购单组任务列表

   @RequestMapping("/orderGroupTaskList")

   public String orderGroupTaskList(HttpSession session, Model model)

         throws Exception {

      // 当前登陆用户

      ActiveUser activeuser = UserUtil.getUserFromSession(session);

      // 用户id

      String userId = activeuser.getUserid();

      List<OrderCustom> list = orderService.findOrderGroupTaskList(userId);

 

      model.addAttribute("list", list);

 

      return "order/orderGroupTaskList";

   }

 

接口功能:拾取组任务

接口参数:taskId任务id,candidateUserId候选人

接口实现 :

         调用taskService,指定组任务id和candidateUserId候选人。

拾取任务之前需要校验候选人是否资格拾取该组任务。

 

 

 

@Override

   public void saveClaimTask(String taskId, String candidateUserId)

         throws Exception {

 

      // 根据候选人和组任务id查询,如果有记录说明该 候选人有资格拾取该 任务

      Task task = taskService.createTaskQuery().taskId(taskId)

            .taskCandidateUser(candidateUserId).singleResult();

 

      if (task != null) {

         // 任务拾取

         taskService.claim(taskId, candidateUserId);

 

         System.out.println("任务拾取成功");

      }

 

   }

 

拾取组任务方法:

需要从页面传入taskId组任务id.

 

// 拾取组任务

   @RequestMapping("/claimTask")

   public String claimTask(HttpSession session, String taskId)

         throws Exception {

      // 当前登陆用户

      ActiveUser activeuser = UserUtil.getUserFromSession(session);

      // 用户id

      String userId = activeuser.getUserid();

      orderService.saveClaimTask(taskId, userId);

     

      //返回采购单组任务列表

      return "redirect:orderGroupTaskList.action";

   }

 

 

修改组任务列表页面,添加“拾取组任务”连接:

 

1.2      测试

 

测试注意点:

1、组任务(使用候选组)

                   准备组和用户的数据,调用activiti的api设置组、用户、组和用户关系信息

         正式开发,将业务系统 用户角色数据实时同步到activiti中。

 

         2、测试组任务办理流程

                   a>查询组任务功能

                   b>拾取组任务功能

 

         3、测试排他网关

                   修改原来的功能是否存在bug。

4、测试并行网关

                   结算功能和入库功能是否并行执行.

 

11  总结

什么是工作流?

工作流是通过计算机自动管理业务流程,实现多个参与者按照预定义的流程自动执行业务流程。

 

什么是activiti?

Activiti是一个工作流的引擎(框架,jar、组件),对业务流程的自动化管理。Activiti按照bpmn2.0标准进行流程定义,按照定义流程(bpmn文件) 去自动执行业务流程。

 

 

第一步:线下进行流程定义

Activiti按照bpmn2.0标准进行流程定义,定义文件包括 .bpmn和.png,其中.bpmn是必须的文件。

第二步:进行流程定义部署

         将线下流程定义文件.bpmn部署到activiti的数据库中。这样activiti方可按照定义流程(bpmn文件) 去自动执行业务流程。

         两种方法部署方法:

1、  单个文件部署方法

2、  Zip包部署方法

建议使用单个文件 部署,建议一次部署只部署一个流程定义 。

第三步:启动一个流程 实例

 

流程定义和流程实例 的区别:

         流程定义 是一个静态文件(.bpmn),流程实例是动态的流程执行过程。如果要activiti去管理业务流程的执行,需要首先发起一个流程实例 。

 

第四步:查询待办任务

 

个人任务:

         通过固定设置方法或UEL表达式设置方法设置task结点的assignee属性。

 

组任务:

         通过设置多个候选人或多个候选组的方法。

组任务常用,组任务中以candidate-group候选组方式最常用。 

 

组任务办理过程:

         通过候选人查询任务

         拾取任务

同个人任务办理流程。

 

第五步:办理任务

 

         流程的执行可能需要通过流程变量决定执行分支。

         流程变量:

                   常用全局变量

                   需要在启动流程实例 或完成任务时设置流程变量

                   在UEL表达式中使用流程变量

 

         网关:

                   排他网关:

                            经过排他网关的分支只有一条。

                   并行网关:

                            经过并行网关分支结点所有分支不管条件是否满足都 会经过并行网关的汇聚结点。

            并行网关常用于会签任务(多个用户共同办理的任务)

        包含网关:

                            经过包含网关分支结点,只有满足条件的分支才经过包含网关的汇聚结点。

第六步:流程完成

                   所有结点完成执行完成,流程自动完成。

                   注意:如果使用并行网关或包含网关,必须经过分支的流程全部执行完成才能到达汇聚结点,并行网关或包含风关就结束。

展开阅读全文

没有更多推荐了,返回首页