1 Activiti介绍

Activiti5是由Alfresco软件在2010年5月17日发布的业务流程管理（BPM）框架，它是覆盖了业务流程管理、工作流、服务协作等领域的一个开源的、灵活的、易扩展的可执行流程语言框架。Activiti基于Apache许可的开源BPM平台，创始人Tom Baeyens是JBoss jBPM的项目架构师，它特色是提供了eclipse插件，开发人员可以通过插件直接绘画出业务。

流程图。

2 BPMN

业务流程建模与标注（Business Process Model and Notation，BPMN) ，描述流程的基本符号，包括这些图元如何组合成一个业务流程图（Business Process Diagram）

3 有什么用 - 为什么要用

很简单，基本上所有的所谓框架，都是基于某个问题，提出的一套解决方案，给你提供一组API，你调就行了。Activiti把表都给你建了，它不香吗？

4 怎么用 - 相关基础知识

1) 5种数据库表

Activiti的后台是有数据库的支持，工程一启动自动建表，所有的表都以ACT_开头。第二部分是表示表的用途的两个字母标识。用途也和服务的API对应，不同的表存放不同方面的数据，有流程定义表、任务结点表、流程变量表、任务历史表等等。

ACT_RE_*: 'RE'表示repository。这个前缀的表包含了流程定义和流程静态资源（图片，规则，等等）。

ACT_RU_*: 'RU'表示runtime。这些运行时的表，包含流程实例，任务，变量，异步任务，等运行中的数据。 Activiti只在流程实例执行过程中保存这些数据，在流程结束时就会删除这些记录。这样运行时表可以一直很小速度很快。

ACT_ID_*: 'ID'表示identity。这些表包含身份信息，比如用户，组等等。

ACT_HI_*: 'HI'表示history。这些表包含历史数据，比如历史流程实例，变量，任务等等。

ACT_GE_*: 通用数据，用于不同场景下，如存放资源文件。

23张表：

2) 5项Service

不同的Service类对应不同的功能。

RepositoryService 管理流程定义

RuntimeService 执行管理，包括启动、推进、删除流程实例等操作

TaskService 任务管理，是activiti的任务服务类。可以从这个类中获取任务的信息。

HistoryService 历史管理(执行完的数据的管理) ，是activiti的查询历史信息的类。在一个流程执行完成后，这个对象为我们提供查询历史信息

IdentityService 组织机构管理

3) 7项基本操作

设计流程图（各种组件，如连线、用户任务、网关）

流程定义增删改查

流程变量增删改查

启动流程定义

任务增删改查

完成任务

历史信息查询

5 工作流程

第一步：流程定义&部署

定义一个新的流程(如：请假流程，外出流程)，在eclipse 或IDEA里面安装bpmn插件，画一个bpmn流程图。重启工程，activiti就在act_re_procdef表中插入一条记录，即这个新加入的流程。

一个请假的bpmn流程图如下：

为什么要画这个流程图？

说明：流程定义文档有两部分组成：

1) bpmn文件

流程规则文件。在部署后，每次系统启动时都会被解析，把内容封装成流程定义放入项目缓存中。Activiti框架结合这个xml文件自动管理流程，流程的执行就是按照bpmn文件定义的规则执行的，bpmn文件是给计算机执行用的。解析.bpmn后得到的流程定义规则的信息，工作流系统就是按照流程定义的规则执行的。

2) 展示流程图的图片

在系统里需要展示流程的进展图片，图片是给用户看的。activiti通过这个图可以追踪到当前流程走到哪一步了(这是工作流软件基本的业务需求)。

在审批过程中的请假流程，如下图(当前走到人事审批这一步)：

第二步：启动流程

这一步是需要开发者来实现的，拿我们日常请假来说，每当你提交了一个请假的申请，就会触发activiti流程控制的相关业务，拿上图的请假流程来说，当你提交一个申请，activiti就自动把流程推进到部门领导审批这一步。

相关代码：

 1 public ProcessInstance startWorkflow(GooutApply apply, String userid, Map<String, Object> variables) {
 2         apply.setApply_time(new Date().toString());
 3         apply.setUser_id(userid);
 4         gooutmapper.save(apply);
 5         String businesskey=String.valueOf(apply.getId());//使用leaveapply表的主键作为businesskey,连接业务数据和流程数据
 6         identityservice.setAuthenticatedUserId(userid);
 7         // 第一个参数：bpmn流程图的key  第二个参数：业务类的主键
 8         ProcessInstance instance=runtimeservice.startProcessInstanceByKey("goout",businesskey,variables);
 9         System.out.println(businesskey);
10         String instanceid=instance.getId();
11         apply.setProcess_instance_id(instanceid);
12         gooutmapper.updateByPrimaryKey(apply);
13         return instance;
14     }

核心代码：runtimeservice.startProcessInstanceByKey("goout",businesskey,variables);

第一个参数：bpmn流程图的key 第二个参数：业务类的主键，activiti通过这个方法把业务(leaveapply)和流程(流程图的key - act_re_procdef)关联起来

runtimeservice是activiti的内部对象，直接注入就可用

这一步，在DB层面插入了相关表：act_ru_execution act_ru_task

act_hi_procinst act_hi_actinst act_hi_taskinst等

第三步：流式审批

不同角色的人依次登录系统，看到并审批和自己角色对应的待办任务，直到整个流程走完。主要更新表act_ru_task。A在审批前能看到记录，审批完就看不见了，因为流程已经走到了下一个人那里。

第四步：查看执行结果

审批发起人可以看到自己的审批到底走到哪个阶段了(红色框和红色箭头标记)，即整个流程的审批情况。

6 相关问题

1) 如何画bpmn图？

推荐用eclipse画，idea对bpmn的支持不友好。

第一步：安装bpmn插件

在Eclipse的菜单中打开help -> install new software:

单击add：

Name: Activiti BPMN 2.0 designer

Location: http://activiti.org/designer/update/

第二步：拖拽组件，画图

第三步：配置组件属性

当前bpmn图的属性：

Task的属性：

Candidate group属性：这个属性很关键，代表哪个角色可以看到当前的task。

gateway的配置：

下图的Condition属性很重要，是用来控制流程走向的条件，即当deptleaderapprove_goout(在完成任务时，通过map传值)为true时，从部门领导审批走到人事审批。

审批时写的同意 & 拒绝存进act_ru/hi_variable，在画bpmn图时，根据act_ru/hi_variable中的值和bpmn图中的<sequenceFlow>匹配，决定画出的图是什么样子的

相关代码：

 1 public MSG deptcomplete_goout(HttpSession session, @PathVariable("taskid") String taskid, HttpServletRequest req) {
 2         String userid = (String) session.getAttribute("username");
 3         Map<String, Object> variables = new HashMap<String, Object>();
 4         // 审批意见：同意，拒绝
 5         String approve = req.getParameter("deptleaderapprove_goout");
 6         variables.put("deptleaderapprove_goout", approve);
 7         taskservice.claim(taskid, userid);
 8         // 提交审批
 9         taskservice.complete(taskid, variables);
10         return new MSG("success");
11     }