勤哲类服务器(勤哲Excel服务器2022版重磅功能WebApi)
勤哲Excel服务器以前版本只能通过外部数据源功能从其中系统里取数据,但是现在很多软件平台都是云端部署的,不允许通过底层数据库读取数据,造成外部数据功能的使用范围越来越小。勤哲Exexel服务器2022版增加了webapi接口,从而可以通过api接口调取第三方系统的数据,实现软件数据的互联互通。下面我们就看一下勤哲webapi功能的详细情况吧!
1、 应用场景
1)在Excel服务器中,对表单的新建、修改、删除后,可以把表单数据同步到第三方系统中。
2)可以提取第三方系统的数据到Excel服务器中,而后这些数据可以在Excel服务器中当做数据源使用。
2、 配置方法2.1定义WebApi请求与返回的数据结构
位置如下:
1)请求数据结构(json)
上传json格式数据文件或直接粘贴(不要求具体数据,只要保证结构正确即可)
点击下一步,识别出字段名称:
注:名称、类型、默认值可以修改
2)返回数据结构(json)
上传json格式数据文件或直接粘贴(不要求具体数据,只要保证结构正确即可)。注意,如果返回失败的json数据比返回成功的json数据的字段要多(通常包含具体的报错信息字段),则要使用返回失败的数据结构。
点击下一步,识别出字段名称:
注:名称、类型、可以修改。需要指定代表成功字段的返回码
3)高级
如果勾选了“可做为数据源”,在成功调用此WebApi后,其返回数据会自动保存到数据库中,可做为数据源使用。
2.2定义调用WebApi的时机
在表间公式WebApi Writer中设置调用时机以及其他设置:
1)选择要调用的WebApi
2)选择来源数据,可以选择其他WeiApi的返回结果当数据源。
3)设置筛选条件
4)构造请求数据
5)设置执行条件
注:可做为数据源的WebApi,会有一个“更新时间”字段。
6)应用时机
7)其他设置与回写公式类似
2.3使用实例
需要在表单的新建、修改、删除时调用某一些业务Api,而这些Api需要带上token参数,此token是由另外的可做为数据源的WebApi结果返回而来的,要求获取token的周期为30天,可以按下列步骤进行设置:
1)定义获取token的WebApi的请求与返回数据结构,勾选“可做为数据源”。
2)定义其他业务WebApi的请求与返回数据结构。
3)定义执行获取token的WebApi的WebApi Writer公式,构造请求数据,设置应用时机,设置执行条件(可选)。
4)定义执行业务WebApi的WebApi Writer公式,构造请求数据,设置应用时机,设置执行条件(可选)。
2.4调用WebApi的结果及查询调用记录
执行完WebApi Writer公式后,如果WebApi返回失败,则有弹出提示,包含调用的WebApi名称,请求数据,返回结果。如果调用成功则不提示:
调用WebApi无论成功失败,都可在日志中查看调用记录:
发布于:2022-12-18,除非注明,否则均为
原创文章,转载请注明出处。
发表评论