1. 概述编辑
1.1 版本说明
FineDataLink 版本 | 功能变动 |
---|---|
4.0.9 |
|
4.0.10 | RestAPI交互优化、支持 text/plain 格式的请求内容 |
4.0.11 | RestAPI中 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格式数据解析为行列格式数据,以供后续加工存储。