Activiti界面元素的使用总结
一、图形设计中元素的使用
1、SequenceFlow:连接线，可以连接两个任务，来管理流程实例的流向
-----General
-----id:流程的id,用与程序内部识别
-----name流程的名字，用于用户显示识别
-----Main config
-----Label width：组件的大小，自动
-----Condition:执行该流程的条件，可以通过#{}或${}结合流程变量来 实现
-----Listeners:通过类来控制流程的执行,该来要实现TaskListener接 口，并重写notify（）方法，把要传入的参数传进去。
2、UserTask:个人任务
----General:当前任务
----id:用于程序内部标示当前任务
-----name:任务名称：用于在视图上显示当前任务描述
----Main config
----Assignee:指定单个办理人（有三种方法）
方法一：直接指定，输入办理人即可
方法二：通过流程变量指定办理人（使用#{}或${}获取流程实例启动 时，通过
.startProcessInstanceByKey(processDefinitionKey,variables)
流程变量传入的值）
方法三：通过类来指定办理人（在该属性下不加任何指定，在Listeners 下指定相关的类，与连接线中的listeners相似）
delegateTask.setAssignee("指定办理人"
----Candidate user(comma separated):指定组任务（三种方式）
方法一：直接指定，如：小a,小b,小c,小d
可以在程序中通过
taskService.addCandidateUser("taskId","userId")添加组成员
.deleteCandidateUser("taskId","userId")删除组成员
.claim("taskId","userId");拾取任务，将组任务分配 给个人任务
.claim("taskId"，null);将个人任务退回到组任务（之 前必须是组任务）
方法二：通过流程变量分配（同个人任务分配一样）
如：variables.put("userIDs","大大,中中,小小");
方法三：通过类来分配（同个人任务分配一样）,只是在方法内部调 用的是：delegateTas.addCandidateUser()
或者.addCandidateUsers()方法
----Candidate groups(comma separated):指定组任务分配给角色
可以在流程发布时，设定相应的角色和用户
添加角色：identityService.saveGroup(new GroupEntity(groupId));
添加用户：identityService.saveUser(new UserEntity(userId))；
添加两者间的关系：
identityService.createMembership(userId,groupId)
----Form
----Form key:表单id，用于程序内部识别（表单链接）
表单的三种方式：
方法一：（动态表单）
在Form属性中指定各个字段
方法二：（外置表单）
在Main config属性中的Form key字段中指定.form文件的路径
方法三：（普通表单）
在Main config属性中的Form key字段中指定存放表单的页面 (jsp,html,jsf等)
----Listeners:
----Task listeners:任务监听，在流程启动时，把流程变量，通过TaskListener接 口的实现类中的notify方式添加进去
----event :
-----create：创建任务，并设置所有属性后触发
----assignment:任务分配给办理人时触发，在create事件之前
----complete：任务完成，且尚未从数据库中删除时触发
----delete：只在任务删除之前触发。（正常完成时也会触发）
----Execution listeners:执行监听器，在任务执行时，调用ExecutionListener接 口的实现类中的notify方法
----event:对于连续：只能是take(因为连续只能触发take事件，默认该属 性会被忽略)
对于其他组件：（start 和end）
----start:事件开始前调用
----end：事件结束后调用
----Multi instance:
----Sequential:
-----yes:串行（多个人要按照list集合中的顺序依次完成任务）
----no:并行（多个人是同级关系，没有先后，可以同时完成各自的 任务）
----Loop cardinality:产生的实例个数（不能超过list集合的元素个数）
----Collection:#{users}接收任务的人员列表，可以在启动流程实例时进行初 始化流程变量users
例：String [] users={“大大”,”中中”,”小小”};
Map<String,Object> variables=new HashMap<String,Object>();
Variables.put(“users”,Arrays.asList(users));
.startProcessInstanceByKey(processDefintionKey,variables);
----Element variable:办理人的环境变量
例：如果在assignment:中指定为#{user},则该项应为user
----Completion condition:完成条件
可以根据以下三个变量进行设置
nrOfInstances:实例总数
nrOfActiveInstances:当前还没有完成的实例
nrOfCompleteInstances:已经完成的实例个数
3、ExclusiveGateway:排他网关
根据不同的条件执行不同的流程分支（每次只能执行一个流程分支）
----General:(id，name和其他组件意义相同)
----Default flow:默认执行的流程分支，值为默认流程连接线的id
4、ParallelGateway:并行网关
可以同时执行多个流程分支
InclusiveGateway:包含网关
可以同时分支出多个流程分支（与并行网关一样），和并行网关的区别就在于在分支流线上如果定义了条件，并行网关会忽略，而包含网关会进行相应的解析。
5、ReceiveTask:手动接收任务
执行到流程中的某个节点后就暂停执行，指定收到外部的信号后才会继续执行
通过调用runtimeService.signal(executionId);方法，使流程继续向下执行。
6、ScriptTask:脚本任务
可以执行一段脚本，可以在脚本中定义或修改变量，来控制流程的流转。
脚本中添加的变量可以再整个流程中使用。execution.setVariable(“变量名”,变量值)
7、ServiceTask:java服务任务
会调用外部的java类
指定调用的class类的三种方式：
第一种中方法：
----Main config
-----Type:java class -----Service class:选择外部实现了JavaDelegate或者ActivityBehavior 的java类；
第二种方法：
----Main config
----Type:Delegate expression
----Delegate expression:${“在spring中定义了的实现了JavaDelegate的bean”}
第三种方法
----Main config
----Type:Expression
----Expression:#{“在spring中配置的javabean的id.所调用的方法”}
在调用外部java类时，可以注入指段：（两种方式）
方法一：直接注入
----Main config
----Field:new时指定Field name和String value
方法二：使用表达式注入
----Main config
----=Field:new时，指定File name和Expression()
表达式中查找的是流程变量或者Spring定义的bean
----Result variable:会把上面指定的java类的指定方法的返回值赋给该变量，该 变量可以是一个流程变量，或者spring的bean
8、Execution listeners和Task Listeners 执行监听和任务监听
在流程执行期间执行外部的java代码
-----Event:start(事件开启前调用),end(事件结束后调用)
Type和Field和上面的一样
9、Email Task邮件任务：（需要在activiti.cfg.xml中配置邮件服务器）
----Mian config
----To:接受者
----From:发送者
----Subject:主题
----Cc：抄送
----Bcc:暗送
----Charset:字符集
----Html text:邮件内容
10、CallActiviti:调用外部其他流程
当流程运行的此时，启动新的流程实例
----General:
----Default flow:默认流程的流转
----Main config
----Called Element:被调用的流程的.bpmn文件中的id值
11、SubProcess:调用子流程（可以在SubProcess中配置新的流程，当流程运行到这里时会知 道启动子流程）
----id,name和上面的一样
12、timer:定时器（Main config中的数据格式均为：）
必选在activiti的配置文件中配置:<property name="jobExecutorActivate" value="true" />，否则定时任务无法正常启动。
Main config中的数据格式均为：ISO_8601格式：（P ,Y,M,W,D,T,.H,M,S）或 cron时间格式：
Iso_8601格式：
-----Time duration:延时多长时间后触发。例：P10D 表示10天以后触发
-----time date:什么时间触发。例：2011-03-12T12:12:23 表示在2011年03 月12日 12:12:23触发
---time cycle:循环规则：
R【循环次数】【/开始时间】/时间间隔【/结束时间】。
例：R3/PT10 表示重复3次，每次间隔10小时
从2004年5月6日北京时间下午1点起时间间隔半年零5天3小 时循环，且循环3次，可以表示为 R3/2004-05-06T130000+08/P0Y6M5DT3H0M0S。
以1年2个月为循环间隔，无限次循环，最后循环终止于2025年1 月1日，可表示为R/P1Y2M/2025-01-01
Cron 时间格式：seconds minutes hours day-of -mouth mouth,day-of-week year
其中*表示这个域上所有的合法值
例：0 * 17 * * ？ 表示每天下午5点到5：59每分钟触发一次
？表示不指定该域上的值（只能用在日域或周域上，且不能同时在两 个域上使用，即假如在在其中的一个域上指定了值，必要再另一 个上放？）
，表示在某个域上指定一个值列表
例：0 10,44 14 ？ 3 WEB 表示三月中每个星期三的下午2:10 和下午的2:44触发
- 表示在某个域上指定一个值范围
例：0 45 3-8 ? * * 表示上午3点到上午8点的45分时触发
m/n 表示某个域的值从m开始，按n递增
例：0/15 0/30 * * * ? 表示整点和半点时每15秒触发
L 表示某个域上允许的最后一个值（只能用在日域和周域上，用在 日域上时，表示当月的最后一天触发；用在周域上，表示周的最 后一天，即周六触发）
例：0 0 12 ? * 2L 表示每个月中的最后一个星期一的12:00触发
W 表示里指定日期最近的工作日（只用在日域上，其只能指定单天， 不能指定范围或列表）
例：在日域上指定15W，那么如果15号是工作日，就在15号 触发
如果15号是周六，就在14号触发
如果15号是周日，就在16号触发
# 表示月份中的第几周的哪一天（只用在周域上）
例：6#3 表示某个月的第三个星期五
二、开发流程
1、配置activiti.cfg.xml文件，里面可以配置要访问的数据库
<bean id=”processEngineConfiguration”
class=”org.activiti.engine.impl.cfg.StandaloneInMemprocessEngineConfiguration>
<property name=”databaseType” value=”mysql”/>
<property name=”jdbcUrl” value=”jdbc:mysql://localhost:3306/activiti”/> ......
<!--在进行过去流程引擎时会自动生成工作流需要的28张表-->
<property name=”databaseSchemaUpdate” value=”true”/>
</bean>
2、获取流程引擎（默认会按照类路径下的activiti.cfg.xml文件生成）
ProcessEngine processEngine=ProcessEngines.getDefaultProcessEngine();
3、部署流程定义
方法一：（从classpath下部署）
Deployment deployment=processEngine.getRepositoryService()
.createDeployment()
.name(“流程名称”)
.addClasspathResource(“diagrams/helloword.bpmn”)
.addClasspathResource(“diagrams/helloword.png”)
.deploy();
方法二：（从zip文件部署）
//将.bpmn和.png文件压缩到helloword.zip文件中
InputStream inputStream=this.getClass().getClaassLoader().
getResourceAsStream(“diagrams/helloword.zip”);
Deployment deployment=processEngine.getRepositoryService()
.createDeployment()
.name(“流程名称”)
.addZipInputStream(new ZipInputStream(inputStream))
.deploy();
方法三：（从当前路径下获取）
要在Build Pah-->configura Build Path--->Source---->某个包下的Included双击
--->Inclusion pathterns下清空，则会把该包下的所有文件进行编译
InpuStream inputStreamBpmn=this.getClass().
getResourceAsStream(“sequenceFlow.bpmn”);//从当前路径下获取
InpuStream inputStreamBpmn=this.getClass().
getResourceAsStream(“/sequenceFlow.bpmn”);//从类路径下获取
Deployment deployment=processEngine.getRepositoryService()
.createDeployment()
.name(“流程名称”)
.addInputStream(“sequenceFlow.bpmn”,inputStreamBpmn)
.addInputStream(“sequenceFlow.png”,inputStreamPng)
.deploy();
4、启动流程实例
ProcesssInstance processInstance=processEngine.getRuntiomService()
.startProcessInstanceByKey(“.bpmn文件中流程的id属性的值”)
5、任务查询
（1）个人任务查询（只有任务的Main config中的Assignee中指定了办理人才代 表个人任务，才可通过个人任务进行查询）
List<Task> list=processEngine.getTaskService()
.createTaskQuery()
.taskAssignee(“办理人”)//指定办理人
.list();
（2）查询组任务
List<Task> list=processEngine.getTaskService()
.createTaskQuery()
.taskCandidateUser(“组成员或者拥有角色的用户”)
.list();
a.如果是通过组任务的方式进行的任务分配,即在Mian config中的 Candidate Users中通过逗号分隔指定的一组办理人
b.如果是通过角色的方式进行的任务分配即在Main config中的
Candidate groups中指定任务的办理角色
6、完成任务
processEngine.getTaskService().complete(“任务id”);