生产汇报单同步实战:从 MySQL 到金蝶云星空的端到端实现
这个策略解决什么问题
某离散制造企业的 MES(MySQL 库)每天会落库几万行单工序汇报数据,质量、生产、仓库都要看;金蝶云星空作为 ERP,要拿到这些汇报去做成本归集与工序核算。两边一旦口径不一致,月结时成本就对不上,IT 团队最怕的就是"MES 里写了,ERP 没收到"或者"ERP 收了两遍"。这条策略就是把 MES 中的单工序汇报单,按入库单号幂等推送到金蝶云星空,做到单据唯一、口径统一、可重跑。
数据流向与字段映射
整体流向是 MySQL → 轻易云(Qeasy) → 金蝶云星空,分两层:
- 源层(MySQL):源接口类型是 SQL 查询,主查询拼出"入库单号 / 生产订单号 / 物料编号 / 计划跟踪号 / 入库数量 / 日期 / 工时 / 工序编码 / 供应组织"等列。其中生产订单号、入库单号、日期三列都是源端 SQL 里现算出来的(比如生产订单号按
delivery_org走case when拼前缀),入库单号直接用CONCAT('RKD', id)当幂等键。 - 目标层(金蝶云星空):目标接口类型是
batchSave,以FBillNo = 入库单号作为单据号,FDate接日期,FPrdOrgId/FWorkshipIdH用_function做组织/车间映射,再挂单据体。
关键字段对照(只列最容易踩坑的几个):
| 维度 | MySQL 源字段 | 轻易云转换 | 金蝶云星空目标字段 | 说明 |
|---|---|---|---|---|
| 单据号 | 入库单号(CONCAT('RKD',id)) | 原值透传 | FBillNo | 必须幂等,重复入库靠它去重 |
| 单据日期 | 日期(update_time) | 透传 | FDate | 源 SQL 已按 config_id=351 兜底成业务日 |
| 生产订单号 | 生产订单号(按 delivery_org 拼前缀) | 透传 | FBillNoEntry 上的生产订单号 | 跨组织前缀别混 |
| 生产组织 | 供应组织(delivery_org) | _function case 翻译 | FPrdOrgId | T01.01→T01.06、T04→T04 |
| 生产车间 | 供应组织 | _function case 翻译 | FWorkshipIdH | 与生产组织配套 |
| 单据类型 | —— | 常量 | FBillType = SCHBD01_SYS | 汇报单固定类型 |
| 入库数量 | confirm_numb | 透传 | 单据体数量 | confirm_numb=0 的不推 |
表头里很多供应组织的翻译,源 SQL 里只产出 T01.01 / T04 等代码,真正的 ERP 组织、车间代码是在轻易云的
_function表达式里集中翻译。编码映射集中管理,是轻易云客户里非常常见的应对模式。
在轻易云上如何配置
我们在客户现场一般按"源接口 → 字段映射 → 目标接口 → 调度"四步配。
- 源接口:选 MySQL 数据源,把那段长 SQL 贴进
main_sql,把:limit / :offset作为分页参数(limit一般给 200~500,具体看库压力);另外把:created_at形式的增量时间变量预留出来,交给调度传入。 - 字段映射:源列直接拖出来当变量;
FPrdOrgId/FWorkshipIdH用_function case ... end内联表达式;FBillType写常量SCHBD01_SYS。所有_function建议另存一份到轻易云的"脚本库",后续同类单据直接复用。 - 目标接口:金蝶云星空
batchSave,JSON 模型按星空Model规则拼;idCheck=true打开,星空会用FBillNo帮我们做重复单据拦截,即使轻易云侧重推也不会重复落库。 - 调度:源端
*/3 * * * *,目标端*/4 * * * *,两边错峰,降低瞬时并发。
实施步骤
我们一般分三个阶段推进,避免一上来就全量扫表把 MES 打爆。
- 阶段一:增量起点对齐。在 MySQL 里查
MAX(update_time),把它减 1 小时当作created_at初值;同时把目标库星空里最近 7 天的FBillNo导出来,反查源端是否存在、是否需要补单,这一步是为了定下"起点",别拍脑袋从 0 开始。 - 阶段二:全量触发 + 校验。把
:limit/:offset调到能 1~2 轮拉完历史数据的量级,跑一次完整回灌;同时准备一份对账 SQL(按RKD + idjoin 星空FBillNo),跑完后行数必须一致,差异单据手工处理。 - 阶段三:增量稳态。把调度切回
*/3/*/4,只推update_time > 上次水位的数据;前两周每天看一次重复率与失败率,水位线建议落库到sys_config或轻易云的全局变量里,避免重启后回溯。
踩坑复盘
- 入库单号当幂等键是底线。早期有客户拿"生产订单号 + 工序"做唯一键,结果同一单工序被多次汇报就丢数据。后来统一改成
RKD + id,源端 SQL 里一次成型,目标端idCheck=true兜底,双保险。 update_time不要直接当业务日期。源端如果只取date(update_time),跨夜时会被推到下一天;素材里通过config_id=351的配置项把日期归到业务日,是稳妥的做法,轻易云客户里常见的就是这种"日期集中翻译"模式。- 组织/车间映射别写在 SQL 里。有的客户把
T01.01→T01.06直接写进 SQL,换组织结构时要改源 SQL、要走 DBA 评审;迁到轻易云的_function表达式后,IT 自己就能改,变更窗口从一天缩到十分钟。 confirm_numb=0的脏数据。MES 端偶发会写入 0 数量,源 SQL 里就过滤掉(confirm_numb<>0),比推到星空再被驳回省事。- 表头表体分阶段上线。单工序汇报表头和表体建议先上线表头,跑一周确认口径,再带表体;别一次性把体也带进去,出问题排错非常痛苦。
适用场景与不适用场景
适用:离散制造的 MES→ERP 单工序汇报同步,数据量在日万行以内,需要幂等、可重跑、可追溯。不适用:多工序并行汇报、需要按工序拆分单据的场景,以及 MES 端本身就在频繁重写历史的库——后者建议先做源端停写,再谈同步。
本文为原创内容,转载请注明出处:https://www.qeasy.cloud/insights/solutions/strat-mysql-kingdee-cloud-2246-shd-c17f8ca8