JNPF Workflow 文档索引
JNPF 流程平台开发指南,整理自 17 条平台示例和前后端源码分析。
JNPF 与 Flowable 引擎集成
JNPF 工作流基于 Flowable 引擎实现,流程数据存储在 JNPF 数据库,但流程执行由 Flowable 管理。
数据存储
| 组件 |
存储位置 |
说明 |
| 流程模板 |
base_flow_template 表 |
JNPF 管理 |
| 流程版本 |
base_flow_template 版本字段 |
JNPF 管理 |
| 流程实例 |
Flowable 表(ACT_*) |
Flowable 引擎 |
| 任务节点 |
Flowable 表(ACT_RU_*) |
Flowable 引擎 |
| 表单数据 |
base_flow_task 表 |
JNPF 管理 |
集成机制
- 模板发布:JNPF 保存流程模板(含 flowXml/flowNodes)到
base_flow_template
- 流程发起:JNPF 调用 Flowable API 创建流程实例,Flowable 生成任务节点
- 审批操作:JNPF 调用 Flowable API 完成审批,Flowable 推进流程
- 任务查询:JNPF 关联查询 Flowable 表和 JNPF 表,返回完整状态
关键表关系
与标准 Flowable 的差异
- JNPF 对 Flowable 做了封装,API 路径为
/api/workflow/*
- Flowable 原生 API 通过内部服务调用,不直接暴露
- 表单数据绑定在 JNPF 层,Flowable 只负责流程控制
文档结构
快速参考
流程类型
| type |
名称 |
说明 |
| 0 |
自由审批 |
标准审批流程,用户自定义节点和连线 |
| 1 |
简单流程 |
预定义三节点(发起→审批→结束) |
| 2 |
触发器流程 |
Webhook/定时触发,无审批环节 |
| 3 |
自由流程 |
允许自由选择审批人 |
| 4 |
决策引擎 |
条件分支决策 |
节点类型
| type |
名称 |
说明 |
| start |
发起节点 |
流程发起 |
| approver |
审批节点 |
需要审批 |
| processing |
办理节点 |
任务处理 |
| subFlow |
子流程 |
调用子流程 |
| free |
自由节点 |
自由选择审批人 |
| gateway |
网关 |
条件路由 |
审批人指定方式 (assigneeType)
| 值 |
名称 |
说明 |
| 1 |
发起人上级 |
发起人的 N 级上级 |
| 2 |
特定岗位 |
指定岗位审批 |
| 3 |
发起人自己 |
发起者自己审批 |
| 4 |
表单变量 |
从表单字段中选择审批人 |
| 5 |
审批节点 |
指定流程中某个节点审批人 |
| 6 |
指定成员 |
直接指定审批人 |
| 7 |
候选人 |
发起时选择审批人 |
| 9 |
数据接口 |
从接口获取审批人 |
| 10 |
逐级审批 |
按层级向上审批 |
会签规则 (counterSign)
| 值 |
名称 |
说明 |
| 0 |
或签 |
一名审批人同意或拒绝即可 |
| 1 |
会签 |
无序会签,达到会签比例通过 |
| 2 |
依次审批 |
按顺序依次审批 |
常用操作
关键配置参考
flowNodes 结构
flowXml
BPMN 2.0 XML,简单流程需要 URL 编码。
flowConfig
- visibleType=1: 公开
- visibleType=2: 权限设置
源码位置
前端
| 文件 |
路径 |
| 流程设计器 |
views/onlineDev/flowEngine/Form.vue |
| 流程模板表单 |
views/onlineDev/flowEngine/DesignForm.vue |
| 流程解析器 |
views/workFlow/components/FlowParser.vue |
| 节点配置 |
views/workFlow/components/NodeFormParser.vue |
| API: task |
src/api/workFlow/task.ts |
| API: template |
src/api/workFlow/template.ts |
后端
| 文件 |
路径 |
| DefinitionController |
后端/jnpf-workflow/.../controller/DefinitionController.java |
| TaskController |
后端/jnpf-workflow/.../controller/TaskController.java |
| FlowUtil |
后端/jnpf-workflow-core/.../util/FlowUtil.java |
| FlowableUtil |
后端/jnpf-workflow-core/.../util/FlowableUtil.java |
平台示例(17条)
详见 workflow_examples.md
| 类型 |
数量 |
示例 |
| type=0 自由审批 |
9 |
leaveApply, 采购申请, 付款申请, 离职申请... |
| type=1 简单流程 |
4 |
crmOrder, salesOrder, materialapply, paymentapply |
| type=2 触发器 |
4 |
webhook, Timedtrigger, customeradd, messagetrigger |
常见错误
- create_template 必须含 flowXml/flowNodes/flowConfig - 否则 NPE
- 审批需要 status 字段 - status=1 同意, status=2 拒绝
- launch_task 的 isFlow 必须是整数 - 用 1 而非 True
- get_flow_info 参数是 version_id - 不是 template_id
- 审批人不能与发起人相同 - 会报系统异常