1、Activity工作流学习笔记

Activiti工作流

一：Activiti第一天

1：工作流的概念

说明：

1) 假设：这两张图就是华谊兄弟的请假流程图

2) 图的组成部分：

A. 人物：范冰冰 冯小刚 王中军

B. 事件（动作）：请假、批准、不批准

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

工作流管理系统(Workflow Management System, WfMS)是一个软件系统，它完成工作量的定义和管理，并按照在系统中预先定义好的工作流规则进行工作流实例的执行。工作流管理系统不是企业的业务系统，而是为企业的业务系统的运行提供了一个软件的支撑环境。

工作流管理联盟(WfMC， Workflow Management Coalition) 给出的关于工作流管理系统的定义是：工作流管理系统是一个软件系统，它通过执行经过计算的流程定义去支持一批专门设定的业务流程。 工作流 管理系统被用来 定义、管理、和执行 工作流程。

工作流管理系统的目标：管理工作的流程以确保工作在正确的时间被期望的人员所执行——在自动化进行的业务过程中插入人工的执行和干预。

2：工作流的执行过程

演示程序：Activiti控制台

3： Activiti 介绍

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

流程图。

3.1：工作流引擎

ProcessEngine对象，这是 Activiti 工作的核心。负责生成流程运行时的各种实例及数据、监控和管理流程的运行。

3.2： BPMN

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

3.3：数据库（先学后看）

Activiti 数据库支持：

Activiti 的后台是有数据库的支持，所有的表都以 ACT_ 开头。 第二部分是表示表的用途的两个字母标识。 用途也和服务的 API 对应。

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

ACT_RU_*: 'RU' 表示 runtime 。 这些运行时的表，包含流程实例，任务，变量，异步任务，等运行中的数据。

Activiti 只在流程实例执行过程中保存这些数据， 在流程结束时就会删除这些记录。 这样运行时表可以一直很小速度很快。

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

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

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

表结构操作：

3.3.1：资源库流程规则表

1) act_re_deployment 部署信息表

2) act_re_model 流程设计模型部署表

3) act_re_procdef 流程定义数据表

3.3.2：运行时数据库表

1) act_ru_execution 运行时流程执行实例表

2) act_ru_identitylink 运行时流程人员表，主要存储任务节点与参与者的相关信息

3) act_ru_task 运行时任务节点表

4) act_ru_variable 运行时流程变量数据表

3.3.3：历史数据库表

1) act_hi_actinst 历史节点表

2) act_hi_attachment 历史附件表

3) act_hi_comment 历史意见表

4) act_hi_identitylink 历史流程人员表

5) act_hi_detail 历史详情表，提供历史变量的查询

6) act_hi_procinst 历史流程实例表

7) act_hi_taskinst 历史任务实例表

8) act_hi_varinst 历史变量表

3.3.4：组织机构表

1) act_id_group 用户组信息表

2) act_id_info 用户扩展信息表

3) act_id_membership 用户与用户组对应信息表

4) act_id_user 用户信息表

这四张表很常见，基本的组织机构管理，关于用户认证方面建议还是自己开发一套，组件自带的功能太简单，使用中有很多需求难以满足

3.3.5：通用数据表

1) act_ge_bytearray 二进制数据表

2) act_ge_property 属性数据表存储整个流程引擎级别的数据,初始化表结构时，会默认插入三条记录，

3.4： activiti.cfg.xml （activiti的配置文件）

Activiti核心配置文件，配置流程引擎创建工具的基本参数和数据库连接池参数。

定义数据库配置参数：

l jdbcUrl : 数据库的 JDBC URL 。

l jdbcDriver : 对应不同数据库类型的驱动。

l jdbcUsername : 连接数据库的用户名。

l jdbcPassword : 连接数据库的密码。

基于 JDBC 参数配置的数据库连接 会使用默认的 MyBatis 连接池。 下面的参数可以用来配置连接池（来自 MyBatis 参数）：

l jdbcMaxActiveConnections : 连接池中处于被使用状态的连接的最大值。默认为 10 。

l jdbcMaxIdleConnections : 连接池中处于空闲状态的连接的最大值。

l jdbcMaxCheckoutTime : 连接被取出使用的最长时间，超过时间会被强制回收。 默认为 20000 （ 20 秒）。

l jdbcMaxWaitTime : 这是一个底层配置，让连接池可以在长时间无法获得连接时， 打印一条日志，并重新尝试获取一个连接。（避免因为错误配置导致沉默的操作失败）。 默认为 20000 （ 20 秒）。

示例数据库配置：

也可以使用javax.sql.DataSource。 （比如， Apache Commons 的 DBCP ）：

3.5： logging.properties （日志处理）

日志的配置文件，Activiti操作数据库的时候，整合的日志文件

4：准备环境

4.1： activiti5 软件环境

1) JDK1.6或者更高版本

2) 支持的数据库有：h2, mysql, oracle, postgres, mssql, db2等。

3) 支持activiti5运行的jar包

4) 开发环境为Eclipse3.7或者以上版本,myeclipse为8.6版本

4.2：相关资源下载

1) JDK可以到sun的官网下载

http://www.oracle.com/technetwork/java/javase/downloads/index.html

2) 数据库，例如：mysql可以在官网上下载。

http://www.mysql.com

3) activiti也可以到Activiti官方网站下载得到。

http://activiti.org/download.html

4) Eclipse3.7或者MyEclipse8.6也可以到相应的网站上获得下载。

4.3：安装流程设计器 (eclipse 插件 )

4.3.1：安装方式一

在 有网络 的情况下，安装流程设计器步骤如下：

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

2) 在如下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…打开面板，如果看到下图内容：

说明安装成功了。

4.3.2：安装方式二

在 没有网络 的情况下，安装流程设计器步骤如下：

1) 解压老师发给大家的

2) 把压缩包中的内容放入eclipse根目录的dropins文件夹下

3) 重启eclipse，点击新建工程new->Other…打开面板，如果看到下图内容：

说明安装成功了

4.4：对流程设计器的使用说明

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

虽然流程引擎在单独部署bpmn文件时会自动生成图片，但在实际开发过程中，自动生成的图片会导致和 BPMN 中的坐标有出入，在实际项目中展示流程当前位置图会有问题。

所在完成以上配置后，会由我们自己来管理流程图片。在发布流程时把流程规则文件和流程图片一起上传就行了。

4.5：准备 Activiti5 开发环境

4.5.1：添加 Activiti5 的 jar 包

在activiti-5.13->wars目录下是一些示例项目，解压 activiti-rest 项目，导入 activiti-rest 目录中 WEB-INF\lib 下所有包。添加到 classpath 中。

由于我们使用的是Mysql数据库， Mysql 数据库的链接驱动 Activiti 官方包中并没有提供，需要我们自己导入。手动导入 mysql-connector-java.jar ，添加到 classpath 下。

4.5.2：初始化数据库

在Activiti中，在创建核心的流程引擎对象时会自动建表。如果程序正常执行， mysql 会自动建库，然后创建 23 张表。

4.5.3：添加并制定配置文件

