SaaS-IHRM 项目-Activiti7基础原理与使用 工作流引擎 工作流使用

第1章 什么是工作流

1.1工作流介绍

工作流(Workflow)，就是通过计算机对业务流程自动化执行管理。它主要解决的是“使在多个参与者 之间按照某种预定义的规则自动进行传递文档、信息或任务的过程，从而实现某个预期的业务目标， 或者促使此目标的实现”。

1.2工作流系统

一个软件系统中具有工作流的功能，我们把它称为工作流系统，一个系统中工作流的功能是什 么？就是对系统的业务流程进行自动化管理，所以工作流是建立在业务流程的基础上，所以一个软 件的系统核心根本上还是系统的业务流程，工作流只是协助进行业务流程管理。即使没有工作流业 务系统也可以开发运行，只不过有了工作流可以更好的管理业务流程，提高系统的可扩展性。

1.2.1适用行业

消费品行业，制造业，电信服务业，银证险等金融服务业，物流服务业，物业服务业，物业管理， 大中型进出口贸易公司，政府事业机构，研究院所及教育服务业等，特别是大的跨国企业和集团公 司。

1.2.2具体应用

1.关键业务流程：订单、报价处理、合同审核、客户电话处理、供应链管理等
2.行政管理类:出差申请、加班申请、请假申请、用车申请、各种办公用品申请、购买申请、日报 周报等凡是原来手工流转处理的行政表单。
3.人事管理类：员工培训安排、绩效考评、职位变动处理、员工档案信息管理等。
4.财务相关类：付款请求、应收款处理、日常报销处理、出差报销、预算和计划申请等。

5.客户服务类：客户信息管理、客户投诉、请求处理、售后服务管理等。

6.特殊服务类：ISO 系列对应流程、质量管理对应流程、产品数据信息管理、贸易公司报关处理、物流公司货物跟踪处理等各种通过表单逐步手工流转完成的任务均可应用工作流软件自动规范 地实施。

1.3工作流实现方式

在没有专门的工作流引擎之前，我们之前为了实现流程控制，通常的做法就是采用状态字段的值来 跟踪流程的变化情况。这样不用角色的用户，通过状态字段的取值来决定记录是否显示。

针对有权限可以查看的记录，当前用户根据自己的角色来决定审批是否合格的操作。如果合格将状 态字段设置一个值，来代表合格；当然如果不合格也需要设置一个值来代表不合格的情况。

这是一种最为原始的方式。通过状态字段虽然做到了流程控制，但是当我们的流程发生变更的时候， 这种方式所编写的代码也要进行调整。

那么有没有专业的方式来实现工作流的管理呢？并且可以做到业务流程变化之后，我们的程序可以 不用改变，如果可以实现这样的效果，那么我们的业务系统的适应能力就得到了极大提升。

1.4工作流实现原理分析

如何可以做到我们在业务流程发生变更后，我们的业务系统代码可以不发生改变？此时我们就来分 析一下原理。
具体分析过程如下图所示：

第2章 什么是Activiti7

2.1Activiti 介绍

Alfresco 软件在 2010 年 5 月17 日宣布Activiti 业务流程管理（BPM）开源项目的正式启动，其首席架构师由业务流程管理BPM 的专家 Tom Baeyens 担任，Tom Baeyens 就是原来 jbpm 的架构师，而 jbpm 是一个非常有名的工作流引擎，当然activiti 也是一个工作流引擎。
Activiti 是一个工作流引擎， activiti 可以将业务系统中复杂的业务流程抽取出来，使用专门的建模语言（BPMN2.0）进行定义，业务系统按照预先定义的流程进行执行，实现了业务系统的业务 流程由activiti 进行管理，减少业务系统由于流程变更进行系统升级改造的工作量，从而提高系统的健壮性，同时也减少了系统开发维护成本。
官方网站：https://www.activiti.org/

经历的版本:
目前最新版本：Activiti7.0.0.Beta

2.1.1BPM

BPM（Business Process Management），即业务流程管理，是一种以规范化的构造端到端的卓越业务流程为中心，以持续的提高组织业务绩效为目的系统化方法，常见商业管理教育如 EMBA、MBA 等均将BPM 包含在内。
企业流程管理主要是对企业内部改革，改变企业职能管理机构重叠、中间层次多、流程不闭环 等，做到机构不重叠、业务不重复，达到缩短流程周期、节约运作资本、提高企业效益的作用。
比较下边的两个人事加薪流程哪个效率更高？ 流程一：

流程二：

上边两个流程的区别在于第二个流程在执行时，如果本次加薪金额在一万元以内不再由总经理审批 将比第一个流程缩短流程周期，从而提交效率。

