API保存弹性域和多选基础资料,就这么简单!

在调用API接口时,你是否对弹性域和多选基础资料等特殊字段的保存无从下手?
单据中复杂类型的弹性域组合,怎样才可以方便快速地通过接口进行保存?
业务对象里的多选基础资料字段,又应该如何构造它的请求体参数?
现在,告诉你一个好消息,有了新版API(V2)的参数示例和在线测试,只需两步就能快速了解入参格式,并且支持实时调试接口。
接下来,小编为你详细解密!
1 适用版本
该功能适用版本为金蝶云·苍穹V5.0.002及以上。
2 特性展示
开放平台可通过零代码配置对外发布操作API,并自动构建数字、日期、文本、基础资料、下拉列表、弹性域、多选基础资料等类型字段的入参格式。
新版API(V2)优化了保存接口中参数示例和解析框架,参数更加扁平化,开发者维护请求参数后,在API参数示例、在线测试、API文档中均可看到参数示例。结合实际场景替换参数值,即可快速构造参数调用接口。
接下来为大家展示具体的接口示例。
01 保存凭证-弹性域应用
在金蝶云·苍穹表单中,弹性域是一种比较特殊的字段,主要用于总账凭证中的核算维度,配合主基础资料字段,将多个维度(基础资料、辅助资料、手工输入)的值组合在一起。
步骤一:创建API接口
以系统中的业务对象凭证为例,录入API基本信息及请求参数,其中字段“核算维度”为弹性域字段,通过点击按钮“添加属性”,可定义接口请求入参。

创建“保存凭证”API接口
点击请求参数上的“参数示例”,可以看到请求参数的示例数据。

参数示例界面
无需定义操作API的返回参数,确认入参字段后,点击“保存”按钮,即可完成接口创建。
注:目前弹性域字段中的维度暂时按名称(name)作为参数标识,后续会同时支持按编码(number)作为参数标识,敬请期待。
步骤二:在线调试
点击“API测试”按钮,进入在线调试界面,根据用户实际核算维度进行调整。此处以入参会计科目的核算维度为供应商(基础资料)和手工输入维度(其他类型)为例,如下图所示:

在线调试示例
接口执行成功后自动生成凭证,如下图所示:

自动生成凭证
注:若用户能确认具体的核算维度id,则以上信息均无需传入,系统直接按核算维度id保存,接口入参简约,执行时效率更高。
02 保存高等院校-多选基础资料字段应用
在金蝶云苍穹表单中,多选基础资料字段,用来选择并录入基础资料数据,可以同时选择多个资料放在一个字段中。此处,小编通过高等院校中的院校特性字段,教大家如何通过接口保存多选基础资料。
步骤一:创建API接口
以系统中的业务对象:高等院校为例,录入API基本信息及请
API保存弹性域和多选基础资料,就这么简单!
声明:除非特别标注,否则均为本站原创文章,转载时请以链接形式注明文章出处。如若本站内容侵犯了原著者的合法权益,可联系本站删除。



