云星空(企业版)连接器配置指引
配置金蝶云星空(企业版)与纷享销客 CRM 之间的数据同步。
概述
本文适用于纷享销客 CRM 与金蝶云星空(企业版)的集成。可实现云星空对象数据同步到 CRM 对象,或将 CRM 对象数据同步到云星空对象。。适用对象:实施顾问、技术顾问、销售经理、CSM 等。
开始之前
[!IMPORTANT]
- 前置条件:客户已下单开通集成平台产品,并联系值班开发配置系统集成平台菜单
第一步:金蝶云星空(企业版)配置
进入云星空,配置连接账号权限,确保该账号具备对接单据的增删查改权限。
第二步:连接授权
进入 管理后台 > 系统集成平台 > 授权配置 菜单,点击右上角 新建连接授权。连接器选择 K3 Cloud 连接器,新建后按提示填写账号授权。。确认无误后,点击 连接授权 即完成云星空的连接。
第三步:配置中间表
目前系统集成平台数据映射关系存储到自定义对象。在配置集成流前,先创建自定义对象。创建时把主属性配置为自增编号,其余按默认即可,保存新建。。
进入 系统集成平台 > 工具 > 数据存储,点击修改符号,在弹窗中选择刚创建的自定义对象进行绑定。。确认后,平台会自动在所选自定义对象中添加 5 个字段。字段名称为:映射数据分组、映射数据 ID1、主属性 1、映射数据 ID2、主属性 2。。
[!WARNING]
修改数据存储绑定的自定义对象时,已存在的数据映射不会自动迁移,需要手动先导出再导入新绑定的自定义对象迁移数据。数据映射关系是同步的关键信息,为避免数据被误改,强烈建议配置该对象仅管理员角色可见。
集成流编排配置中间表节点
数据同步完成后需要保存数据映射关系。可在集成流末尾配置「创建映射动作」节点。。映射节点可以配置多组,可以通过映射数量的值控制写入多少组映射。每组映射,根据映射数据分类、映射数据 ID1、映射数据 ID2 三个数据确定唯一的一个映射关系。
与云星空集成时受对方接口特性约束:查询数据需传数据编码,更新数据则需传数据 ID。因此建议每组数据映射同时保存 ID 和编码的映射关系,以便按需使用。。
[!TIP]
如果是明细的数据映射关系,需要使用pluck公式循环写映射关系。因为明细为数组结构,里面有多条明细,需要遍历执行映射写入。
第四步:配置集成流
数据创建和更新是否拆分说明
系统集成平台对外部系统动作做了拆分。用户可按需自行配置新增或更新,两者配置相互独立。。对于高频对接的云星空和 CRM 系统,连接器也支持合并动作配置。CRM 的新建/更新动作合一,云星空的保存/提交/审核动作合一。但需在节点的配置步骤里配置 ID 查询公式;若为主从结构,则需分别配置。。同步时,会根据查询结果判断是走新增接口还是走更新接口。
集成流配置示例
集成流配置示例覆盖组织、物料分组、物料、多单位、客户、联系人和订单等对象的同步配置。。
第五步:数据同步及历史数据核对
集成流配置完成并发布后,可在列表点击 立即同步 触发数据同步,验证配置是否正确。。
集成流验证无误后,拉取历史数据时,可以在 工具 > 历史数据同步 创建同步任务。
任务开始执行后,可进入 读取日志 查看执行情况。日志包含历史任务读取基本信息、接口读取速度、异常接口等信息。。用户可以下载异常接口的信息,按数据核对指引排查缺漏数据。
[!NOTE]
读取日志仅记录任务读取接口的情况。数据读取后会在 运行监控 > Trigger 日志 记录,并在 Trigger 数据快照记录每条数据快照。相同数据将不再触发集成流同步。
预期结果与验证
完成配置并启用集成流后,金蝶云星空(企业版)与纷享销客 CRM 之间按配置同步数据。
验证方法:
- 在列表点击 立即同步 触发一次数据同步。
- 进入 读取日志 查看任务执行情况。
- 在 CRM 对应对象中确认数据已正确写入或更新。