1. 概述
循环容器已经介绍了循环容器的基本功能。
本文以一个具体示例为你做介绍,API 接口每次只能取一条数据,希望能将接口中满足数据库表「orderlist」中data_id 的数据取出并落库。
此时需要将「orderlist」数据库表中 data_id 取出作为参数,然后将该参数写入API请求中,通过循环容器一一将参数值赋给API,一条条取出数据到指定数据库。
FineDataLink 中的数据处理过程,详情参见:https://demo.finedatalink.com/ 「循环容器-」
2. 操作步骤
数据库数据:orderlist.xlsx
接口数据:https://api.jiandaoyun.com/api/v4/app/62e9e1c00a99380008a3ccd2/entry/6315aef0ee89a400086fcc54/data_retrieve
2.1 设置参数
1)新建一个定时任务,将「参数赋值」节点拖入到设计界面。取出「orderlist」数据库表中 data_id 数据,如下图所示:
点击「数据预览」,如下图所示:
2)将 data_id 设置为参数,如下图所示:
注1:若参数作为循环参数,那么参数值在遍历时是一维数组的形式,可供容器循环获取,若参数赋值的参数在其他场景中使用,还是字符串的形式。
注2:对「参数赋值」中单个参数输出的字段值个数进行限制,限制最多不能超过 10000 个。
注3:容器内可以使用「参数赋值」,「参数赋值」输出的值形成容器内的参数:
容器内参数仅可在容器内使用,不可向容器外传递。
容器内参数优先级最高,优先级大于其他所有容器外参数和内置的参数。
2.2 引入循环容器
由于数据同步-API取数需要将参数一条条赋值给接口,因此新增「循环容器」节点,将「循环容器」节点与「参数赋值」节点相连,如下图所示:
2.3 API 取数并落库
为了将 API 接口中的数据取出,需要将「数据同步」节点拖入到「循环容器」中,并输入 API、请求方式、认证类型,API 取数详情参见:数据同步-API,如下图所示:
设置请求头为 JSON格式,并将参数赋值中设置的 dataid 参数写入请求参数中,如下图所示:
由于取出的 API 数据返回的是JSON 格式,因此可以通过「返回值处理」取出想要的数据,然后点击「数据预览」查看取出数据,如下图所示:
点击「数据去向」设置取出的数据的写入数据表,如下图所示:
2.4 参数绑定循环容器
设置循环遍历对象,选择 3.1节设置的 dataid 参数,在数据同步 API 取数时,循环容器会一一将参数值赋给接口请求参数,如下图所示:
「循环容器」节点设置项介绍如下表所示:
设置项 | 说明 |
---|---|
循环限制 | 默认 128 次,用户可手动调整,上限为 10000 次,不可为空 超出循环限制后,循环容器运行将报错 |
循环方式-遍历循环 | 遍历参数输出的结果,遍历结束则循环结束,循环次数与遍历对象的元素个数一致
|
循环方式-条件循环 | 可设置「结束条件」,循环次数由条件决定:
整体逻辑是先执行一次循环体,再判断条件。示例:条件循环首次执行时,条件判断返回值为 false,循环先执行一次,再跳出循环 |
遍历对象 | 可勾选参数:选择的参数逐行获取值,未选择的参数直接获取值 可以选择单个或多个参数,限制只能选择容器外的参数 |
结束条件 | 循环方式选择「条件循环」时,可设置「结束条件」。 条件中的参数可以是容器外的参数,也可以是容器内的参数 |
2.5 运行任务
点击右上角的「保存并运行」。如下图所示:
运行成功后,可看到数据库中新增了数据表,将数据库表「orderlist」中 data_id 对应的 API 数据取出。如下图所示: