用脚本开发API,快到不敢想象!

您在使用API功能时,是否被以下问题困扰:
如何同时调用多个API?
如何对某个API的返回值做二次处理得到想要的返回值?
现在,帮你甩掉困扰的好帮手来了!
金蝶云·苍穹V5.0开放平台重磅推出 “自定义API-脚本开发”功能,该功能可以在维护API时,将多个API组合生成新的API,还可以对出入参进行逻辑处理,却只需对外提供一个API。这么方便的功能还不快快学习起来!
1 适用版本
该功能适用版本为金蝶云·苍穹V5.0.002及以上。
2 特性展示
说了这么多,大家一定好奇这个新功能具体如何使用,它到底难不难~
莫慌!下面,我们用一个例子来带领大家快速入门。
“自定义API-脚本开发”功能入口:【开发服务云】→【开放平台】→【API管理】→点击“新增”按钮→选择【自定义API-脚本开发】,如下图所示:

2.1 案例场景
通过脚本开发API,实现基础资料的保存、提交、审核。
2.2 操作步骤
1. 准备接口
除了第一个脚本API主入口,还需要准备基础资料保存、提交、审核的三个操作接口,如下图所示:

2. 基础资料保存(demo__save)
此处以基础资料demo5为例,介绍保存操作接口的配置方法:通过开放平台“零代码配置”方式配置该实体的保存接口,主要维护请求体参数,将需要存储数据的字段维护好,此处用简单的基础资料编码、名称作为参数。

配置完成并保存后可以直接点击“API测试”按钮测试接口是否调通,若显示“successCount = 1”, 证明有一天数据存储成功了。

3. 基础资料提交(demo_submit)
同理,以相同的方式配置该基础资料的提交接口,只需在操作方式中选择“提交”,配置相应的请求体即可。


4. 基础资料审核(demo_audit)
接着,配置第三个操作接口:基础资料的审核操作接口,配置方法与提交操作的完全一致,只需要修改操作方式为“审核”。


5. 脚本开发API
最后,配置脚本服务,具体步骤如下:
1)配置基本信息
填写基本信息,注意请求方式必须为“POST”。

2)定义请求参数
定义API请求参数,用基础资料保存API的入参作为该API的入参。

3)维护引用资源
由于脚本编写依赖别名,需先维护引用资源,否则无法写脚本。

4)编写API脚本
在页面的API脚本代码编辑器中输入对应处理接口调用的业务逻辑。
整体逻辑:首先,根据传入data保存数据,然后脚本调用提交接口,最后调用审核接口。
“保存”操作接口脚本如下:

“提交”操作接口脚本如下:

“审核”操作接口脚本如下:

完整脚本如下:
result = {}; // 初始化api 结果
// 保存
var saveData = {"data": data}; // 单据保存 参数
var saveResult = demo_save_api(saveData); // 调用单据保存api
if(! saveResult?.status) { // 保存结果验证
throw "保存失败"; // 保存失败抛出异常
}
result.saveResult = saveResult.data.result; // 将保存结果赋值给api结果
// 获取保存单据的id
var id = saveResult.data.result[0].id;
id = L(id);
// 查询保存单据的编码
var sql = "select fnumber from t_isc_demo_basedata_5 where fid = ?";
var numberMap = DB.queryOne("iscb", sql, [id]);
if(! numberMap?.fnumber) {
throw "查询单据编码失败"
}
var number = numberMap.fnumber;
// 提交
var submitData = {
"data":{
"number":number
}
};
var submitResult = dem用脚本开发API,快到不敢想象!
声明:除非特别标注,否则均为本站原创文章,转载时请以链接形式注明文章出处。如若本站内容侵犯了原著者的合法权益,可联系本站删除。



