1. 概述编辑
1.1 版本
| FineDataLink 版本 | 功能變動 |
|---|---|
| 4.1.3 | - |
1.2 應用場景
需要使用 FineDataLink 取出 API 資料時，由於資料量限制或者API回應時間，有時需要分頁取數。
1.2 功能說明
FineDataLink 提供了 API 分頁功能。
在「參數指派」「資料同步」「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行的二維表 |