在Actiiti5中定制流程必定会操作到数据库，如果都像上面那样写一大段代码会非常麻烦，所以我们可以把数据库连接配置写入配置文件。

在Activiti5的官方示例中并没有现成的配置文件，所以先得找到 activiti-rest\WEB-INF\classes 下有：

4.5.3.1： activiti-context.xml ：

一个类似spring结构的配置文件，清空内容后改名为 activiti.cfg.xml ，用来做流程引擎的相关配置。

按照上面代码配置ProcessEngineConfiguration对象，主要定义数据库的 连接配置 和 建表策略 ，配置文件代码如下：

Java代码如下：

createProcessEngineConfigurationFromResource的参数值为我们添加的配置文件 activiti.cfg.xml 的名称，执行 java 代码，流程引擎对象创建成功运行后数据库会自动建表。

4.5.3.2： log4j.properties 日志配置文件

把两个文件放入resource目录下即可。

5：核心 API

5.1： ProcessEngine

说明：

1) 在Activiti中最核心的类，其他的类都是由他而来。

2) 产生方式：

在前面看到了两种创建ProcessEngine（流程引擎）的方式，而这里要简化很多，调用 ProcessEngines 的 getDefaultProceeEngine 方法时会自动加载 classpath 下名为 activiti.cfg.xml 文件。

3) 可以产生RepositoryService

4) 可以产生RuntimeService

5) 可以产生TaskService

各个Service的作用：

RepositoryService	管理流程定义
RuntimeService	执行管理，包括启动、推进、删除流程实例等操作
TaskService	任务管理
HistoryService	历史管理(执行完的数据的管理)
IdentityService	组织机构管理
FormService	一个可选服务，任务表单管理
ManagerService

5.2： RepositoryService

是Activiti的仓库服务类。所谓的仓库指流程定义文档的两个文件： bpmn 文件和流程图片。

1) 产生方式

2) 可以产生DeploymentBuilder，用来定义流程部署的相关参数

3) 删除流程定义

5.3： RuntimeService

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

5.4： TaskService

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

5.5： HistoryService

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

5.6： ProcessDefinition

流程定义类。可以从这里获得资源文件等。

5.7： ProcessInstance

代表流程定义的执行实例。如范冰冰请了一天的假，她就必须发出一个流程实例的申请。一个流程实例包括了所有的运行节点。我们可以利用这个对象来了解当前流程实例的进度等信息。 流程实例就表示一个流程从开始到结束的最大的流程分支 ，即一个流程中流程实例只有一个。

5.8： Execution

Activiti用这个对象去描述流程执行的每一个节点。在没有并发的情况下， Execution 就是同 ProcessInstance 。 流程按照流程定义的规则执行一次的过程 ，就可以表示执行对象Execution。

如图为ProcessInstance的源代码：

从源代码中可以看出ProcessInstance就是Execution。但在现实意义上有所区别：

在单线流程中，如上图的贷款流程，ProcessInstance与Execution是一致的。

这个例子有一个特点：wire money(汇钱)和archive(存档)是并发执行的。 这个时候，总线路代表ProcessInstance，而分线路中每个活动代表Execution。

总结：

* 一个流程中，执行对象可以存在多个，但是流程实例只能有一个。

* 当流程按照规则只执行一次的时候，那么流程实例就是执行对象。

6： HelloWorld 程序（模拟流程的执行）

6.1：流程图：

6.2：部署流程定义

这里使用 RepositoryService 部署流程定义

addClasspathResource表示从类路径下加载资源文件，一次只能加载一个文件

6.3：启动流程实例

这里使用 RuntimeService 启动流程实例

6.4：查看我的个人任务

这里使用 TaskService 完成任务的查询

6.5：完成我的个人任务

这里使用 TaskService 完成任务的办理

7：管理流程定义

7.1：设计流程定义文档

7.1.1：流程图

7.1.2： bpmn 文件

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

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

1) bpmn文件

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

2) 展示流程图的图片

在系统里需要展示流程的进展图片， 图片是给用户看的 。

7.2：部署流程定义（ classpath 路径加载文件）

说明：

1) 先获取流程引擎对象：在创建时会自动加载classpath下的 activiti.cfg.xml

2) 首先获得默认的流程引擎，通过流程引擎获取了一个RepositoryService对象（仓库对象）

3) 由仓库的服务对象产生一个部署对象配置对象，用来封装部署操作的相关配置。

4) 这是一个链式编程，在部署配置对象中设置显示名，上传流程定义规则文件

5) 向数据库表中存放流程定义的规则信息。

6) 这一步在数据库中将操作三张表：

a) act_re_deploym ent（部署对象表）

存放流程定义的显示名和部署时间，每部署一次增加一条记录

b) act_re_procdef（流程定义表）

存放流程定义的属性信息，部署每个新的流程定义都会在这张表中增加一条记录。

注意：当流程定义的key相同的情况下，使用的是版本升级

c) act_ge_bytearray（资源文件表）

存储流程定义相关的部署信息。即流程定义文档的存放地。每部署一次就会增加两条记录，一条是关于bpmn规则文件的，一条是图片的（如果部署时只指定了 bpmn 一个文件， activiti 会在部署时解析 bpmn 文件内容自动生成流程图）。两个文件不是很大，都是以二进制形式存储在数据库中。

7.3：部署流程定义（ zip 格式文件）

将

压缩成zip格式的文件，使用 zip 的输入流用作部署流程定义

7.4：查看流程定义

查询流程定义的信息

结果：

再部署一次运行结果为：

可以看到流程定义的key值相同的情况下，版本是从 1 开始逐次升级的

流程定义的 I d是【 key ：版本：生成 ID 】

说明：

1) 流程定义和部署对象相关的Service都是 RepositoryService 。

2) 创建流程定义查询对象，可以在ProcessDefinitionQuery上设置查询的相关参数

3) 调用ProcessDefinitionQuery对象的 list 方法，执行查询，获得符合条件的流程定义列表

4) 由运行结果可以看出：

Key和 N ame的值为： bpmn 文件 process 节点的 id 和 name 的属性值

5) key属性被用来区别不同的流程定义。

6) 带有特定key的流程定义第一次部署时， version 为 1 。之后每次部署都会在当前最高版本号上加 1

7) I d的值的生成规则为 :{processDefinitionKey}:{processDefinitionVersion}:{generated-id}, 这里的 generated-id 是一个自动生成的唯一的数字

8) 重复部署一次，deploymentId的值以一定的形式变化

规则 act_ge_property 表生成

7.5：删除流程定义

删除部署到activiti中的流程定义。

说明：

1) 因为删除的是流程定义，而流程定义的部署是属于仓库服务的，所以应该先得到RepositoryService

2) 如果该流程定义下没有正在运行的流程，则可以用普通删除。如果是有关联的信息，用级联删除。项目开发中使用级联删除的情况比较多，删除操作一般只开放给超级管理员使用。

7.6：获取流程定义文档的资源（查看流程图附件）

查询出流程定义文档。主要查的是图片，用于显示流程用。

说明：

1) deploymentId为流程部署 ID

2) resourceName为 act_ge_bytearray 表中 NAME_ 列的值

