配置连接和服务路径

在金蝶K/3 WISE系统→EBDI→API说明→供应链→供应商档案,在接口列表栏目,选择获取列表,如图:

在【常规】配置界面,填写服务路径,选择请求类型,如图:

配置传参

在金蝶K/3 WISE系统→EBDI→API说明→供应链→供应商档案,在接口列表栏目,选择获取列表,查看请求参数说明。如图:

在调用界面,以导入架构的方式,导入请求参数,如图:

以拖拽的方式,把左侧分页参数,start、limit和查询参数param依次映射到右侧对应的参数,如图:

由于K3 WISE接口返回的分页方式与ESB分页方式不同,所以要转换一下:PageIndex: Paging.start/Paging.limit+1。详情参考:公共知识

注意看说明书,查询参数这里写法比较特殊,并且我们只用到了FName(供应商名称),可以把没用到的参数删掉,并且把参数名称改的友好一些,如图:

注意:

1、Fields字段,根据说明书是显示字段,有时候不写也能正确返回数据,有时候不写不能正确返回数据,建议写上。

2、SelectPage字段,根据说明书是标体索引,有时候不写也能正确返回数据,有时候不写会报错,建议写上。

根据说明书,url地址需要Token这个参数,我们在连接里已经获取,这里在QueryParams上右键编辑,添加token参数,并把左侧token映射到添加的参数上,如图:

配置返回数据

在金蝶K/3 WISE系统→EBDI→API说明→供应链→供应商档案,在接口列表栏目,选择获取列表,查看返回参数示例,如图:

以导入架构的方式,导入返回参数,如图:

我们需要返回具体的字段,我们看到返回示例DATA为null,没有列出具体字段,这时我们需要手动加我们需要的字段,在金蝶K/3 WISE系统→EBDI→API说明→供应链→供应商档案,在接口列表栏目,选择获取模版,查看字段说明,如图:

作为数据源,这里我们用到的字段有FNumber供应商编码、FName供应商名称,在DATA上右键编辑,添加字段,如图:

修改右侧参数的显示名称并删掉用不到的参数,然后把左侧用到的返回参数和右侧的Response返回参数以拖拽的方式依次映射,如图:

注意:经过测试,发现K3  WISE官方API说明书提供的返回参数有误,虽然说明书返回参数全是大写,正常配置却出不来数据,需要改为仅首字母大写才可以。所以,先按照说明书的大写配置,如果配置不成功,尝试把用到的返回参数改为仅首字母大写。

测试

到这里,获取供应商数据就配好了,保存为:RESTful-K3 WISE供应商列表,点击测试,获取数据,如图:


Created with the Personal Edition of HelpNDoc: Create help files for the Qt Help Framework