JeeSite BPM 业务流程、工作流引擎、Flowable

特点

  • JeeSite BPM 基于 Flowable（Activiti）生来具有的稳定工作流引擎

  • 支持在线流程设计器，流程导入导出，符合 BPMN 规范，中国式工作流

  • 支持流程办理、退回、自由流、会签、并行、串行、服务任务等

  • 支持退回任务，退回到指定环节，退回到上一步，退回到发起人

  • 支持转办任务，将任务交接给他人办理，办理完成后继续下一步骤

  • 支持委托任务，将任务委托给他人，他人办理完成后再回到委托人

  • 支持智能提交，相同处理人自动跳过，支持自由指定下一步处理人

  • 支持作废流程，允许发起人快速终止流程，管理员维护终止流程

  • 支持自由流程，根据环节选择，自由跳转到指定环节，特事特办

  • 支持流程撤回，下一步未办理的任务，可进行取回撤销重做任务

  • 支持流程跟踪图，流程状态展现，流转信息，任务历史，任务分配信息

  • 支持一个流程模型挂接多个业务单据，如某公司8种费用审批流程，表单不一样，但流程相同

  • 支持一个表单挂接多个流程环节，以表单角度去管理流程，方便业务理解

  • 流程事件脚本在线编写，包括：流程启动、完成、取消；任务分配、创建、结束等

  • 流程脚本管理（Groovy、Beetl），在线编辑、自动完成、脚本测试、多语言脚本模板维护

  • 我的待办任务处理，我的已办任务、我创建的任务查询、流程跟踪、审批记录查询

  • 流程管控，在无关联表单情况下流程调试，如流程发起、挂起；流程定义、实例、任务等查询；任务办理等

  • 支持流程组件标签定义（流程按钮、意见审批、下一步流程信息等）快速与自定义的业务表单建立关系。

  • 版本化管理流程，新调整的流程业务不影响正在运行，未结束的流程继续流转。

  • 计划：任务加签、催办任务、传阅任务、流程委托设置、流水号管理、常用语管理

模块安装

1、前置条件

JeeSite BPM 模块要求 JeeSite 版本最低为 4.1.8，若你使用的版本低于 4.1.8，请先升级到最新版本，再继续操作。 升级方法：JeeSite 4.x 更新日志

2、引入依赖

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

<!-- 业务流程管理 --><dependency>
<groupId>com.jeesite</groupId>
<artifactId>jeesite-module-bpm</artifactId>
<version>${project.parent.version}</version></dependency>

注意：此功能是专业版功能（联系技术支持获取私服地址）

若你手中有 jeesite-web-pro 包，该包相比 jeesite-web 多了一个 BPM 模块。

3、初始化数据库

第一种情况：若是 v4.2.x 版本，或新项目初次安装

  1. 运行 jeesite-web-pro/bin/init-data.bat(sh) 初始化数据库即可。

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

  1. 无需执行 bpm 模块的 init-data 初始化数据库脚本。

  2. 项目 pom.xml 里加入 bpm 模块依赖后，直接启动服务，系统会自动检测并初始化数据库。

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

  1. 若你先初始化了核心功能模块数据库，并没有初始化 BPM 的相关表和数据。

  2. 这种情况可能会提示 js_bpm_*、act_* 的表不存在，这时你需要单独初始化这些表。

  3. 防止误操作，请先备份数据库。备份完成后，你可以直接运行 jeesite-web-bpm 项目 com.jeesite.test.InitData 类的 initStep03 单元测试，单独去初始化 BPM 模块的表及基础数据。执行前请设置 -Djeesite.initdata=true JVM 参数（该参数防止误操作需要手动添加，执行完成后删除该参数）

我的第一个流程

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

1、创建流程分类

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

  • 分类名称：办公流程

  • 分类编码：office

2、流程模型设计