再比较下边的例子，哪个效率更高？
流程一：

流程二：

上边两个流程的区别在于第二个流程将交费和取药放在一起进行，这样导致的结果是此窗口的工作 人员必须具备财务、药学专业知识，岗位强度加大，人员培训难度加大从而导致人员不易扩展，工 作效率低下。
2.1.2BPM 软件

BPM 软件就是根据企业中业务环境的变化，推进人与人之间、人与系统之间以及系统与系统之间的整合及调整的经营方法与解决方案的 IT 工具。 通常以Internet 方式实现信息传递、数据同步、业务监控和企业业务流程的持续升级优化，从而实现跨应用、跨部门、跨合作伙伴与客户的企业运 作。通过 BPM 软件对企业内部及外部的业务流程的整个生命周期进行建模、自动化、管理监控和优化，使企业成本降低，利润得以大幅提升。
BPM 软件在企业中应用领域广泛，凡是有业务流程的地方都可以 BPM 软件进行管理，比如企业人事办公管理、采购流程管理、公文审批流程管理、财务管理等。
2.1.3BPMN

BPMN（Business Process Model And Notation）- 业务流程模型和符号 是由 BPMI（Business Process Management Initiative）开发的一套标准的业务流程建模符号，使用BPMN 提供的符号可以创建业务流程。 2004 年 5 月发布了 BPMN1.0 规范.BPMI 于 2005 年 9 月并入 OMG（The Object Management Group 对象管理组织)组织。OMG 于 2011 年 1 月发布BPMN2.0 的最终版本。

具体发展历史如下:

BPMN 是目前被各 BPM 厂商广泛接受的 BPM 标准。Activiti 就是使用 BPMN 2.0 进行流程建模、流程执行管理，它包括很多的建模符号，比如：

Event 用一个圆圈表示，它是流程中运行过程中发生的事情。

活动用圆角矩形表示，一个流程由一个活动或多个活动组成

一个bpmn 图形的例子：
首先当事人发起一个请假单；
其次他所在部门的经理对请假单进行审核； 然后人事经理进行复核并进行备案；
最后请假流程结束。

Bpmn 图形其实是通过xml 表示业务流程，上边的.bpmn 文件使用文本编辑器打开：

2.2Activit 如何使用

1)部署activiti
Activiti 是一个工作流引擎（其实就是一堆 jar 包 API），业务系统使用activiti 来对系统的业务流程进行自动化管理，为了方便业务系统访问(操作)activiti 的接口或功能，通常将 activiti 环境与业务系统的环境集成在一起。

2)流程定义
使用activiti 流程建模工具(activity-designer)定义业务流程(.bpmn 文件) 。
.bpmn 文件就是业务流程定义文件，通过xml 定义业务流程。

如果使用其它公司开发的工作作引擎一般都提供了可视化的建模工具(Process Designer)用于生成流程定义文件，建模工具操作直观，一般都支持图形化拖拽方式、多窗口的用户界面、丰富的过 程图形元素、过程元素拷贝、粘贴、删除等功能。
3)流程定义部署
向activiti 部署业务流程定义（.bpmn 文件）。
使用activiti 提供的 api 向 activiti 中部署.bpmn 文件（一般情况还需要一块儿部署业务流程的图片.png）

4)启动一个流程实例（ProcessInstance）
启动一个流程实例表示开始一次业务流程的运行，比如员工请假流程部署完成，如果张三要请 假就可以启动一个流程实例，如果李四要请假也启动一个流程实例，两个流程的执行互相不影 响，就好比定义一个 java 类，实例化两个对象一样，部署的流程就好比java 类，启动一个流程实例就好比new 一个java 对象。

5)用户查询待办任务(Task)

因为现在系统的业务流程已经交给activiti 管理，通过activiti 就可以查询当前流程执行到哪了， 当前用户需要办理什么任务了，这些 activiti帮我们管理了，而不像上边需要我们在 sql语句中的where 条件中指定当前查询的状态值是多少。

6)用户办理任务
用户查询待办任务后，就可以办理某个任务，如果这个任务办理完成还需要其它用户办理，比如采 购单创建后由部门经理审核，这个过程也是由 activiti 帮我们完成了，不需要我们在代码中硬编码指定下一个任务办理人了。

7)流程结束
当任务办理完成没有下一个任务/结点了，这个流程实例就完成了。

第3章 环境准备

3.1三个环境

第一个环境：没有加入工作流SaaS-IHRM 系统
作用：主要是为activiti 工作流引擎的引入提供场景

