计量单位修改同步：MES 与业务系统的基础资料一致性方案
这个策略解决什么问题（场景与价值，150 字内）
某制造企业将计量单位作为物料、配方和生产领料的基础资料。业务系统中的单位发生修改后，MES 若仍保留旧数据，可能造成单位名称、编码或换算关系不一致。我们在轻易云数据集成平台中承接收取—转换—更新链路，并借助 Qeasy 的调度与异常处理能力，确保基础资料按既定规则同步到目标系统。
数据流向与字段映射（源 → 中间层 → 目标，关键字段对照表）
本策略是单向更新：源系统提供计量单位资料，轻易云数据集成平台负责分页读取、字段整理和请求组装，目标系统接收更新参数。由于策略聚焦修改，源端先按唯一标识定位已有单位，再调用目标端的更新能力。
| 业务含义 | 源系统字段 | 目标系统字段 | 配置说明 |
|---|---|---|---|
| 计量单位流水 | FUNITID | unitUuid | 用作定位和更新依据，不按名称反查 |
| 单位编码 | FNumber | unitNo | 保持编码规则一致；必要时集中维护映射 |
| 单位名称 | FName | unitName | 更新名称，避免只改编码不更新名称 |
| 公司范围 | 按业务上下文配置 | companyCode | 应从受控配置或上下文传入，不把示例值写死 |
| 基准单位流水 | 暂无统一来源 | basicUnitUuid | 明确默认值、必填性和已有关系处理方式 |
| 换算系数 | 素材未完整展示 | coefficient | 先确认源端与目标端取值口径，不能凭字段名直接映射 |
| 禁用状态 | FForbidStatus | 按目标接口能力映射 | 若目标端无对应字段，应在中间层转换为是否允许更新 |
中间层应至少完成三项处理：分页结果合并、唯一键校验和目标请求参数组装。这里的关键不是“字段能对上”，而是每一字段都具备来源、更新语义和异常处置方式。
在轻易云上如何配置（给出典型配置要点，可读性好）
先配置源连接器，查询计量单位资料。接口以 POST 方式请求，分页参数 Limit 由平台变量 {{PAGINATION_PAGE_SIZE}} 注入；输出字段包括 FNumber、FName、FForbidStatus 和 FUNITID。不要把页容量写成一个脱离运行环境的固定值，应结合数据量和接口限制配置。
再配置目标连接器，调用计量单位更新能力。unitUuid 映射 FUNITID，unitNo 映射 FNumber，unitName 映射 FName。公司代码应从受控业务上下文获取，不能照搬素材中的示例值。basicUnitUuid 与 coefficient 的完整来源在现有素材中未展示，实施前必须由接口定义和项目数据模型确认，不能猜测后直接上线。
在转换规则中，建议集中管理字段类型、编码映射与状态转换。如果项目存在历史单位或非标准编码，可由轻易云数据集成平台的映射表统一处理。典型错误是直接以单位名称或编码作为更新主键；稳妥做法是优先使用稳定流水号，并保留“流水号优先、编码兜底”的双路径校验，但兜底路径必须先验证唯一性。
最后配置结果处理：成功更新进入完成状态；目标端找不到单位时单独记录；参数不完整或映射不明确时阻断写入，而不是生成无法解释的请求。私有化环境下，还要确认 Qeasy 调度服务、网络连通、日志脱敏和失败重试策略。
实施步骤（分阶段调度：增量起点 / 全量触发 / 调度频率）
第一步建立基线。人工选取少量计量单位，核对编码、名称、状态及单位关系，形成可追溯的测试集。优先验证更新，不建议用新建设备随意触发创建类行为。
第二步执行首轮全量。按分页读取源数据，轻易云逐条定位目标记录并更新。首轮应设置限速或较小批次，便于观察接口返回、分页边界和状态判断。全量触发适合项目上线、数据修复或策略调整后的重新对齐。
第三步切换增量。增量起点应明确为首轮全量成功完成的时间点，或使用源系统可支持的变更条件；若源端没有可靠增量信号，只能采用“增量与全量双轨”模式：按计划运行增量，并定期执行全量校准。全量不能被当作普通批次的简单放大，而应设置独立入口、独立批次和独立告警。
第四步配置调度。素材中的计划为 * 7-22 * * *，表示在业务时段内按分钟调度。实际项目可先缩小窗口，确认稳定后再恢复；需要处理停机窗口时，应避开跨日边界，并明确错过计划后的补跑方式。平台应保留上次成功位置、失败重试和人工补偿入口。
第五步做对账验收。每日检查读取量、成功量、失败量、未匹配量和目标拒绝量；随机抽取已修改单位，确认两边编码、名称、状态及换算关系一致。测试全部通过后再从“仅验证”切换为“持续同步”。
踩坑复盘（3-5 条实战经验）
- 只同步新增，不处理修改。 基础资料问题通常不是“没有数据”，而是修改后没有抵达。策略必须明确更新主键和更新接口，避免把修改误做成新增。
- 依赖分页参数但忽略边界。 最后一页可能少于设定行数，也可能因数据变化出现重复。这里容易翻车，稳妥做法是使用平台分页机制并校验标识唯一性。
- 字段非必填等于可以不传。 源端字段非必填，不代表目标端可任意缺省。
basicUnitUuid、coefficient等字段必须确认更新语义，否则接口可能部分成功或形成静默错误。 - 把示例值固化到生产。 素材中的公司代码和单位流水仅用于说明结构。生产配置必须由受控上下文或映射表提供，并纳入密钥与敏感信息管理。
- 全量校准与日常任务混在一起。 某制造企业现场常见做法是启用“增量与全量双轨”：日常增量保障时效，定期全量修复遗漏；两者分阶段配置，失败日志也分开统计，问题定位会更清楚。
适用场景与不适用场景（150 字内，讲清边界）
适用于计量单位编码、名称、状态或换算关系需要跨系统持续一致，且目标端已提供按稳定标识更新的场景。适合私有化环境中的基础资料同步、周期性校准和局部修复。若源端没有变更信号、目标端不支持定位更新，或计量单位关系复杂且字段来源未确认，不宜直接启用；应先完成接口核验和试运行。