3) 使用repositoryService的 getDeploymentResourceNames 方法可以获取指定部署下得所有文件的名称

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

5) 最后的有关IO流的操作，使用 FileUtils 工具的 copyInputStreamToFile 方法完成流程流程到文件的拷贝，将资源文件以流的形式输出到指定文件夹下

7.7：附加功能：查询最新版本的流程定义

7.8：附加功能：删除流程定义（删除 key 相同的所有不同版本的流程定义）

7.9：总结

Deployment 部署对象

1 、一次部署的多个文件的信息。对于不需要的流程可以删除和修改。

2 、对应的表：

act_re_deployment ：部署对象表

act_re_procdef ：流程定义表

act_ge_bytearray ：资源文件表

act_ge_property ：主键生成策略表

ProcessDefinition 流程定义

1 、解析 . bpmn后得到的流程定义规则的信息，工作流系统就是按照流程定义的规则执行的。

8：流程实例、任务的执行

8.1：流程图

8.2：部署流程定义

8.3：启动流程实例

说明：

1) 操作数据库的act_ru_execution表 , 如果是用户任务节点，同时也会在 act_ru_task 添加一条记录

8.4：查询我的个人任务

说明：

1) 因为是任务查询，所以从processEngine中应该得到 TaskService

2) 使用TaskService获取到任务查询对象 TaskQuery

3) 为查询对象添加查询过滤条件，使用taskAssignee指定任务的办理者（即查询指定用户的代办任务），同时可以添加分页排序等过滤条件

4) 调用list方法执行查询，返回办理者为指定用户的任务列表

5) 任务ID、名称、办理人、创建时间可以从 act_ru_task 表中查到。

6) Execution与 ProcessInstance 见 5.6 和 5.7 章节的介绍。在这种情况下， ProcessInstance 相当于 Execution

7) 如果assignee属性为部门经理，结果为空。因为现在流程只到了 ” 填写请假申请 ” 阶段，后面的任务还没有执行，即在数据库中没有部门经理可以办理的任务，所以查询不到。

8) 一个Task节点和 Execution 节点是 1 对 1 的情况，在 task 对象中使用 Execution_ 来表示他们之间的关系

9) 任务ID在数据库表 act_ru_task 中对应“ ID_ ”列

附加：

在activiti任务中，主要分为两大类查询任务（ 个人任务 和组任务）：

1.确切指定了办理者的任务，这个任务将成为指定者的私有任务，即个人任务。

2.无法指定具体的某一个人来办理的任务，可以把任务分配给几个人或者一到 多个小组，让这个范围内的用户可以选择性（如有空余时间时）来办理这类任务，即组任务。

先知道个人任务的查询和办理，组任务的操作后面讲

8.5：办理任务

说明：

1) 是办理任务，所以从ProcessEngine得到的是 TaskService 。

2) 当执行完这段代码，再以员工的身份去执行查询的时候，会发现这个时候已经没有数据了，因为正在执行的任务中没有数据。

3) 对于执行完的任务，activiti将从 act_ru_task 表中删除该任务，下一个任务会被插入进来。

4) 以 ” 部门经理 ” 的身份进行查询，可以查到结果。因为流程执行到部门经理审批这个节点了。

5) 再执行办理任务代码，执行完以后以 ” 部门经理 ” 身份进行查询，没有结果。

6) 重复第3和 4 步直到流程执行完。

8.6：查询流程状态（判断流程正在执行，还是结束）

在流程执行的过程中，创建的流程实例ID在整个过程中都不会变，当流程结束后，流程实例将会在正在执行的执行对象表中（ act_ru_execution ）被删除

说明：

1) 因为是查询流程实例，所以先获取runtimeService

2) 创建流程实例查询对象，设置实例ID过滤参数

3) 由于一个流程实例ID只对应一个实例，使用 singleResult 执行查询返回一个唯一的结果，如果结果数量大于 1 ，则抛出异常

4) 判断指定ID的实例是否存在，如果结果为空，则代表流程结束，实例在正在执行的执行对象表中已被删除，转换成历史数据。

8.7：附加功能：查询历史任务（后面讲）

8.8：附加功能：查询历史流程实例（后面讲）

8.9：总结

Execution 执行对象

按流程定义的规则执行一次的过程 .

对应的表：

act_ru_execution ： 正在执行的信息

act_hi_procinst ：已经执行完的历史流程实例信息

act_hi_actinst ：存放历史所有完成的活动

ProcessInstance 流程实例

特指流程从开始到结束的那个最大的执行分支，一个执行的流程中，流程实例只有 1 个。

注意

（ 1 ）如果是单例流程，执行对象 ID 就是流程实例 ID

（ 2 ）如果一个流程有分支和聚合，那么执行对象 ID 和流程实例 ID 就不相同

（ 3 ）一个流程中，流程实例只有 1 个，执行对象可以存在多个。

Task 任务

执行到某任务环节时生成的任务信息。

对应的表：

act_ru_task ：正在执行的任务信息

act_hi_taskinst ：已经执行完的历史任务信息

9：流程变量

9.1：流程图

流程变量在整个工作流中扮演很重要的作用。例如：请假流程中有请假天数、请假原因等一些参数都为流程变量的范围。流程变量的作用域范围是只对应一个流程实例。也就是说各个流程实例的流程变量是不相互影响的。 流程实例结束完成以后流程变量还保存在数据库中（存放到流程变量的历史表中）。

例如：

即：

9.2：部署流程定义

说明：

• 输入流加载资源文件的3种方式

9.3：启动流程实例

9.4：设置流程变量

说明：

1) 流程变量的作用域就是流程实例，所以只要设置就行了，不用管在哪个阶段设置

2) 基本类型设置流程变量，在taskService中使用任务 ID ，定义流程变量的名称，设置流程变量的值。

3) J avabean类型设置流程变量，需要这个 javabean 实现了 Serializable 接口

4) 设置流程变量的时候，向act_ru_variable这个表添加数据

9.5：获取流程变量

说明：

1） 流程变量的获取针对流程实例（即1个流程），每个流程实例获取的流程变量时不同的

2） 使用基本类型获取流程变量，在taskService中使用任务 ID ，流程变量的名称，获取流程变量的值。

3） J avabean类型设置获取流程变量，除了需要这个 javabean 实现了 Serializable 接口外，还要求流程变量对象的属性不能发生变化，否则抛出异常。解决方案，固定序列化 ID

9.6：模拟流程变量的设置和获取的场景

说明：

1） RuntimeService对象可以设置流程变量和获取流程变量

2） TaskService对象可以设置流程变量和获取流程变量

3） 流程实例启动的时候可以设置流程变量

4） 任务办理完成的时候可以设置流程变量

5） 流程变量可以通过名称/值的形式设置单个流程变量

6） 流程变量可以通过Map集合，同时设置多个流程变量

M ap集合的 key 表示流程变量的名称

Map集合的 value 表示流程变量的值

9.7：查询历史的流程变量

说明：

1）历史的流程变量查询，指定流程变量的名称，查询 act_hi_varinst 表（也可以针对，流程实例ID，执行对象 ID ，任务 ID 查询）

9.8：流程变量的支持的类型