第二个环境：activiti 测试环境
作用：用于测试activiti 的api，提供各种 service 接口。需要创建一个数据库：
仅仅有activiti 的数据表
第三个环境：activiti 应用环境，加入工作流的SaaS-IHRM 系统需要创建一个数据库：
包括activiti 的数据表和业务表（SaaS-IHRM 系统的表）

3.2开发环境

3.2.1Java 环境

Jdk1.8 或以上版本。

3.2.2数据库

Mysql 5 及以上的版本
本教程采用 5.5 版本

3.2.3Web 容器

本项目采用的是Tomcat8.5

3.2.4开发工具

Mysql 客户端连接工具，Sqlyog 或其它文本编辑器EditPlus 或其它
Java 开发工具：IDEA 或Eclipse 工具

注意：activiti 的流程定义工具插件可以安装在IDEA 下，也可以安装在Eclipse 工具下。

3.3Activiti 环境

Activiti7.0.0.Beta1
默认支持spring5
3.3.1下载 activiti7

Activiti 下载地址：http://activiti.org/download.html

org.activiti
activiti-dependencies
7.0.0.Beta1
import
pom

1)Database：
activiti 运行需要有数据库的支持，支持的数据库有：h2, mysql, oracle, postgres, mssql, db2 等，该目录存放activiti 的建表脚本。

2)Docs
Activiti 的帮助文档。

3)Wars
官方自带的示例工程。

3.3.2Activiti Designer 流程设计器(Eclipse 工具)

本教程使用Activiti –Designer-eclipse-plugin（activiti 流程设计器插件）完成流程的制作。

下面介绍了 activiti designer 设计器插件的安装方式，本教程使用的插件安装方式详细参考“activiti 开发环境配置.docx”文档的“Eclipse 插件安装”章节。

3.3.2.1Eclispe 工具下插件安装方式 1

参数文档开发工具目录下的“activiti 开发环境配置.docx”中“eclipse 插件安装”，其中包括了 Activiti
插件。
3.3.2.2Eclispe 工具下插件安装方式 2

网络在线安装：

1)打开 Help -> Install New Software. 在如下面板中:

在如下Install 界面板中，点击Add 按钮

配置新装插件的地址和名称

3)然后填入下列字段

Name: Activiti BPMN 2.0 designer
Location: http://activiti.org/designer/update/

4)回到 Install 界面，在面板正中列表中把所有展示出来的项目都勾上：

5)点击复选框

在 Detail 部分记得选中 “Contact all updates sites…” , 因为它会检查所有当前安装所需要的插件并可以被 Eclipse 下载.

6)安装完以后，点击新建工程new->Other…打开面板，如果看到下图内容：

说明安装成功了。

3.3.2.3补充说明

打开菜单Windows->Preferences->Activiti->Save 下流程图片的生成方式:

说明安装成功了。

3.3.2.3补充说明

打开菜单Windows->Preferences->Activiti->Save 下流程图片的生成方式:

虽然流程引擎在单独部署 bpmn 文件时会自动生成图片，但在实际开发过程中，自动生成的图片会导致和BPMN 中的坐标有出入，在实际项目中展示流程当前位置图会有问题。
所在完成以上配置后，会由我们自己来管理流程图片。在发布流程时把流程规则文件和流程图片一 起上传就行了。
3.3.3Activiti Designer 流程设计器(IDEA 工具)

在IDEA 的File 菜单中找到子菜单”Settings”,后面我们再选择左侧的“plugins”菜单，如下图所示：

此时我们就可以搜索到actiBPM 插件，它就是Activiti Designer 的IDEA 版本。安装好后，页面如下：

3.3.4Activiti 支持的数据库

Activiti 的运行需要数据库支撑，需要安装activiti 数据库，支持如下版本：

3.3.5创建 mysql 数据库

本教程使用mysql 数据库。

创建mysql 数据库activiti（名字任意）：

CREATE DATABASE activiti DEFAULT CHARACTER SET utf8;

3.3.6创建表方式

通过运行 java 程序创建表。

3.3.6.1创建 java 工程

使用eclipse 或idea 创建 maven 的java 工程。

3.3.6.2加入 maven 依赖的坐标（jar 包）

首先需要在java 工程中加入ProcessEngine 所需要的 jar 包，包括
1)activiti-engine-7.0.0.beta1.jar
2)activiti 依赖的 jar 包：mybatis、alf4j、log4j 等
3)activiti 依赖的spring 包
4)数据库驱动
5)第三方数据连接池dbcp
6)单元测试Junit-4.12.jar
我们使用maven 来实现项目的构建，所以应当导入这些 jar 所对应的坐标到pom.xml 文件中。

1.6.6
1.2.12




org.activiti
activiti-engine
7.0.0.Beta1




