黑湖小工单「自定义事件」完整设置全流程（自动流转、字段传递、委外入库带供应商通用）

一、进入自定义事件入口

1. 使用管理员账号登录 Web 后台

2. 左侧菜单：【生产管理】→【任务】（任务中心页面顶部）

3. 页面上方找到【自定义事件】按钮，点击进入事件列表

4. 右上角点击新增事件，进入两步配置向导：①触发规则配置 → ②执行规则配置

二、第一步：触发规则配置（什么时候触发自动化）

1. 基础信息填写

• 自定义事件名称：区分用途（例：委外报工合格自动入库、末道工序完工关闭工单、委外入库自动回填供应商）

• 状态：启用（配置完成才生效）

• 触发表单：选择源头单据（常用）

  • 任务：工人报工、工序状态变更（最常用）

  • 委外加工单：外协单据保存 / 变更

  • 工单：生产工单新建、修改、完成

  • 入库单 / 领料单：库存单据变更

• 触发事件类型

  1. 数据变更：单据保存、报工提交、状态修改（90% 场景用这个）

  2. 时间触发：定时提醒逾期工单、每日产量推送

• 触发事件动作：编辑数据 / 新增数据（报工属于编辑任务数据）

2. 关键：触发条件（过滤，只满足条件才执行后续动作）

通用示例 1（委外工序报工合格触发自动入库）

通用示例 2（末道检验完工自动关闭工单）

通用示例 3（抓取委外单供应商，自动带入入库单）

三、第二步：执行规则配置（触发后自动做什么）

1. 执行基础参数

• 执行事件类型（四大类）

  1. 数据变更：修改已有单据字段（回填供应商、修改工单状态）

  2. 新增数据：自动生成入库单、领料单、通知消息

  3. 消息推送：微信 / 系统消息推送责任人

  4. Webhook 推送：推数据到 ERP、集成平台

• 执行表单：目标单据（要操作的单据）

  • 工单：修改工单状态

  • 委外入库单：自动生成入库单、回填供应商

  • 任务：自动开启下一道工序

  • 消息通知：推送提醒

• 过滤条件：本工单 / 本委外单（绑定源头单据，避免跨单错乱）

2. 核心场景 1：委外报工后自动生成委外入库单 + 自动携带供应商

1. 执行事件类型：新增数据

2. 执行表单：委外入库单

3. 字段映射（重点，实现供应商自动带入）

   | 委外入库单目标字段 | 来源上游字段（表达式） |

   | ---- | ---- |

   | 委外单号 | ${任务.委外单号} |

   | 供应商 | ${委外加工单.供应商} |

   | 产品 | ${工单.产品名称} |

   | 入库数量 | ${任务.合格数量} |

4. 附加设置：入库单自动审核 / 保存草稿，按需勾选

5. 保存执行规则

3. 核心场景 2：工序完成自动结束工单

1. 执行事件类型：数据变更

2. 执行表单：工单

3. 执行动作：结束工单

4. 过滤条件：本工单

   适合成品检验工序完成后，工单自动归档。

4. 核心场景 3：工序完成推送消息给仓管 / 质检

1. 执行事件类型：消息推送

2. 执行对象：指定角色 / 用户（仓管、车间主任）

3. 内容模板自定义：工单编号、产品、合格数量、外协厂名称

4. 支持微信服务号推送、系统内消息弹窗

四、保存、启用与测试流程

1. 两步配置全部完成，点击底部【保存】，事件回到事件列表

2. 确认事件状态为启用（灰色停用、绿色启用）

3. 车间测试验证：

   1. 走完整业务流程（新建委外单→扫码委外报工）

   2. 查看是否自动生成委外入库单，表头供应商是否自动带出

   3. 看板 / 消息通知是否正常推送

4. 多事件优先级：多个事件同时触发，按列表从上至下顺序执行

五、高频落地场景配置模板（直接复制条件）

模板 1：委外工序报工合格，自动生成带供应商的委外入库

模板 2：成品检验完工，自动关闭工单 + 推送入库提醒

模板 3：工单交期提前 3 天自动推送预警

六、常见故障排查

1. 自动入库单不带供应商名称

   • 触发条件未绑定委外单号判断 ${任务.委外单号}!=''

   • 执行字段映射错误，未选择委外加工单.供应商，只取了任务表无供应商字段

   • 委外加工单是手工输入供应商文本，未选择系统供应商档案，无法同步档案名称

2. 规则配置完成不自动执行

   • 事件状态未启用

   • 触发条件表达式写错（字段名大小写、符号错误）

   • 报工 / 单据操作不满足条件（不良数量、工序名称不匹配）

   • 账号无自定义事件配置权限，切换管理员账号

3. 自动生成多张入库单

   • 过滤条件未勾选「本工单 / 本委外单」，重复触发生成多单

   • 工人重复提交报工，可增加限制：同一任务一天仅触发一次

七、权限管理说明

1. 仅系统管理员拥有新增、编辑、删除自定义事件权限

2. 车间主任、操作工、仓管账号仅能查看事件列表，无法修改规则

3. 若多人维护自动化规则，建议创建专用管理员账号统一配置，避免规则冲突