请假流程环节业务描述：

  • 申请人发起请假申请，由部门经理审核。

  • 若申请人为部门经理，则自动跳过部门经理节点。

  • 若请假天数大于3天，则需要总经理审核，否则跳过总经理审核。

  • 审核完成后，有人力专员进行备案，并结束流程。

  • 审批不通过任务退回到申请人。

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

  • 模型名称：请假流程学习

  • 模型Key：leave_test

  • 描述：我的第一个流程

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

1）画流程图

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

2）为每个环节设置ID

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

  • 填写申请单，主键ID：edit

  • 部门经理审核，主键ID：dept

  • 总经理审核，主键ID：ceo

  • 人力专员备案，主键ID：har

3）为每个环节“分配用户”

  • 填写申请单：流程发起人（可以不设置，启动流程后默认自动跳过第一个环节，第一个环节为填写申请单或修改申请单使用）

  • 部门经理审核：身份存储 -> 候选组 -> 部门经理（若没有创建一个部门）

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

  • 总经理审核：身份存储 -> 分配给单个用户 -> 选择总经理用户

  • 人力专员备案：身份存储 -> 分配给单个用户 -> 选择人力专员用户

4）配置流转条件

  • 选择“小于等于3天”连接线，流转条件编写：${leaveDays <= 3}

  • 选择“大于3天”连接线，流转条件编写：${leaveDays > 3}

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

5）配置流程变量

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

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

6）保存流程，并发布

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

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

弹出如下对话框：

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

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

7）调试流程

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

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

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

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

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

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

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

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

3、流程与业务关联

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

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

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

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

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

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

  • 申请单查询：/oa/oaLeave/list

  • 申请单填写：/oa/oaLeave/form

  • 申请单编辑：/oa/oaLeave/form

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

1）业务关联配置

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

  • 一个流程可以关联多个业务单据，如：某公司8种费用审批流程，表单不一样，但流程相同，这里的表单 key 对应一种费用。表单的版本对应流程的版本，当新发布一个流程定义的时候，流程表单也跟随新增版本。

  • 流程表单是一个树结构，顶级表单定义为全局表单（对所有环节生效）；下级表单为环节表单（该表单只对指定环节生效）。若没有定义环节表单的环节，则获取全局表单数据。

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

  • 表单名称：请假流程

  • 表单Key： leave（对应代码生成里指定的流程表单Key）

  • 表单类型：URL表单

  • 表单标题：${form.currentUser.userName} 在 ${date(),'yyyy-MM-dd'} 发起了 ${form.formName}

  • PC表单地址：/oa/oaLeave/form?id=${task.procIns.bizKey}

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

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

2）流程事件配置

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

  • 表单下支持定义流程事件，主要用来：更新业务表单数据状态、发送通知、发送邮件、业务处理等。

  • 目前支持的事件包括：流程启动、流程完成、流程终止、任务分配、任务创建、任务完成等；若这些事件缺少你想要的，你也可以自己在字典管理里找到 bpm_event_type 字典类型，添加 Flowable 流程事件，更多的流程事件编码，详见：org.flowable.common.engine.api.delegate.event.FlowableEngineEventType 枚举类。

  • 流程事件脚本为 Groovy 语言，它是一个脚本语言，无需编译直接运行；可以完全使用 Java 语法，能够很好和 Java 代码进行结合；又可以使用 Groovy 自身的特性，简化 Java 语法的编写。

  • 提供强大的脚本编辑器，自动提醒，自动完成常用语法。

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

  • 事件名称：更新业务表状态（审核、退回）

  • 是否异步：否

  • 事件类型：任务创建

  • 事件脚本：如下

    import com.jeesite.common.entity.DataEntity;import com.jeesite.modules.bpm.utils.BpmUtils;if (BpmUtils.isCurrentCmd(execution, 'back')){ // 如果当前执行的是退回命令，则更新状态为审批退回
  BpmUtils.updateStatus(execution, 'oaLeaveService', DataEntity.STATUS_AUDIT_BACK);}else{
  BpmUtils.updateStatus(execution, 'oaLeaveService', DataEntity.STATUS_AUDIT);}

  • 事件名称：更新业务表状态（流程完成）

  • 是否异步：否

  • 事件类型：流程完成

  • 事件脚本：如下

    import com.jeesite.common.entity.DataEntity;import com.jeesite.modules.bpm.utils.BpmUtils;BpmUtils.updateStatus(execution, 'oaLeaveService', DataEntity.STATUS_NORMAL);

  • 事件名称：更新业务表状态（流程终止）

  • 是否异步：否

  • 事件类型：流程取消

  • 事件脚本：如下

    import com.jeesite.common.entity.DataEntity;import com.jeesite.modules.bpm.utils.BpmUtils;BpmUtils.updateStatus(execution, 'oaLeaveService', DataEntity.STATUS_DELETE);

