Flowable 工作流API应用与数据库对应展示

原创 已于 2025-01-21 11:38:51 修改 · 441 阅读 · 2 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#java #前端 #服务器

于 2025-01-19 22:42:19 首次发布

模型保存

请求参数分析

流程基本信息 process

{
  "id": "process_8616qrt8",
  "name": "name_d5mdibck"
}

流程图位置信息 svg

<?xml version="1.0" encoding="utf-8"?>
<!-- created with bpmn-js / http://bpmn.io -->
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="322" height="97"
     viewBox="-31 154 322 97" version="1.1">
    <defs>
        <marker id="sequenceflow-end-white-black-3sruubs92w8hngtoqurf3y84v" viewBox="0 0 20 20" refX="11" refY="10"
                markerWidth="10" markerHeight="10" orient="auto">
            <path d="M 1 5 L 11 10 L 1 15 Z"
                  style="fill: black; stroke-width: 1px; stroke-linecap: round; stroke-dasharray: 10000, 1; stroke: black;"/>
        </marker>
    </defs>
    <g class="djs-group">
        <g class="djs-element djs-shape" data-element-id="Event_02lbc8a" style="display: block;"
           transform="matrix(1 0 0 1 222 182)">
            <g class="djs-visual">
                <circle cx="18" cy="18" r="18"
                        style="stroke: black; stroke-width: 4px; fill: white; fill-opacity: 0.95;"/>
            </g>
            <rect class="djs-hit djs-hit-all" x="0" y="0" width="36" height="36"
                  style="fill: none; stroke-opacity: 0; stroke: white; stroke-width: 15px;"/>
            <rect x="-6" y="-6" width="48" height="48" class="djs-outline" style="fill: none;"/>
        </g>
    </g>
    <g class="djs-group">
        <g class="djs-element djs-connection" data-element-id="Flow_00van8r" style="display: block;">
            <g class="djs-visual">
                <path d="m  160,200L222,200 "
                      style="fill: none; stroke-width: 2px; stroke: black; stroke-linejoin: round; marker-end: url('#sequenceflow-end-white-black-3sruubs92w8hngtoqurf3y84v');"/>
            </g>
            <polyline points="160,200 222,200 " class="djs-hit djs-hit-stroke"
                      style="fill: none; stroke-opacity: 0; stroke: white; stroke-width: 15px;"/>
            <rect x="154" y="194" width="74" height="12" class="djs-outline" style="fill: none;"/>
        </g>
    </g>
    <g class="djs-group">
        <g class="djs-element djs-connection" data-element-id="Flow_1eyb522" style="display: block;">
            <g class="djs-visual">
                <path d="m  5,200L60,200 "
                      style="fill: none; stroke-width: 2px; stroke: black; stroke-linejoin: round; marker-end: url('#sequenceflow-end-white-black-3sruubs92w8hngtoqurf3y84v');"/>
            </g>
            <polyline points="5,200 60,200 " class="djs-hit djs-hit-stroke"
                      style="fill: none; stroke-opacity: 0; stroke: white; stroke-width: 15px;"/>
            <rect x="-1" y="194" width="67" height="12" class="djs-outline" style="fill: none;"/>
        </g>
    </g>
    <g class="djs-group">
        <g class="djs-element djs-shape" data-element-id="event_start" style="display: block;"
           transform="matrix(1 0 0 1 -25 185)">
            <g class="djs-visual">
                <circle cx="15" cy="15" r="15"
                        style="stroke: black; stroke-width: 2px; fill: white; fill-opacity: 0.95;"/>
            </g>
            <rect class="djs-hit djs-hit-all" x="0" y="0" width="30" height="30"
                  style="fill: none; stroke-opacity: 0; stroke: white; stroke-width: 15px;"/>
            <rect x="-6" y="-6" width="42" height="42" class="djs-outline" style="fill: none;"/>
        </g>
    </g>
    <g class="djs-group">
        <g class="djs-element djs-shape" data-element-id="startNode1_label" style="display: block;"
           transform="matrix(1 0 0 1 -23 222)">
            <g class="djs-visual">
                <text lineHeight="1.2" class="djs-label"
                      style="font-family: Arial, sans-serif; font-size: 11px; font-weight: normal; fill: black;">
                    <tspan x="0" y="9.899999999999999">开始</tspan>
                </text>
            </g>
            <rect class="djs-hit djs-hit-all" x="0" y="0" width="23" height="14"
                  style="fill: none; stroke-opacity: 0; stroke: white; stroke-width: 15px;"/>
            <rect x="-6" y="-6" width="35" height="26" class="djs-outline" style="fill: none;"/>
        </g>
    </g>
    <g class="djs-group">
        <g class="djs-element djs-shape" data-element-id="khjl001" style="display: block;"
           transform="matrix(1 0 0 1 60 160)">
            <g class="djs-visual">
                <rect x="0" y="0" width="100" height="80" rx="10" ry="10"
                      style="stroke: black; stroke-width: 2px; fill: white; fill-opacity: 0.95;"/>
                <text lineHeight="1.2" class="djs-label"
                      style="font-family: Arial, sans-serif; font-size: 12px; font-weight: normal; fill: black;">
                    <tspan x="50" y="43.599999999999994"/>
                </text>
                <path d="m 15,12 c 0.909,-0.845 1.594,-2.049 1.594,-3.385 0,-2.554 -1.805,-4.62199999 -4.357,-4.62199999 -2.55199998,0 -4.28799998,2.06799999 -4.28799998,4.62199999 0,1.348 0.974,2.562 1.89599998,3.405 -0.52899998,0.187 -5.669,2.097 -5.794,4.7560005 v 6.718 h 17 v -6.718 c 0,-2.2980005 -5.5279996,-4.5950005 -6.0509996,-4.7760005 zm -8,6 l 0,5.5 m 11,0 l 0,-5"
                      style="fill: white; stroke-width: 0.5px; stroke: black;"/>
                <path d="m 15,12 m 2.162,1.009 c 0,2.4470005 -2.158,4.4310005 -4.821,4.4310005 -2.66499998,0 -4.822,-1.981 -4.822,-4.4310005 "
                      style="fill: white; stroke-width: 0.5px; stroke: black;"/>
                <path d="m 15,12 m -6.9,-3.80 c 0,0 2.25099998,-2.358 4.27399998,-1.177 2.024,1.181 4.221,1.537 4.124,0.965 -0.098,-0.57 -0.117,-3.79099999 -4.191,-4.13599999 -3.57499998,0.001 -4.20799998,3.36699999 -4.20699998,4.34799999 z"
                      style="fill: black; stroke-width: 0.5px; stroke: black;"/>
            </g>
            <rect class="djs-hit djs-hit-all" x="0" y="0" width="100" height="80"
                  style="fill: none; stroke-opacity: 0; stroke: white; stroke-width: 15px;"/>
            <rect x="-6" y="-6" width="112" height="92" class="djs-outline" style="fill: none;"/>
        </g>
    </g>
    <g class="djs-group">
        <g class="djs-element djs-shape" data-element-id="Event_02lbc8a_label" style="display: block;"
           transform="matrix(1 0 0 1 195 225)">
            <g class="djs-visual">
                <text lineHeight="1.2" class="djs-label"
                      style="font-family: Arial, sans-serif; font-size: 11px; font-weight: normal; fill: black;">
                    <tspan x="0" y="9.899999999999999">结束</tspan>
                </text>
            </g>
            <rect class="djs-hit djs-hit-all" x="0" y="0" width="90" height="20"
                  style="fill: none; stroke-opacity: 0; stroke: white; stroke-width: 15px;"/>
            <rect x="-6" y="-6" width="102" height="32" class="djs-outline" style="fill: none;"/>
        </g>
    </g>