org.activiti
activiti-spring
7.0.0.Beta1




org.activiti
activiti-bpmn-model
7.0.0.Beta1




org.activiti
activiti-bpmn-converter
7.0.0.Beta1




org.activiti
activiti-json-converter
7.0.0.Beta1

.....

3.3.6.3log4j.properties

# CONSOLE is set to be a ConsoleAppender using a PatternLayout. log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout log4j.appender.CONSOLE.layout.ConversionPattern=%d{ISO8601}
[%15.15t] %-5p %30.30c %x - %m\n

# LOGFILE is set to be a File appender using a PatternLayout. log4j.appender.LOGFILE=org.apache.log4j.FileAppender log4j.appender.LOGFILE.File=d:\axis.log log4j.appender.LOGFILE.Append=true log4j.appender.LOGFILE.layout=org.apache.log4j.PatternLayout log4j.appender.LOGFILE.layout.ConversionPattern=%d{ISO8601}
[%15.15t] %-5p %30.30c %x - %m\n

3.3.6.4activiti.cfg.xml

在classpath 下创建activiti.cgf.xml 文件

在activiti.cfg.xml 中配置数据源和 processEngineConfiguration

1)数据源

在activiti.cfg.xml 中配置数据源和 processEngineConfiguration

1)数据源

2)processEngineConfiguration

processEngineConfiguration 用来创建ProcessEngine，在创建ProcessEngine 时会执行数据库的操作。

关于 processEngineConfiguration 中的 databaseSchemaUpdate 参数，通过此参数设计 activiti
数据表的处理策略，参数如下：

false（默认）：检查数据库表的版本和依赖库的版本， 如果版本不匹配就抛出异常。 true: 构建流程引擎时，执行检查，如果需要就执行更新。 如果表不存在，就创建。create-drop: 构建流程引擎时创建数据库表， 关闭流程引擎时删除这些表。
drop-create：先删除表再创建表。
create: 构建流程引擎时创建数据库表， 关闭流程引擎时不删除这些表。
注意：在 activiti.cfg.xml 配置文件中的 dataSource 和 processEngineConfiguration 也可以使用一次性配置出来。

3.3.6.5编写程序

创建 ProcessEngineConfiguration，通过 ProcessEngineConfiguration 创建 ProcessEngine，在创建ProcessEngine 时会自动创建数据库。

说明：
1、运行以上程序段即可完成activiti 数据库创建，通过改变activiti.cfg.xml 中
databaseSchemaUpdate 参数的值执行不同的数据表处理策略。

2 、上边的方法 createProcessEngineConfigurationFromResource 在执行时在
activiti.cfg.xml 中找固定的名称 processEngineConfiguration
也可以使用重载方法调用，这时可以不用限定 processEngineConfiguration 名称
此时我们查看数据库，创建了 25 张表，结果如下：

3.3.7数据库表的命名规则

Activiti 的表都以ACT_开头。 第二部分是表示表的用途的两个字母标识。 用途也和服务的 API 对应。
ACT_RE_*: 'RE'表示 repository。 这个前缀的表包含了流程定义和流程静态资源 （图片， 规则，等等）。
ACT_RU_*: 'RU'表示 runtime。 这些运行时的表，包含流程实例，任务，变量，异步任务， 等运行中的数据。 Activiti 只在流程实例执行过程中保存这些数据， 在流程结束时就会删除这些记录。 这样运行时表可以一直很小速度很快。
ACT_HI_*: 'HI'表示 history。 这些表包含历史数据，比如历史流程实例， 变量，任务等等。
ACT_GE_*:	GE 表示general。通用数据， 用于不同场景下。

第4章 Activiti 服务架构图

在新版本中，我们通过实验可以发现IdentityService，FormService 两个Serivce 都已经删除了。
所以后面我们对于这两个 Service 也不讲解了，但老版本中还是有这两个 Service，同学们需要了解一下。

4.1activiti.cfg.xml

activiti 的引擎配置文件，包括：ProcessEngineConfiguration 的定义、数据源定义、事务管理器等， 此文件其实就是一个 spring 配置文件，下面是一个基本的配置只配置了 ProcessEngineConfiguration 和数据源：

4.2ProcessEngineConfiguration：

流程引擎的配置类，通过ProcessEngineConfiguration 可以创建工作流引擎ProceccEngine，常用的两种方法如下：

4.2.1StandaloneProcessEngineConfiguration
通过org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration
Activiti 可以单独运行，使用它创建的 ProcessEngine，Activiti 会自己处理事务。
配置文件方式：
通常在activiti.cfg.xml 配置文件中定义一个 id 为 processEngineConfiguration 的 bean，这里会使用spring 的依赖注入来构建引擎。
方法如下：