如图是从官网列出来的流程变量的类型：

从图中可以看出包括了大部分封装类型和Date、 String 和实现了 Serializable 接口的类的类型。

9.9：总结

• 1：流程变量

在流程执行或者任务执行的过程中，用于设置和获取变量，使用流程变量在流程传递的过程中传递业务参数。

对应的表：

act_ru_variable ：正在执行的流程变量表

act_hi_varinst ：流程变量历史表

• 2：扩展知识： setVariable 和 setVariableLocal 的区别

setVariable ：设置流程变量的时候，流程变量名称相同的时候，后一次的值替换前一次的值，而且可以看到TASK_ID的字段不会存放任务 ID 的值

setVariableLocal ：

1：设置流程变量的时候，针对当前活动的节点设置流程变量，如果一个流程中存在 2 个活动节点，对每个活动节点都设置流程变量，即使流程变量的名称相同，后一次的版本的值也不会替换前一次版本的值，它会使用不同的任务 ID 作为标识，存放 2 个流程变量值，而且可以看到TASK_ID的字段会存放任务 ID 的值

例如 act_hi_varinst 表的数据：不同的任务节点，即使流程变量名称相同，存放的值也是不同的。

如图：

2：还有，使用 setVariableLocal 说明流程变量绑定了当前的任务，当流程继续执行时，下个任务获取不到这个流程变量（因为正在执行的流程变量中没有这个数据），所有查询正在执行的任务时不能查询到我们需要的数据，此时需要查询历史的流程变量。

10：流程执行历史记录

10.1：查询历史流程实例

查找按照某个流程定义的规则一共执行了多少次流程

10.2：查询历史活动

某一次流程的执行一共经历了多少个活动

10.3：查询历史任务

某一次流程的执行一共经历了多少个任务

10.4：查询历史流程变量

某一次流程的执行一共设置的流程变量

10.5：总结

由于数据库中保存着历史信息以及正在运行的流程实例信息，在实际项目中对已完成任务的查看频率远不及对代办和可接任务的查看，所以在 activiti 采用分开管理，把正在运行的交给 RuntimeService 、TaskService管理，而历史数据交给 HistoryService 来管理。

这样做的好处在于，加快流程执行的速度，因为正在执行的流程的表中数据不会很大。

二：Activiti第二天

11:连线

11.1：流程图

注意：如果将流程图放置在和 java 类相同的路径，需要配置 ：

11.2：部署流程定义 + 启动流程实例

11.3：查询我的个人任务

11.4：完成任务

说明：

1）使用流程变量，设置连线需要的流程变量的名称 message ，并设置流程变量的值

对应：

流程会按照指定的连线完成任务。

11.5：总结

1 、一个活动中可以指定一个或多个 SequenceFlow （ Start 中有一个， End 中没有）。

* 开始活动中有一个 SequenceFlow 。

* 结束活动中没有 SequenceFlow 。

* 其他活动中有 1 条或多条 SequenceFlow

2 、如果只有一个，则可以不使用流程变量设置 codition 的名称；

如果有多个，则需要使用流程变量设置 codition 的名称。 message 表示流程变量的名称， ‘ 不重要 ’ 表示流程变量的值， ${} 中间的内容要使用 boolean 类型的表达式，用来判断应该执行的连线。

12：排他网关（ ExclusiveGateWay ）

12.1：流程图

12.2：部署流程定义 + 启动流程实例

12.3：查询我的个人任务

12.4：完成我的个人任务

说明：

1) 一个排他网关对应一个以上的顺序流

2) 由排他网关流出的顺序流都有个conditionExpression元素，在内部维护返回 boolean 类型的决策结果。

3) 决策网关只会返回一条结果。当流程执行到排他网关时，流程引擎会自动检索网关出口，从上到下检索如果发现第一条决策结果为true或者没有设置条件的 ( 默认为成立 ) ，则流出。

4) 如果没有任何一个出口符合条件，则抛出异常

5) 使用流程变量，设置连线的条件，并按照连线的条件执行工作流，如果没有条件符合的条件，则以默认的连线离开。例如：

则执行连线：

如果使用流程变量设置

则执行连线：

13：并行网关 (parallelGateWay)

13.1：流程图

13.2：部署流程定义 + 启动流程实例

13.3：查询我的个人任务

13.4：完成我的个人任务

说明：

1） 一个流程中流程实例只有1个，执行对象有多个

2） 并行网关的功能是基于进入和外出的顺序流的：

分支(fork) ： 并行后的所有外出顺序流，为每个顺序流都创建一个并发分支。

汇聚(join) ： 所有到达并行网关，在此等待的进入分支， 直到所有进入顺序流的分支都到达以后， 流程就会通过汇聚网关。

3） 并行网关的进入和外出都是使用相同节点标识

4） 如果同一个并行网关有多个进入和多个外出顺序流， 它就同时具有分支和汇聚功能。 这时，网关会先汇聚所有进入的顺序流，然后再切分成多个并行分支。

5） 并行网关不会解析条件。 即使顺序流中定义了条件，也会被忽略。

6） 并行网关不需要是“平衡的”（比如， 对应并行网关的进入和外出节点数目不一定相等）。如图中标示是合法的：

14：开始活动节点

14.1：流程图

14.2：部署流程定义 + 启动流程实例 + 查询流程实例 + 查询历史流程实例

14.3：总结

1 ）：结束节点没有出口

2 ）：其他节点有一个或多个出口。

如果有一个出口，则代表是一个 单线流程 ；

如果有多个出口，则代表是开启 并发流程 。

15：接收活动（ receiveTask ，即等待活动）

接收任务是一个简单任务，它会等待对应消息的到达。 当前，官方只实现了这个任务的java语义。 当流程达到接收任务，流程状态会保存到数据库中。

在任务创建后，意味着 流程会进入等待状态 ， 直到引擎接收了一个 特定的消息 ， 这会触发流程穿过接收任务继续执行。

15.1：流程图

15.2：部署流程定义 + 启动流程实例

/**

* ReceiceTask 任务，机器自动完成的任务

* 只会在 act_ru_execution 表中产生一条数据

* @throws Exception

*/

@Test