3）增加流程相关后台代码

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

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

import com.jeesite.modules.bpm.entity.BpmEntity;public class OaLeave extends BpmEntity<OaLeave> {}

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

import com.jeesite.modules.bpm.utils.BpmUtils;public void save(OaLeave oaLeave) {

// 如果未设置状态，则指定状态为审核状态，以提交审核流程
if (StringUtils.isBlank(oaLeave.getStatus())){
oaLeave.setStatus(OaLeave.STATUS_AUDIT);
}

// 如果状态为正常，则代表不正常操作，可能前端进行了数据参数修改
if (OaLeave.STATUS_NORMAL.equals(oaLeave.getStatus())){
throw new ServiceException(text("非法操作，前端数据被劫持！"));
}

// 如果状态为草稿或审核状态，才可以保存业务数据
if (OaLeave.STATUS_DRAFT.equals(oaLeave.getStatus())
|| OaLeave.STATUS_AUDIT.equals(oaLeave.getStatus())){
super.save(oaLeave);
}

// 如果为审核状态，则进行审批流操作
if (OaLeave.STATUS_AUDIT.equals(oaLeave.getStatus())){

        // 指定请假天数流程变量，作为流程条件，决定流转方向
Map<String, Object> variables = MapUtils.newHashMap();
variables.put("leaveDays", oaLeave.getLeaveDays());

// 如果流程实例为空，任务编号也为空，则：启动流程
if (StringUtils.isBlank(oaLeave.getBpm().getProcInsId())
&& StringUtils.isBlank(oaLeave.getBpm().getTaskId())){
BpmUtils.start(oaLeave, "leave", variables, null);
}
// 如果有任务信息，则：提交任务
else{
BpmUtils.complete(oaLeave, variables, null);
}
}}

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

4）增加流程相关视图代码

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

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

$('#dataGrid').dataGrid({
columnModel: [
// ... 此处省略 ...
{header:'${text("操作")}', name:'actions', width:120, sortable:false, title:false, formatter: function(val, obj, row, act){
var actions = [];
    // ... 此处省略 ...
            // 如果表单已启动流程，则可以显示流程追踪按钮，其中：formKey 是创建表单时的Key，bizKey 是当前业务的主键
if (row.status != Global.STATUS_DRAFT){
actions.push('<a href="${ctx}/bpm/bpmRuntime/trace?formKey=leave&bizKey='+row.id+'" class="btnList" title="${text("流程追踪")}" data-layer="true"><i class="fa fa-file-picture-o"></i></a> ');
}
return actions.join('');
}}
]});

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

<% if (hasPermi('oa:oaLeave:edit')){ %>
<#form:hidden path="status"/>
<% if (oaLeave.isNewRecord || oaLeave.status == '9'){ %>
<button type="submit" class="btn btn-sm btn-info" id="btnDraft"><i class="fa fa-save"></i> ${text('暂 存')}</button>
<% } %>
<#bpm:button bpmEntity="${oaLeave}" formKey="leave" completeText="${text('提 交')}"/><% } %><script>// 业务实现草稿按钮$('#btnDraft').click(function(){
$('#status').val(Global.STATUS_DRAFT);});// 流程按钮提交事件BpmButton = window.BpmButton || {};BpmButton.complete = function($this, task){
$('#status').val(Global.STATUS_AUDIT);};</script>

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

