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 数据取出。如下图所示：
