黑湖小工单「自定义事件」完整设置全流程（自动流转、字段传递、委外入库带供应商通用）
自定义事件核心作用：单据数据变更后自动执行动作，实现工序自动流转、字段自动回填、消息推送、自动入库、跨单携带供应商 / 委外单号等自动化规则，全程 Web 后台管理员配置，无需代码。
一、进入自定义事件入口
- 使用管理员账号登录 Web 后台
- 左侧菜单：【生产管理】→【任务】（任务中心页面顶部）
- 页面上方找到【自定义事件】按钮，点击进入事件列表
- 右上角点击新增事件，进入两步配置向导：①触发规则配置 → ②执行规则配置
二、第一步：触发规则配置（什么时候触发自动化）
1. 基础信息填写
- 自定义事件名称：区分用途（例：委外报工合格自动入库、末道工序完工关闭工单、委外入库自动回填供应商）
- 状态：启用（配置完成才生效）
- 触发表单：选择源头单据（常用）
- 任务：工人报工、工序状态变更（最常用）
- 委外加工单：外协单据保存 / 变更
- 工单：生产工单新建、修改、完成
- 入库单 / 领料单：库存单据变更
- 触发事件类型
- 数据变更：单据保存、报工提交、状态修改（90% 场景用这个）
- 时间触发：定时提醒逾期工单、每日产量推送
- 触发事件动作：编辑数据 / 新增数据（报工属于编辑任务数据）
2. 关键：触发条件（过滤，只满足条件才执行后续动作）
系统支持字段表达式写法 ${表单.字段名}，多条件用&&并列
通用示例 1（委外工序报工合格触发自动入库）
触发表单 = 任务条件：${任务.工序类型} == '委外工序' && ${任务.任务状态} == '已结束' && ${任务.合格数量} > 0含义：委外工序报工完成、有合格数量才触发入库
通用示例 2（末道检验完工自动关闭工单）
${任务.工序名称} == '成品检验' && ${任务.任务状态} == '已结束'
通用示例 3（抓取委外单供应商，自动带入入库单）
触发条件增加：关联上游委外加工单不为空${任务.委外单号} != ''
填写完成，点击【下一步】进入执行配置页面。
三、第二步：执行规则配置（触发后自动做什么）
1. 执行基础参数
- 执行事件类型（四大类）
- 数据变更：修改已有单据字段（回填供应商、修改工单状态）
- 新增数据：自动生成入库单、领料单、通知消息
- 消息推送：微信 / 系统消息推送责任人
- Webhook 推送：推数据到 ERP、集成平台
- 执行表单：目标单据（要操作的单据）
- 工单：修改工单状态
- 委外入库单：自动生成入库单、回填供应商
- 任务：自动开启下一道工序
- 消息通知：推送提醒
- 过滤条件：本工单 / 本委外单（绑定源头单据，避免跨单错乱）
2. 核心场景 1：委外报工后自动生成委外入库单 + 自动携带供应商
- 执行事件类型：新增数据
- 执行表单：委外入库单
- 字段映射（重点，实现供应商自动带入）
- | 委外入库单目标字段 | 来源上游字段（表达式） |
- | ---- | ---- |
- | 委外单号 |
${任务.委外单号}| - | 供应商 |
${委外加工单.供应商}| - | 产品 |
${工单.产品名称}| - | 入库数量 |
${任务.合格数量}| - 附加设置：入库单自动审核 / 保存草稿，按需勾选
- 保存执行规则
3. 核心场景 2：工序完成自动结束工单
- 执行事件类型：数据变更
- 执行表单：工单
- 执行动作：结束工单
- 过滤条件：本工单
- 适合成品检验工序完成后，工单自动归档。
4. 核心场景 3：工序完成推送消息给仓管 / 质检
- 执行事件类型：消息推送
- 执行对象：指定角色 / 用户（仓管、车间主任）
- 内容模板自定义：工单编号、产品、合格数量、外协厂名称
- 支持微信服务号推送、系统内消息弹窗
四、保存、启用与测试流程
- 两步配置全部完成，点击底部【保存】，事件回到事件列表
- 确认事件状态为启用（灰色停用、绿色启用）
- 车间测试验证：
- 走完整业务流程（新建委外单→扫码委外报工）
- 查看是否自动生成委外入库单，表头供应商是否自动带出
- 看板 / 消息通知是否正常推送
- 多事件优先级：多个事件同时触发，按列表从上至下顺序执行
五、高频落地场景配置模板（直接复制条件）
模板 1：委外工序报工合格，自动生成带供应商的委外入库
触发配置：触发表单 = 任务，类型 = 数据变更触发条件：${任务.工序类型} == '委外工序' && ${任务.任务状态} == '已结束' && ${任务.委外单号} != '' && ${任务.合格数量}>0
执行配置：执行类型 = 新增数据，执行表单 = 委外入库单字段映射：供应商 = 委外加工单。供应商、委外单号 = 任务。委外单号、入库数量 = 任务。合格数
模板 2：成品检验完工，自动关闭工单 + 推送入库提醒
触发条件：${任务.工序名称} == '成品终检' && ${任务.任务状态} == '已结束'执行 1：数据变更 - 工单 - 结束工单执行 2：消息推送 - 仓管，通知成品待入库
模板 3：工单交期提前 3 天自动推送预警
触发类型：时间触发触发条件：${工单.计划完工日期} - 当前日期 <= 3执行：消息推送车间主管、老板
六、常见故障排查
- 自动入库单不带供应商名称
- 触发条件未绑定委外单号判断
${任务.委外单号}!='' - 执行字段映射错误，未选择
委外加工单.供应商，只取了任务表无供应商字段 - 委外加工单是手工输入供应商文本，未选择系统供应商档案，无法同步档案名称
- 规则配置完成不自动执行
- 事件状态未启用
- 触发条件表达式写错（字段名大小写、符号错误）
- 报工 / 单据操作不满足条件（不良数量、工序名称不匹配）
- 账号无自定义事件配置权限，切换管理员账号
- 自动生成多张入库单
- 过滤条件未勾选「本工单 / 本委外单」，重复触发生成多单
- 工人重复提交报工，可增加限制：同一任务一天仅触发一次
七、权限管理说明
- 仅系统管理员拥有新增、编辑、删除自定义事件权限
- 车间主任、操作工、仓管账号仅能查看事件列表，无法修改规则
- 若多人维护自动化规则，建议创建专用管理员账号统一配置，避免规则冲突