</svg>

流程图实例信息(关键) xml

<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI"
             xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC" xmlns:bioc="http://bpmn.io/schema/bpmn/biocolor/1.0"
             xmlns:flowable="http://flowable.org/bpmn" xmlns:di="http://www.omg.org/spec/DD/20100524/DI"
             xmlns:xsd="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.flowable.org/processdef">
    <process id="process_8616qrt8" name="name_d5mdibck">
        <documentation>随便一个</documentation>
        <extensionElements>
            <flowable:executionListener class="com.bu.xxx" event="take"/>
        </extensionElements>
        <startEvent id="event_start" name="开始" flowable:formKey="表单11key" flowable:initiator="zhangs">
            <documentation>开始节点</documentation>
            <outgoing>Flow_1eyb522</outgoing>
        </startEvent>
        <sequenceFlow id="Flow_1eyb522" sourceRef="event_start" targetRef="khjl001"/>
        <userTask id="khjl001" name="客户经理" flowable:candidateGroups="90112111">
            <documentation>客户经理</documentation>
            <incoming>Flow_1eyb522</incoming>
            <outgoing>Flow_00van8r</outgoing>
        </userTask>
        <endEvent id="Event_02lbc8a" name="结束">
            <documentation>结束节点</documentation>
            <extensionElements>
                <flowable:executionListener class="com.bu.xxx" event="end"/>
            </extensionElements>
            <incoming>Flow_00van8r</incoming>
        </endEvent>
        <sequenceFlow id="Flow_00van8r" sourceRef="khjl001" targetRef="Event_02lbc8a"/>
    </process>
    <bpmndi:BPMNDiagram id="BPMNDiagram_flow">
        <bpmndi:BPMNPlane id="BPMNPlane_flow" bpmnElement="process_8616qrt8">
            <bpmndi:BPMNEdge id="Flow_1eyb522_di" bpmnElement="Flow_1eyb522">
                <di:waypoint x="5" y="200"/>
                <di:waypoint x="60" y="200"/>
            </bpmndi:BPMNEdge>
            <bpmndi:BPMNEdge id="Flow_00van8r_di" bpmnElement="Flow_00van8r">
                <di:waypoint x="160" y="200"/>
                <di:waypoint x="222" y="200"/>
            </bpmndi:BPMNEdge>
            <bpmndi:BPMNShape id="BPMNShape_startNode1" bpmnElement="event_start" bioc:stroke="">
                <omgdc:Bounds x="-25" y="185" width="30" height="30"/>
                <bpmndi:BPMNLabel>
                    <omgdc:Bounds x="-23" y="222" width="23" height="14"/>
                </bpmndi:BPMNLabel>
            </bpmndi:BPMNShape>
            <bpmndi:BPMNShape id="Activity_17r1b2u_di" bpmnElement="khjl001">
                <omgdc:Bounds x="60" y="160" width="100" height="80"/>
            </bpmndi:BPMNShape>
            <bpmndi:BPMNShape id="Event_02lbc8a_di" bpmnElement="Event_02lbc8a">
                <omgdc:Bounds x="222" y="182" width="36" height="36"/>
                <bpmndi:BPMNLabel>
                    <omgdc:Bounds x="195" y="225" width="90" height="20"/>
                </bpmndi:BPMNLabel>
            </bpmndi:BPMNShape>
        </bpmndi:BPMNPlane>
    </bpmndi:BPMNDiagram>
