activiti-流程变量
文章目录
- 二、流程变量
- 1、什么是流程变量
- 2、流程变量类型
- 3、流程变量作用域
- 3.1、globa变量
- 3.2、local变量
- 4、流程变量的使用方法
- 4.1、在属性上使用UEL表达式
- 4.2、在连线上使用UEL表达式
- 5、使用Global变量控制流程
- 5.1、需求
- 5.2、流程定义
- 5.3、设置global流程变量
- 5.3.1、创建POJO对象
- 5.3.2、启动流程时设置变量
- 5.3.2、任务办理时设置变量
- 5.3.3、通过当前流程实例设置
- 5.3.4、通过当前任务设置
- 5.4、测试
- 5.6、操作数据库表
- 6、设置local流程变量
- 6.1、任务办理时设置
- 6.2、通过当前任务设置
- 6.3、 Local变量测试1
- 6.4、 Local变量测试2
以下内容均为黑马课程的学习笔记
视频链接: https://www.bilibili.com/video/BV1H54y167gf?p=106&spm_id_from=333.337.top_right_bar_window_history.content.click
二、流程变量
1、什么是流程变量
流程变量在 activiti 中是一个非常重要的角色,流程运转有时需要靠流程变量,业务系统和 activiti
结合时少不了流程变量,流程变量就是 activiti 在管理工作流时根据管理需要而设置的变量。
比如:在出差申请流程流转时如果出差天数大于 3 天则由总经理审核,否则由人事直接审核, 出差天
数就可以设置为流程变量,在流程流转时使用。
注意:虽然流程变量中可以存储业务数据可以通过activiti的api查询流程变量从而实现 查询业务数据,但是不建议这样使用,因为业务数据查询由业务系统负责,activiti设置流程变量是为了流程执行需要而创建。
2、流程变量类型
如果将 pojo 存储到流程变量中,必须实现序列化接口 serializable,为了防止由于新增字段无
法反序列化,需要生成 serialVersionUID。
3、流程变量作用域
流程变量的作用域可以是一个流程实例(processInstance),或一个任务(task),或一个执行实例
(execution)
3.1、globa变量
流程变量的默认作用域是流程实例。当一个流程变量的作用域为流程实例时,可以称为 global 变量
注意:
如: Global变量:userId(变量名)、zhangsan(变量值)
global 变量中变量名不允许重复,设置相同名称的变量,后设置的值会覆盖前设置的变量值。
3.2、local变量
任务和执行实例仅仅是针对一个任务和一个执行实例范围,范围没有流程实例大, 称为 local 变量。
Local 变量由于在不同的任务或不同的执行实例中,作用域互不影响,变量名可以相同没有影响。Local 变量名也可以和 global 变量名相同,没有影响。
4、流程变量的使用方法
4.1、在属性上使用UEL表达式
可以在 assignee 处设置 UEL 表达式,表达式的值为任务的负责人,比如: ${assignee}, assignee 就是一个流程变量名称。
Activiti获取UEL表达式的值,即流程变量assignee的值 ,将assignee的值作为任务的负责人进行任务分配
4.2、在连线上使用UEL表达式
可以在连线上设置UEL表达式,决定流程走向。
比如:${price<10000} 。price就是一个流程变量名称,uel表达式结果类型为布尔类型。
如果UEL表达式是true,要决定 流程执行走向。
5、使用Global变量控制流程
5.1、需求
员工创建出差申请单,由部门经理审核,部门经理审核通过后出差3天及以下由人财务直接审批,3天以上先由总经理审核,总经理审核通过再由财务审批。
5.2、流程定义
1)、出差天数大于等于3连线条件
也可以使用对象参数命名,如evection.num:
2)、出差天数小于3连线条件
也可以使用对象参数命名,如:
5.3、设置global流程变量
在部门经理审核前设置流程变量,变量值为出差单信息(包括出差天数),部门经理审核后可以根据流程变量的值决定流程走向。
在设置流程变量时,可以在启动流程时设置,也可以在任务办理时设置
5.3.1、创建POJO对象
创建出差申请pojo对象
package com.itheima.demo.pojo;import java.io.Serializable;
import java.util.Date;/*** 出差申请 pojo*/
public class Evection implements Serializable {/*** 主键id*/private Long id;/*** 出差申请单名称*/private String evectionName;/*** 出差天数*/private Double num;/*** 预计开始时间*/private Date beginDate;/*** 预计结束时间*/private Date endDate;/*** 目的地*/private String destination;/*** 出差事由*/private String reson;public Long getId() {return id;}public void setId(Long id) {this.id = id;}public String getEvectionName() {return evectionName;}public void setEvectionName(String evectionName) {this.evectionName = evectionName;}public Date getBeginDate() {return beginDate;}public void setBeginDate(Date beginDate) {this.beginDate = beginDate;}public Date getEndDate() {return endDate;}public void setEndDate(Date endDate) {this.endDate = endDate;}public String getDestination() {return destination;}public void setDestination(String destination) {this.destination = destination;}public String getReson() {return reson;}public void setReson(String reson) {this.reson = reson;}public Double getNum() {return num;}public void setNum(Double num) {this.num = num;}
}
5.3.2、启动流程时设置变量
在启动流程时设置流程变量,变量的作用域是整个流程实例。
通过Map<key,value>设置流程变量,map中可以设置多个变量,这个key就是流程变量的名字。
/*** 启动流程实例,设置流程变量的值*/@Testpublic void startProcess(){// 获取流程引擎ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
// 获取RunTimeServiceRuntimeService runtimeService = processEngine.getRuntimeService();
// 流程定义keyString key = "myEvection2";
// 创建变量集合Map<String, Object> map = new HashMap<>();
// 创建出差pojo对象Evection evection = new Evection();
// 设置出差天数evection.setNum(2d);
// 定义流程变量,把出差pojo对象放入mapmap.put("evection",evection);
// 设置assignee的取值,用户可以在界面上设置流程的执行map.put("assignee0","张三");map.put("assignee1","李经理");map.put("assignee2","王总经理");map.put("assignee3","赵财务");
// 启动流程实例,并设置流程变量的值(把map传入)ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(key, map);
// 输出System.out.println("流程实例名称="+processInstance.getName());System.out.println("流程定义id=="+processInstance.getProcessDefinitionId());}/*** 完成任务,判断当前用户是否有权限*/@Testpublic void completTask() {//任务idString key = "myEvection2";
// 任务负责人String assingee = "张三";//获取processEngineProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();// 创建TaskServiceTaskService taskService = processEngine.getTaskService();
// 完成任务前,需要校验该负责人可以完成当前任务
// 校验方法:
// 根据任务id和任务负责人查询当前任务,如果查到该用户有权限,就完成Task task = taskService.createTaskQuery().processDefinitionKey(key).taskAssignee(assingee).singleResult();if(task != null){taskService.complete(task.getId());System.out.println("任务执行完成");}}
说明:
startProcessInstanceByKey(processDefinitionKey, variables)
流程变量作用域是一个流程实例,流程变量使用Map存储,同一个流程实例设置变量map中key相同,后者覆盖前者。
5.3.2、任务办理时设置变量
在完成任务时设置流程变量,该流程变量只有在该任务完成后其它结点才可使用该变量,它的作用域是整个流程实例,如果设置的流程变量的key在流程实例中已存在相同的名字则后设置的变量替换前边设置的变量。
这里需要在创建出差单任务完成时设置流程变量
/*** 完成任务,判断当前用户是否有权限*/@Testpublic void completTask() {//任务idString key = "myEvection2";
// 任务负责人String assingee = "张三";
// 获取processEngineProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
// 创建TaskServiceTaskService taskService = processEngine.getTaskService();
// 创建变量集合Map<String, Object> map = new HashMap<>();
// 创建出差pojo对象Evection evection = new Evection();
// 设置出差天数evection.setNum(2d);
// 定义流程变量map.put("evection",evection);
// 完成任务前,需要校验该负责人可以完成当前任务
// 校验方法:
// 根据任务id和任务负责人查询当前任务,如果查到该用户有权限,就完成Task task = taskService.createTaskQuery().processDefinitionKey(key).taskAssignee(assingee).singleResult();if(task != null){//完成任务是,设置流程变量的值taskService.complete(task.getId(),map);System.out.println("任务执行完成");}}
说明:
通过当前任务设置流程变量,需要指定当前任务id,如果当前执行的任务id不存在则抛出异常。
任务办理时也是通过map<key,value>设置流程变量,一次可以设置多个变量。
5.3.3、通过当前流程实例设置
通过流程实例id设置全局变量,该流程实例必须未执行完成。
@Testpublic void setGlobalVariableByExecutionId(){// 当前流程实例执行 id,通常设置为当前执行的流程实例String executionId="2601";
// 获取processEngineProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
// 获取RuntimeServiceRuntimeService runtimeService = processEngine.getRuntimeService();
// 创建出差pojo对象Evection evection = new Evection();
// 设置天数evection.setNum(3d);
// 通过流程实例 id设置流程变量runtimeService.setVariable(executionId, "evection", evection);
// 一次设置多个值
// runtimeService.setVariables(executionId, variables)}
注意:
executionId必须当前未结束 流程实例的执行id,通常此id设置流程实例 的id。也可以通runtimeService.getVariable()获取流程变量。
5.3.4、通过当前任务设置
@Testpublic void setGlobalVariableByTaskId(){//当前待办任务idString taskId="1404";
// 获取processEngineProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();TaskService taskService = processEngine.getTaskService();Evection evection = new Evection();evection.setNum(3);//通过任务设置流程变量taskService.setVariable(taskId, "evection", evection);//一次设置多个值 //taskService.setVariables(taskId, variables)}
注意:
任务id必须是当前待办任务id,act_ru_task中存在。如果该任务已结束,会报错
也可以通过taskService.getVariable()获取流程变量。
5.4、测试
正常测试:
设置流程变量的值大于等于3天
设计流程变量的值小于3天
异常测试:
流程变量不存在
流程变量的值为空NULL,price属性为空
UEL表达式都不符合条件
不设置连线的条件
####5.5、注意事项
1、 如果UEL表达式中流程变量名不存在则报错。
2、 如果UEL表达式中流程变量值为空NULL,流程不按UEL表达式去执行,而流程结束 。
3、 如果UEL表达式都不符合条件,流程结束
4、 如果连线不设置条件,会走flow序号小的那条线
5.6、操作数据库表
设置流程变量会在当前执行流程变量表插入记录,同时也会在历史流程变量表也插入记录。
//当前流程变量表
SELECT * FROM act_ru_variable
记录当前运行流程实例可使用的流程变量,包括 global和local变量
Id_:主键
Type_:变量类型
Name_:变量名称
Execution_id_:所属流程实例执行id,global和local变量都存储
Proc_inst_id_:所属流程实例id,global和local变量都存储
Task_id_:所属任务id,local变量存储
Bytearray_:serializable类型变量存储对应act_ge_bytearray表的id
Double_:double类型变量值
Long_:long类型变量值
Text_:text类型变量值
#历史流程变量表
SELECT * FROM act_hi_varinst
记录所有已创建的流程变量,包括 global和local变量
字段意义参考当前流程变量表。
6、设置local流程变量
6.1、任务办理时设置
任务办理时设置local流程变量,当前运行的流程实例只能在该任务结束前使用,任务结束该变量无法在当前流程实例使用,可以通过查询历史任务查询。
/*
*处理任务时设置local流程变量
*/
@Test
public void completTask() {//任务idString taskId = "1404";
// 获取processEngineProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();TaskService taskService = processEngine.getTaskService();
// 定义流程变量Map<String, Object> variables = new HashMap<String, Object>();Evection evection = new Evection ();evection.setNum(3d);
// 定义流程变量Map<String, Object> variables = new HashMap<String, Object>();
// 变量名是holiday,变量值是holiday对象variables.put("evection", evection);
// 设置local变量,作用域为该任务taskService.setVariablesLocal(taskId, variables);
// 完成任务taskService.complete(taskId);
}
说明:
设置作用域为任务的local变量,每个任务可以设置同名的变量,互不影响。
6.2、通过当前任务设置
@Test
public void setLocalVariableByTaskId(){// 当前待办任务idString taskId="1404";
// 获取processEngineProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();TaskService taskService = processEngine.getTaskService();Evection evection = new Evection ();evection.setNum(3d);
// 通过任务设置流程变量taskService.setVariableLocal(taskId, "evection", evection);
// 一次设置多个值 //taskService.setVariablesLocal(taskId, variables)
}
注意:
任务id必须是当前待办任务id,act_ru_task中存在。
6.3、 Local变量测试1
如果上边例子中设置global变量改为设置local变量是否可行?为什么?
Local变量在任务结束后无法在当前流程实例执行中使用,如果后续的流程执行需要用到此变量则会报错。
6.4、 Local变量测试2
在部门经理审核、总经理审核、财务审核时设置local变量,可通过historyService查询每个历史任务时将流程变量的值也查询出来。
代码如下:
// 创建历史任务查询对象HistoricTaskInstanceQuery historicTaskInstanceQuery = historyService.createHistoricTaskInstanceQuery();// 查询结果包括 local变量historicTaskInstanceQuery.includeTaskLocalVariables();
for (HistoricTaskInstance historicTaskInstance : list) {System.out.println("==============================");System.out.println("任务id:" + historicTaskInstance.getId());System.out.println("任务名称:" + historicTaskInstance.getName());System.out.println("任务负责人:" + historicTaskInstance.getAssignee());System.out.println("任务local变量:"+ historicTaskInstance.getTaskLocalVariables());}
注意:查询历史流程变量,特别是查询pojo变量需要经过反序列化,不推荐使用。
activiti-流程变量相关推荐
- Activiti——流程变量(六)
Activiti--流程变量 转自:http://lib.csdn.net/article/java/66665?knId=268 流程变量在整个工作流中扮演很重要的作用.例如:请假流程中有请假天数. ...
- activiti流程变量
import org.activiti.engine.*; import org.activiti.engine.repository.Deployment; import org.activiti. ...
- 学习笔记之-Activiti7工作流引擎,概述,环境搭建,类关系图,使用Activiti BPMN visualizer,流程变量,组任务 网关,Activiti整合Spring SpringBoot
本篇学习笔记是观看黑马程序员Activiti7视频而得 Activiti7 一.工作流介绍 1.1 概念 工作流(Workflow),就是通过计算机对业务流程自动化执行管理.它主要解决的是" ...
- 【activiti】流程变量
activiti流程变量 1. 什么是流程变量 流程变量在activiti中是一个非常重要的角色,流程运转有时就需要流程变量,流程变量就是activiti在管理工作流时根据管理需要而设置的变量. 前面 ...
- Activiti工作流之流程变量
1.什么是流程变量 流程变量在 activiti 中是一个非常重要的角色,流程运转有时需要靠流程变量,业务系统和 activiti 结合时少不了流程变量,流程变量就是 activiti 在管理工作流时 ...
- Activiti第二篇【管理流程定义、执行任务和流程实例、流程变量】
tags: Activiti 上篇Activiti只是一个快速入门案例,这篇就讲定义.部署.查看任务等等的一些细节[涉及到的数据库表.对象等等]... 管理流程定义 管理流程定义主要涉及到以下的4张表 ...
- Activiti工作流(三)——流程变量
流程变量可以是流程中一系列参数,比如办理人(Assignee),消息(message)等.这些流程变量使得activiti能够应用于更为复杂的业务中,使得流程变得更加灵活可控. 场景(一) 图一:没有 ...
- 《Activiti/Flowable 深入BPM工作流》-什么是流程变量?
<Activiti/Flowable 深入BPM工作流>-什么是流程变量? 一. 问题: 1. 什么是流程变量? 2. 什么是glob ...
- flowable工作流 流程变量_业务流程 BPM、工作流引擎、Flowable、Activiti
特点 基于 Flowable(Activiti)生来具有的稳定工作流引擎 支持在线流程设计器,流程导入导出,符合 BPMN 规范,中国式工作流 支持流程办理.退回.自由流.会签.并行.串行.服务任务等 ...
- 《Activiti/Flowable 深入BPM工作流》-如何设置local流程变量?
<Activiti/Flowable 深入BPM工作流>-如何设置local流程变量? 一. 问题: 1. 什么是local流程变量? 2. 如何设置local流程变量? ...
最新文章
- databinding学习(1)
- 解决Latex图片或者表格浮动
- vue -resource 文件提交提示process,或者拦截处理
- [转]Hadoop集群_WordCount运行详解--MapReduce编程模型
- pluto实现分析(22)
- git 怎么还原历史版本_4. Git--修改/回退等操作
- centos7.3 mysql5.7_CentOS7.3 yum install MySQL5.7
- 新的“钉子户”来了!一加9RT将于10月13日正式亮相
- 2022年工作室暑期培训
- 搜狗拼音输入法2015 v7.5 官方版​
- 【C++要笑着学】类的默认成员函数详解 | 构造函数 | 析构函数 | 构造拷贝函数
- 关于CS找实习的不完整经验
- 工作日志(部门管理)
- 献给那些没有自信的人。
- [置顶] 我读《海底两万里》
- AI英雄出少年!奔赴星辰,他们正在创造黄金时代
- 图像语义分割入门:FCN/U-Net网络解析
- 电子设计教程17:从共射极放大电路到射极跟随电路
- java阶段七容器集合之Map------练习2
- OpenHarmony轻量系统 子系统,组件那点事
热门文章
- 在Windows中开启Wifi热点共享,无需第三方工具
- 树袋熊无线网络打印服务器,2大1小完美澳洲自驾之旅(第九天:树袋熊之旅)—2013完整版(社区系统故障更新中)...
- spring边边角角
- Intel 11代 CPU 更新Win 10 20H2 后显示问题
- OpenLayers 彻底清除测量图层Overlays
- tensorflow 自定义向量外积
- 不懂批判性思维,可能正在限制你的程序员生涯!
- 面试题:寻找一个字符串中出现次数最多的字符以及出现的次数
- c++找出1000以内的完数
- 基于python的入侵检测系统毕设_基于时空特征融合的入侵检测系统模型