4.2.2SpringProcessEngineConfiguration

通过 org.activiti.spring.SpringProcessEngineConfiguration 与 Spring 整合。

创建spring 与activiti 的整合配置文件：
activity-spring.cfg.xml（名称不固定）

4.2.3创建processEngineConfiguration

上边的代码要求activiti.cfg.xml 中必须有一个processEngineConfiguration 的bean
也可以使用下边的方法，更改bean 的名字：

ProcessEngineConfiguration.createProcessEngineConfigurationFromResou rce(String resource, String beanName);

4.3ProcessEngine

工作流引擎，相当于一个门面接口，通过 ProcessEngineConfiguration 创建 processEngine，通过ProcessEngine 创建各个service 接口。

4.3.1 一般创建方式

//通过ProcessEngineConfiguration创建ProcessEngine ProcessEngine processEngine =
processEngineConfiguration.buildProcessEngine();

4.3.2 简单创建方式
将activiti.cfg.xml 文件名及路径固定，且 activiti.cfg.xml 文件中有 processEngineConfiguration 的配置， 可以使用如下代码创建processEngine:

//使用classpath下的activiti.cfg.xml中的配置创建processEngine
ProcessEngine	processEngine
ProcessEngines.getDefaultProcessEngine();
System.out.println(processEngine);

4.4Service

4.4.1Service 创建方式

通过 ProcessEngine 创建 Service，Service 是工作流引擎提供用于进行工作流部署、执行、管理的服务接口。
方式如下：

RuntimeService runtimeService = processEngine.getRuntimeService(); RepositoryService repositoryService = processEngine.getRepositoryService(); TaskService taskService = processEngine.getTaskService();
……

4.4.2Service 总览
RepositoryService | activiti 的资源管理类
RuntimeService | activiti 的流程运行管理类
TaskService | activiti 的任务管理类
HistoryService | activiti 的历史管理类
ManagerService | activiti 的引擎管理类

注：红色标注为常用service。
4.4.3RepositoryService

是activiti 的资源管理类，提供了管理和控制流程发布包和流程定义的操作。使用工作流建模工具设计的业务流程图需要使用此service 将流程定义文件的内容部署到计算机。
除了部署流程定义以外还可以： 查询引擎中的发布包和流程定义。
暂停或激活发布包，对应全部和特定流程定义。 暂停意味着它们不能再执行任何操作了，激活是对应的反向操作。
获得多种资源，像是包含在发布包里的文件， 或引擎自动生成的流程图。获得流程定义的pojo 版本， 可以用来通过java 解析流程，而不必通过xml。

4.4.4RuntimeService

它是activiti 的流程运行管理类。可以从这个服务类中获取很多关于流程执行相关的信息

4.4.5TaskService

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

4.4.6HistoryService

是 activiti 的历史管理类，可以查询历史信息，执行流程时，引擎会保存很多数据（根据配置），比如流程实例启动时间，任务的参与者， 完成任务的时间，每个流程实例的执行路径，等等。 这个服务主要通过查询功能来获得这些数据。

4.4.7ManagementService

是activiti 的引擎管理类，提供了对 Activiti 流程引擎的管理和维护功

第5章 Activiti 入门体验

5.1流程定义

5.1.1Activiti-Designer 使用

5.1.1.1Palette（画板）
在eclipse 或 idea 中安装activiti-designer 插件即可使用，画板中包括以下结点：
Connection—连接Event—事件Task—任务Gateway—网关Container—容器
Boundary event—边界事件Intermediate event- -中间事件
流程图设计完毕保存生成.bpmn 文件。

5.1.1.2新建流程(IDEA 工具)

首先选中存放图形的目录(本次我们选择resources 下的bpmn 目录)，点击菜单：New-BpmnFile，如下图所示：

弹出如下图所示框：

起完名字holiday 后（默认扩展名为bpmn），就可以看到进入了流程设计页面，如图所示：

5.1.1.3新建流程(Eclipse 工具)

首先选中存放图形的目录(本次我们选择 resources 下的 bpmn 目录)， File-New-Other 菜单，打开如下窗口。

创建成功：

左侧区域是绘图区，右侧区域是palette 画板区域鼠标先点击画板的元素即可在左侧绘图。

5.1.2绘制流程

图形绘制好后会生成两个文件：

自动生成图形，需要设置eclipse:

5.1.3指定流程定义 key

流程定义key 即流程定义的标识，在eclipse 中通过properties 视图查看流程的key

建议：相同的业务流程，流程定义的 key 名字定义一样，比如，如果需要创建新的业务流程，请假流程则使用新的key。

