勤哲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无论成功失败，都可在日志中查看调用记录：