JeeSite BPM 模块要求 JeeSite 版本最低为 4.1.8，若您使用的版本低于 4.1.8，请先升级。

打开 web 的 pom.xml，加入如下模块依赖代码

注意：v4.1.8+ 专业版提供，此模块依赖，请向售后人员索取。

第一种情况：若是 v4.2.0+ 以上版本，或新项目初次安装

第二种情况：若是 v4.1.8 之前版本升级上来的项目，后加入 bpm 模块

第三种情况：最初就是 v4.1.8 版本的项目，使用社区版初始化的数据库

常见问题：

下面让咱们以一个最简单的《请假单》为例，快速体验它的强大。

首先咱们先创建一个流程分类，对咱们新建的流程进行归类。进入菜单：业务流程-> 流程管控 -> 流程分类管理，点击“新增”按钮，新建一个分类，数据如下：

请假流程环节业务描述：

了解业务后，咱们开始进行流程图设计。进入菜单：业务流程-> 流程管控 -> 流程模型设计，点击“创建流程”按钮，填写数据如下：

点击“创建新模型”按钮，接着系统会弹出流程设计界面。

注意：已实现中国式流程，无需画“退回”线路。

设“主键ID”作为环节的编号，如下：

以此类推，继续配置如下环节：

其中：变量 leaveDays 为业务表单字段，后续会说明如何赋值。

方便调试流程，此操作为可选配置（可以配置也可以不配置），主要是在“业务流程 -> 流程管控 -> 流程定义”中直接发起“非关联业务”的流程进行调试时，展现的流程变量列表。

点击流程图空白处，在下方属性列表中，点击“数据对象”，填写信息如下：

点击左上角的“保存”按钮，接着点击“保存和关闭编辑器”按钮，保存流程图。

系统会返回到“流程模型列表”界面，找到刚新建的流程，点击“发布流程模型”按钮：

弹出如下对话框：

选择一个 office 流程分类，点击“发布流程模型”，右下角提示“发布流程成功”即可。

注意：流程表单、流程事件，不需要在流程模型中配置。发布流程后可以在流程定义管理进行关联业务，绑定表单，编写流程事件。

验证流转是否正确，进入菜单：业务流程 -> 流程管控 -> 流程定义。

接上一步，流程发布后，在流程定义列表中会出现刚发布的“请假流程”一条数据，点击“调试流程”，可以进行“无关联业务”的流程流转测试，来验证您刚才发布的流程，是否可以正常流转。

点击“启动流程”，会发起该流程（流程名称后会带一个【调试】字样）。

在流程定义列表中点击流程名称，可以查询该流程下的所有实例。

接着点击流程实例名称，可以查询该实例下的任务。

接着点击任务名称，可以签收、办理该任务。

若当前启动人是部门经理，则部门经理审批环节自动跳过。

流程调通之后，接下来，咱们可以进行关联业务表单了。

现在我们开始准备表单，首先通过 ERMaster 创建一张请假表，如下：

导出DDL并执行，完成数据表的创建。

v4.2.2 以后的版本中新增了 BPM 的表单代码生成功能。生成时选择 “增删改查” 模板，然后在下方其它选项里找到 “是否为流程表单” 选择 “是” ，然后填写 “流程表单Key”，与 “流程定义 -> 表单或业务关联” 的 “流程表单Key” 一致。

v4.2.2 之前版本生成 “增删改查” 代码，再后续添加 BPM 代码即可。

代码生成工具生成后，创建一个 “请假管理” 菜单。

这里主要以流程为主，就不多赘述了具体生成步骤了，最终表单地址如下：

这里填写和编辑的地址相同，主要用来学习入门，根据业务需要可以分开设计

目前表单和流程都已经准备好，咱们正式开始建立联系。进入“业务流程 -> 流程管控 -> 流程定义”菜单。找到“请假流程”数据行，点击“表单或业务关联”操作按钮，进入“流程表单”界面。

点击右上角“新增流程表单”按钮。创建一个表单，数据如下：

其中表单标题和表单地址为 Beetl 语法模板，可以根据业务数据规则动态生成。

若每个环节的表单不同，您可以继续创建下级表单，指定环节名称，则仅对指定环节有效，如下（本例学习可以不用配置）：