5.1.4指定任务负责人

在properties 视图指定每个任务结点的负责人， 比如下边是填写请假单的负责人为zhangsan

5.2部署流程定义

部署流程定义就是要将上边绘制的图形即流程定义（.bpmn）部署在工作流程引擎 activiti 中，方法如下：

使用ProcessEngine 创建RepositoryService，代码如下：

// 获取repositoryService
RepositoryService repositoryService = processEngine
.getRepositoryService();
//部署对象
Deployment deployment = repositoryService.createDeployment()
.addClasspathResource("diagram/myholiday.bpmn")// bpmn文
件
.addClasspathResource("diagram/myholiday.png")// 图片文 
件
.name("请假申请流程")
.deploy();
System.out.println("流程部署id:" + deployment.getId()); System.out.println("流程部署名称:" + deployment.getName());

执行此操作后activiti 会将上边代码中指定的bpm 文件和图片文件保存在activiti 数据库。

5.3启动一个流程实例

流程定义部署在activiti 后就可以通过工作流管理业务流程了，也就是说上边部署的请假申请流程可以使用了。
针对该流程，启动一个流程表示发起一个新的请假申请单，这就相当于 java 类与java 对象的关系，类定义好后需要new 创建一个对象使用，当然可以 new 多个对象。对于请假申请流程，张三发起一个请假申请单需要启动一个流程实例，请假申请单发起一个请假单也需要启动一个流程实例。
代码如下：

5.4任务查询

流程启动后，各各任务的负责人就可以查询自己当前需要处理的任务，查询出来的任务都是该用户 的待办任务。

// 查询当前个人待执行的任务
@Test
public void findPersonalTaskList() {
// 任务负责人
String assignee = "zhangsan";
// 创建TaskService
TaskService taskService = processEngine.getTaskService(); List list = taskService.createTaskQuery()//
.processDefinitionKey("myholiday01")//
.taskAssignee(assignee)//只查询该任务负责人的任务
.list();

for (Task task : list) {
System.out.println("	流
task.getProcessInstanceId());
System.out.println("任务id：" + task.getId());
System.out.println("任务负责人：" + task.getAssignee()); System.out.println("任务名称：" + task.getName());
}
}

5.5任务处理

任务负责人查询待办任务，选择任务进行处理，完成任务。

// 完成任务
@Test
public void completTask() {
//任务id
String taskId = "8305";
// 创建TaskService
TaskService taskService = processEngine.getTaskService();
//完成任务taskService.complete(taskId);
System.out.println("完成任务id="+taskId);
}

第6章 流程定义

6.1流程定义

6.1.1什么是流程定义

流程定义是线下按照 bpmn2.0 标准去描述 业务流程，通常使用activiti-explorer（web 控制台） 或 activiti-eclipse-designer 插件对业务流程进行建模，这两种方式都遵循 bpmn2.0 标准。本教程使用activiti-eclipse-designer 插件完成流程建模。使用designer 设计器绘制流程，会生成两个文件：.bpmn 和.png

6.1.2.bpmn 文件

使用activiti-desinger 设计业务流程，会生成.bpmn 文件，

首先将holiday.bpmn 文件改名为holiday.xml，如下图：

.bpmn 内容如下：

BPMN 2.0 根节点是 definitions 节点。 这个元素中，可以定义多个流程定义（不过我们建议每个文件只包含一个流程定义， 可以简化开发过程中的维护难度）。 注意，definitions 元素 最少也要包含xmlns 和 targetNamespace 的声明。 targetNamespace 可以是任意值，它用来对流程实例进行分类。

流程定义部分：定义了流程每个结点的描述及结点之间的流程流转。流程布局定义：定义流程每个结点在流程图上的位置坐标等信息。

6.1.3.png 图片文件

Eclipse 工具中的操作
流程图片生成的两种方式：
使用activiti-designer 设计流程图时自动生成需在eclipse 中进行配置：

使用designer 设计流程图的同时自动生成与bpmn 文件同名的图片文件(.png)

由activiti 自动生成图形

流程图设计完毕向activiti 中部署流程定义文件bpmn，部署时由 activiti 自动生成流程图片。(流程部署在下面的章节讲解)
注意：此方法生成时如果图形中有中文生成的图片上显示乱码，且.bpmn 中的坐标和图片显示错位。

IDEA 工具中的操作方式

第一步：将holiday.bpmn 文件改为扩展名xml 的文件名称：holiday.xml 修改前的bpmn 文件，效果如下：

第二步：在holiday.xml 文件上面，点右键并选择 Diagrams 菜单，再选择 Show BPMN2.0 Designer…

第三步：打开后的效果图如下：