<% if(isNotBlank(oaLeave.bpm.taskId)){ %><div class="row">
<div class="col-xs-12">
<div class="form-group">
<label class="control-label col-xs-2">${text('审批意见')}：</label>
<div class="col-xs-10">
<#bpm:comment bpmEntity="${oaLeave}" />
</div>
</div>
</div></div><% } %><#bpm:nextTaskInfo bpmEntity="${oaLeave}" />

5）一切就绪，测试效果

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

请假单列表：

任务办理：

  • 要求完成时间：下一步任务的要求完成时限，提醒作用

  • 任务优先级：根据任务的等级排序，优先级越高越靠前

  • 下一步处理人：下一步任务的执行人设定，若不设置，则有流程引擎自动分配

  • 流程分配的下一步处理人若与当前人想符合，流程自动跳过

  • 注意：若点击办理的表单提示 “403 您的操作权限不足” 或 “404 您访问的页面不存在”，该问题一般是：流程定义 -> 表单或业务关联 -> 流程表单 -> PC表单地址，您定义的这个地址无访问权限或地址不对，您需要对这个地址给当前用户授权。

任务退回：

任务转办：

任务委托：

自由跳转（特事特办）：

流程终止（作废）：

流程跟踪信息：

附：API

BpmEntity 业务流程实体

public class BpmEntity<T extends DataEntity<?>> extends DataEntity<T> {

private BpmParams bpm;// 流程相关参数}

BpmParams 流程接受参数

public class BpmParams implements Serializable {

private static final long serialVersionUID = 1L;

private String taskId; // 任务编号
private String procInsId; // 实例编号
private String activityId; // 活动编号

private String comment;// 审批意见

    private Date dueDate;// 任务期限
    private Integer priority;// 任务优先级
    private String nextUserCodes;// 下一步处理人用户编码

private boolean isView;// 是否为查看表单（来自：已办、我创建、查询等）
}

button 流程按钮组件

var p = {

// 业务流程实体对象
bpmEntity: bpmEntity!,

// 业务表单Key
formKey: formKey!,

// 按钮的标签，设置为空，则不显示按钮
claimText: claimText!text('签 收'),
completeText: completeText!text('提 交'),
backText: backText!text('退 回'),// 退回到之前办理过的任务环节
turnText: turnText!text('转 办'),// 将任务转交他人办理，办理完成后继续流转
delegateText: delegateText!text('委 托'),// 任务交由被委托人办理，办理完成后返回委托人
stopText: stopText!text('终 止'),// 单据作废，结束流程实例
moveText: moveText!text('自由跳转'), // 特事特办，自由流
traceText: traceText!text('流程追踪'),
};

按钮事件接口：

BpmButton = window.BpmButton || {};// 获取到任务信息后，渲染按钮前调用BpmButton.init = function(task){ }// 点击提交按钮时调用BpmButton.complete = function($this, task){ }// 点击签收按钮时调用BpmButton.claim = function($this, task){
js.ajaxSubmit(ctx + '/bpm/bpmTask/claim', {id: task.id}, function(data){
js.showMessage(data.message);
if(data.result == Global.TRUE){
var $button = $('#bpmButton');
$button.find('.taskClaim').addClass('hide');
$button.find('.needClaim').removeClass('hide');
}
});}// 点击退回按钮时调用BpmButton.back = function($this, task){
js.addTabPage($this, $this.text(), ctx + '/bpm/bpmTask/back?id='+task.id);}// 点击转发按钮时调用BpmButton.turn = function($this, task){
js.addTabPage($this, $this.text(), ctx + '/bpm/bpmTask/turn?id='+task.id);}// 点击委托按钮时调用BpmButton.delegate = function($this, task){
js.addTabPage($this, $this.text(), ctx + '/bpm/bpmTask/turn?id='+task.id+'&delegate=true');}// 点击自由跳转按钮时调用BpmButton.move = function($this, task){
js.addTabPage($this, $this.text(), ctx + '/bpm/bpmTask/move?id='+task.id);}// 点击终止流程按钮时调用BpmButton.stop = function($this, task){
js.addTabPage($this, $this.text(), ctx + '/bpm/bpmRuntime/stop?id='+task.procIns.id);}// 点击流程跟踪按钮时调用BpmButton.trace = function($this, task){
js.addTabPage($this, $this.text(), ctx + '/bpm/bpmRuntime/trace?id='+task.procIns.id);}

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

