历史版本4 :API输入-Webservice 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 版本说明

FineDataLink 版本功能变动
4.0.9
  • 请求类型为POST时,「请求参数」支持传入XML格式数据

  • 对于GET与POST请求,支持输出XML格式数据,支持预览XML响应结果。

4.0.10RestAPI交互优化、支持 text/plain 格式的请求内容
4.0.11RestAPI中 Webservice 接口取数支持读取WSDL文件,且自动生成请求参数、请求体

1.2 应用场景

用户想要将 Webservice 接口数据取出并进行后续的数据处理。

1.3 功能说明

FineDataLink 支持在数据转换中使用 RestAPI 输入将 Webservice 接口中的数据取出取数并对数据进行进一步处理。

在导入接口配置后,API 配置和 Headers、body 界面会自动生成请求参数与请求体,用户只需要对请求体中的参数填写具体值或引用参数,即可完成调用 WebService 接口的配置。

更多 API 相关详情参见:RestAPI 专题概述

注:目前仅支持参数为文本、数字、日期的 WebService 接口调用(最终都以文本形式传入),其他格式不支持。

demo示例详情参见:https://demo.finedatalink.com/ 「01.功能示例>01最新功能>4.0.9 xml解析」

2. 操作步骤编辑

2.1 前提条件

例如某 Webservice 接口可以返回不同城市的天气情况和基本信息,想要将这些信息取出并进行进一步的解析加工。

以下为获取到的请求地址、请求头和请求参数信息:

首先测试该接口是否生效,如下图所示:

2.2 API 取数

新建定时任务,拖入数据转换节点并进入编辑界面,如下图所示:

将 RestAPI输入拖入画布中,由于是 Webservice 接口,因此可以点击导入,选择「导入Webservice 接口配置」,如下图所示:

在导入配置界面中可以选择 WSDL 解析方式,示例中选择了 URL ,当然用户也可以选择文件方式,将 API 地址 http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?WSDL  输入,注意 API 地址后需要加?WSDL,如下图所示:

然后即可选择需要的接口,如下图所示:

点击「确定」后, API 配置和 Headers、body 界面会自动生成请求参数与请求体用户只需要对请求体中的参数填写具体值或引用参数,即可完成调用WebService接口的配置,如下图所示:

注:如果 body 是SOAP1.1:Content-Type:text/xml; charset=utf-8(这里的字符集以解析到的字符集为准)。

如果是SOAP1.2:Content-Type:application/soap+xml; charset=utf-8(这里的字符集以解析到的字符集为准)。

然后可以修改请求体参数值,例如我们将「无锡」的天气情况数据取出,如下图所示:

点击「数据预览」,即可看到返回的 XML 格式的数据,如下图所示:

3. 后续操作编辑

接下来即可使用 XML解析 对取出的 API 数据进行解析,将返回的XML格式数据解析为行列格式数据,以供后续加工存储。