在“流程表单”界面，找到您刚新建的“请假流程”表单数据行，点击“流程事件”操作按钮，进入“流程事件”界面。

点击右上角“新增”按钮。连续创建三个事件，数据如下：

Cloud版本：

Cloud版本：

Cloud版本：

在 v4.2.2 以后的版本中新增了 流程表单 代码生成功能，可忽略该步骤，之前版本按照以下方法追加：

将实体类的父类替换为 BpmEntity 实体（树表为 BpmTreeEntity），该实体里包含提交流程的相关参数。

修改 OaLeaveService 的 save 方法，增加流程处理代码，如下：

关注：BpmUtils 的 start 和 complete 方法，这才是流程的重点。上面的几步判断，只是一些数据存储和验证。

在 v4.2.2 以后的版本中新增了 流程表单 代码生成功能，可忽略该步骤，之前版本按照以下方法追加：

请假管理列表中增加“流程追踪”按钮：

替换原来的提交按钮（如果需要暂存功能，可以增加暂存按钮，否则可以不加）：

在表单部分增加“审批意见”和“下一步任务信息”控件（如果不需要可以不加）

到这一步说明一个请假流程就算完成了，下面贴图展示：

请假单列表：

任务办理：

任务退回：

任务转办：

任务委托：

自由跳转（特事特办）：

流程终止（作废）：

流程跟踪信息：

按钮事件接口：

以上代码放到流程表单页面最下面

根据业务查询流程实例：

根据流程实例查询任务：

查询历史实例和任务：

执行自定义命令：

拿到流程模型数据：

获取任务节点数据：

该功能是 v4.3.0 新增功能，可快速导出和导入流程 zip 压缩包（包含：流程bpmn、流程图、表单、流程事件）。

进入流程定义管理菜单，找到要导出的流程，点击操作列里的“导出”按钮即可下载 zip 文件。

点击右上角的“导入流程”，可快速导入 zip 文件里包含的流程、表单和事件等信息。

除了通过用户或角色分配人员，我们还可以通过程序逻辑计算出结果，进行分配：

下面我们来举例：根据某角色并在某部门的用户分配方法

EmpUserDao.xml 里添加

EmpUserService.java 里添加

数据有了，但还需要传递给流程引擎，下面我们举例 2 种调用方法：

方法一：

直接在分配人填写表达式，可以调用 Spring Bean 的方法：

流程设计器里，点击任务节点 -> 分配用户 -> 候选用户 -> 填写如下表达式：

方法二：

利用流程事件脚本设置流程变量的方式

1）字典里添加活动开始事件类型（如果存在，则忽略）

2）给节点设置接受人变量

3）给节点添加事件，进入节点时在脚本中赋值

上图是直接赋值处理人，如何调用刚才我们写的方法呢，写如下脚本即可：

常见问题

创建事件类型：任务创建

在该事件里，到的处理人或候选组后，可用于发送消息等。

发送消息参考：https://gitee.com/thinkgem/jeesite5/issues/I5EUTI (opens new window)

接口获取：

Java 工具:

1、第一种，简单情况：明确会签人员的个数，会签人员全部签收后，再继续流转

2、第二种：复杂情况：会签人员部分签收后（如 80%），或更复杂的计算条件通过后，再继续流转

Java 调用举例

Flowable 官方文档：https://jeesite.com/front/flowable/6.5.0/bpmn/index.html (opens new window)

Flowable 数据字典表结构：https://my.oschina.net/thinkgem/blog/4765491 (opens new window)

点击我，看清晰大图。 点击我，看清晰大图。

Flowable 表结构的 Excel 版本可联系售后人员获取。

v4.2.3 打开 jeesite-cloud-module-core 项目的 pom.xml 文件，加入如下模块依赖代码

v4.3.0+ 无需加入到 jeesite-cloud-module-core 直接启动 jeesite-cloud-module-bpm 项目即可。

打开 jeesite-cloud-module-test1-client 项目的 pom.xml 文件，加入如下模块依赖代码

直接访问：http://127.0.0.1:8980/js/a/test1/testData/bpmTest (opens new window)