comment 审批意见组件

var p = {

// 业务流程实体对象
bpmEntity: bpmEntity!,
};

nextTaskInfo 下一步任务信息

var p = {

// 业务流程实体对象
bpmEntity: bpmEntity!,
};

BpmUtils 工具类

/**
 * BPM 工具
 * @author ThinkGem
 * @version 2019-05-20
 */public class BpmUtils {

/**
 * 根据业务实体获取流程实例
 * @param bpmEntity 业务对象
 * @param formKey 表单KEY
 * @author ThinkGem
 */
public static BpmProcIns getProcIns(BpmEntityApi<?> bpmEntity, String formKey);

/**
 * 启动流程实例，自动完成流程的第一个节点
 * @param bpmEntity 业务对象
 * @param formKey 表单KEY
 * @param variables 流程变量
 * @param transientVariables 流程瞬时变量
 * @author ThinkGem
 */
public static BpmTask start(BpmEntityApi<?> bpmEntity, String formKey, Map<String, Object> variables, Map<String, Object> transientVariables);

/**
 * 提交任务
 * @param bpmEntity bpm.taskId 任务编号
 * @param bpmEntity bpm.procInsId 实例编号
 * @param bpmEntity bpm.activityId 活动编号
 * @param bpmEntity bpm.comment 提交意见
 * @param bpmEntity bpm.dueDate 要求完成时间
 * @param bpmEntity bpm.priority 任务优先级
 * @param bpmEntity bpm.nextUserCodes 任务下一步处理人
 * @param variables 流程变量
 * @param transientVariables 瞬时流程变量
 * @author ThinkGem
 */
public static BpmTask complete(BpmEntityApi<?> bpmEntity, Map<String, Object> variables, Map<String, Object> transientVariables);

/**
 * 获取业务主键数据
 * @author ThinkGem
 */
public static String getBizKey(DelegateExecution execution);

/**
 * 更新业务状态数据
 * @author ThinkGem
 */
public static void updateStatus(DelegateExecution execution, String serviceBeanName, String status);

/**
 * 判断当前执行的命令
 * @author ThinkGem
 */
public static boolean isCurrentCmd(DelegateExecution execution, String cmd);
}

其它常用 API

根据业务查询流程实例：

String formKey = "表单Key";  String bizKey = "业务主键";runtimeService.createProcessInstanceQuery().processInstanceBusinessKey(formKey+":"+bizKey).active().list();

根据流程实例查询任务：

String procInsId = "实例id";taskService.createTaskQuery().processInstanceId(procInsId).active().list();

查询历史实例和任务：

historyService.createHistoricProcessInstanceQuery().listPage(1, 20);historyService.createHistoricTaskInstanceQuery().listPage(1, 20);

执行自定义命令：

managementService.executeCommand(new CustomCmd("procDefId"));

拿到流程模型数据：

repositoryService.getBpmnModel(processDefinitionId);

流程退回命令

BpmTask params = new BpmTask();// 当前任务IDparams.setId(taskId);// 退回到第一步params.setActivityId(BpmTask.BACK_TASK_FIRST);// 退回到上一步params.setActivityId(BpmTask.BACK_TASK_PREV);// 执行退回命令bpmTaskService.backTask(params);

分配人高级应用

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

第二步：给节点设置接受人变量

处理人一个人的时候，设置 userCode 到 “分配人” 文本框里；
处理人多个人的时候，设置 userCode 到 “候选用户” 或 “候选组” 里。

第三步：给节点添加事件，进入节点时在脚本中赋值

设置 “分配人” 的时候，userCode 为 String 类型；
设置 “候选用户” 或 “候选组” 的时候，userCode 为 List<String> 类型。
若提示 userCode 未定义，也可以使用这样赋值：execution.setVariable("userCode", "user16_bw27");