public void testExecution() throws Exception {

// 1 发布流程

InputStream inputStreamBpmn = this .getClass().getResourceAsStream( "receiveTask.bpmn" );

InputStream inputStreamPng = this .getClass().getResourceAsStream( "receiveTask.png" );

processEngine .getRepositoryService() //

.createDeployment() //

.addInputStream( "receiveTask.bpmn" , inputStreamBpmn) //

.addInputStream( "receiveTask.png" , inputStreamPng) //

.deploy();

// 2 启动流程

ProcessInstance pi = processEngine .getRuntimeService() //

.startProcessInstanceByKey( "receiveTaskDemo" );

System. out .println( "pid:" + pi.getId());

String pid = pi.getId();

// 3 查询是否有一个执行对象在描述 ” 汇总当日销售额 “

Execution e1 = processEngine .getRuntimeService() //

.createExecutionQuery() //

.processInstanceId(pid) //

.activityId( " 汇总当日销售额 " ) //

.singleResult();

// 4 执行一堆逻辑，并设置流程变量

Map vars = new HashMap();

vars.put( " 当日销售额 " , 10000);

// 5 流程向后执行一步：往后推移 e1, 使用 signal 给流程引擎信号，告诉他当前任务已经完成了，可以往后执行

processEngine .getRuntimeService()

.signal(e1.getId(),vars);

// 6 判断当前流程是否在 ” 给老板发短信 “ 节点

Execution e2 = processEngine .getRuntimeService() //

.createExecutionQuery() //

.processInstanceId(pid) //

.activityId( " 给总经理发短信 " ) //

.singleResult();

// 7 获取流程变量

Integer money = (Integer) processEngine .getRuntimeService() //

.getVariable(e2.getId(), " 当日销售额 " );

System. out .println( " 老板，今天赚了 " +money);

// 8 向后执行一步：任务完成，往后推移 ” 给老板发短信 “ 任务

processEngine .getRuntimeService() //

.signal(e2.getId());

// 9 查询流程状态

pi = processEngine .getRuntimeService() //

.createProcessInstanceQuery() //

.processInstanceId(pid) //

.singleResult();

if (pi== null ){

System. out .println( " 流程正常执行！！！，已经结束了 " );

}

}

说明：

1） 当前任务（一般指机器自动完成，但需要耗费一定时间的工作）完成后，向后推移流程，可以调用runtimeService.signal(executionId)，传递接收执行对象的 id 。

16：用户任务（ userTask ，即用户操作的任务）

16.1：个人任务

16.1.1：流程图

16.1.2:：分配个人任务方式一（直接指定办理人）

1：流程图中任务节点的配置

2：测试代码：

ProcessEngine processEngine = ProcessEngines. getDefaultProcessEngine ();

// 部署流程定义，启动流程实例

@Test

public void testTask() throws Exception {

// 1 发布流程

InputStream inputStreamBpmn = this .getClass().getResourceAsStream( "taskProcess.bpmn" );

InputStream inputStreamPng = this .getClass().getResourceAsStream( "taskProcess.png" );

processEngine .getRepositoryService() //

.createDeployment() //

.addInputStream( "userTask.bpmn" , inputStreamBpmn) //

.addInputStream( "userTask.png" , inputStreamPng) //

.deploy();

// 2 启动流程

// 启动流程实例的同时，设置流程变量

ProcessInstance pi = processEngine .getRuntimeService() //

.startProcessInstanceByKey( "taskProcess" );

System. out .println( "pid:" + pi.getId());

}

// 查询我的个人任务列表

@Test

public void findMyTaskList(){

String userId = " 张三丰 " ;

List list = processEngine .getTaskService() //

.createTaskQuery() //

.taskAssignee(userId) // 指定个人任务查询

.list();

for (Task task:list ){

System. out .println( "id=" +task.getId());

System. out .println( "name=" +task.getName());

System. out .println( "assinee=" +task.getAssignee());

System. out .println( " createTime =" +task.getCreateTime());

System. out .println( "executionId=" +task.getExecutionId());

}

}

// 完成任务

@Test

public void completeTask(){

String taskId = "3209" ;

processEngine .getTaskService() //

.complete(taskId); //

System. out .println( " 完成任务 " );

}

说明：

1） 张三丰是个人任务的办理人

2） 但是这样分配任务的办理人不够灵活，因为项目开发中任务的办理人不要放置XML文件中。

16.1.3:：分配个人任务方式二（使用流程变量）

1：流程图中任务节点的配置

2：测试代码

ProcessEngine processEngine = ProcessEngines. getDefaultProcessEngine ();

// 部署流程定义，启动流程实例

@Test

public void testTask() throws Exception {

// 1 发布流程

InputStream inputStreamBpmn = this .getClass().getResourceAsStream( "taskProcess.bpmn" );

InputStream inputStreamPng = this .getClass().getResourceAsStream( "taskProcess.png" );

processEngine .getRepositoryService() //

.createDeployment() //

.addInputStream( "userTask.bpmn" , inputStreamBpmn) //

.addInputStream( "userTask.png" , inputStreamPng) //

.deploy();

// 2 启动流程

// 启动流程实例的同时，设置流程变量

Map variables = new HashMap();

variables.put( "userID" , " 张翠三 " );

ProcessInstance pi = processEngine .getRuntimeService() //

.startProcessInstanceByKey( "taskProcess" ,variables);

System. out .println( "pid:" + pi.getId());

}

// 查询我的个人任务列表

@Test

public void findMyTaskList(){

String userId = " 张翠三 " ;

List list = processEngine .getTaskService() //

.createTaskQuery() //

.taskAssignee(userId) // 指定个人任务查询

.list();

for (Task task:list ){

System. out .println( "id=" +task.getId());

System. out .println( "name=" +task.getName());

System. out .println( "assinee=" +task.getAssignee());

System. out .println( " createTime =" +task.getCreateTime());

System. out .println( "executionId=" +task.getExecutionId());

}

}

// 完成任务

@Test

public void completeTask(){

String taskId = "3209" ;

processEngine .getTaskService() //

.complete(taskId); //

System. out .println( " 完成任务 " );

}

说明：

1） 张翠山是个人任务的办理人

2） 在开发中，可以在页面中指定下一个任务的办理人，通过流程变量设置下一个任务的办理人

16.1.4:：分配个人任务方式三（使用类）

1：流程图中任务节点的配置

此时流程图的XML文件，如图：

2： TaskListenerImpl 类，用来设置任务的办理人

public class TaskListenerImpl implements TaskListener {

/** 指定个人任务和组任务的办理人 */

@Override

public void notify(DelegateTask delegateTask) {

String assignee = " 张无忌 " ;

// 指定个人任务

delegateTask.setAssignee(assignee);

}

}

3：测试代码

ProcessEngine processEngine = ProcessEngines. getDefaultProcessEngine ();

// 部署流程定义，启动流程实例

@Test

public void testTask() throws Exception {

// 1 发布流程

InputStream inputStreamBpmn = this .getClass().getResourceAsStream( "taskProcess.bpmn" );

InputStream inputStreamPng = this .getClass().getResourceAsStream( "taskProcess.png" );

processEngine .getRepositoryService() //

.createDeployment() //

.addInputStream( "userTask.bpmn" , inputStreamBpmn) //

.addInputStream( "userTask.png" , inputStreamPng) //

.deploy();

// 2 启动流程

ProcessInstance pi = processEngine .getRuntimeService() //

.startProcessInstanceByKey( "taskProcess" );

System. out .println( "pid:" + pi.getId());

}

// 查询我的个人任务列表

@Test

public void findMyTaskList(){

String userId = " 张无忌 " ;

List list = processEngine .getTaskService() //

.createTaskQuery() //

.taskAssignee(userId) // 指定个人任务查询

.list();

for (Task task:list ){

System. out .println( "id=" +task.getId());

System. out .println( "name=" +task.getName());

System. out .println( "assinee=" +task.getAssignee());

System. out .println( " createTime =" +task.getCreateTime());

System. out .println( "executionId=" +task.getExecutionId());

}

}

// 完成任务

@Test

