配置连接和服务路径

在金蝶K/3 WISE系统→EBDI→API说明→基础资料→部门,在接口列表栏目,选择获取列表,如图:

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

配置传参

在金蝶K/3 WISE系统→EBDI→API说明→基础资料→部门,在接口列表栏目,选择获取列表,查看请求参数说明。如图:

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

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

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

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

注意:Fields字段,根据说明书是显示字段,有时候不写也能正确返回数据,有时候不写不能正确返回数据,建议把参数都写上。

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

配置返回数据

在金蝶K/3 WISE系统→EBDI→API说明→基础资料→部门,在接口列表栏目,选择获取列表,查看返回参数示例,如图:

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

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

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

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

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

         获取部门API这里,我们需要把用到的返回参数改为仅首字母大写,然后重新映射,如图:

测试

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


注意:在这里我们发现一个问题,K3 WISE系统有多条数据,测试永远显示一条,经过调试,发现是K3 WISE API有BUG。

        在【金蝶K/3 WISE】专有的集成节点,我们集成时临时修复了一下,在【常规】模块勾选修复项即可,但是在通用的RESTful节点,不对特定系统的API修复,只能等K/3 WISE官方后续修复这个BUG。

        如果需要使用这个API,可以先用【金蝶K/3 WISE】专有的集成节点。这里仅演示RESTful集成形式的配置。


Created with the Personal Edition of HelpNDoc: Free iPhone documentation generator