获取部门列表
配置连接和API
在金蝶K/3 WISE系统→EBDI→API说明→基础资料→部门,在接口列表栏目,选择获取列表,如图:
在【常规】配置界面,填写API,选择请求类型,如图:
配置传参
在金蝶K/3 WISE系统→EBDI→API说明→基础资料→部门,在接口列表栏目,选择获取列表,查看请求参数说明。如图:
默认会列出常用参数,若需要修改参数,右键编辑即可,如图:
以拖拽的方式,把左侧分页参数,start、limit和查询参数param依次映射到右侧对应的参数。
由于K3 WISE接口返回的分页方式与ESB分页方式不同,所以要转换一下:PageIndex: Paging.start/Paging.limit+1。详情参考:公共知识
注意看说明书,查询参数这里写法比较特殊,并且我们只用到了FName(部门名称),可以把没用到的参数删掉,并且把参数名称改的友好一些,如图:
注意:Fields字段,根据说明书是显示字段,有时候不写也能正确返回数据,有时候不写不能正确返回数据,建议写上。
配置返回数据
在金蝶K/3 WISE系统→EBDI→API说明→基础资料→部门,在接口列表栏目,选择获取列表,查看返回参数示例,如图:
我们需要返回具体的字段,我们看到返回示例DATA为null,没有列出具体字段,这时我们需要手动加我们需要的字段,在金蝶K/3 WISE系统→EBDI→API说明→基础资料→部门,在接口列表栏目,选择获取模版,查看字段说明,如图:
作为数据源,这里我们用到的字段有FNumber部门编码、FName部门名称(显示用)和RowCount总行数(分页用),修改右侧参数的显示名称并删掉用不到的参数,然后把左侧用到的返回参数和右侧的Response返回参数以拖拽的方式依次映射,如图:
注意:经过测试,发现K3 WISE官方API说明书提供的返回参数有误,有时候返回参数全是大写,正常配置出不来,需要改为仅首字母大写才可以。所有BPM系统默认返回有两套参数,先按照说明书的大写配置,如果配置不成功,尝试使用仅首字母那一套。
测试
到这里,获取部门数据就配好了,保存为:K3 WISE-部门列表,点击测试,获取数据,如图:
在这里我们发现一个问题,K3 WISE系统有多条数据,测试永远显示一条,经过调试,发现是K3 WISE API有问题,我们集成时临时修复了一下,在【常规】模块勾选修复项,如图:
保存,再次点击测试,成功获取数据,如图:
Created with the Personal Edition of HelpNDoc: Free Web Help generator