public void completeTask(){

String taskId = "3408" ;

processEngine .getTaskService() //

.complete(taskId); //

System. out .println( " 完成任务 " );

}

// 可以分配个人任务从一个人到另一个人（认领任务）

@Test

public void setAssigneeTask(){

// 任务 ID

String taskId = "3408" ;

// 指定认领的办理者

String userId = " 周芷若 " ;

processEngine .getTaskService() //

.setAssignee(taskId, userId);

}

说明：

1） 在类中使用 delegateTask.setAssignee(assignee); 的方式分配个人任务的办理人，此时张无忌是下一个任务的办理人

2） 通过 processEngine.getTaskService().setAssignee(taskId, userId) ;将个人任务从一个人分配给另一个人，此时张无忌不再是下一个任务的办理人，而换成了周芷若

3） 在开发中，可以将每一个任务的办理人规定好，例如张三的领导是李四，李四的领导是王五，这样张三提交任务，就可以查询出张三的领导是李四，通过类的方式设置下一个任务的办理人

16.1.5：总结

个人任务及三种分配方式：

1 ：在 taskProcess.bpmn 中直接写 assignee=“ 张三丰 "

2 ：在 taskProcess.bpmn 中写 assignee=“#{userID}” ，变量的值要是 String 的。

使用流程变量指定办理人

3 ，使用 TaskListener 接口，要使类实现该接口，在类中定义：

delegateTask.setAssignee(assignee);// 指定个人任务的办理人

使用任务 ID 和办理人重新指定办理人：

processEngine.getTaskService()//

.setAssignee(taskId, userId);

16.2：组任务

16.2.1：流程图

16.2.2:：分配组任务方式一（直接指定办理人）

1：流程图中任务节点的配置

2：测试代码：

ProcessEngine processEngine = ProcessEngines. getDefaultProcessEngine ();

// 部署流程定义，启动流程实例

@Test

public void testTask() throws Exception {

// 1 发布流程

InputStream inputStreamBpmn = this .getClass().getResourceAsStream( "taskProcess.bpmn" );

InputStream inputStreamPng = this .getClass().getResourceAsStream( "taskProcess.png" );

processEngine .getRepositoryService() //

.createDeployment() //

.addInputStream( "userTask.bpmn" , inputStreamBpmn) //

.addInputStream( "userTask.png" , inputStreamPng) //

.deploy();

// 2 启动流程

ProcessInstance pi = processEngine .getRuntimeService() //

.startProcessInstanceByKey( "taskProcess" );

System. out .println( "pid:" + pi.getId());

}

// 3 查询我的个人任务列表

@Test

public void findMyTaskList(){

String userId = " 小A " ;

List list = processEngine .getTaskService() //

.createTaskQuery() //

.taskAssignee(userId) // 指定个人任务查询

.list();

for (Task task:list ){

System. out .println( "id=" +task.getId());

System. out .println( "name=" +task.getName());

System. out .println( "assinee=" +task.getAssignee());

System. out .println( " createTime =" +task.getCreateTime());

System. out .println( "executionId=" +task.getExecutionId());

}

}

// 4 查询组任务列表

@Test

public void findGroupList(){

String userId = " 小A " ;

List list = processEngine .getTaskService() //

.createTaskQuery() //

.taskCandidateUser(userId) // 指定组任务查询

.list();

for (Task task:list ){

System. out .println( "id=" +task.getId());

System. out .println( "name=" +task.getName());

System. out .println( "assinee=" +task.getAssignee());

System. out .println( " createTime =" +task.getCreateTime());

System. out .println( "executionId=" +task.getExecutionId());

System. out .println( "##################################" );

}

}

// 5 查询组任务成员列表

@Test

public void findGroupUser(){

String taskId = "3709" ;

List list = processEngine .getTaskService() //

.getIdentityLinksForTask(taskId);

// List list = processEngine.getRuntimeService()//

// .getIdentityLinksForProcessInstance(instanceId);

for(IdentityLink identityLink:list ){

System. out .println( "userId=" +identityLink.getUserId());

System. out .println( "taskId=" +identityLink.getTaskId());

System. out .println( "piId=" +identityLink.getProcessInstanceId());

System. out .println( "######################" );

}

}

// 6 查询组任务成员历史列表

@Test

public void findGroupHisUser(){

String taskId = "3709" ;

List list = processEngine .getHistoryService() //

.getHistoricIdentityLinksForTask(taskId);

// List list = processEngine.getHistoryService()//

// .getHistoricIdentityLinksForProcessInstance(processInstanceId);

for (HistoricIdentityLink identityLink:list ){

System. out .println( "userId=" +identityLink.getUserId());

System. out .println( "taskId=" +identityLink.getTaskId());

System. out .println( "piId=" +identityLink.getProcessInstanceId());

System. out .println( "######################" );

}

}

// 完成任务

@Test

public void completeTask(){

String taskId = "3709" ;

processEngine .getTaskService() //

.complete(taskId); //

System. out .println( " 完成任务 " );

}

/** 将组任务分配给个人任务，拾取任务 */

// 由 1 个人去完成任务

@Test

public void claim(){

// 任务 ID

String taskId = "5908" ;

// 分配的办理人

String userId = " 小 B" ;

processEngine .getTaskService() //

.claim(taskId, userId);

}

说明：

1） 小A，小 B ，小 C ，小 D 是组任务的办理人

2） 但是这样分配组任务的办理人不够灵活，因为项目开发中任务的办理人不要放置XML文件中。

3） act_ru_identitylink 表存放任务的办理人，包括个人任务和组任务，表示正在执行的任务

4） act_hi_identitylink 表存放任务的办理人，包括个人任务和组任务，表示历史任务

区别在于：如果是个人任务TYPE的类型表示 participant （参与者）

如果是组任务TYPE的类型表示 candidate （候选者）和 participant （参与者）

16.2.3:：分配个人任务方式二（使用流程变量）

1：流程图中任务节点的配置

2：测试代码

ProcessEngine processEngine = ProcessEngines. getDefaultProcessEngine ();

// 部署流程定义，启动流程实例

@Test

public void testTask() throws Exception {

// 1 发布流程

InputStream inputStreamBpmn = this .getClass().getResourceAsStream( "taskProcess.bpmn" );

InputStream inputStreamPng = this .getClass().getResourceAsStream( "taskProcess.png" );

processEngine .getRepositoryService() //

.createDeployment() //

.addInputStream( "userTask.bpmn" , inputStreamBpmn) //

.addInputStream( "userTask.png" , inputStreamPng) //

.deploy();

// 2 启动流程

// 启动流程实例，同时设置流程变量，用来指定组任务的办理人

Map variables = new HashMap();

variables.put( "userIDs" , " 大大 , 小小 , 中中 " );

ProcessInstance pi = processEngine .getRuntimeService() //

.startProcessInstanceByKey( "taskProcess" ,variables);

System. out .println( "pid:" + pi.getId());

}

// 查询我的个人任务列表

@Test