-- 查询某角色并在某部门的用户select a.user_code, a.user_name from js_sys_user ajoin js_sys_user_role ur on ur.user_code=a.user_codejoin js_sys_employee e on e.emp_code=a.ref_codejoin js_sys_office o on o.office_code=e.office_codewhere ur.role_code='dept' and o.office_code='SDJN01'

上述 SQL 是举例，根据角色和部门查询用户，你在 EmpUserService 服务类里添加一个新方法，如 findUserByRoleAndOffice，调用 dao 查询数据，然后，在流程事件里这样调用：

def empUserService = StringUtils.getBean("empUserService");def userCode = empUserService.findUserByRoleAndOffice("dept", "SDJN01");execution.setVariable("userCode", userCode);

流程事件中得到处理人

创建事件类型：任务创建

println "==================== 获取任务处理人 ";if (eventEntity != null && eventEntity instanceof org.flowable.task.service.impl
.persistence.entity.TaskEntity){
// 如果设定了下一步处理人
def nextUserCodes = com.jeesite.common.web.http.ServletUtils.getParameter('nextUserCodes');
if (StringUtils.isNotBlank(nextUserCodes)){
println "下一步处理人：" + nextUserCodes;
}
// 如果是有处理人，则排除当前处理人
else if (StringUtils.isNotBlank(eventEntity.getAssignee())){
if (!eventEntity.getAssignee().equals(UserUtils.getUser().getUserCode())){
println "处理人：" + eventEntity.getAssignee();
}
}
// 如果是组任务
else{
for (org.flowable.identitylink.service.impl.persistence.entity.
IdentityLinkEntity e : eventEntity.getCandidates()){
println "候选组：" + e.getGroupId();
}
}}println "==================== 获取任务处理人 end ";

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

流程事件中得到流转命令

import com.jeesite.modules.bpm.utils.BpmUtils;if (BpmUtils.isCurrentCmd(execution, 'start')){
println '启动';}else if (BpmUtils.isCurrentCmd(execution, 'claim')){
println '签收';}else if (BpmUtils.isCurrentCmd(execution, 'complete')){
println '提交';}else if (BpmUtils.isCurrentCmd(execution, 'back')){
println '退回';}else if (BpmUtils.isCurrentCmd(execution, 'turn')){
println '转办';}else if (BpmUtils.isCurrentCmd(execution, 'delegate')){
println '委托';}else if (BpmUtils.isCurrentCmd(execution, 'stop')){
println '终止';}else if (BpmUtils.isCurrentCmd(execution, 'move')){
println '自由跳转';}

每个环节使用不同的表单

  1. 进入“业务流程 -> 流程管控 -> 流程定义”菜单。找到“你要配置的流程定义”数据行，点击“业务关联”操作按钮，进入“流程表单”界面。

  2. 一个流程可以关联多个业务单据，如：某公司8种费用审批流程，表单不一样，但流程相同，这里的表单 key 对应一种费用。表单的版本对应流程的版本，当新发布一个流程定义的时候，流程表单也跟随新增版本。

  3. 流程表单是一个树结构，顶级表单定义为全局表单（对所有环节生效）；下级表单为环节表单（该表单只对指定环节生效）。若没有定义环节表单的环节，则获取全局表单数据。

  4. 当指定多表单的 URL 时，需传递一个业务主键，这个业务主键贯穿整个流程，是全部环节表单的重要关联关系。如在发起表单，业务主键是ID，而在环节表单中，业务主键应该是一个外键（发起表的ID）。

会签参数配置

