Activiti使用文档
低价商品，欢迎微信扫码选购
1：Activiti使用流程
1：绘制流程图。
1：Eclipse安装Activiti插件(Eclipse有些版本装不了，需要注意)。
2：安装完插件之后，在项目文件夹下创建Activiti Diagram(和创建Java类类似)
3：Eclipse右侧会有一些Activiti图标，每个图标代表的含义可以参阅Activiti文档(共享盘有)
4：Window->Showview->Package Explorer打开包试图，右键刚才创建Activiti流程图的项目，点击Create deployement artifacts。会根据流程图生成相应的*.bpmn20.xml文件
注：Window->Preferences->Activiti->Save，勾选右侧的Create process definition image…,在保存流程图时，自动生成流程图
2：流程部署(参阅文档第6章)
1：直接部署生成的*.bpmn20.xml文件，Activiti自动生成流程图。如果流程图中包含汉字，生成的流程图会乱码。
2：将生成的*.bpmn20.xml和*.png流程图通过Ant打包，然后部署压缩文件
3：同时部署*.bpmn20.xml 和生成的流程图，项目中就是采用该方法。
3：启动流程(表单提交)
通过RuntimeService方法提交，Activiti提供了2种提交表单的方式
1：startProcessInstanceById：每次流程部署时，都会根据流程key，version生成一个流程ID，通过流程ID查找特定的流程，来提交表单。
2:startProcessInstanceByKey：通过key来提交表单，每次提交单据时，都会使用最新部署的流程。
3：第1个参数，是对应的流程id或流程key，也可以在提交表单时，传递一些参数，供Activiti使用。Eg：表单提交后，根据部门不同，指定不同人审核，可以在启动流程时，就通过Map传递参数。
4：单据审批
单据审批时，实际是处理的审批任务(Task)，需要先拿到任务的ID（Task_id），通过TaskService.complete来完成任务。在执行complete时，也可以传递一些参数。Eg：员工在审批时，可能选择通过(C)，不通过(D)，对应流程图中通过${status==’C’},${status==’D’}走不同的流程，可以通过Map来传递status的值。
2：通过简单DEMO详细讲解Activiti使用
通过截图及部分代码，详细讲解1中的每一步操作
1：绘制流程图
1：Eclipse安装Activiti插件。Activiti插件地址：http://activiti.org/designer/update/
不清楚插件安装方式的，可以直接google搜索。注：某些Eclipse版本安装不了，需注意。
2：右键项目文件夹，创建Activiti Diagram文件。
3：创建一个简单的流程图。
a：右键创建一个简单的空白的Activiti Diagram文件，假设文件名叫SimpleDemo。
b：Window->Show View调出Properties视图。点击SimpleDemo文件空白处，
在Properties视图中，设置流程图的Id(对应提交表单时的Key)。
注：不要和项目中存在的流程重名
c：通过Palette试图中的组件，画出如下的流程图(用到的组件，右侧已标注)
d：用户任务讲解。选中用户任务，Properties视图中设置参数。
Main config选项：
Assignee：可以直接在Assignee中指定员工或通过Spring指定Bean的方法进行人员查找。无论通过哪种方式，都只能指定一个人。
Candidateusers：可以设定为“123,456”，将员工123或456设定为候选人，由其中的一个员工进行审批（审批前需要taskService.claim进行任务认领）
Form选项：
如果使用Activiti内置表单，才会用到Form。内置表单可以参考Activiti文档，
上面有详细讲解，由于项目中使用的是自定义表单，所以不讲解Form。
Listeners选项：
通过指定一个实现TaskListener接口的类，来指定将该用户任务分配给某个员工。
如果不需要向SimpleUserTask传递参数，也可以不添加nodeId属性。
TaskListener接口，在org.activiti.engine.delegate包下，不要继承错误。
Multi instance选项：
下面截图是出差审批流程中的部分截图
Sequential：比如一共创建了3个用户任务，他们是并行执行还是串行执行。
Loopcardinality：从单词意识上也可以看出来，一共循环几次，即：创建几个用户任务。
Collection：是一个集合，里面存放了需要通过多实例创建用户任务的员工ID。
Elementvariable：循环Collection集合时，集合中元素对应的变量名。
Completioncondition：定义多实例结束条件。如果该多实例创建了3个用户任务，在3个员工全部审批完，或有一个员工审批不通过时，跳出该节点继续向后执行。
e：条件顺序流
General：Name属性也可以不写或使用默认的，为了流程图容易理解，我们将其改为“同意”。
Mainconfig：将Condition设置为${status=='C'}，在审批时，传递一个status参数。
同理设置不同意的Name和Condition。
注：Activiti审批流必须从startEvent开始，最终走向endEvent结束，如果传递的status既不是C也不是D，则会报no outgoing的错误
f：Java服务任务
Java服务任务会由Activiti自动执行，不像用户任务会阻塞，等待人为的处理。
可以在通过或不通过的回调中，执行不同申请的逻辑处理。
4：Window-Show View切换到Package Explorer。
右键项目，点击Create deployment artifacts，
将生成的bpmn20.xml文件以及保存时自动生成的png流程图文件上传到服务器，然后部署。
2：流程部署(参阅文档第6章)
流程部署只讲项目中使用的方法
3：启动流程(表单提交)
也可以通过startProcessInstanceById提交单据。通过ByKey提交时，每次部署新的流程，
都会自动使用最新部署的流程；但是使用ById提交单据时，即便流程图重新部署，也只会使用
提交时指定的流程图。
4：单据审批
通过taskService.complete(task, map);进行审批。
task：任务ID
map：包括status，opinion等。
说明：
1：在startProcessInstanceByKey启动流程时通过Map传递的参数可以再流程图(eg:${param==’xxx’)，用户任务接口(DelegateTask.getVariable)，Java服务任务(DelegateExecution. getVariable)中使用。
2：在用户任务(TaskListener接口实现类)，Java服务任务(JavaDelegate)以及
审批时（taskService.complete）同样可以向Activiti传递参数。