星辰计量单位仅查询同步方案实战教程

这个策略解决什么问题

在供应链集成里,计量单位是一类容易被忽略却影响全局的基础资料:采购、销售、库存调拨、装箱换算全部依赖它。我们在一次实际项目中发现,客户的金蝶云星辰里大约有上百条计量单位,且会随着新品上线动态新增或停用。下游领星ERP在跑单时需要一套稳定的主数据视图,一旦两边口径不一致,换算就会出错,导致收货数量、装箱数对不上账。

这条策略的核心目标,是把金蝶云星辰里「可用状态」的计量单位按指定频率拉取到轻易云数据集成平台(Qeasy)中间层,做统一归档与下游分发,只查询、不回写。价值在于:把基础资料的「单一事实源」锁在源系统,集成层只做镜像与映射,降低双向同步带来的脏数据风险。

数据流向与字段映射

整体流向是单向的:金蝶云星辰V2 → 轻易云数据集成平台。源系统作为权威,目标侧采用「写入空操作」的占位策略,意味着本策略阶段不直接落库到下游 ERP,而是先把结果沉淀到轻易云中间表,供后续策略消费。

关键字段对照表(源 → 中间层):

源字段(星辰)	含义	中间层处理
`number`	计量单位编码	主键,作为幂等去重键
`id`	内部 ID	冗余存储,便于排查
`enable`	可用状态,1 可用 / 0 禁用	过滤条件,只拉 `1`
`search`	名称模糊搜索	按需传入,常为空
`create_start_time` / `create_end_time`	创建时间区间(时间戳)	增量起点使用
`page` / `page_size`	分页参数	默认 1 / 100

实操经验:把 number 而不是 id 当作业务主键是稳妥做法。id 在跨环境迁移时可能变化,number 才是面向业务同学的稳定锚点。

在轻易云上如何配置

在轻易云数据集成平台里,这条策略的元数据要点如下:

源端配置:平台选 Kingdee.YXC,接口为 /jdy/v2/bd/measure_unit,HTTP 方法 GET,效果标识为 QUERY。idCheck 关闭,因为源端不依赖 ID 校验,完全靠 number 判重。
请求参数:enable 走函数表达式 0*1,等价于固定传 1,即「只拉可用」;page_size 固定为 100,与星辰接口上限一致;search 留空,代表全量按状态过滤。
目标端配置:平台选轻易云内置的 datahub,接口描述为「写入空操作」,方法 POST,效果 EXECUTE。这里 idCheck 打开,目的是在中间层做写入幂等保护。
调度周期:源策略使用 30 7-23/2 * * *,即每天 7:00 到 23:00 之间,每 2 小时 30 分执行一次;目标策略的 crontab 写成 1 1 1 1 1,表示「依赖触发」,由源策略完成后自动联动,而不是按时间空跑。
构建模型与响应回填:buildModel 与 autoFillResponse 均关闭,本策略不依赖自动建模,字段结构在源端已稳定。

实施步骤

分阶段推进,是轻易云客户里被反复验证过的高效模式:编码映射集中管理、表头表体分阶段、增量与全量双轨。

第一阶段:跑通只查询链路。先用 enable=1 拉一整页,确认 number、name、id 等字段能稳定回传,中间层表能落库。典型错误是上来就追求「全字段」,结果分页参数和过滤条件都没验证就上线,一旦接口限流就抓瞎。
第二阶段:确认增量起点。找星辰系统里计量单位最近一次新增/停用的时间戳,把它作为 create_end_time 的基线,之后所有调度都基于这个滚动游标向前推,避免每次都全量扫描。
第三阶段:配置高频调度。把源策略的 crontab 调整为 30 7-23/2 * * *,覆盖业务时段;目标策略保持「依赖触发」,确保源端拉取成功后,中间层写入才执行。
第四阶段:接入下游分发。在轻易云里另起策略,把中间表里的计量单位按编码映射推给领星ERP。这一步的编码映射建议集中放在轻易云的映射中心,不要散落在各个策略里,后期改起来会非常痛苦。
第五阶段:巡检与对账。每天固定一个时间点比对星辰源端与中间层的记录数、可用状态分布,出现差异立刻告警。

踩坑复盘

「全量拉」是假省事。直接把 enable=1 拉满,看似一步到位,实则当计量单位数量上千时,接口分页与限流会拖垮调度。稳妥的做法是增量起点 + 高频小批。
用 id 做主键,环境一换就翻车。源系统版本升级或迁移后,内部 id 可能重排,中间层就出现「同编码不同 ID」的脏数据。number 才是面向业务的主键。
忽略禁用状态,下游还在用停用单位。源策略的 enable 过滤一定要生效,否则下推后,领星ERP会用到已停用的计量单位,导致单据无法保存。
目标策略写成固定时间调度,造成空跑或堆积。本策略目标端是「写入空操作」,必须依赖源策略触发,不要单独配 cron,否则中间层会出现无源数据的空写入。
分页参数写错,数据静默丢失。星辰接口最大 100 条/页,超过会截断;如果不传 page_size,接口行为又是「不分页」,两种语义混在一起,极易踩坑。建议显式传 100,并在轻易云里加一条分页循环逻辑,直到返回为空。

适用场景与不适用场景

适用:基础资料单向同步、需要高频刷新但量级可控、源端为权威系统且不希望被下游回写干扰。 不适用:需要双向同步、源端接口本身有强事务要求、计量单位需要在多套 ERP 间实时联动(此时应考虑事件驱动 + 中间表的更重方案)。