第四步：

点击Export To File 的小图标，如下：

打开如下窗口，注意填写文件名及扩展名，选择好保存图片的位置：

第五步：中文乱码的解决
1.打开 IDEA 安装路径，找到如下的安装目录

根据自己所安装的版本来决定，我使用的是 64 位的 idea，所以在 idea64.exe.vmoptions 文件的最后一行追加一条命令： -Dfile.encoding=UTF-8
如下所示：

一定注意，不要有空格，否则重启 IDEA 时会打不开，然后 重启 IDEA，把原来的 png 图片删掉， 再重新生成，即可解决乱码问题

6.2流程定义部署

6.2.1什么是流程定义部署

将线下定义的流程部署到activiti 数据库中，这就是流程定义部署，通过调用 activiti 的api 将流程定义的 bpmn 和 png 两个文件一个一个添加部署到 activiti 中，也可以将两个文件打成 zip 包进行部署。

6.2.2单个文件部署方式

分别将bpmn 文件和png 图片文件部署。

@Test
public void deployProcess() {
// 获取repositoryService
RepositoryService repositoryService = processEngine
.getRepositoryService();
// bpmn输入流
InputStream inputStream_bpmn = this
.getClass()
.getClassLoader()
.getResourceAsStream(
"diagram/holiday.bpmn");
// 图片输入流
InputStream inputStream_png = this
.getClass()
.getClassLoader()
.getResourceAsStream(
" diagram/holiday.png");
// 流程部署对象
Deployment deployment = repositoryService.createDeployment()
.addInputStream("holiday.bpmn", inputStream_bpmn)
.addInputStream("holiday.png", inputStream_png)
.deploy();
System.out.println("流程部署id：" + deployment.getId()); System.out.println("流程部署名称：" + deployment.getName());
}

执行此操作后activiti 会将上边代码中指定的bpm 文件和图片文件保存在activiti 数据库。

6.2.3压缩包部署方式

将holiday.bpmn 和 holiday.png 压缩成 zip 包。

@Test
public void deployProcessByZip() {
// 定义zip输入流
InputStream inputStream = this
.getClass()
.getClassLoader()
.getResourceAsStream(
" diagram/holiday.zip");
ZipInputStream zipInputStream = new ZipInputStream(inputStream);
// 获取repositoryService
RepositoryService repositoryService = processEngine
.getRepositoryService();
// 流程部署
Deployment deployment = repositoryService.createDeployment()//
.addZipInputStream(zipInputStream)//
.deploy();
System.out.println("流程部署id：" + deployment.getId()); System.out.println("流程部署名称：" + deployment.getName());
}

执行此操作后activiti 会将上边代码中指定的bpm 文件和图片文件保存在activiti 数据库。

6.2.4操作数据表

流程定义部署后操作activiti 数据表如下：

SELECT * FROM act_re_deployment #流程定义部署表，记录流程部署信息SELECT * FROM act_re_procdef #流程定义表，记录流程定义信息SELECT * FROM act_ge_bytearray #资源表

说明：
act_re_deployment 和act_re_procdef 一对多关系，一次部署在流程部署表生成一条记录，但一次部署可以部署多个流程定义，每个流程定义在流程定义表生成一条记录。每一个流程定义在act_ge_bytearray 会存在两个资源记录，bpmn 和png。

建议：一次部署一个流程，这样部署表和流程定义表是一对一有关系，方便读取流程部署及流程定 义信息。

6.3流程定义查询

查询部署的流程定义。

// 流程定义查询

@Test
public void queryProceccDefinition() {
// 流程定义key
String processDefinitionKey = "holiday";
// 获取repositoryService
RepositoryService repositoryService = processEngine
.getRepositoryService();
// 查询流程定义
ProcessDefinitionQuery processDefinitionQuery = repositoryService
.createProcessDefinitionQuery();
//遍历查询结果
List list = processDefinitionQuery
.processDefinitionKey(processDefinitionKey)
.orderByProcessDefinitionVersion().desc().list();
for (ProcessDefinition processDefinition : list) { System.out.println("	");
System.out.println("流程定义id：" + processDefinition.getId());
System.out.println("流程定义名称：" + processDefinition.getName()); System.out.println("流程定义key：" + processDefinition.getKey());
System.out.println("流程定义版本：" + processDefinition.getVersion());
}
}

6.4流程定义删除

删除已经部署成功的流程定义。

public void deleteDeployment() {
// 流程部署id
String deploymentId = "8801";
// 通 过 流 程 引 擎 获 取 repositoryService RepositoryService repositoryService = processEngine
.getRepositoryService();
//删除流程定义，如果该流程定义已有流程实例启动则删除时出错repositoryService.deleteDeployment(deploymentId);
//设置true 级联删除流程定义，即使该流程有流程实例启动也可以删除，设置为false非级别删除方式，如果流程
//repositoryService.deleteDeployment(deploymentId, true);
}

