2.管理对接字段说明

各种字段类型如何配置和

一、在金蝶云星空获取字段信息

在连接器的对接对象下,维护需要对接的字段时,相关字段的信息可通过以下方式获取:
在金蝶云星空(含早期K3 Cloud版本)web api查询界面
左侧栏找到对应的业务单据,点击
右侧上方操作列表选择保存
点字段说明查看具体的字段名称及对应的apiname,点击上方的 在线测试WebAPI ,弹窗填写账户信息后点击 验证接口,操作列表选择 保存,在测试数据框即会展示对应的数据格式(为方便查看可以将数据格式复制出来放置网页版json校验工具或者文本编辑软件中查看),对照字段说明通过字段名称查看的字段apiname查找。
以销售订单为例,将ERP销售订单拆分为主从中间对象,分别对主对象和从对象字段示例说明,左侧为ERP查看,右侧为在线测试WebAPI 保存 接口列表取出的数据在网页格式化后的展示效果:
示例:主对象字段编码/保存接口字段编码
注:此处需要加上FSaleOrderFinance,因为财务信息为子单据头;
示例:从对象字段编码/保存接口字段编码
特别说明:此处不需要加FSaleOrderEntry前缀,因为在ERP对象拆分中间对象时,明细编码已经填写了SAL_SaleOrder.FSaleOrderEntry,程序已有处理逻辑;
查看接口字段编码
在金蝶云星空(含早期K3 Cloud版本)web api查询界面,左侧栏找到对应的业务单据,点击,右侧上方操作列表选择保存,第五点字段说明查看具体的字段名称及对应的apiname,点击上方的 在线测试WebAPI ,弹窗填写账户信息后点击 验证接口,操作列表选择 查看,在测试数据框中 Number 字段添加单据编号,点击菜单栏的 接口验证 即可查看到该单据编号的订单查看接口返回的具体字段(为方便查看可以将数据格式复制出来放置网页版json校验工具或者notepad+工具中查看),对照字段说明通过字段名称查看的字段apiname查找。
以销售订单为例,将ERP销售订单拆分为主从中间对象,分别对主对象和从对象字段示例说明,左侧为ERP查看,右侧为在线测试WebAPI 查看 接口 详细结果框 取出的数据在网页格式化后的展示效果:
示例:主对象字段查看字段编码
特别说明:查看接口特别注意实际接口返回字段和字段说明的apiname不一样,例如单据编号字段(apiname:FBillNo)字段说明有F前缀,实际返回并没有,已接口实际返回为准!
对语言结构查看接口返回字段填写说明:
示例:从对象字段查看接口字段编码
特别说明:此处也不需要加SaleOrderEntry前缀;
保存接口字段编码:同上 字段编码 书写规则,不做赘述;
是否必填:根据实际选择;
字段类型:根据实际选择;

二、K3C对接字段类型说明

2.1 主键

每个ERP中间对象都必须要有主键字段,用来表示在集成平台中数据的唯一标识。目前主键字段有的设置为ERP编码比如客户、产品,有的设置为ERP内码id#单据编号比如销售订单主对象,有的设置为ERP内码id比如批次、序列号。ERP预置对象的主键字段不可轻易更改,如需更改请慎重
在数据维护中,第三方对象数据ID即是主键字段所表示的数据

2.2 查找关联

一个对象中某些字段需要关联到另外一个对象的对象数据,可以用查找关联字段进行配置。比如销售订单中的客户字段需要关联客户对象数据,则把该字段设置为查找关联-关联对象为客户
在集成流的字段映射中,查找关联字段只能与查找关联字段进行映射或者设置为固定值

2.3 主从关联

当ERP对象拆分为主从关系的中间对象时,从对象需设置虚拟主从字段来进行主从关联。虚拟主从字段的字段编码通常设置为【fake_master_detail】,关联对象设置所需要关联的主对象。比如销售订单拆分为主从关系的中间对象,从对象订单明细中设置了虚拟主从字段如下

2.4 单选

单选字段,跟平常在其他地方用到的单选并没有太大差别,单选字段需要配置选项编码和选项名称,如下
在集成流的字段映射中,单选字段需要把选项进行映射
当选项比较多时,如果两边选项名称基本一致,则可通过「子选项名字自动映射」操作快速映射

2.5 固定值

固定值就是该字段设置为一个固定不变的值,配置为固定值后,所有同步成功的数据该字段都为字段映射中设置的固定值。比如单据类型(编码)字段设置为固定值--XSDD01_SYS,那么设置后同步成功的数据,单据类型(编码)字段的值则为XSDD01_SYS
固定值在集成流的字段映射中配置,点击插入值后选择输入固定值,则可进行固定值设置

2.6 默认值

默认值就是如果映射的字段是没有填写或者没有获取到值,则设置为默认值。比如下图中「名称」与「岗位名称」字段映射,默认值设置为sk001,假设某条数据的名称字段没有填写,则同步成功后,在目标系统对应数据的版本号字段值为sk001

2.7 部门

CRM部门想要与ERP部门进行对接,需要建立部门字段进行映射
首先建立部门数据的映射。部门字段数据映射是在对应连接器-「系统字段」管理下
在部门数据映射中,可通过新建或者导入把CRM的部门与ERP的部门进行映射
其中CRM基础数据ID和CRM基础数据名称可参照下图获取
其中ERP基础数据ID填写ERP部门的编码,ERP基础数据名称填写ERP部门名称
后面在集成流的字段映射中,把部门字段进行映射即可

2.8 员工

1.人员字段,有两种对接方式,一种是销售员编码,一种是员工ID,通常情况下选择销售员编码,如果是需要在数据维护中显示员工ID则使用员工ID对接
2.首先在数据同步设置-账户绑定中把人员进行绑定。K3C推荐使用【同步ERP职员账户】来同步ERP侧人员,同步ERP侧人员时会根据ERP职员的手机号自动匹配CRM员工账号,如果未能匹配则点击 操作列的【编辑】,手工绑定CRM员工账号
3.人员绑定后,在集成流把人员字段进行映射,如下图
4.如果同一人员在K3C不同部门有不同的销售员编码,又需要进行销售员对接,则还需在ERP中间对象里面添加一个字段编码为【ERP_Dept】的字段并进行字段映射配置
首先添加字段,字段编码为【ERP_Dept】,字段名称任意,字段类型为单选,选项编码和选项名称均填写部门名称
在集成流中添加该字段的映射,在CRM建立单选字段与之映射即可
2024-06-03
3 1