</definitions>

流程部署API

核心 API 

RepositoryService 流程图管理

deploy 负责deploy部署
String tenantId = UUID.randomUUID().toString();
        repositoryService.createDeployment()
                .name(processName)
                // 租户
                .tenantId(tenantId)
                // 种类
                .category(processName)
                .deploymentProperty("name", processName)
                .deploymentProperty("path", processPath)
                // 工作流文件位置
                .addClasspathResource("processes/" + processPath)
                // 部署
                .deploy();
ACT_RE_DEPLOYMENT 存储部署信息 与 API 映射保持一致 

ACT_GE_BYTEARRAY [deployment_id] 流程资源 XML 信息 与 ACT_RE_DEPLOYMENT [id] 关联

ACT_RE_PROCDEF [deployment_id] 流程基本信息 与 ACT_RE_DEPLOYMENT [id] 关联

suspend 中断流程
/**
     * @param id
     * @return 中断
     */
    @Override
    public boolean suspendDeployment(String id) {
        try {
            repositoryService.suspendProcessDefinitionById(id);
            return true;
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
    }
ACT_RE_PROCDEF [SUSPENSION_STATE_] 字段表示流程状态 1 启用 2 中断

active 启用流程图

    /**
     * @param id
     * @return 唤醒
     */
    @Override
    public boolean activeDeployment(String id) {
        try {
            repositoryService.activateProcessDefinitionById(id);
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
        return true;
    }
ACT_RE_PROCDEF [SUSPENSION_STATE_] 字段表示流程状态 1 启用 2 中断
deleteDeployment 删除流程

    @Override
    public boolean deleteDeployment(String deployId) {
        repositoryService.deleteDeployment(deployId);
        return true;
    }
listDeployment 查询流程图列表(自定义查询sql)
select p.ID_               id,
        d.NAME_             name,
        d.CATEGORY_         category,
        d.TENANT_ID_        tenantId,
        d.DEPLOY_TIME_      deploymentTime,
        d.KEY_              'key',
        p.DEPLOYMENT_ID_    deployId,
        p.NAME_             xmlName,
        p.RESOURCE_NAME_    fileName,
        p.SUSPENSION_STATE_ state
        from ACT_RE_DEPLOYMENT d
        left join ACT_RE_PROCDEF p
        on d.ID_ = p.DEPLOYMENT_ID_
        order by d.DEPLOY_TIME_ desc

RuntimeService 流程管理

启动流程 createProcessInstanceBuilder



    @Override
    public void startProcess(String deployId, Object param01) {
        HashMap<String, Object> param = new HashMap<>();
        param.put("variable", param01);
        ProcessInstance start = runtimeService.createProcessInstanceBuilder()
                .processDefinitionId(deployId)
                .variables(param)
                // 节点执行人
                .tenantId("bhz")
                .name("启动了")
                .start();
    }

流程查询接口 createProcessInstanceQuery


    @Override
    public List<ProcessInstanceDto> listProcess(Integer pageNum, Integer pageSize) {
        List<ProcessInstance> list = runtimeService.createProcessInstanceQuery()
                .listPage(pageNum, pageSize);
        return list.stream().map(i -> {
            // 获取流程携带参数
            Map<String, Object> variables = runtimeService.getVariables(i.getId());
            ProcessInstanceDto processInstanceDto = new ProcessInstanceDto();
            BeanUtils.copyProperties(i, processInstanceDto);
            processInstanceDto.setVars(variables);
            return processInstanceDto;
        }).collect(Collectors.toList());
    }

ACT_RU_EXECUTION 存储启动的流程实例

获取流程携带参数  getVariables

Map<String, Object> variables = runtimeService.getVariables(i.getId());

TaskService 任务管理

ACT_RU_TASK 任务数据信息(流程启动Task任务表已经存在任务数据)
查询任务数据信息 ACT_RU_TASK [ PROC_INST_ID_ ] 与 ACT_RU_VARIABLE [PROC_INST_ID_ ] 保持一致
select t.ID_ id,
        t.EXECUTION_ID_ executionId,
        t.PROC_INST_ID_ processInstanceId,
        t.PROC_DEF_ID_ processDefinitionId,
        t.NAME_ name,
        t.DESCRIPTION_ description,
        t.ASSIGNEE_ assignee,
        t.OWNER_ owner,
        t.TENANT_ID_ tenantId,
        t.REV_ rev,
        t1.BYTES_ bytes
        from ACT_RU_TASK t
        left join (
        select y.BYTES_,v.PROC_INST_ID_ -- 流程图 , 实例id
        from ACT_RU_VARIABLE v inner join ACT_GE_BYTEARRAY y on v.BYTEARRAY_ID_ = y.ID_
        ) t1 on t.PROC_INST_ID_ = t1.PROC_INST_ID_
        order by t.CREATE_TIME_ desc
任务审核提交 complete

    public Boolean complete(String id, String commonContext) {
        try {
            // 审批意见
            HashMap<String, Object> param = new HashMap<>();
            param.put("commonContext", commonContext);
            taskService.complete(id, param);
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
        return true;
    }

提交完成的数据保存在  ACT_HI_TASKINST 表、ACT_RU_TASK 只保留待执行任务

调单 claim (任务id,操作人) 操作人解厄下来任务的执行人

    public Boolean claim(String id, String name) {
        try {
            // 取消调单
            taskService.unclaim(id);
            // 调单
            taskService.claim(id, name);
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
        return true;
    }
未调单数据

调单后数据

HistoryService 历史信息查询

历史流程查询 createHistoricTaskInstanceQuery

历史任务查询 createHistoricProcessInstanceQuery

布Coder
关注
flowable工作流看这一篇就够了（基础篇）
qq_38196449的博客
12-10 1万+
接下来我们构建一个非常简单的请假流程，Flowable引擎需要流程定义为BPMN 2.0格式，这是一个业界广泛接受的XML标准。在Flowable术语中，我们将其称为一个流程定义(process definition)。一个流程定义可以启动多个流程实例(process instance)。流程定义可以看做是重复执行流程的蓝图。在这个例子中，流程定义定义了请假的各个步骤，而一个流程实例对应某个雇员提出的一个请假申请。
flowable工作流看这一篇就够了（进阶篇 上）
qq_38196449的博客
12-30 2506
循环设定启动事件：根据设置循环启动流程实例。中间事件：即使设置了循环时间也只会触发异常。边界事件：即使设置了循环时间也只会触发异常。
Flowable中文文档（v 6.4.2）
01-06
工作流程设计平台 Flowable 的 Word 版中文文档（v 6.4.2），本人自己从英语原版翻译而来，收获很多！
Flowable常用API
qq_74748121的博客
05-11 468
Flowable常用API
Flowable引擎API深度解析：核心服务与使用指南
最新发布
gitblog_00063的博客
06-05 316
Flowable引擎API深度解析：核心服务与使用指南 一、Flowable引擎API概述 Flowable引擎API是与工作流引擎交互的主要方式，其核心入口是ProcessEngine类。通过ProcessEngine可以获取各种服务对象，这些服务对象包含了工作流/BPM相关的操作方法。值得注意的是，ProcessEngine及其服务对象都是线程安全的，可以在整个服务器生命周期中保持对它们的引用...
flowable 流程引擎API与服务
03-23 1701
引擎API是与Flowable交互的最常用手段。总入口点是ProcessEngine。 1、RepositoryService很可能是使用Flowable引擎要用的第一个服务。这个服务提供了管理与控制部署(deployments)与流程定义(process definitions)的操作。管理静态信息， 2、RuntimeService用于启动流程定义的新流程实例。 3、IdentityService很简单。它用于管理（创建，更新，删除，查询……）组与用户。 4、FormService是可选服务。也
flowable基本服务
limonero
12-24 947
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine(); RuntimeService runtimeService = processEngine.getRuntimeService(); RepositoryService repositoryService = processEngine. getRepositoryService(); TaskService taskService = processEngine.
Flowable API
Dowjone梦工厂
02-01 4224
Flowable API   流程引擎API与服务 引擎API是与Flowable交互的最常用手段。总入口点是ProcessEngine。可以使用多种方式创建。使用ProcessEngine，可以获得各种提供工作流/BPMN方法的服务。它是线程安全的，可以在服务器中保存并共用一个引用。   ProcessEngine processEngine = ProcessEngine...
工作流Flowable 入门API
fouling的博客
07-12 1085
工作流Flowable 常用service对象，以及常用PAI
Springboot+Flowable 实现工作流开发流程.docx
12-11
在代码中，你可以利用Flowable的API来启动流程实例、查询任务、提交任务以及处理其他与工作流相关的操作。 总的来说，SpringBoot结合Flowable提供了一种高效且灵活的方式来实现业务流程自动化。通过理解Flowable UI...
flowable官方文档中文版.zip
06-24
flowable官方文档中文版.pdf
flowable_rest_api接口详细介绍
11-20
切记不要自动换行！ 全是我自己对它的理解和查看源码来进行中文注解的，如果注解有错请联系我进行修改。
flowable官方文档汉化版_text.rar
11-18
流程引擎基础案例,全中文文档 Flowable可以作为一个jar替换掉到一个已编译的应用程序中并继续正常工作。 如果在MINOR版本中引入API更改，则策略是保留向后兼容的版本，并使用@Deprecated注释。这样被弃用的API将在稍后被删除两个 MINOR版本。
flowable ui和flowable api 的对应关系（结合使用场景）
孤岛的鲸
02-09 854
Flowable UI **基于 Flowable API 构建**，所有 UI 操作最终会转换为 API 调用（如 `TaskService.complete()`）。二者共享同一数据库，操作结果通过 Flowable 的 **数据库表**（如 `ACT_RU_TASK`、`ACT_HI_TASKINST`）同步。- **UI 高频操作**：优化对应 API 的数据库查询（如索引 `ACT_RU_TASK`）。`ACT_RU_TASK`（任务减少）、`ACT_HI_TASKINST`（历史任务记录）。
Flowable 工作流（一）
42
04-03 1106
Flowable工作流介绍，部署
Flowable主要API介绍
zp的博客
09-17 3008
负责与各个服务进行交互和管理流程的整个生命周期。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值