SpringBoot3+Flowable 空审批人处理：自动通过、拒绝、指定成员与流程管理员怎么落地

SpringBoot3Flowable 空审批人处理自动通过、拒绝、指定成员与流程管理员怎么落地文档地址https://ruoyioffice.com源码1·GitHubhttps://github.com/yuqing2026/ruoyi-office源码2·GitCodehttps://gitcode.com/zhouzhongyan/ruoyi-office源码3·Giteehttps://gitee.com/yqzy1688/ruoyi-office微信17156169080备注「RuoYi Office」一句话候选人策略算出空集时流程必须有书面策略。RuoYi Office 把「自动通过 / 自动拒绝 / 指定成员 / 流程管理员」写进 UserTask 扩展元素——前两者在任务创建后补刀结案后两者在算候选人时就把人补上。▲ 指定成员与管理员在算候选人阶段补人通过/拒绝在事务提交后走正式任务 API业务单能回写引言空人不是超时也不是会签上线第一周最常见的工单不是「引擎算错会签比例」而是现场原话根因错把当「待办里没人单停着」角色停用、部门没负责人、上级空缺当成 Flowable 挂了「空了就当过」制度是备案类模型却没配自动通过靠实施口头说「空了必须停」用印/额度模型默认通过事故它和另外两套开关正交开关回答的问题多人审批依次 / 会签 / 或签人怎么过超时催办 / 自动同意 / 自动拒绝人在但不点怎么办空审批人算不出人怎么办可以同时存在指定角色 或签 空则转管理员 24h 催办。不要合成一个「审批规则」下拉。从流程模型进入简单流程设计器空人配置在节点右侧和超时、会签挨在一起最容易点错▲ 流程模型改完空人策略必须发布在途实例仍绑定旧 processDefinitionId画布上点开审批节点才能看到「审批人为空时」四选一▲ 简单流程画布空人、超时、驳回都在节点配置里发布前用空部门账号预演一遍一、业务设计四种策略对应四种制度前端文案简单流程节点值文案适合不适合1自动通过知会、备案、低风险用印、合同、资金2自动拒绝找不到人就不许占用额度「先过再说」的备案流3指定成员审批固定行政兜底兜底人自己也请假且没配第二人4转交给流程管理员实施期、模型上已维护管理员列表管理员当成业务审批岗长期用产品原话要翻译成一条不要四条都勾「部门没人时单据不能过」→ 自动拒绝或指定法务固定人。「先跑起来空了给实施」→ 流程管理员。「空了视同同意」→ 自动通过并要求原因码可审计。1.1 和「审批类型 自动通过」的差别节点还可以配「审批类型」人工审核 / 自动通过 / 自动拒绝。那是不管有没有候选人都按类型过。空审批人只在人工审核且候选人空时触发。把两者混用会出现「明明指定了经理仍被自动过」——那是审批类型配错不是空人策略。1.2 和发起人节点的差别发起人节点另有由发起人对自己审批 / 自动跳过 / 转交部门负责人。那是「第一棒要不要自己点」。空人是「这一棒算不出人」。费用确认常要自己审请假常跳过发起人。两套枚举不要共用一个 Radio。二、系统设计两条链路不要写成一个 if运行时分两段创建 UserTask → 按候选人策略算人 ├─ 策略结果为空且空人 指定成员 / 管理员 │ → 用扩展元素里的 userIds 或模型 managerUserIds 补人 └─ 仍为空且空人 通过 / 拒绝 → 任务先创建出来assignee、owner 皆空 → 事务提交后 afterCompletion → 调用正式 approveTask / rejectTask带空人原因码指定成员和管理员不会走到自动通过分支因为补人之后assignee已经有值。这是验收时最容易测错的点你以为会自动过其实待办落到了兜底人身上——这是对的。待办列表是补人是否成功的唯一观感▲ 待办指定成员/管理员策略下必须出现真人自动拒绝后待办应消失业务单状态随回调更新三、PC 端配置入口与验收路径流程模型→ 简单流程 → 审批节点 → 分组「审批人为空时」。选「指定成员」时出现人员多选其它三项不出现选人。保存并发布模型。草稿态改了不算。用没有部门负责人的账号发起观察待办或自动拒绝原因。BPMN 设计器里同一组扩展属性走自定义面板不要只在简单流程里配、BPMN 里漏配。两套设计器必须写同一套assignEmptyHandlerType/assignEmptyUserIds。操作路径建议步骤做什么期望1复制一条请假模型不影响生产定义2经理节点候选人改成空部门角色预演空集3空人选自动拒绝并发布新发起的单应拒绝4改指定成员后再发一张待办出现该成员5手机打开同一待办按钮与 PC 一致四、流程设计扩展元素才是合同简单流程转 BPMN 时审批节点会写入空处理扩展与超时边界事件分开assignEmptyHandlerType1/2/3/4assignEmptyUserIds仅类型 3逗号分隔用户 ID超时走的是挂在 UserTask 上的 Timer Boundary Event扩展名是timeoutHandlerType。两套属性不要复用。子流程超时是第三套边界类型本文不展开。发布后定义版本冻结。把空人从「自动通过」改成「自动拒绝」只影响新实例。这和流程图高亮必须绑processDefinitionId是同一条纪律。五、后端核心实现5.1 算候选人时补人类型 3 / 4候选人策略里有一条「空审批人」分支类型 3 读扩展里的用户 ID类型 4 读流程定义信息上的管理员列表。都不满足则仍返回空集把皮球踢给创建任务之后的补刀。IntegertypeparseAssignEmptyHandlerType(flowElement);if(typeASSIGN_USER){returnnewHashSet(parseAssignEmptyHandlerUserIds(flowElement));}if(typeASSIGN_ADMIN){returnnewHashSet(processDefinition.getManagerUserIds());}returnnewHashSet();// 交给创建后的通过/拒绝管理员列表来自流程定义信息不是系统超管。模型上没维护管理员又选了类型 4运行时会断言失败——实施期要先填管理员再选这项。5.2 创建后补刀类型 1 / 2人工审核且assignee、owner都空才在事务afterCompletion里自动通过或拒绝。必须走正式approveTask/rejectTask带上「空审批人自动通过/拒绝」原因码FlowBill 回调才能把业务单状态写下。不要runtimeService.deleteProcessInstance偷懒否则用印、请假台账会停在「审批中」。if(isUserApproveisAllEmpty(task.getAssignee(),task.getOwner())){if(typeAPPROVE){approveTask(null,req.reason(空审批人自动通过));}elseif(typeREJECT){rejectTask(null,req.reason(空审批人自动拒绝));}}第一个任务就是自动通过时Spring 事务回调可能走到STATUS_UNKNOWN。实现里对「任务已被删」做了短路避免二次同意。写二开时不要删这段否则空人通过会打两次业务回调。5.3 写入 BPMN 的时机简单流程ApproveNodeConvert在构建 UserTask 时调用addAssignEmptyHandlerType。emptyHandler null则不写扩展。新节点默认必须有值前端校验 required避免「没配」被理解成引擎默认通过。addExtensionElement(userTask,assignEmptyHandlerType,emptyHandler.getType());addExtensionElement(userTask,assignEmptyUserIds,join(,,emptyHandler.getUserIds()));数据权限在算候选人时要关掉。否则实施账号在测试租户里「看不见」本该补上的管理员误判为空。六、和超时、会签一起配时的决策表制度空人超时会签/或签请假经理转管理员或指定 HR24h 催办单人不必会签用印法务财务自动拒绝自动拒绝或长催办会签知会备案自动通过可关或签即可合同会签指定法务固定人催办不要轻易自动过会签会签节点上如果候选人算出三个人、其中一个角色停用只剩两个不是空人集合非空。空人指整个集合为空。会签人数变少要靠组织数据治理不要指望空人策略。七、数据结构与扩展属性不新建业务表。合同在流程定义 BPMN / SIMPLE JSON 里存储字段含义UserTask 扩展assignEmptyHandlerType1 通过 2 拒绝 3 指定人 4 管理员UserTask 扩展assignEmptyUserIds类型 3 的兜底用户流程定义信息managerUserIds类型 4 的管理员运行时任务assignee/owner补人后非空通过/拒绝前可为空历史原因码要能区分空人通过、超时通过、审批类型自动通过。三者审计口径不同不要写成同一个「系统通过」。八、技术亮点要点做法价值两段式处理3/4 补人1/2 结案兜底人出现在待办通过/拒绝能回写单据正式 API复用同意/拒绝FlowBill、消息、状态机一条链扩展元素随定义版本冻结旧单不被新策略改写与超时正交不同扩展名、不同边界事件实施能独立验收关数据权限算候选人忽略数据范围测试租户不会「看不见管理员」九、快速体验在线演示https://ruoyioffice.com/web/账号 admin / admin123打开流程模型复制一条请假或用印模型。把某审批节点候选人改成空角色空人分别试「自动拒绝」和「指定成员」。发布后各发起一张对比待办与单据状态。手机打开同一待办确认不是 PC 独有能力。仓库地址GitHubhttps://github.com/yuqing2026/ruoyi-officeGitCodehttps://gitcode.com/zhouzhongyan/ruoyi-officeGiteehttps://gitee.com/yqzy1688/ruoyi-office常见问题FAQSpringBoot 集成 Flowable 后部门负责人空了单据为什么一直停着候选人算出空集且节点没配空人策略或配了指定成员但 ID 无效。在简单流程节点「审批人为空时」显式选择四项之一并发布。空审批人自动通过和超时自动同意有什么差别空人是创建任务时没有审批人超时是有人但不处理。原因码、边界事件、验收用例都不同不要共用一个 Job 去扫。为什么选了自动通过待办却到了行政小王空人配的是「指定成员」或「流程管理员」补人发生在算候选人阶段不会走到自动通过。这是预期行为。改了空人策略已经在途的单会变吗不会。实例绑定发布时的流程定义。要验证新策略必须新发起。会签少了一个人算空审批人吗不算。空人指候选人集合整体为空。会签人数变化要治理组织主数据。总结空人是「算不出人」不是超时也不是会签。指定成员/管理员补人通过/拒绝结案两段不要写成一个 if。结案必须走正式同意/拒绝否则业务台账停在审批中。策略写进定义版本上线用空部门账号预演不要用全员管理员租户。你们空部门出现时是自动拒绝、转管理员还是指定固定行政评论区对照一下制度有没有写进节点。想要体验 RuoYi Office 的强大功能在线演示https://ruoyioffice.com/web/账号 admin / admin123源码仓库GitHubhttps://github.com/yuqing2026/ruoyi-office GitCodehttps://gitcode.com/zhouzhongyan/ruoyi-office Giteehttps://gitee.com/yqzy1688/ruoyi-office技术咨询添加微信17156169080备注「RuoYi Office」⭐如果觉得不错请给个 Star 支持一下