public void findMyTaskList(){

String userId = " 大大 " ;

List list = processEngine .getTaskService() //

.createTaskQuery() //

.taskAssignee(userId) // 指定个人任务查询

.list();

for (Task task:list ){

System. out .println( "id=" +task.getId());

System. out .println( "name=" +task.getName());

System. out .println( "assinee=" +task.getAssignee());

System. out .println( "assinee=" +task.getCreateTime());

System. out .println( "executionId=" +task.getExecutionId());

}

}

// 查询组任务列表

@Test

public void findGroupList(){

String userId = " 大大 " ;

List list = processEngine .getTaskService() //

.createTaskQuery() //

.taskCandidateUser(userId) // 指定组任务查询

.list();

for (Task task:list ){

System. out .println( "id=" +task.getId());

System. out .println( "name=" +task.getName());

System. out .println( "assinee=" +task.getAssignee());

System. out .println( "assinee=" +task.getCreateTime());

System. out .println( "executionId=" +task.getExecutionId());

System. out .println( "##################################" );

}

}

// 查询组任务成员列表

@Test

public void findGroupUser(){

String taskId = "3709" ;

List list = processEngine .getTaskService() //

.getIdentityLinksForTask(taskId);

for (IdentityLink identityLink:list ){

System. out .println( "userId=" +identityLink.getUserId());

System. out .println( "taskId=" +identityLink.getTaskId());

System. out .println( "piId=" +identityLink.getProcessInstanceId());

System. out .println( "######################" );

}

}

// 查询组任务成员历史列表

@Test

public void findGroupHisUser(){

String taskId = "3709" ;

List list = processEngine .getHistoryService() //

.getHistoricIdentityLinksForTask(taskId);

for (HistoricIdentityLink identityLink:list ){

System. out .println( "userId=" +identityLink.getUserId());

System. out .println( "taskId=" +identityLink.getTaskId());

System. out .println( "piId=" +identityLink.getProcessInstanceId());

System. out .println( "######################" );

}

}

// 完成任务

@Test

public void completeTask(){

String taskId = "3709" ;

processEngine .getTaskService() //

.complete(taskId); //

System. out .println( " 完成任务 " );

}

/** 将组任务分配给个人任务，拾取任务 */

// 由 1 个人去完成任务

@Test

public void claim(){

// 任务 ID

String taskId = "5908" ;

// 分配的办理人

String userId = " 小 B" ;

processEngine .getTaskService() //

.claim(taskId, userId);

}

说明：

1） 大大，中中，小小是组任务的办理人

2） 在开发中，可以在页面中指定下一个组任务的办理人，通过流程变量设置下一个任务的办理人

16.2.4:：分配个人任务方式三（使用类）

1：流程图中任务节点的配置

此时流程图的XML文件，如图：

2： TaskListenerImpl 类，用来设置任务的办理人

public class TaskListenerImpl implements TaskListener {

/** 指定个人任务和组任务的办理人 */

@Override

public void notify(DelegateTask delegateTask) {

String userId1 = " 孙悟空 " ;

String userId2 = " 猪八戒 " ;

// 指定组任务

delegateTask.addCandidateUser(userId1);

delegateTask.addCandidateUser(userId2);

}

}

3：测试代码

ProcessEngine processEngine = ProcessEngines. getDefaultProcessEngine ();

// 部署流程定义，启动流程实例

@Test

public void testTask() throws Exception {

// 1 发布流程

InputStream inputStreamBpmn = this .getClass().getResourceAsStream( "taskProcess.bpmn" );

InputStream inputStreamPng = this .getClass().getResourceAsStream( "taskProcess.png" );

processEngine .getRepositoryService() //

.createDeployment() //

.addInputStream( "userTask.bpmn" , inputStreamBpmn) //

.addInputStream( "userTask.png" , inputStreamPng) //

.deploy();

// 2 启动流程

ProcessInstance pi = processEngine .getRuntimeService() //

.startProcessInstanceByKey( "taskProcess" );

System. out .println( "pid:" + pi.getId());

}

// 查询我的个人任务列表

@Test

public void findMyTaskList(){

String userId = " 孙悟空 " ;

List list = processEngine .getTaskService() //

.createTaskQuery() //

.taskAssignee(userId) // 指定个人任务查询

.list();

for (Task task:list ){

System. out .println( "id=" +task.getId());

System. out .println( "name=" +task.getName());

System. out .println( "assinee=" +task.getAssignee());

System. out .println( "assinee=" +task.getCreateTime());

System. out .println( "executionId=" +task.getExecutionId());

}

}

// 查询组任务列表

@Test

public void findGroupList(){

String userId = " 孙悟空 " ;

List list = processEngine .getTaskService() //

.createTaskQuery() //

.taskCandidateUser(userId) // 指定组任务查询

.list();

for (Task task:list ){

System. out .println( "id=" +task.getId());

System. out .println( "name=" +task.getName());

System. out .println( "assinee=" +task.getAssignee());

System. out .println( "assinee=" +task.getCreateTime());

System. out .println( "executionId=" +task.getExecutionId());

System. out .println( "##################################" );

}

}

// 查询组任务成员列表

@Test

public void findGroupUser(){

String taskId = "4008" ;

List list = processEngine .getTaskService() //

.getIdentityLinksForTask(taskId);

for (IdentityLink identityLink:list ){

System. out .println( "userId=" +identityLink.getUserId());

System. out .println( "taskId=" +identityLink.getTaskId());

System. out .println( "piId=" +identityLink.getProcessInstanceId());

System. out .println( "######################" );

}

}

// 查询组任务成员历史列表

@Test

public void findGroupHisUser(){

String taskId = "4008" ;

List list = processEngine .getHistoryService() //

.getHistoricIdentityLinksForTask(taskId);

for (HistoricIdentityLink identityLink:list ){

System. out .println( "userId=" +identityLink.getUserId());

System. out .println( "taskId=" +identityLink.getTaskId());

System. out .println( "piId=" +identityLink.getProcessInstanceId());

System. out .println( "######################" );

}

}

// 完成任务

@Test

public void completeTask(){

String taskId = "4008" ;

processEngine .getTaskService() //

.complete(taskId); //

System. out .println( " 完成任务 " );

}

// 将组任务分配给个人任务（认领任务）

@Test

public void claimTask(){

String taskId = "4008" ;

// 个人任务的办理人

String userId = " 如来 " ;

processEngine .getTaskService().claim(taskId, userId);

}

// 可以分配个人任务回退到组任务，（前提之前是个组任务）

@Test

public void setAssigneeTask(){

// 任务 ID

String taskId = "4008" ;

processEngine .getTaskService() //

.setAssignee(taskId, null );

}

// 向组任务中添加成员

@Test

public void addUser(){

String taskId = "4008" ;

String userId = " 沙和尚 " ;

processEngine .getTaskService().addCandidateUser(taskId, userId);

}

// 向组任务中删除成员

@Test

public void removeUser(){

String taskId = "4008" ;

String userId = " 沙和尚 " ;

processEngine .getTaskService().deleteCandidateUser(taskId, userId);

}

说明：

1） 在类中使用 delegateTask. addCandidateUser ( userId ); 的方式分配组任务的办理人，此时孙悟空和猪八戒是下一个任务的办理人。

2） 通过 processEngine.getTaskService().claim (taskId, userId) ;将组任务分配给个人任务，也叫认领任务，即指定某个人去办理这个任务，此时由如来去办理任务。

