Activiti7学习（基础篇）
文章目录
-
- 学习链接
- 1. 工作流介绍
-
- 1.1工作流概念介绍
- 1.2工作流系统
- 1.3适用行业
- 1.4具体应用
- 2. Activiti介绍
-
- 2.1 介绍
-
- 2.1.1BPM
- 2.1.2BPM软件
- 2.1.3BPMN
- 2.2使用步骤
-
- 部署activiti
- 流程定义
- 流程定义部署
- 启动一个流程实例
- 用户查询待办任务(Task)
- 用户办理任务
- 流程结束
- 3. Activiti应用
-
- 3.1 Activiti的基本使用
-
- 3.1.1 创建Maven项目
- 3.1.2 log4j
- 3.1.3 添加Activiti配置文件
- 3.1.4 Java程序生成表结构
- 3.2 表结构介绍
-
- 3.2.1 表的命名规则和作用
- 3.2.2 Activiti数据表介绍
- 3.3 ProcessEngine创建方式
- 3.4Servcie服务接口
-
- 3.4.1Service创建方式
- 3.4.2 Service总览
-
- RepositoryService
- RuntimeService
- TaskService
- HistoryService
- ManagementService
- 3.5 流程绘制
-
- 3.5.1 绘制插件
- 3.5.2 绘制流程
-
- 指定流程的主键
- 指定任务的负责人
- 在idea中，可使用actiBPM插件，如下操作
- 3.5.3图标介绍
-
- 流程符号
-
- 事件 Event
- 活动 Activity
- 网关 GateWay
-
- 排他网关 (x)
- 并行网关 (+)
- 包容网关 (+)
- 事件网关 (+)
- 流向 Flow
- 流程设计器使用
- 4.Activiti流程操作
-
- 4.1流程的部署
-
- 4.1.1单个文件部署
- 4.1.2 部署zip文件
- 4.1.3操作数据表
- 4.2 启动流程实例
- 4.3任务查找
- 4.4流程任务处理
- 4.5流程定义的查询
- 4.6流程的删除
- 4.7流程资源的下载
- 4.8流程历史信息查看
学习链接
【全套完整版】2023最新工作流引擎Activiti7最全讲解，从基础到进阶到项目
2021全网最全Activiti7教程01(Activiti7详细介绍-欢迎收藏) - 原博主
Activiti专栏
Activiti工作流专栏
Activiti6专栏
- 【弄nèng - Activiti6】Springboot搭建Activiti整合流程设计器
工作流
1. 工作流介绍
1.1工作流概念介绍
工作流(Workflow)，就是通过计算机对业务流程自动化执行管理。它主要解决的是“使在多个参与者之 间按照某种预定义的规则自动进行传递文档、信息或任务的过程，从而实现某个预期的业务目标，或者 促使此目标的实现”。
1.2工作流系统
一个软件系统中具有工作流的功能，我们把它称为工作流系统，一个系统中工作流的功能是什么？就 是对系统的业务流程进行自动化管理，所以工作流是建立在业务流程的基础上，所以一个软件的系统核 心根本上还是系统的业务流程，工作流只是协助进行业务流程管理。即使没有工作流业务系统也可以开 发运行，只不过有了工作流可以更好的管理业务流程，提高系统的可扩展性。
1.3适用行业
消费品行业，制造业，电信服务业，银证险等金融服务业，物流服务业，物业服务业，物业管理，大 中型进出口贸易公司，政府事业机构，研究院所及教育服务业等，特别是大的跨国企业和集团公司。
1.4具体应用
1、关键业务流程：订单、报价处理、合同审核、客户电话处理、供应链管理等
2、行政管理类:出差申请、加班申请、请假申请、用车申请、各种办公用品申请、购买申请、日报周报 等凡是原来手工流转处理的行政表单。
3、人事管理类：员工培训安排、绩效考评、职位变动处理、员工档案信息管理等。
4、财务相关类：付款请求、应收款处理、日常报销处理、出差报销、预算和计划申请等。
5、客户服务类：客户信息管理、客户投诉、请求处理、售后服务管理等。
6、特殊服务类：ISO系列对应流程、质量管理对应流程、产品数据信息管理、贸易公司报关处理、物流 公司货物跟踪处理等各种通过表单逐步手工流转完成的任务均可应用工作流软件自动规范地实施。
2. Activiti介绍
2.1 介绍
Alfresco软件在2010年5月17日宣布Activiti业务流程管理（BPM）开源项目的正式启动，其首席架构 师由业务流程管理BPM的专家 Tom Baeyens担任，Tom Baeyens就是原来jbpm的架构师，而jbpm是一个非常有名的工作流引擎，当然activiti也是一个工作流引擎。
Activiti是一个工作流引擎， activiti可以将业务系统中复杂的业务流程抽取出来，使用专门的建模语言BPMN2.0进行定义，业务流程按照预先定义的流程进行执行，实现了系统的流程由activiti进行管理，减 少业务系统由于流程变更进行系统升级改造的工作量，从而提高系统的健壮性，同时也减少了系统开发 维护成本。
官方网站：https://www.activiti.org/
2.1.1BPM
BPM（Business Process Management），即业务流程管理，是一种规范化的构造端到端的业务流程， 以持续的提高组织业务效率。常见商业管理教育如EMBA、MBA等均将BPM包含在内。
2.1.2BPM软件
BPM软件就是根据企业中业务环境的变化，推进人与人之间、人与系统之间以及系统与系统之间的整合 及调整的经营方法与解决方案的IT工具。
通过BPM软件对企业内部及外部的业务流程的整个生命周期进行建模、自动化、管理监控和优化，使企 业成本降低，利润得以大幅提升。
BPM软件在企业中应用领域广泛，凡是有业务流程的地方都可以BPM软件进行管理，比如企业人事办公 管理、采购流程管理、公文审批流程管理、财务管理等。
2.1.3BPMN
BPMN（Business Process Model AndNotation）- 业务流程模型和符号 是由BPMI（BusinessProcess 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图形其实是通过xml表示业务流程，上边的.bpmn文件使用文本编辑器打开：
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:activiti="http://activiti.org/bpmn" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC" xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI" typeLanguage="http://www.w3.org/2001/XMLSchema" expressionLanguage="http://www.w3.org/1999/XPath" targetNamespace="http://www.activiti.org/test">
<process id="myProcess" name="My process" isExecutable="true">
<startEvent id="startevent1" name="Start">startEvent>
<userTask id="usertask1" name="创建请假单">userTask>
<sequenceFlow id="flow1" sourceRef="startevent1" targetRef="usertask1">
sequenceFlow>
<userTask id="usertask2" name="部门经理审核">userTask>
<sequenceFlow id="flow2" sourceRef="usertask1" targetRef="usertask2">
sequenceFlow>
<userTask id="usertask3" name="人事复核">userTask>
<sequenceFlow id="flow3" sourceRef="usertask2" targetRef="usertask3">
sequenceFlow>
<endEvent id="endevent1" name="End">endEvent>
<sequenceFlow id="flow4" sourceRef="usertask3" targetRef="endevent1">
sequenceFlow>
process>
<bpmndi:BPMNDiagram id="BPMNDiagram_myProcess">
<bpmndi:BPMNPlane bpmnElement="myProcess" id="BPMNPlane_myProcess">
<bpmndi:BPMNShape bpmnElement="startevent1" id="BPMNShape_startevent1">
<omgdc:Bounds height="35.0" width="35.0" x="130.0" y="160.0">
omgdc:Bounds>
bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="usertask1" id="BPMNShape_usertask1">
<omgdc:Bounds height="55.0" width="105.0" x="210.0" y="150.0">
omgdc:Bounds>
bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="usertask2" id="BPMNShape_usertask2">
<omgdc:Bounds height="55.0" width="105.0" x="360.0" y="150.0">
omgdc:Bounds>
bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="usertask3" id="BPMNShape_usertask3">
<omgdc:Bounds height="55.0" width="105.0" x="510.0" y="150.0">
omgdc:Bounds>
bpmndi:BPMNShape>
<bpmndi:BPMNShape bpmnElement="endevent1" id="BPMNShape_endevent1">
<omgdc:Bounds height="35.0" width="35.0" x="660.0" y="160.0">
omgdc:Bounds>
bpmndi:BPMNShape>
<bpmndi:BPMNEdge bpmnElement="flow1" id="BPMNEdge_flow1">
<omgdi:waypoint x="165.0" y="177.0">omgdi:waypoint>
<omgdi:waypoint x="210.0" y="177.0">omgdi:waypoint>
bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="flow2" id="BPMNEdge_flow2">
<omgdi:waypoint x="315.0" y="177.0">omgdi:waypoint>
<omgdi:waypoint x="360.0" y="177.0">omgdi:waypoint>
bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="flow3" id="BPMNEdge_flow3">
<omgdi:waypoint x="465.0" y="177.0">omgdi:waypoint>
<omgdi:waypoint x="510.0" y="177.0">omgdi:waypoint>
bpmndi:BPMNEdge>
<bpmndi:BPMNEdge bpmnElement="flow4" id="BPMNEdge_flow4">
<omgdi:waypoint x="615.0" y="177.0">omgdi:waypoint>
<omgdi:waypoint x="660.0" y="177.0">omgdi:waypoint>
bpmndi:BPMNEdge>
bpmndi:BPMNPlane>
bpmndi:BPMNDiagram>
definitions>
2.2使用步骤
部署activiti
Activiti是一个工作流引擎（其实就是一堆jar包API），业务系统访问(操作)activiti的接口，就可以方便的 操作流程相关数据，这样就可以把工作流环境与业务系统的环境集成在一起。
流程定义
- 使用activiti流程建模工具(activity-designer)定义业务流程(.bpmn文件) 。
- .bpmn文件就是业务流程定义文件，通过xml定义业务流程。
流程定义部署
- activiti部署业务流程定义（.bpmn文件）。
- 使用activiti提供的api把流程定义内容存储起来，在Activiti执行过程中可以查询定义的内容
- Activiti执行把流程定义内容存储在数据库中
启动一个流程实例
- 流程实例也叫：ProcessInstance
- 启动一个流程实例表示开始一次业务流程的运行。
- 在员工请假流程定义部署完成后，如果张三要请假就可以启动一个流程实例，如果李四要请假也启动一 个流程实例，两个流程的执行互相不影响。
用户查询待办任务(Task)
因为现在系统的业务流程已经交给activiti管理，通过activiti就可以查询当前流程执行到哪了，当前用户 需要办理什么任务了，这些activiti帮我们管理了，而不需要开发人员自己编写在sql语句查询。
用户办理任务
用户查询待办任务后，就可以办理某个任务，如果这个任务办理完成还需要其它用户办理，比如采购单 创建后由部门经理审核，这个过程也是由activiti帮我们完成了。
流程结束
当任务办理完成没有下一个任务结点了，这个流程实例就完成了。
3. Activiti应用
3.1 Activiti的基本使用
3.1.1 创建Maven项目
创建一个普通的Maven项目，并添加相关的依赖
<properties>
<slf4j.version>1.6.6slf4j.version>
<log4j.version>1.2.12log4j.version>
<activiti.version>7.0.0.Beta1activiti.version>
properties>
<dependencies>
<dependency>
<groupId>org.activitigroupId>
<artifactId>activiti-engineartifactId>
<version>${activiti.version}version>
dependency>
<dependency>
<groupId>org.activitigroupId>
<artifactId>activiti-springartifactId>
<version>${activiti.version}version>
dependency>
<dependency><groupId>org.activitigroupId>
<artifactId>activiti-bpmn-modelartifactId>
<version>${activiti.version}version>
dependency>
<dependency>
<groupId>org.activitigroupId>
<artifactId>activiti-bpmn-converterartifactId>
<version>${activiti.version}version>
dependency>
<dependency>
<groupId>org.activitigroupId>
<artifactId>activiti-json-converterartifactId>
<version>${activiti.version}version>
dependency>
<dependency>
<groupId>org.activitigroupId>
<artifactId>activiti-bpmn-layoutartifactId>
<version>${activiti.version}version>
<exclusions>
<exclusion>
<groupId>com.github.jgraphgroupId>
<artifactId>jgraphxartifactId>
exclusion>
exclusions>
dependency>
<dependency>
<groupId>org.activiti.cloudgroupId>
<artifactId>activiti-cloud-services-apiartifactId>
<version>${activiti.version}version>
dependency>
<dependency>
<groupId>mysqlgroupId>
<artifactId>mysql-connector-javaartifactId>
<version>5.1.40version>
dependency>
<dependency>
<groupId>org.mybatisgroupId>
<artifactId>mybatisartifactId>
<version>3.4.5version>
dependency>
<dependency>
<groupId>commons-dbcpgroupId>
<artifactId>commons-dbcpartifactId>
<version>1.4version>
dependency>
<dependency>
<groupId>junitgroupId>
<artifactId>junitartifactId>
<version>4.12version>
dependency>
<dependency>
<groupId>log4jgroupId>
<artifactId>log4jartifactId>
<version>${log4j.version}version>
dependency>
<dependency>
<groupId>org.slf4jgroupId>
<artifactId>slf4j-apiartifactId>
<version>${slf4j.version}version>
dependency>
<dependency>
<groupId>org.slf4jgroupId>
<artifactId>slf4j-log4j12artifactId>
<version>${slf4j.version}version>
dependency>
dependencies>
3.1.2 log4j
添加一个日志文件log4j.properties
# Set root category priority to INFO and its only appender to CONSOLE.
#log4j.rootCategory=INFO, CONSOLE debug info warn error fatal
log4j.rootCategory=debug, CONSOLE, LOGFILE
# Set the enterprise logger category to FATAL and its only appender to CONSOLE.
log4j.logger.org.apache.axis.enterprise=FATAL, CONSOLE
# 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} %-6r[%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:\log\act\activiti.log
log4j.appender.LOGFILE.Append=true
log4j.appender.LOGFILE.layout=org.apache.log4j.PatternLayout
log4j.appender.LOGFILE.layout.ConversionPattern=%d{ISO8601} %-6r[%15.15t] %-5p %30.30c %x - %m\n
3.1.3 添加Activiti配置文件
我们在本案例中使用的数据库是mysql8.0.
Activiti的默认的使用方式是要求我们在resources下创建activiti.cfg.xml文件，默认的方式的名称是不能修改的。
在配置文件中我们有两种配置方式：一种是单独配置数据源，另一种是不单独配置数据源
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd">
<bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
<property name="jdbcDriver" value="com.mysql.cj.jdbc.Driver"/>
<property name="jdbcUrl" value="jdbc:mysql:///activiti2?characterEncoding=utf-8&nullCatalogMeansCurrent=true&serverTimezone=UTC"/>
<property name="jdbcUsername" value="root"/>
<property name="jdbcPassword" value="123456"/>
<property name="databaseSchemaUpdate" value="true"/>
bean>
<bean class="org.apache.commons.dbcp.BasicDataSource" id="dataSource">
<property name="driverClassName" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql:///activiti2?characterEncoding=utf-8&nullCatalogMeansCurrent=true&serverTimezone=UTC"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
<property name="maxActive" value="3"/>
<property name="maxIdle" value="2"/>
bean>
beans>
3.1.4 Java程序生成表结构
创建一个工具类，调用Activiti的工具类来生成activiti需要的表结构
public class Test01 {
/**
* 生成Activiti的相关的表结构
*/
@Test
public void test01(){
// 使用classpath下的activiti.cfg.xml中的配置来创建 ProcessEngine对象
// (注意：这个activiti.cfg.xml就是上面的spring的配置文件)
ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
System.out.println(engine);
}
}
执行的效果
执行完成后我们查看数据库，在其中创建了25张表，结果如下：
3.2 表结构介绍
3.2.1 表的命名规则和作用
看到刚才创建的表，我们发现Activiti 的表都以 ACT_ 开头。
第二部分是表示表的用途的两个字母标识。 用途也和服务的 API 对应。
ACT_RE ：'RE’表示 repository。 这个前缀的表包含了流程定义和流程静态资源 （图片，规则，等等）。
ACT_RU：'RU’表示 runtime。 这些运行时的表，包含流程实例，任务，变量，异步任务，等运行中的数据。 Activiti 只在流程实例执行过程中保存这些数据， 在流程结束时就会删除这些记录。 这样运行时表可以一直很小速度很快。
ACT_HI：'HI’表示 history。 这些表包含历史数据，比如历史流程实例， 变量，任务等等。
ACT_GE ： GE 表示 general。 通用数据， 用于不同场景下
3.2.2 Activiti数据表介绍
3.3 ProcessEngine创建方式
前面使用的是getDefaultProcessEngine()方法来加载classpath下的 activiti.cfg.xml文件，有些情况下我们可能没有按照默认的方式来处理，那这时我们应该怎么办呢？
/**
* 自定义的方式来加载配置文件
*/
@Test
public void test02() {
// 首先创建ProcessEngineConfiguration对象
// (其中activiti.cfg.xml就是spring的配置文件,
// 然后里面定义了1个名为: processEngineConfiguration的bean，
// 并且它的类型必须是ProcessEngineConfiguration类型的)
ProcessEngineConfiguration configuration = ProcessEngineConfiguration
.createProcessEngineConfigurationFromResource("activiti.cfg.xml");
// 通过ProcessEngineConfiguration对象来创建 ProcessEngine对象
ProcessEngine processEngine = configuration.buildProcessEngine();
}
3.4Servcie服务接口
Service是工作流引擎提供用于进行工作流部署、执行、管理的服务接口，我们使用这些接口可以就是操 作服务对应的数据表
3.4.1Service创建方式
通过ProcessEngine创建Service
方式如下：
RuntimeService runtimeService = processEngine.getRuntimeService();
RepositoryService repositoryService = processEngine.getRepositoryService();
TaskService taskService = processEngine.getTaskService();
3.4.2 Service总览
RepositoryService
是activiti的资源管理类，提供了管理和控制流程发布包和流程定义的操作。使用工作流建模工具设计的
业务流程图需要使用此service将流程定义文件的内容部署到计算机。
除了部署流程定义以外还可以：查询引擎中的发布包和流程定义。
暂停或激活发布包，对应全部和特定流程定义。 暂停意味着它们不能再执行任何操作了，激活是对应的反向操作。获得多种资源，像是包含在发布包里的文件， 或引擎自动生成的流程图。
获得流程定义的pojo版本， 可以用来通过java解析流程，而不必通过xml。
RuntimeService
Activiti的流程运行管理类。可以从这个服务类中获取很多关于流程执行相关的信息
TaskService
Activiti的任务管理类。可以从这个类中获取任务的信息。
HistoryService
Activiti的历史管理类，可以查询历史信息，执行流程时，引擎会保存很多数据（根据配置），比如流程实例启动时间，任务的参与者， 完成任务的时间，每个流程实例的执行路径，等等。 这个服务主要通过查询功能来获得这些数据。
ManagementService
Activiti的引擎管理类，提供了对 Activiti 流程引擎的管理和维护功能，这些功能不在工作流驱动的应用程序中使用，主要用于 Activiti 系统的日常维护。
3.5 流程绘制
3.5.1 绘制插件
由于Idea 在2019年之后就没有再更新维护Activiti的设计工具了，那么在高版本的IDEA中我们就没法使用actiBPM插件来绘制了，这时可以选择降低版本来使用，或者使用我们给大家提供的Eclipse来实现流程的设计。
我们提供给大家的Eclipse是已经集成好了Activiti插件的。
创建一个Activiti项目
3.5.2 绘制流程
使用滑板来绘制流程，通过从右侧把图标拖拽到左侧的面板，最终的效果
指定流程的主键
（注意：要点击空白的地方）
指定任务的负责人
在Properties视图中指定每个任务节点的负责人（注意：要选中对应的userTask的框框）：
经理审批：lisi
总经理审批：wangwu
财务审批：xiaoming
当我们设置完成后保存文件，会同时生成png图片
然后将这两个文件拷贝到IDEA项目中即可
在idea中，可使用actiBPM插件，如下操作
在idea中，绘制流程图
将evection.bpmn复制一份，并改名为evection.xml
将文件导出即可，然后将导出的文件拷贝到项目里
3.5.3图标介绍
流程符号
BPMN 2.0是业务流程建模符号2.0的缩写。
它由Business Process Management Initiative这个非营利协会创建并不断发展。作为一种标识，BPMN 2.0是使用一些符号来明确业务流程设计流程图的一整套符号规范，它能增进业务建模时的沟通效率。
目前BPMN2.0是最新的版本，它用于在BPM上下文中进行布局和可视化的沟通。 接下来我们先来了解在流程设计中常见的 符号。
BPMN2.0的基本符合主要包含：
事件 Event
活动 Activity
活动是工作或任务的一个通用术语。一个活动可以是一个任务，还可以是一个当前流程的子处理流程；
其次，你还可以为活动指定不同的类型。常见活动如下：
网关 GateWay
网关用来处理决策，有几种常用网关需要了解：
排他网关 (x)
——只有一条路径会被选择。流程执行到该网关时，按照输出流的顺序逐个计算，当条件的计算结果为true时，继续执行当前网关的输出流；
如果多条线路计算结果都是 true，则会执行第一个值为 true 的线路。如果所有网关计算结果没有true，则引擎会抛出异常。
排他网关需要和条件顺序流结合使用，default 属性指定默认顺序流，当所有的条件不满足时会执行默认顺序流。
并行网关 (+)
——所有路径会被同时选择
-
拆分 —— 并行执行所有输出顺序流，为每一条顺序流创建一个并行执行线路。
-
合并 —— 所有从并行网关拆分并执行完成的线路均在此等候，直到所有的线路都执行完成才继续向下执行。
包容网关 (+)
—— 可以同时执行多条线路，也可以在网关上设置条件
- 拆分 —— 计算每条线路上的表达式，当表达式计算结果为true时，创建一个并行线路并继续执行
- 合并 —— 所有从并行网关拆分并执行完成的线路均在此等候，直到所有的线路都执行完成才继续向下执行。
事件网关 (+)
—— 专门为中间捕获事件设置的，允许设置多个输出流指向多个不同的中间捕获事件。当流程执行到事件网关后，流程处于等待状态，需要等待抛出事件才能将等待状态转换为活动状态。
流向 Flow
流是连接两个流程节点的连线。常见的流向包含以下几种：
流程设计器使用
Palette（ 画 板 ）
Connection—连接
Event—事件
Task—任务
Gateway—网关
Container—容器
Boundary event—边界事件
Intermediate event- -中间事件
4.Activiti流程操作
4.1流程的部署
将上面在设计器中定义的流程部署到activiti数据库中，就是我们讲的流程部署。
通过调用Activiti的api将流程定义的bpmn和png两个文件一个一个添加部署到activiti中，还可以将两个文件打到zip包部署。
4.1.1单个文件部署
分别将bpmn文件和png图片分别部署
/**
* 实现文件的单个部署
*/
@Test
public void test03() {
// 1.获取ProcessEngine对象
ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
// 2.获取RepositoryService进行部署操作
RepositoryService service = engine.getRepositoryService();
// 3.使用RepositoryService进行部署操作
Deployment deploy = service.createDeployment()
.addClasspathResource("bpmn/evection.bpmn") // 添加bpmn资源
.addClasspathResource("bpmn/evection.png") // 添加png资源
.name("出差申请流程")
.deploy();// 部署流程
// 4.输出流程部署的信息
System.out.println("流程部署的id:" + deploy.getId());
System.out.println("流程部署的名称：" + deploy.getName());
}
日志中查看到相关的输出信息
4.1.2 部署zip文件
将bpmn文件和png文件两个打包为一个zip文件，统一上传
/**
* 通过一个zip文件来部署操作
*/ @Test
public void test04() {
// 定义zip文件的输入流
InputStream inputStream = this.getClass().getClassLoader().getResourceAsStream("bpmn/evection.zip");
// 对 inputStream 做装饰
ZipInputStream zipInputStream = new ZipInputStream(inputStream);
ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
RepositoryService repositoryService = engine.getRepositoryService();
Deployment deploy = repositoryService.createDeployment()
.addZipInputStream(zipInputStream)
.name("出差申请流程")
.deploy();
// 4.输出流程部署的信息
System.out.println("流程部署的id:" + deploy.getId());
System.out.println("流程部署的名称：" + deploy.getName());
}
上传后的数据库中的数据和单个文件上传其实是一样的。
4.1.3操作数据表
流程定义部署后操作activiti中的三张表：
-
act_re_deployment: 流程定义部署表，每部署一次就增加一条记录
-
act_re_procdef ：流程定义表，部署每个新的流程定义都会在这张表中增加一条记录
-
act_ge_bytearray ：流程资源表，流程部署的 bpmn文件和png图片会保存在该表中
4.2 启动流程实例
流程定义部署在Activiti后就可以通过工作流管理业务流程，也就是说上边部署的出差申请流程可以使用了。
针对该流程，启动一个流程表示发起一个新的出差申请单，这就相当于Java类和Java对象的关系，类定 义好了后需要new创建一个对象使用，当然可以new出多个对象来，对于出差申请流程，张三可以发起 一个出差申请单需要启动一个流程实例。
/**
* 启动一个流程实例
*/
@Test
public void test05() {
// 1.创建ProcessEngine对象
ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
// 2.获取RuntimeService对象
RuntimeService runtimeService = engine.getRuntimeService();
// 3.根据流程定义的id启动流程
// (注意: 这个“evection”就是在创建bpmn文件时, 点击空白区域时, 填入的id, 它会存入到 act_re_procdef表的KEY_字段中，
// 这里通过它来创建1个流程实例)
// （ act_re_procdef表的KEY_字段就是processDefinitionKey,
// act_re_procdef表的ID_字段就是processDefinitionId,
// runtimeService可使用processDefinitionKey或processDefinitionId开启1个流程实例）
String id= "evection";
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(id);
// 4.输出相关的流程实例信息
System.out.println("流程定义的ID：" + processInstance.getProcessDefinitionId());
System.out.println("流程实例的ID：" + processInstance.getId());
System.out.println("当前活动的ID：" + processInstance.getActivityId());
}
输出内容：
启动流程实例涉及到的表结构
- act_hi_actinst 流程实例执行历史
- act_hi_identitylink 流程的参与用户的历史信息
- act_hi_procinst 流程实例历史信息
- act_hi_taskinst 流程任务历史信息
- act_ru_execution 流程执行信息
- act_ru_identitylink 流程的参与用户信息
- act_ru_task 任务信息
4.3任务查找
流程启动后，任务的负责人就可以查询自己当前能够处理的任务了，查询出来的任务都是当前用户的待 办任务
/**
* 任务查询
*/ @Test
public void test06(){
String assignee ="zhansan";
ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
// 任务查询 需要获取一个 TaskService 对象
TaskService taskService = engine.getTaskService();
// 根据流程的key和任务负责人 查询任务
// （就是通过ACT_RU_TASK - 任务表 与 ACT_RE_PROCDEF - 流程定义表 内连接查询的）
// （ACT_RU_TASK只会存当前待办的任务，已办的任务会被删掉）
List<Task> list = taskService.createTaskQuery()
.processDefinitionKey("evection")
.taskAssignee(assignee)
.list();
// 输出当前用户具有的任务
for (Task task : list) {
System.out.println("流程实例id：" + task.getProcessInstanceId()); // (流程实例id: 对应act_hi_procinst表的ID_字段, 也同 同表的 PROC_INST_ID_字段)
System.out.println("任务id:" + task.getId());
System.out.println("任务负责人：" + task.getAssignee());
System.out.println("任务名称：" + task.getName());
}
}
输出结果
4.4流程任务处理
任务负责人查询出来了待办的人，选择任务进行处理，完成任务
/**
* 流程任务的处理
*/
@Test
public void test07() {
ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
TaskService taskService = engine.getTaskService();
// 查询zhangsan在指定流程定义下的任务
// （注意：这里最好带上条件去查询，小心把任务都查出来了）
Task task = taskService.createTaskQuery()
.processDefinitionKey("evection")
.taskAssignee("zhansan")
.singleResult();
// 完成任务
taskService.complete(task.getId());
}
zhangsan处理了这个操作后，流程就流转到了 lisi处
然后就是不同的用户登录，然后查询任务处理任务，直到任务流程走完。
(act_hi_actinst记录了流程实例的每个任务步骤的数据，并且act_hi_actinst表有个PROC_INST_ID字段指向act_hi_procinst表的PROC_INST_ID字段，而act_hi_procinst表对于每个流程实例都只会记录1条流程实例数据。对于act_hi_taskinst表来说，1个流程实例会对应该表中的多条数据，同时该表的PROC_INST_ID字段同样指向act_hi_procinst表的PROC_INST_ID字段字段，但是与act_hi_actinst相比，又不包括开始事件)
4.5流程定义的查询
查询流程相关的信息，包括流程的定义，流程的部署，流程定义的版本
/**
* 查询流程的定义
*/
@Test
public void test08() {
ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
RepositoryService repositoryService = engine.getRepositoryService();
// 获取一个 ProcessDefinitionQuery对象 用来查询操作
ProcessDefinitionQuery processDefinitionQuery = repositoryService.createProcessDefinitionQuery();
// （这里还可以根据部署id来查，因为我们部署1个流程的时候，可以拿到部署id，可以由此部署id拿到此次部署的流程定义数据）
List<ProcessDefinition> list = processDefinitionQuery
.processDefinitionKey("evection") // 这里的evection就是创建bpmn文件时,点击空白区域,设置的id 对应的内容
.orderByProcessDefinitionVersion() // 安装版本排序
.desc() // 倒序
.list();
// 输出流程定义的信息
for (ProcessDefinition processDefinition : list) {
System.out.println("流程定义的ID：" + processDefinition.getId());
System.out.println("流程定义的name：" + processDefinition.getName());
System.out.println("流程定义的key：" + processDefinition.getKey());
System.out.println("流程定义的version:" + processDefinition.getVersion());
System.out.println("流程部署的id:" + processDefinition.getDeploymentId());
}
}
输出结果
流程定义的ID：evection:1:12504
流程定义的name：出差申请单
流程定义的key:evection
流程定义的version:1
流程部署的id:12501
4.6流程的删除
/**
* 删除流程
*/
@Test
public void test09() {
ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
RepositoryService repositoryService = engine.getRepositoryService();
// 删除流程定义，如果该流程定义已经有了流程实例启动，则删除时会报错
// （传入act_re_deployment表的ID_字段）
repositoryService.deleteDeployment("12501");
// 设置为TRUE 级联删除流程定义，即使流程有实例启动，也可以删除，设置为false 非级联删除操作。
// （注意：设置为true的话，act_hi_*表中的历史数据也会被清空掉）
//repositoryService.deleteDeployment("12501",true);
}
注意：项目开发中级联删除操作的权限一般只开发给超级管理员使用。
4.7流程资源的下载
现在我们的流程资源文件已经上传到了数据库中，如果其他用户想要查看这些资源，可以从数据库中把 这些资源下载到本地。
解决方案：
- jdbc对blob类型处理clob类型数据读取出来就可以了。
- 使用activiti的api来实现操作。
使用activiti的api来操作我们需要添加commons-io的依赖
<dependency>
<groupId>commons-iogroupId>
<artifactId>commons-ioartifactId>
<version>2.6version>
dependency>
实现代码
/**
* 读取数据库中的资源文件
*/
@Test
public void test10() throws Exception {
// 1.得到ProcessEngine对象
ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
// 2.获取RepositoryService对象
RepositoryService repositoryService = engine.getRepositoryService();
// 3.得到查询器
ProcessDefinition definition = repositoryService.createProcessDefinitionQuery()
.processDefinitionKey("evection")
.singleResult();
// 4.获取流程部署的id
String deploymentId = definition.getDeploymentId();
// 5.通过repositoryService对象的相关方法 来获取图片信息和bpmn信息
// png图片
InputStream pngInput = repositoryService
.getResourceAsStream(deploymentId, definition.getDiagramResourceName());
// bpmn 文件的流
InputStream bpmnInput = repositoryService
.getResourceAsStream(deploymentId, definition.getResourceName());
// 6.文件的保存
File filePng = new File("d:/evection.png");
File fileBpmn = new File("d:/evection.bpmn");
OutputStream pngOut = new FileOutputStream(filePng);
OutputStream bpmnOut = new FileOutputStream(fileBpmn);
IOUtils.copy(pngInput, pngOut);
IOUtils.copy(bpmnInput, bpmnOut);
pngInput.close();
pngOut.close();
bpmnInput.close();
bpmnOut.close();
}
4.8流程历史信息查看
即使流程定义已经被删除了，流程执行的实例信息通过前面的分析，依然保存在Activiti的act_hi_* 的相关表结构中，所以我们还是可以查询流程的执行的历史信息，可以通过HistoryService来查看
/**
* 流程历史信息查看
*/
@Test
public void test11() {
ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
// 查看历史信息我们需要通过 HistoryService来实现
HistoryService historyService = engine.getHistoryService();
// 获取 actinst 表的查询对象
HistoricActivityInstanceQuery instanceQuery = historyService.createHistoricActivityInstanceQuery();
instanceQuery.processDefinitionId("evection:1:12504");
instanceQuery.orderByHistoricActivityInstanceStartTime().desc();
List<HistoricActivityInstance> list = instanceQuery.list();
// 输出查询的结果
for (HistoricActivityInstance hi : list) {
System.out.println(hi.getActivityId());
System.out.println(hi.getActivityName());
System.out.println(hi.getActivityType());
System.out.println(hi.getAssignee());
System.out.println(hi.getProcessDefinitionId());
System.out.println(hi.getProcessInstanceId());
System.out.println(" ");
}
}
输出结果
usertask3
总经理审批
userTask
wangwu
evection:1:12504
15001
-----------------------
usertask2
经理审批
userTask
lisi
evection:1:12504
15001
-----------------------
usertask1
创建请假单
userTask
zhansan
evection:1:12504
15001
-----------------------
startevent1
Start
startEvent
null
evection:1:12504
15001
-----------------------