Excel服务器WebApi更新数据

日期：2024-12-20 16:33  |  分类：查询管理  |  人气：

WebApi的调用既可以实现数据查询，也可以实现数据新增或者其它操作，至于具体是哪个功能完全是由所调用的WebAPI自己来决定的，只要按要求正确调用API即可。所以通过取数公式调用API既可以实现数据查询，其实也可以实现数据的新增。
    相对于查询数据的WebAPI，新增数据的WebAPI的参数一般会更加复杂，通常会还同时使用到上Body参数，同时也是使用POST方法来提交执行。目前Body参数只支持JSON格式的数据。
    下面我们以用友的开放接口中的新增销售单来简单举例说明一下，如下图所示：

如上图所示，从接口文档中我们知道了这个WebAPI的URL和请求方式；
接着是参数的详细说明，如下图所示：


重点来了，我们找到调用示例，如下图所示：

从这个调用示例中，我们可以知道，这个WebAPI调用的时候需要提供 Query参数和Body参数，到时候我们建立这个WebAPI的时候就是把这个示例拷贝进去，然后点击自动生成按钮即可。
下面我们开始建立这个WebAPI数据源，如下图所示：
我们输入 数据源名称：新增销售单
         URL：https://api.yonyouup.com/api/consignment/add
         请求方式：POST
 
把示例中的完整URL+Query参数字符串：
https://api.yonyouup.com/api/consignment/add?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&biz_id=0971&ds_sequence=1
 
拷贝到Query参数的样本输入框，然后点击“生成参数表”，如下图所示：

 
接着从示例中把Body参数拷贝粘贴到Body参数的Json结构参数样本输入框中，然后点击“生成参数表”，如下图所示：

到这里，我们就完成了输入参数的设置了。
 
接着我们定义结果输出表，我们继续看接口文档，我们找到返回参数的说明，从返回参数的说明中，我们知道此API的返回结果里有4个参数，接着我们从示例里找到包含这4个参数的样本，如下图所示：

我们把样本拷贝到输出结果表的样本输入框里，然后点击“生成数据表”即可，结果如下如所示：

到这里，这个“新增销售单“的WebAPI就定义完成了。下面建立一条取数公式来调用这个WebAPI实现新增一张销售单，公式如下图所示：

    因为这条公式的主要目的是新增一张销售单，所以这条取数公式最后取回来的是什么数据都无关紧要，你既可以从这个WebAPI的结果表提取是否执行成功的信息，也可以从其它非WebAPI的任意来源表获取数据都可以。而核心是在执行取数之前先调用一下这个WebAPI即可实现新增销售单的目的。
    如下图所示：

选择“新增销售单“的WebAPI，点击”设置输入参数“，分别给Body参数和Query参数设置数据来源，如下图所示：



设置完成后，我们就可以填报执行公式了，公式执行后就可以到用友的系统了查看刚才新增过去的销售单数据了。