多实例参数

  • 多实例类型：Parallel（并行，并发执行）；Sequential（串行，按顺序执行）

  • 多实例基数：定义多实例的基数，指定多实例会签人数，循环多少次后结束，一般设定会签人集合的大小，例如：${num} （提交任务的时候设定该变量，类型为 Integer）

  • 多实例集合变量名：定义多实例集合的变量名，指定会签人的集合，根据集合中元素去创建任务数量，例如：pers （提交任务的时候设定该变量，类型为 List）

  • 多实例元素变量名：集合中每个元素的变量名，可在每个任务中获取，例如：per （将该变量名设定到分配人，如：${per}）

  • 多实例完成条件：定义多实例的完成条件，内置多实例变量包括：nrOfInstances（实例总数）、nrOfActiveInstances（当前还未完成的，对于顺序的多实例，此值总是1）、nrOfCompletedInstances（已完成的实例个数），例如：${nrOfCompletedInstances/nrOfInstances >= 0.8} （说明当有 80% 的任务完成时，完成此多实例）、${nrOfCompletedInstances/nrOfInstances == 1} （说明全部任务都完成时，完成此多实例）

配置举例说明

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

  • 多实例类型：Parallel（并行）

  • 多实例基数：${num}

  • 多实例集合变量名：pers

  • 多实例元素变量名：per

  • 多实例完成条件：空（无需设定）

  • 分配用户：分配人 ${per}

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

  • 多实例类型：Parallel（并行）

  • 多实例基数：空（无需设定）

  • 多实例集合变量名：pers

  • 多实例元素变量名：per

  • 多实例完成条件：${nrOfCompletedInstances/nrOfInstances >= 0.8}

  • 分配用户：分配人 ${per}

其它学习资源

Flowable 官方文档：https://jeesite.gitee.io/front/flowable/6.5.0/bpmn/index.html

Flowable 数据字典表结构：https://my.oschina.net/thinkgem/blog/4765491

Cloud 中使用 BPM 模块

1、引入依赖

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

<!-- 业务流程 Rest --><dependency>
<groupId>com.jeesite</groupId>
<artifactId>jeesite-cloud-module-bpm-rest</artifactId>
<version>${project.parent.version}</version></dependency>

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

<!-- 业务流程 Client --><dependency>
<groupId>com.jeesite</groupId>
<artifactId>jeesite-cloud-module-bpm-client</artifactId>
<version>${project.parent.version}</version></dependency>

2、新建测试代码

@Controller@RequestMapping(value = "${adminPath}/test1/testData")public class TestData1Controller2 extends BaseController {

/**
 * 业务流程测试
 */
@RequiresPermissions("test:testData:edit")
@RequestMapping(value = "bpmTest")
@ResponseBody
public String bpmTest() {

// 模拟创建一个业务实体对象
BpmEntity<?> bpmEntity = new BpmEntity<EmpUser>(){
private static final long serialVersionUID = 1L;
private String bpmEntityId = IdGen.nextId();
@Override
public String getId() {
return bpmEntityId;
}
};
Map<String, Object> variables = MapUtils.newHashMap();
variables.put("leaveDays", 5);

// 启动流程
BpmTask start = BpmUtils.start(bpmEntity, "leave", variables, null);
System.out.println("启动流程实例："+start.getProcIns().getId());

// 根据业务表单获取流程实例
BpmProcIns procIns = BpmUtils.getProcIns(bpmEntity, "leave");
System.out.println("获取流程实例："+procIns.getId());

// 查询并完成流程实例下的任务，直到全部任务都已经完成
BpmTaskServiceClient bean = SpringUtils.getBean(BpmTaskServiceClient.class);
while(true){
BpmTask where = new BpmTask(procIns);
where.setStatus(BpmTask.STATUS_UNFINISHED);
Page<BpmTask> page = bean.findTaskPage(where);
List<BpmTask> list = page.getList();
System.out.println("====== 任务数："+list.size());
if (list.size() == 0){
break;
}
for (BpmTask task : list) {
bpmEntity.getBpm().setTaskId(task.getId());
if (StringUtils.isBlank(task.getAssignee())){
System.out.println("签收任务："+task.getId());
bean.claimTask(task);
}
System.out.println("转办任务："+task.getId());
task.setUserCode("admin");
bean.turnTask(task);
System.out.println("完成任务："+task.getId());
BpmUtils.complete(bpmEntity, variables, null);
}
}
return renderResult(Global.TRUE, "业务流程测试完成，请打开 "
+ Global.getProperty("spring.application.name")
+ " 控制台，查看执行状态！");
}
}

