配置连接和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