一:云星辰配置
1.背景说明
之前金蝶云星辰(精斗云)插件的对接,是固定字段,固定的同步方向进行数据同步。现在集成平台接入云星辰对接,依赖集成平台本身强大的对接能力,能够满足客户自定义对象或者字段的对接需求。
下面将详细介绍怎么通过集成平台对接金蝶云星辰。
2.金蝶云星辰api授权
集成平台是通过调用云星辰api的相关接口,实现数据的拉取跟同步。金蝶侧要求调用api的时候,需要用户购买api的相关授权。
配置api授权的相关文档请参考:云星辰插件说明
3.集成平台的配置
(1)金蝶api授权
完成金蝶api授权后,可以在金蝶获取到应用id(ClientId),应用Secret(clientSecret),第三方实例ID,appkey.相关的获取截图请参考
(2)购买纷享销客【集成平台-金蝶云·星辰连接器】
(3)初始化连接器
进入纷享销客-管理后台-集成平台管理-连接器 点击此菜单,平台会自动初始化金蝶云星辰连接器。平台会内置相关的云星辰需要对接的对象,对象字段以及相关的集成流
(4)配置连接账套信息
点击上面创建的【云星辰】连接器,进入配置页面
点击【系统自动创建函数】,默认会生成自定义函数与金蝶进行api调用,(此函数不能更改名字,不可以替换其他函数),默认函数名:JDYManagerErpAPL__c
将上面的应用ID,应用secret,第三方实例ID,APPkey都填写在上方配置参数。
(5)配置函数
打开函数,根据注释填写对应的应用信息,进行保存。
(6)集成平台常见的概念描述
为了更好的理解集成平台版云星辰对接,请学习该文档,了解常用的术语以及操作:
(7)云星辰的单据对象以及字段管理
平台预置的相关对象
平台预置的相关字段
平台预置的集成流,默认都是停用状态。启用才会进行同步
具体操作请参考【云星辰二次开发】
4.集成平台数据同步说明
(1)crm-> erp
启用相关的集成流,比如:想进行客户crm-云星辰的同步
点击右侧操作按钮,进行启用
当crm有新增或者修改数据的时候,集成平台会通过上面配置的集成流进行数据同步。具体同步规则以及配置可以参考:
https://help.fxiaoke.com/9bfb/c4ff/bde5
(2)erp-> crm
集成平台会通过函数调用云星辰的批量查询或者单条获取的接口。
集成平台会根据这里配置的轮询规则,按照指定的时间频次去调用金蝶api。返回相关的数据进行同步(这里只会监听当前时间范围内的数据变更,不包括删除)。
二:云星辰二次开发
(1)怎么在已有的集成流,添加或者删除对接的字段
以【客户】为例,想在原有字段的基础上,增加对接需要的字段 字段的参考,需要按照金蝶的开放文档进行配置: 在api文档,找到对应的单据详情接口返回值,字段的参考,需要按照金蝶的开放文档进行配置:
打开集成平台管理-连接器-选择云星辰-连接对象。找到需要设置的对象,点击【编辑字段】
(2)怎么对接非预置的单据
1.打开 云星辰开发文档 ,找到需要对接的单据编码
比如:需要增加【预收退款单】对接,找到对应的编码,ar_precreditretbill
有些单据是需要对接主从的,从对象取参数名称,例如:source_bill_entry_list,pay_entry_list
2.在集成平台管理-选择云星辰连接器-连接对象 ,点击新建
将上面的对象名称以及编码,按照下面的格式填进。进行保存。
点击添加字段,按照上面的金蝶的文档,选择需要对接的字段。注意,主对象跟明细都需要设置[主键字段],一般选择id.
从对象需要配置主从字段,默认都是【vir_master_id】,关联的对象选择主对象。涉及到关联销售订单的,默认
3.需要在代码里面,添加对象的请求apiurl.
JDY_OBJ_URL_MAPPING是一个map,以云星辰的apiname作为key,
字段名 | 字段描述 | 是否必填 |
jdyObjectApiName | 云星辰的单据编码 | true |
queryDetailUrl | 查询详情的地址 | true |
queryListUrl | 查询列表的地址 | true |
createUrl | 创建(更新)数据的地址 | true |
detailObjApiName | 该单据的从对象编码(假设有从对象) | false |
complexIdKey | 复合ID的key(有些对象的想以编码+id作为主键) | false |
三:使用云星辰(精斗云)插件的客户,怎么迁移到集成平台-云星辰
提工单给集成平台值班的同学,后台处理迁移。迁移后,crm/erp数据不会在旧插件同步。旧插件的对象数据会同步到集成平台的中间表,不包括(产品分类,产品单位,职员数据)
四:常见问题
1.函数预设的字段解析:
UP_QUERY_SALES_ORDER_FIELD
上查源单为销售订单的类型,作用于销售订单下推的相关的数据,想上查到对应的销售订单。同样也是一个map。key是下推的单据编码,value是源单的key
代码已经预置了出库单sal_bill_outbound,ar_creditbill收款单的上查销售订单的key.其他单据添加时,参考该key_value配置
2.平台不支持的功能
暂时不支持删除数据同步。