注意：认领任务的时候，可以是组任务成员中的人，也可以不是组任务成员的人，此时通过Type的类型为 participant 来指定任务的办理人

3） addCandidateUser ()即向组任务添加成员， deleteCandidateUser ()即删除组任务的成员。

4） 在开发中，可以将每一个任务的办理人规定好，例如张三的领导是李四和王五，这样张三提交任务，由李四或者王五去查询组任务，可以看到对应张三的申请，李四或王五再通过认领任务（claim）的方式，由某个人去完成这个任务。

16.2.5：总结

组任务及三种分配方式：

1 ：在 taskProcess.bpmn 中直接写 candidate-users=“ 小 A, 小 B, 小 C, 小 D"

2 ：在 taskProcess.bpmn 中写 candidate-users =“#{userIDs}” ，变量的值要是 String 的。

使用流程变量指定办理人

Map variables = new HashMap();

variables.put("userIDs", " 大大 , 小小 , 中中 ");

3 ，使用 TaskListener 接口，使用类实现该接口，在类中定义：

// 添加组任务的用户

delegateTask.addCandidateUser(userId1);

delegateTask.addCandidateUser(userId2);

组任务分配给个人任务（认领任务）：

processEngine.getTaskService().claim(taskId, userId);

个人任务分配给组任务：

processEngine.getTaskService(). setAssignee(taskId, null);

向组任务添加人员：

processEngine.getTaskService().addCandidateUser(taskId, userId);

向组任务删除人员：

processEngine.getTaskService().deleteCandidateUser(taskId, userId);

个人任务和组任务存放办理人对应的表：

act_ru_identitylink 表存放任务的办理人，包括个人任务和组任务，表示正在执行的任务

act_hi_identitylink 表存放任务的办理人，包括个人任务和组任务，表示历史任务

区别在于：如果是个人任务TYPE的类型表示 participant （参与者）

如果是组任务TYPE的类型表示 candidate （候选者）和 participant （参与者）

16.3:工作流定义的角色组（了解）

16.3.1：流程图

流程图中任务节点的配置：

分配任务负责的组

使用 candidate groups 属性指定 任务负责组

代码：

审批 ” activiti:candidateGroups=“ 部门经理 ” >

其中部门经理表示一个用户组的角色

16.3.2：测试代码

ProcessEngine processEngine = ProcessEngines. getDefaultProcessEngine ();

// 部署流程定义，启动流程实例

@Test

public void testTask() throws Exception {

// 1 发布流程

InputStream inputStreamBpmn = this .getClass().getResourceAsStream( "taskProcess.bpmn" );

InputStream inputStreamPng = this .getClass().getResourceAsStream( "taskProcess.png" );

processEngine .getRepositoryService() //

.createDeployment() //

.addInputStream( "userTask.bpmn" , inputStreamBpmn) //

.addInputStream( "userTask.png" , inputStreamPng) //

.deploy();

/** 在部署流程定义和启动流程实例的中间，设置组任务的办理人，向 Activity 表中存放组和用户的信息 */

IdentityService identityService = processEngine.getIdentityService();// 认证：保存组和用户信息

identityService.saveGroup(new GroupEntity(" 部门经理 "));// 建立组

identityService.saveGroup(new GroupEntity(" 总经理 "));// 建立组

identityService.saveUser(new UserEntity(" 小张 "));

identityService.saveUser(new UserEntity(" 小李 "));

identityService.saveUser(new UserEntity(" 小王 "));

identityService.createMembership(" 小张 ", " 部门经理 ");// 建立组和用户关系

identityService.createMembership(" 小李 ", " 部门经理 ");// 建立组和用户关系

identityService.createMembership(" 小王 ", " 总经理 ");// 建立组和用户关系

// 2 启动流程

ProcessInstance pi = processEngine .getRuntimeService() //

.startProcessInstanceByKey( "taskProcess" );

System. out .println( "pid:" + pi.getId());

}

// 查询我的个人任务列表

@Test

public void findMyTaskList(){

String userId = " 唐僧 " ;

List list = processEngine .getTaskService() //

.createTaskQuery() //

.taskAssignee(userId) // 指定个人任务查询

.list();

for (Task task:list ){

System. out .println( "id=" +task.getId());

System. out .println( "name=" +task.getName());

System. out .println( "assinee=" +task.getAssignee());

System. out .println( "assinee=" +task.getCreateTime());

System. out .println( "executionId=" +task.getExecutionId());

}

}

// 查询组任务列表

@Test

public void findGroupList(){

String userId = " 小李 " ; // 小张，小李可以查询结果，小王不可以，因为他不是部门经理

List list = processEngine .getTaskService() //

.createTaskQuery() //

.taskCandidateUser(userId) // 指定组任务查询

.list();

for (Task task:list ){

System. out .println( "id=" +task.getId());

System. out .println( "name=" +task.getName());

System. out .println( "assinee=" +task.getAssignee());

System. out .println( "assinee=" +task.getCreateTime());

System. out .println( "executionId=" +task.getExecutionId());

System. out .println( "##################################" );

}

}

// 查询组任务成员列表

@Test

public void findGroupUser(){

String taskId = "4408" ;

List list = processEngine .getTaskService() //

.getIdentityLinksForTask(taskId);

for (IdentityLink identityLink:list ){

System. out .println( "userId=" +identityLink.getUserId());

System. out .println( "taskId=" +identityLink.getTaskId());

System. out .println( "piId=" +identityLink.getProcessInstanceId());

System. out .println( "######################" );

}

}

// 完成任务

@Test

public void completeTask(){

String taskId = "5108" ;

processEngine .getTaskService() //

.complete(taskId); //

System. out .println( " 完成任务 " );

}

}

16.3.3：分配任务负责的组 (IdentityService)

/** 在部署流程定义和启动流程实例的中间，设置组任务的办理人，向 Activiti 表中存放组和用户的信息 */

IdentityService identityService = processEngine.getIdentityService();// 认证：保存组和用户信息

identityService.saveGroup( new GroupEntity(" 部门经理 "));// 建立组

identityService.saveGroup( new GroupEntity(" 总经理 "));// 建立组

identityService.saveUser( new UserEntity(“ 小张 ”));// 建立用户

identityService.saveUser( new UserEntity(" 小李 ")); // 建立用户

identityService.saveUser( new UserEntity(" 小王 ")); // 建立用户

identityService.createMembership(" 小张 ", " 部门经理 ");// 建立组和用户关系

identityService.createMembership(" 小李 ", " 部门经理 ");// 建立组和用户关系

identityService.createMembership(“ 小王 ”, “ 总经理 ”);// 建立组和用户关系

表结构介绍

act_id_group ：角色组表

act_id_user ：用户表：

act_id_membership ：用户角色表

指定组任务的办理人，查询组任务

String userId = “ 小张 ”;// 小张，小李可以查询结果，小王不可以，因为他不是部门经理角色

List list = processEngine.getTaskService()//

.createTaskQuery()//

.taskCandidateUser(userId)// 指定组任务查询

.list();

A ctiviti总结：