3、运行测试代码

直接访问：http://127.0.0.1:8980/js/a/test1/testData/bpmTest

赞 (0)

相关推荐

  • java 自定义表单 动态表单 表单设计器 工作流引擎 flowable 项目源码

    自定义表单设计模块都有哪些? 1 定义模版:拖拽左侧表单元素到右侧区域,编辑表单元素,保存表单模版 2 表单模版:编辑维护表单模版,复制表单模版,修改模版类型,预览表单模版 3. 我的表单:选择表单模 ...

  • 评估工作流程引擎的30个关键技术点

    1.1:支持国际化 1.如果使用工具包的模式开发,支持国际化的工作由自己完成的. 2.如果使用Ccbpm 的前端,主要的功能页面已经支持, 3.后台的设置的页面全部中文,没有做支持国际化. 1.2:能 ...

  • 工作流项目一般都有哪些模块？

    工作流模块------------------------------- 1.模型管理 :web在线流程设计器.导入导出xml.复制流程.部署流程 2.流程管理 :导入导出流程资源文件.查看流程图.根 ...

  • 实战Spring Cloud、Vue构建基于微服务的SaaS低代码开发平台2

    大角云低代码开发2019-10-07 20:28:08 一.低代码开发平台不是快速开发平台 1. 低代码开发平台定义 最近,阿里巴巴发布了自己的低代码开发平台"宜搭",网址是:ht ...

  • 一文看懂开源工作流引擎 Flowable

    2020-05-13 按:本文写作完成于 2019 年 6 月 1 日,当时 Flowable 版本号为 V6.4.1.2020 年 3 月,Flowable 发布 V6.5.1 版本.Flowabl ...

  • java 自定义表单 动态表单 表单设计器 工作流引擎 flowable 设计方案

    工作流模块------------------------------- 1.模型管理 :web在线流程设计器.导入导出xml.复制流程.部署流程 2.流程管理 :导入导出流程资源文件.查看流程图.根 ...

  • LeaRun .Net Core-Java工作流引擎，分离式前端，升级Vue

    流程作为企业管理系统的核心,在企业的发展过程中具有重要的作用.通常来说,一个完整的流程大致包括有工作流引擎.工作流设计器.流程操作.客户界面.流程监控.表单设计器.表单集成以及与应用程序集成等. 工作 ...

  • 老板要我开发一个简单的工作流引擎

    极客挖掘机 今天 第1关 一天,老板找到我,说要做个简单的工作流引擎. 我查了一天啥是工作流,然后做出了如下版本: 按顺序添加任意个审批人组成一个链表,最后加一个结束节点 记录当前审批人,当审批完后, ...

  • 使用工作流引擎的好处

    所谓工作流引擎是指workflow作为应用系统的一部分,并为之提供对各应用系统有决定作用的根据角色.分工和条件的不同决定信息传递路由.内容等级等核心解决方案.工作流引擎包括流程的节点管理.流向管理.流 ...

  • 实用流程工具，浅析LR.NET配置型工作流引擎

    在企业信息化过程中,软件系统始终是无法绕过的话题,一套优秀的企业信息系统至少应该要拥有美观友好的交互界面,稳定的数据库信息交换,满足实际业务需求的高效程序逻辑等,这将在一定程度上保证其易用性. 稳定, ...

  • 三分钟看懂新一代.Net Core3.1工作流引擎平台

    工作流(Workflow),简单理解就是指业务的过程(部分或整体)在计算机应用环境下的自动化.它是对工作流程及其各操作步骤之间业务规则的抽象.概括描述.在计算机中,工作流属于计算机支持的协同工作(CS ...

  • 基于python的django框架的workflow工作流引擎学习

    工作流就是"业务过程的部分或整体在计算机应用环境下的自动化".将一组任务组织起来以完成某个特定的过程:定义了任务的触发顺序和触发条件,每个任务可以由一个或多个软件系统完成,也可以由 ...