1. 概述
1.1 版本
| FineDataLink 版本 | 功能变动 |
|---|---|
| 4.1.3 | - |
1.2 应用场景
需要使用 FineDataLink 取出 API 数据时，由于数据量限制或者接口响应时间，有时需要分页取数。
1.2 功能说明
FineDataLink 提供了 API 分页功能。
在「参数赋值」「数据同步」「API输入」功能中，若选择数据来源为 API ，则可以在数据来源下的「高级配置」中勾选「分页取数」，根据接口设置的分页方式进行取数，如下图所示：
2. 使用限制
当前只支持返回值为 json 的 API。
3. 功能说明
所有分页方式的分页取数中，分页结束条件逻辑：先执行循环体，再判断是否终止循环。示例：假设页数 pageNum>=totalpages 时，停止执行，当 totalpages 为 8，pageNum 也为 8 时，会先执行 pageNum 为 8 的循环，再终止执行。
| 维度 | 说明 |
|---|---|
| 取数限制 | 限制分页取数的次数。
|
分页方式-页码 | 参数：
更新策略：
用户配置起始值和增长间隔后，每次循环后执行自增动作，自增逻辑为：pageNum=pageNum+增长间隔 分页结束条件：
注：值可以引用参数。 |
| 分页方式-偏移量 | 参数：
更新策略：
用户配置起始值和增长间隔后，每次循环后执行自增动作，自增逻辑为：offset=offset+增长间隔 分页结束条件：
注：值可以引用参数 |
| 分页方式-游标 | 游标：
更新策略：
注：先判断分页结束条件，再执行游标参数更新。
分页结束条件：
注：值可以引用参数 |
勾选了分页取数后， API 数据源其他功能说明：
| 功能 | 说明 |
|---|---|
| 重试 | 若 API 输入分页取数单次执行调用API失败，没有重试逻辑，按整个数据转换节点重试 |
| 调用频率控制 | 在一个任务实例中，分页取数多次调用API受「调用频率控制」控制 |
|
因为每次分页取数时获得 json 可能不一样，如果找不到相应json路径，则为空
因为每次分页取数时获得 json 可能不一样，每次将json展开二维表时，如果遇到新的属性，则新增列 没有相关属性的分页取数，相关列为空 |
| 返回值格式 | 当响应体格式为 xml 时，不支持分页取数 |
信息类型（参数赋值）
| 如果参数赋值同时解析响应体、响应头、状态码，将每次取数获得响应拼成一个N列N行的二维表 |