说明：
1)使用repositoryService 删除流程定义
2)如果该流程定义下没有正在运行的流程，则可以用普通删除。
3)如果该流程定义下存在已经运行的流程，使用普通删除报错，可用级联删除方法将流程及相关 记录全部删除。项目开发中使用级联删除的情况比较多，删除操作一般只开放给超级管理员使 用。

6.5流程定义资源查询

6.5.1方式 1

通过流程定义对象获取流程定义资源，获取bpmn 和png。

@Test
public void getProcessResources() throws IOException {

// 流程定义id
String processDefinitionId = "";
// 获取repositoryService
RepositoryService repositoryService = processEngine
.getRepositoryService();
// 流程定义对象
ProcessDefinition processDefinition = repositoryService
.createProcessDefinitionQuery()

.processDefinitionId(processDefinitionId).singleResult();
//获取bpmn
String resource_bpmn = processDefinition.getResourceName();
//获取png
String	resource_png	= processDefinition.getDiagramResourceName();

// 资源信息
System.out.println("bpmn：" + resource_bpmn); System.out.println("png：" + resource_png);

File file_png = new File("d:/purchasingflow01.png"); File file_bpmn = new File("d:/purchasingflow01.bpmn");

// 输出bpmn
InputStream resourceAsStream = null;
resourceAsStream = repositoryService.getResourceAsStream( processDefinition.getDeploymentId(), resource_bpmn);
FileOutputStream fileOutputStream=new
FileOutputStream(file_bpmn);
byte[] b = new byte[1024]; int len = -1;
while ((len = resourceAsStream.read(b, 0, 1024)) != -1) {
fileOutputStream.write(b, 0, len);
}

// 输出图片
resourceAsStream = repositoryService.getResourceAsStream( processDefinition.getDeploymentId(), resource_png);

fileOutputStream = new FileOutputStream(file_png);
// byte[] b = new byte[1024];
// int len = -1;
while ((len = resourceAsStream.read(b, 0, 1024)) != -1) {
fileOutputStream.write(b, 0, len);
}

}

6.5.2方式 2

通过查询流程部署信息获取流程定义资源。

// 获取流程定义图片资源
@Test
public void getProcessResources() throws IOException {
//流程部署id
String deploymentId = "9001";
// 通 过 流 程 引 擎 获 取 repositoryService RepositoryService repositoryService = processEngine
.getRepositoryService();
//读取资源名称
List	resources
repositoryService.getDeploymentResourceNames(deploymentId);
String resource_image = null;
//获取图片
for(String resource_name :resources){
if(resource_name.indexOf(".png")>=0){ resource_image = resource_name;
}
}
//图片输入流
InputStream inputStream=
repositoryService.getResourceAsStream(deploymentId, resource_image);

File exportFile = new File("d:/holiday.png");

FileOutputStream fileOutputStream=new
FileOutputStream(exportFile);
byte[] buffer = new byte[1024];
int len = -1;
//输出图片
while((len = inputStream.read(buffer))!=-1){ fileOutputStream.write(buffer, 0, len);
}
inputStream.close(); fileOutputStream.close();
}

说明：
1)deploymentId 为流程部署ID
2)resource_name 为act_ge_bytearray 表中NAME_列的值
3)使用repositoryService 的getDeploymentResourceNames 方法可以获取指定部署下得所有文件的名称

4)使用repositoryService 的getResourceAsStream 方法传入部署ID 和资源图片名称可以获取部署下指定名称文件的输入流

5)最后的将输入流中的图片资源进行输出。

6.6流程历史信息的查看

即使流程定义已经删除了，流程执行的历史信息通过前面的分析，依然保存在 activiti 的 act_hi_*相关的表中。所以我们还是可以查询流程执行的历史信息，可以通过 HistoryService 来查看相关的历史记录。

表中。所以我们还是可以查询流程执行的历史信息，可以通过 HistoryService 来查看相关的历史记录。
public void testHistoric01(){
HistoryService historyService = pe.getHistoryService(); HistoricActivityInstanceQuery query =
historyService.createHistoricActivityInstanceQuery(); query.processInstanceId("1501");

List list = query.list();
for(HistoricActivityInstance ai :list){ System.out.println(ai.getActivityId()); System.out.println(ai.getActivityName());
System.out.println(ai.getProcessDefinitionId()); System.out.println(ai.getProcessInstanceId()); System.out.println("==============================");
}
}