KingswaySoft数据迁移时如何在upsert中手动指定字段GUID/名称

结论 #

可以在KingswaySoft的Upsert操作中手动指定目标字段的GUID或匹配名称，这是处理跨系统GUID不匹配场景的常规实现方案。

实现方法 #

方案1：硬编码指定GUID（适合单固定值场景） #

• 在数据流任务中删除该字段原有的自动映射关系
• 新增一个派生列，值设置为云系统侧该字段的正确GUID字符串，把新的派生列映射到目标对应字段即可
• 注意：确保填入的GUID符合32位带分隔符的标准格式，避免触发目标系统的格式校验报错

方案2：通过名称自动匹配GUID（适合多值查找类字段场景） #

• 如果是选项集、关联实体Lookup等类型的字段，可以直接使用目标写入组件自带的文本匹配功能，不需要额外硬编码
• 以Dynamics 365/CDS目标组件为例，直接在对应字段的映射属性中选择Match by name选项，组件会自动根据传入的字段名称拉取云系统中对应记录的GUID完成写入
• 多值匹配场景也可以搭配Lookup Transformation组件提前完成名称到GUID的转换，再映射到目标字段

注意事项 #

• Upsert执行前建议先开启组件的错误输出重定向功能，单独捕获匹配失败的记录做校验，避免全量导入出错
• 如果该字段是目标系统的主键类字段，需要先确认云系统侧已放开该字段的手动写入权限，否则指定的GUID会被系统自动覆盖或直接返回写入错误
• 建议先跑1-2条测试数据验证配置逻辑正确后，再执行全量迁移任务，避免无效脏数据写入云系统

内容的提问来源于stack exchange，提问作者SteveWWH