Activiti(6)-流程实例、任务的执行

1、流程图

    

2、部署流程定义

    

        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
	
	/**部署流程定义(从zip)*/
	@Test
	public void deploymentProcessDefinition_zip(){
		InputStream in = this.getClass().getClassLoader().getResourceAsStream("diagrams/helloworld.zip");
		ZipInputStream zipInputStream = new ZipInputStream(in);
		Deployment deployment = processEngine.getRepositoryService()//与流程定义和部署对象相关的Service
						.createDeployment()//创建一个部署对象
						.name("流程定义")//添加部署的名称
						.addZipInputStream(zipInputStream)//指定zip格式的文件完成部署
						.deploy();//完成部署
		System.out.println("部署ID:"+deployment.getId());//
		System.out.println("部署名称:"+deployment.getName());//
	}
	

3、启动流程实例

    

/**启动流程实例
   当流程到达一个节点时,会在act_ru_execution表中产生1条数据
   如果当前节点时用户任务节点,这时会在acu_ru_task表中产生1条数据(任务的办理人、任务的创建时间)

 */
	@Test
	public void startProcessInstance(){
		//按照流程定义的id启动:myProcess:2:604
		//runtimeService.startProcessInstanceById(processDefinitionId)
		//通过流程定义的key启动流程,会启动版本更高的流程
		//流程定义的key
		String processDefinitionKey = "helloworld";
		ProcessInstance pi = processEngine.getRuntimeService()//与正在执行的流程实例和执行对象相关的Service
						.startProcessInstanceByKey(processDefinitionKey);//使用流程定义的key启动流程实例,key对应helloworld.bpmn文件中id的属性值,使用key值启动,默认是按照最新版本的流程定义启动
		System.out.println("流程实例ID:"+pi.getId());//流程实例ID    101
		System.out.println("流程定义ID:"+pi.getProcessDefinitionId());//流程定义ID   helloworld:1:4
	}

说明:

操作数据库的act_ru_execution表,如果是用户任务节点,同时也会在

act_ru_task添加一条记录

4、查询我的个人任务

    

	/**查询当前人的个人任务*/
	@Test
	public void findMyPersonalTask(){
		String assignee = "王五";
		List<Task> list = processEngine.getTaskService()//与正在执行的任务管理相关的Service
						.createTaskQuery()//创建任务查询对象
						/**查询条件(where部分)*/
						.taskAssignee(assignee)//指定个人任务查询,指定办理人
//						.taskCandidateUser(candidateUser)//组任务的办理人查询
//						.processDefinitionId(processDefinitionId)//使用流程定义ID查询
//						.processInstanceId(processInstanceId)//使用流程实例ID查询
//						.executionId(executionId)//使用执行对象ID查询
						/**排序*/
						.orderByTaskCreateTime().asc()//使用创建时间的升序排列
						/**返回结果集*/
//						.singleResult()//返回惟一结果集
//						.count()//返回结果集的数量
//						.listPage(firstResult, maxResults);//分页查询
						.list();//返回列表
		if(list!=null && list.size()>0){
			for(Task task:list){
				System.out.println("任务ID:"+task.getId());
				System.out.println("任务名称:"+task.getName());
				System.out.println("任务的创建时间:"+task.getCreateTime());
				System.out.println("任务的办理人:"+task.getAssignee());
				System.out.println("流程实例ID:"+task.getProcessInstanceId());
				System.out.println("执行对象ID:"+task.getExecutionId());
				System.out.println("流程定义ID:"+task.getProcessDefinitionId());
				System.out.println("########################################################");
			}
		}
	}
	

说明:

1)    因为是任务查询,所以从processEngine中应该得到TaskService。
2)    使用TaskService获取到任务查询对象TaskQuery。
3)    为查询对象添加查询过滤条件,使用taskAssignee指定任务的办理者(即查询指定用户的代办任务),同时可以添加分页排序 等过滤条件。
4    )调用list方法执行查询,返回办理者为指定用户的任务列表。
5)    任务ID、名称、办理人、创建时间可以从act_ru_task表中查到。
6)    Execution与ProcessInstance见5.6和5.7章节的介绍。在这种情况下,ProcessInstance相当于Execution。
7)    如果assignee属性为部门经理,结果为空。因为现在流程只到了”填写请假申请”阶段,后面的任务还没有执行,即在数据库中没有部门经理可以办理的任务,所以查询不到。
8)    一个Task节点和Execution节点是1对1的情况,在task对象中使用Execution_来表示他们之间的关系。
9)    任务ID在数据库表act_ru_task中对应“ID_”列。


附加:
    在activiti任务中,主要分为两大类查询任务(个人任务和组任务):
