Files
2026-05-18 09:28:15 +08:00
..
2026-05-18 09:28:15 +08:00
2026-05-18 09:28:15 +08:00
2026-05-18 09:28:15 +08:00
2026-05-18 09:28:15 +08:00
2026-05-18 09:28:15 +08:00

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 管理

集成机制

  1. 模板发布:JNPF 保存流程模板(含 flowXml/flowNodes)到 base_flow_template
  2. 流程发起:JNPF 调用 Flowable API 创建流程实例,Flowable 生成任务节点
  3. 审批操作:JNPF 调用 Flowable API 完成审批,Flowable 推进流程
  4. 任务查询:JNPF 关联查询 Flowable 表和 JNPF 表,返回完整状态

关键表关系

base_flow_template (模板)
    ↓ version_id
base_flow_task (流程实例) ← 关联 → Flowable ACT_RU_* (任务)

与标准 Flowable 的差异

  • JNPF 对 Flowable 做了封装,API 路径为 /api/workflow/*
  • Flowable 原生 API 通过内部服务调用,不直接暴露
  • 表单数据绑定在 JNPF 层,Flowable 只负责流程控制

文档结构

workflow/
├── README.md                      # 本文档(速查入口)
├── 01-template-guide.md           # 流程模板创建与配置
├── 02-flow-design-guide.md        # 流程设计指南
├── 03-task-operation-guide.md     # 任务操作指南
├── 04-approval-operation-guide.md  # 审批操作指南
├── 05-advanced-features-guide.md   # 高级功能指南
├── 06-examples/                   # 示例文档
│   ├── 01-simple-flow.md          # 简单流程(type=1)
│   ├── 02-standard-flow.md        # 自由审批流程(type=0)
│   ├── 03-trigger-flow.md          # 触发器流程(type=2)
│   └── 04-form-workflow.md        # 表单工作流(webType=3)
└── 07-troubleshooting.md          # 故障排查

../workflow-guide.md                # 完整开发指南(详细)

快速参考

流程类型

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 依次审批 按顺序依次审批

常用操作

# 创建简单流程
result = client.workflow.create_simple_flow(
    full_name="采购审批",
    en_code="purchaseFlow",
    form_id=func_id,
    approver_user_ids=["user_id"],
)
version_id = result["version_id"]

# 发起流程
task = client.workflow.launch_task(version_id, {"f_amount": 5000})

# 审批
client.workflow.approve(operator_id, "同意")

# 拒绝
client.workflow.reject(operator_id, "不同意")

# 退回
client.workflow.back(operator_id, {"targetNodeId": "node_id"})

关键配置参考

flowNodes 结构

{
  "global": { "formId": "", "titleType": 0 },
  "Event_0oz4pwh": { "type": "start", "formId": "" },
  "Activity_1qf73gq": { "type": "approver", "assigneeType": 6, "approvers": [] },
  "Event_0zlhfee": { "type": "end" }
}

flowXml

BPMN 2.0 XML,简单流程需要 URL 编码。

flowConfig

{"visibleType": 1}
  • 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

常见错误

  1. create_template 必须含 flowXml/flowNodes/flowConfig - 否则 NPE
  2. 审批需要 status 字段 - status=1 同意, status=2 拒绝
  3. launch_task 的 isFlow 必须是整数 - 用 1 而非 True
  4. get_flow_info 参数是 version_id - 不是 template_id
  5. 审批人不能与发起人相同 - 会报系统异常