亿信ABI
当前版本:5.6.1

HTTP接口组件&WebService接口

1.HTTP 接口组件

1.组件介绍

可调用数据源管理页面的接口数据源下的http格式的接口,读取接口返回结果,将结果保存到临时表的一个字段中,供后置组件使用。

数据源:选择数据源下的一个接口数据源(只支持json格式)

查看:跳转页面到接口数据源列表

测试:查看接口数据源访问返回数据

忽略异常:多用于重复请求的情况,如需请求接口N次,在其中某次请求失败时,会直接报错并终止整个流程,但勾选了忽略异常会跳过失败的请求,继续执行剩余的请求。

header:设置请求头,如token等

参数名称:可以根据需要自行添加

参数值:支持常量、宏以及前置输入组件的字段,参数设置为字段时会读取字段所有取值循环调用接口。

刷新:刷新仅刷新HTTP默认创建的字段COL_,功能为还原字段设置(字段名称,字段类型,字段长度,小树精度)

HTTP接口组件默认自动创建一个定义好的字段(用于保存接口返回结果)

拾取:当组件的参数值设置选择为前置组件的字段时,可以根据需要拾取前置组件字段,拾取的段的原始名称这一列不允许修改

2.使用场景

2.1 接口读取数据

http接口组件的使用与数据源-接口数据源有着密切关系,所以使用前需要在接口数据源处新建一个接口,确保能够正常调通。目前环境中存在一个天气查询的接口,该接口请求参数为city ,通过输入城市名称查询该城市近几天的天气情况。

接口数据源建立完成之后,进入数据集成页面,新建交换任务,拖入表输入组件、http接口组件、表达式组件、json解析组件、表输出组件。表输入组件选择城市信息表,记录需要查询的城市名称,数据如图所示:

http接口组件选择刚刚新建的天气接口数据源,请求参数city的参数值设置为表输入的id_字段,这样配置表输入中的每一条数据都会调用这个接口。

由于http接口组件的返回值默认是clob大字段,所以表达式组件中使用字段类型转换函数将大字段转换成字符型,方便我们查看接口的返回值。

由于接口的返回值是json格式,所以需要用到json解析组件,解析出我们需要的属性信息,此处我们需要解析日期、与当天天气两个信息。根据接口实际返回信息配置json 解析组件,此处json解析组件配置参考如下:

配置完成后输出到目标表即可。输出数据如图,输出的数据包含了各个城市未来近四天的天气情况。

2.2接口写入数据

某公司人力资源系统需要定时将新员工信息推送到下游的OA系统中存储,且只能通过接口的形式进行数据的推送。下面以该场景为例,通过设计ETL任务来实现此场景。

首先需要在接口数据源中新建一个OA接收数据的接口,并配置其基本信息。

接口数据源配置完成后,进入ETL任务设计页面,拖入表输入组件、表达式组件、json生成组件,http接口组件。

表输入组件选择人员信息表,json 生成组件 根据OA接口请求体的格式将信息表中的数据生成对应的json 串。该场景中的json 生成组件配置如图所示:

接口组件配置完成后,选择进入http 接口组件配置,选择OA人员接口,配置基本信息以及请求体。在http接口组件中,请求体格式的参数配置通过一个空格代表该参数为请求体的值。请求体的值选择json生成组件生成的字段。具体配置如图所示:

配置完成后,运行任务即可。该ETL任务会把原表中的每一条数据通过json生成组件以请求体的形式推送给OA系统中。具体请求信息可以系统配置-接口请求日志查询每条数据的推送情况。

3.注意事项

①.该组件的输出字段列表来自本组件的字段列表。

②.该组件没有对应的实体表,用临时表代替,所以只能在调试模式下预览数据。

③.该组件可以没有前置组件,直接使用。

 2.WebService接口组件

1.概述

WebService接口输入组件是根据数据源下的一个接口数据源,将接口返回结果读取生成一张临时表。

数据源:选择数据源下的一个接口数据源

查看:跳转页面到接口数据源列表

测试:查看接口数据源访问返回数据

数据区:根据所选数据源解析出的数据区(WSDL格式内容为方法)

参数:根据所选数据源解析出的输入参数,参数支持常量、宏以及前置输入组件的字段,参数设置为字段时会读取字段所有取值循环调用接口。

参数值:通过表达式编辑器设置,可以设置常量、参数、前置组件字段其中一种或者组合的形式。

2.使用场景

WebService接口组件使用场景与http接口组件类似,唯一的区别是WebService接口组件返回值与http 接口组件有差异,http接口组件接口返回值一般为json的格式。WebService接口组件的返回值多为WSDL格式。

附件列表

0

文档内容仅供参考
如果您需要解决具体问题,还可以登录亿信社区
在提问求助板块提问,30分钟内帮您解决问题

如果您认为本词条还有待完善,请编辑

上一篇HDFS组件

下一篇JSON生成组件

请先登录