1. 概述
1.1 版本說明
| FineDataLink 版本 | 功能變動 |
|---|---|
| 1.7 | 新增一種節點類型：「參數指派」，可以將取到的資料匯出為參數，被下游遠端節點使用，不允許跨節點使用 |
| 4.1.6.1 | 參數指派批量操作「選擇行/列」相關文案優化，詳情參見本文 3.2 3.3 3.4 節 |
| 4.1.7.3 | 資料源選擇 API後，「進階配置」中支援指定回應資料字元編碼方式，與資料同步-API一致 |
| 4.1.13.2 | 配置方式為「選表」時，支援選欄位 |
| 4.2.4.3 | 支援一鍵重新整理除錯值，解決除錯值需要經常重新整理重新獲取的問題 |
1.2 歷史版本
| FineDataLink 版本 | 功能變動 |
|---|---|
| 2.0 |
|
| 3.7.1 | 「參數指派」下游分支所有的節點都可以使用匯出的參數（可跨節點使用），但是不可跨分支被其他節點使用，詳情請參見本文 功能說明 |
| 4.0.13 | 支援自動將參數指派內容生成「資料轉換」節點，便於使用複雜的資料處理結果生成參數，詳情參見本文 3.1 節 |
| 4.0.14 |
|
| 4.0.19 | 資料來源API配置支援關閉SSL憑證驗證，詳情參見：API输出典型示例 |
| 4.0.23 | 資料來源API 配置中的 body 請求內容支援使用 Content-Type 為 form-data 和 x-www-form-urlencoded 請求格式，允許新增多行、每行均為自訂輸入、支援引用參數，詳情參見 資料同步-API |
| 4.1.0 |
|
| 4.1.1 | 當資料源為 API 時，支援獲取API回應的header、body、http狀態碼，便於後續將其設定為參數，詳情參見本文 3.1.1 節 |
| 4.1.3 | 1）資料來源Tab下，「資料源」中選擇DB表輸入類型時，新增「配置方式」設定項，「配置方式」設定項中可選擇SQL、選表（本版本新增功能）、儲存程式（本版本新增功能）
2）支援分頁取數，詳情參見：API輸入-分頁取數 |
| 4.1.5.4 | 資料來源 Tab 中，配置方式選擇「選表」時，顯示表備注 |
1.3 應用場景
使用者希望上游節點運作的結果，能夠被下游節點使用。
希望能夠基於某些節點的運作結果，實現一些條件判斷的功能。
此時可以透過「參數指派」節點用參數承載上游節點運作的結果，然後在下游節點中使用該結果。
1.4 功能簡介
當資料開發的業務流程中，某個下游節點的任務需要獲取多個、多級上游節點的匯出參數時，可以使用參數節點，在「資料來源」中將需要指派的資料取出，併為參數指派，將獲取到的資料匯出為參數，下游節點可以使用參數值。
基於使用者自訂的取數邏輯，在任務實體運作程式中，運作到對應的「參數指派」節點，參數值方可確定下來。在FDL產品內名稱為“指派參數”，行業內也稱為"動態變數"。
2. 使用說明
3. 功能介紹
3.1 參數新增、使用說明
在定時任務中建立「參數指派」節點，可新增參數供下游節點使用。如下圖所示：
3.1.1 資料來源
透過「資料來源」將需要指派的資料取出。
支援從多種資料源中取數，支援的資料源詳情參見：資料開發支援的資料源
1）「資料源」中選擇DB表輸入類型時，支援三種方式獲取資料：寫 SQL 語句、直接選表（可新增過濾條件）、定时任务调用数据库存储过程。如下圖所示：
資料來源 Tab 中，配置方式選擇「選表」時，顯示表描述。表描述具體說明請參見：資料同步-資料來源
2）有時候使用者需要從 API 的請求頭中獲取token，將其設定為參數，便於後續呼叫API。
因此當參數指派選擇資料源為「API」時，支援獲取API回應的回應頭header、回應體body、狀態碼。如下圖所示：
| 屬性 | 類型 | 說明 |
|---|---|---|
| 回應體處理 | json | 選擇處理回應體，可以對回應體設定指定json路徑或者將解析後的json資料展開為二維表 例如選擇傳回回應體，且解析為二維表，則得到以下解析結果：
當處理資訊類型勾選了除「回應體」以外的其他類型，則無法勾選「將解析後的json資料展開為二維表」 |
| 解析回應頭 | key | 勾選回應頭時，則會解析回應頭中哪些key的value 可以將當前獲取回應頭的key進行批量配置，也可以手動新增key
|
注：如果解析回應體之外，還勾選解析回應頭時，則不支援解析 JSON 資料展開為二維表，且不支援「生成資料轉換」。
若同時將回應頭header、回應體body、狀態碼勾選，則生成一個二維表，列順序按照狀態碼、回應頭、回應體的順序，如下圖所示：
注：原本API請求不展開為二維表時，下游算子獲取到的欄位為 default 的二維表（1行1列），現在將「default」改為「responseBody」。
使用者即可根據解析好的資料，在後一步匯出參數中設定為參數。
3.1.2 匯出參數
可指定取出資料表的行列資料，將其作為參數。如下圖所示：
注：參數名和參數值中不允許包含${} 。
| 設定項 | 說明 |
|---|---|
| 參數名 | 同一個參數指派節點中不支援參數名相同 |
| 值來源 | 支援指定取出資料表的行列資料，將其作為參數 注：「參數指派」中，單個參數的匯出值個數最多為 10000。如果超過此限制，指派節點將運作失敗。在 4.1.10.2 及之後的版本中，可以透過使用「循环容器循环次数无限制插件」來處理超過 10000 個匯出值的情況。 取出的資料表如下圖所示：
設定參數值為資料表的第一欄所有行，如下圖所示：
|
| 閉包符 | 4.1.0 之前版本：
數值類型分隔：單個值範例：1；多個值範例：1,2,3 正文型分隔：單個值範例：'text'；多個值範例：'text1','text2' 注：若匯出的資料是多個值，且值不是數值時，需要將分隔符設定為正文型 4.1.0 及之後版本：
新生成參數值，閉包符預設關閉 閉包符關閉：相當於 4.1.0 之前版本選擇「數值類型分隔」 閉包符開啟：相當於 4.1.0 之前版本選擇「正文型分隔」 |
| 參數預覽 | 設定「參數值」後，點選參數預覽，即可查看參數值
注1：如果來源表為空，那麼參數指派預覽後會報錯。 |
| 除錯值 | 除錯值僅用於下游節點的資料預覽，正式運作時不會被使用 4.1.0 之前版本，需手動填入參數預設值，為方便下游節點查看效果，強烈建議給參數設定預設值；4.1.0 及之後版本，點選「參數預覽」，預覽成功後，會取前 5 個參數值自動填入預設值 4.2.4.3 及之後版本，可以點選「重新整理除錯值」，實時重新整理預覽值，便於在 API 解析設定token 後可以保證除錯時隨時重新整理不失效。 |
在當前任務的參數列表中，即可看到所有「參數指派」設定的參數，如下圖所示：
4.2.4.3 及之後的版本支援編輯和重新整理，如下圖所示：
勾選多個參數後，可以對指派參數批量重新整理，如下圖所示：
3.1.3 參數使用
1）支援跨節點傳遞參數。
「參數指派」下游分支所有的節點都可以使用匯出的參數，但是不可跨分支被其他節點使用。
「參數指派」節點執行後匯出的參數值，在下次執行之前都是固定的，即傳遞給下游節點的參數值均為固定的，不會受下游步驟影響。
2）參數支援跨層級傳遞，將父任務的參數傳遞給子任務，詳情參見：呼叫任務
3）若上游節點參數被同一流程遠端中的所有下游節點應用，下游節點引用參數時寫法如下：
值是單個字串或單個數值：=${a}
值是多個字串或多個數值：in (${a})
注：跟自訂參數不同，參數指派節點的參數引用時，不一定需要加單引號，如果在「參數指派」中定義的分隔符是正確的，那麼使用時直接用${參數名}即可。
3.2 批量生成參數
點選「批量生成」按鈕，可批量生成參數。
透過選擇來源列，生成對應參數；參數名自動生成，命名邏輯：欄位名_參數（若重複則加“_參數”，直到不重複）。
3.3 批量修改參數
選中要批量修改的參數，點選「修改來源行」按鈕，可批量修改參數。如下圖所示：
3.4 批量刪除參數
選中要批量刪除的參數，點選「刪除」按鈕，可批量刪除參數。如下圖所示：
4. 使用範例
| 簡介 | 文檔 |
|---|---|
| 「參數指派」節點的簡單使用範例 | 参数赋值示例 |
| 使用者希望透過郵件/企業微信等渠道，向成員發佈資訊或羅列特定交易，使用「參數指派+條件分支+訊息通知」節點實現 | 一条消息通知同时提醒多人 |
| 定期清理 30 天前的定時任務的運作記錄資料，使用「參數指派+SQL腳本」實現 | 自动清理FineDataLink运行记录 |
| 若來源表有時間戳，可以使用參數指派獲取目標表時間戳最大值，再使用資料同步獲取增量資料做增量更新 | 数据增量更新同步 |
5. 注意事項
若在匯出參數步驟預覽失敗，報錯「param unable to get the specified row and column data」，說明參數匯出資料為空，可忽略，任務可正常執行。