金蝶云星空客户资料变更回写 WMS：基于轻易云的增量同步实战
这个策略解决什么问题
在零售或分销场景里，金蝶云星空通常是客户主数据的「权威源」，而下游 WMS 需要这份资料来判定收货方、参与合单等行为。我们做过的项目里，「云星空-WM 客户资料修改」这条策略专门处理已存在且发生修改的客户的回写：源端用 executeBillQuery 按修改时间窗增量拉取，目标端用 UPDATE 把变更落到 base_customer。本质上是为下游仓储环节提供一份「一直在变、但从不漏」的客户档案。
数据流向与字段映射
数据流向为：金蝶云星空（BD_Customer）→ 轻易云数据集成平台中间层 → MySQL（WMS base_customer）。主键/业务键统一用客户编码 FNumber ↔ customerCode，保持一一对应。
| 目标字段 | 源字段 | 映射类型 | 说明 |
|---|---|---|---|
| customerCode | FNumber | DIRECT | 客户编码，作为 UPDATE 的 WHERE 定位 |
| customerName | FName | DIRECT | 客户名称 |
| isPartakeMerge | FIsTrade | TRANSFORM | 是否参与合单；需做布尔/数值转换 |
其余源端字段（创建组织、使用组织、简称、地址、电话、销售员等）本策略不映射，留给其他策略按需消费，避免单点膨胀。
在轻易云上如何配置
我们在客户现场通常按三步落地：
- 新建源端方案：选金蝶云星空，接口
executeBillQuery，请求体里勾选FNumber / FName / FIsTrade / FUseOrgId.FNumber / FModifyDate等字段。 - 新建目标端方案：选 MySQL，接口
execute，把 UPDATE 语句配到main_sql，参数对象main_params承载{customerCode, customerName, isPartakeMerge}。 - 在策略编辑器里串起来：做字段映射，
isPartakeMerge用_function表达式把true/false归一成1/0，比如case when {{FIsTrade}}=true then '1' else '0' end。
轻易云客户常见的两种应对模式在这里都用得上：一是编码映射集中管理——本策略客户编码是直接映射，跨方案不查表；如果以后引入客户类别、客户分组的转换，建议放到统一的编码映射集里，避免散落在 N 个策略里；二是表头表体分阶段——本策略只回写客户「表头」级别的三个字段，地址、电话这类表体扩展项另起策略，便于排障时按字段域切片。
实施步骤
分阶段调度是这条策略的关键：
- 增量起点：源端
FilterString写FModifyDate>='{{MINUTE_AGO_30|datetime}}'，配合FUseOrgId.FNumber='100'与FFORBIDSTATUS='A'两个静态条件，把"最近 30 分钟内、属于指定组织、且启用的客户"圈出来。 - 全量触发：首次上线时关掉过滤跑一次历史，把 WMS 里已有客户补齐；之后切回增量。
- 调度频率：源端
7-59/20 * * * *（每 20 分钟一档、避开整点），目标端*/2 * * * *（每 2 分钟）。源端粗、目标端细，是轻易云里典型的源慢目标快的双轨模式——拉数据慢、消化回写快，能有效削峰。
目标端 SQL 的边界也要写死在语句里：where shipperId='...' and customerCode not in (...)，确保只动指定货主、且排除历史遗留的特殊客户编码。
踩坑复盘
- 修改时间字段被忽略。典型错误是只过滤创建时间，结果老客户永远同步不下来。稳妥做法是在源端
FilterString里显式用FModifyDate，并用MINUTE_AGO_30这种相对时间宏，避免跨天时区坑。 FIsTrade类型飘忽。金蝶某些环境返回true/false，某些返回'1'/'0'，直接 DIRECT 会在目标端写出非法值。建议一律走_function表达式归一，轻易云这边把转换规则集中维护。- 货主 / 排除条件写在应用层。一次实际项目中，工程师把
shipperId过滤放在中间层 Java 代码里，导致多货主场景漏写。稳妥的做法是把货主与排除编码直接写进目标 SQL 的 WHERE，跟应用层解耦，迁移数据库也不丢约束。 - 调度频率错配。源端 2 分钟一次会把金蝶打爆，目标端 20 分钟一次又会丢时效。按"源粗目标细"配，是轻易云上跑过最稳的组合。
- 禁用状态同步进了 WMS。忘了
FFORBIDSTATUS='A'，把已停用的客户也回写，导致 WMS 给停用客户分配了发货单。
适用场景与不适用场景
适用：单一组织或少数组织、启用状态清晰、客户档案以金蝶为权威源、且只需要回写"是否参与合单 + 名称"这种轻量字段的场景。
不适用：需要回写地址、电话、银行信息等表体扩展项的（应另起策略）；客户主数据新建场景（应走"客户新增"策略，走 INSERT 而不是 UPDATE）；多组织共享且组织维度频繁变动的场景（本策略只按 FUseOrgId.FNumber 静态过滤，多组织需重构）。