1.    确切指定了办理者的任务,这个任务将成为指定者的私有任务,即个人任务。
2.    无法指定具体的某一个人来办理的任务,可以把任务分配给几个人或者一到 多个小组,让这个范围内的用户可以选择性(如有空余时间时)来办理这类任务,即组任务。
    先知道个人任务的查询和办理,组任务的操作后面讲


5、办理任务

        /**完成我的任务*/
	@Test
	public void completeMyPersonalTask(){
		//任务ID
		String taskId = "1202";
		processEngine.getTaskService()//与正在执行的任务管理相关的Service
					.complete(taskId);
		System.out.println("完成任务:任务ID:"+taskId);
	}

说明:

1) 是办理任务,所以从ProcessEngine得到的是TaskService。
2) 当执行完这段代码,再以员工的身份去执行查询的时候,会发现这个时候已经没有数据了,因为正在执行的任务中没有数据。
3) 对于执行完的任务,activiti将从act_ru_task表中删除该任务,下一个任务会被插入进来。
4) 以”部门经理”的身份进行查询,可以查到结果。因为流程执行到部门经理审批这个节点了。
5) 再执行办理任务代码,执行完以后以”部门经理”身份进行查询,没有结果。

6) 重复第3和4步直到流程执行完。

6、查询流程状态(判断流程正在执行,还是结束)

    /**查询流程状态(判断流程正在执行,还是结束)*/
	@Test
	public void isProcessEnd(){
		String processInstanceId = "1001";
		ProcessInstance pi = processEngine.getRuntimeService()//表示正在执行的流程实例和执行对象
						.createProcessInstanceQuery()//创建流程实例查询
						.processInstanceId(processInstanceId)//使用流程实例ID查询
						.singleResult();
		if(pi==null){
			System.out.println("流程已经结束");
		}
		else{
			System.out.println("流程没有结束");
		}
	}

             在流程执行的过程中,创建的流程实例ID在整个过程中都不会变,当流程结束后,流程实例将会在正在执行的执行对象表中(act_ru_execution)被删除

说明:
1) 因为是查询流程实例,所以先获取runtimeService。
2) 创建流程实例查询对象,设置实例ID过滤参数。
3) 由于一个流程实例ID只对应一个实例,使用singleResult执行查询返回一个唯一的结果,如果结果数量大于1,则抛出异常。

4) 判断指定ID的实例是否存在,如果结果为空,则代表流程结束,实例在正在执行的执行对象表中已被删除,转换成历史数据。


7、附加功能:查询历史任务(后面说)

    

        /**查询历史任务(后面讲)*/
	@Test
	public void findHistoryTask(){
		String taskAssignee = "张三";
		List<HistoricTaskInstance> list = processEngine.getHistoryService()//与历史数据(历史表)相关的Service
						.createHistoricTaskInstanceQuery()//创建历史任务实例查询
						.taskAssignee(taskAssignee)//指定历史任务的办理人
						.list();
		if(list!=null && list.size()>0){
			for(HistoricTaskInstance hti:list){
				System.out.println(hti.getId()+"    "+hti.getName()+"    "+hti.getProcessInstanceId()+"   "+hti.getStartTime()+"   "+hti.getEndTime()+"   "+hti.getDurationInMillis());
				System.out.println("################################");
			}
		}
	}

8、附加功能:查询历史流程实例(后面讲)

        
        /**查询历史流程实例(后面讲)*/
	@Test
	public void findHistoryProcessInstance(){
		String processInstanceId = "1001";
		HistoricProcessInstance hpi = processEngine.getHistoryService()//与历史数据(历史表)相关的Service
						.createHistoricProcessInstanceQuery()//创建历史流程实例查询
						.processInstanceId(processInstanceId)//使用流程实例ID查询
						.singleResult();
		System.out.println(hpi.getId()+"    "+hpi.getProcessDefinitionId()+"    "+hpi.getStartTime()+"    "+hpi.getEndTime()+"     "+hpi.getDurationInMillis());
	}

9、总结

 Execution   执行对象
     按流程定义的规则执行一次的过程.
 对应的表:
      act_ru_execution: 正在执行的信息
      act_hi_procinst:已经执行完的历史流程实例信息
      act_hi_actinst:存放历史所有完成的活动
ProcessInstance  流程实例
     特指流程从开始到结束的那个最大的执行分支,一个执行的流程中,流程实例只有1个。

注意
    (1)如果是单例流程,执行对象ID就是流程实例ID
    (2)如果一个流程有分支和聚合,那么执行对象ID和流程实例ID就不相同
    (3)一个流程中,流程实例只有1个,执行对象可以存在多个。


Task 任务

         执行到某任务环节时生成的任务信息。
 对应的表:
      act_ru_task:正在执行的任务信息
      act_hi_taskinst:已经执行完的历史任务信息

猜你喜欢

转载自blog.csdn.net/qq_31784189/article/details/80873259