1. 概述
1.1 版本
| FineDataLink 版本 | 功能變動 |
|---|---|
| 4.1.8.1 | 新增動態指派參數設定功能 |
| 4.1.13.2 | 配置方式為「選表」時,支援選欄位 |
| 4.1.14.1 | 全局參數除錯值的長度,最大為 2000 |
| 4.2.12.4 | 支援限定指派參數的使用範圍 支援為指派參數新增描述 |
1.2 應用場景
當多個定時任務需要使用相同的參數指派時,如果參數需要修改,每個定時任務都需要進行修改,實現程式比較麻煩;希望多個定時任務可以呼叫同一個參數,這樣只需要修改該參數就可以達到修改所有定時任務參數的目的,提高維護任務的效率。
例如有一個「參數指派」在多個定時任務中都用到了,不想在多個定時任務中都維護;或者在多個定時任務中都需要呼叫API,在正式呼叫API前都需要呼叫獲取token的API。
1.3 功能簡介
支援設定指派全局參數,該動態參數可在多個定時任務中使用。
2. 使用需知
1)「循環容器」遍曆物件支援選擇動態全局參數。
若循環容器使用該全局參數遍曆執行&循環容器裏有全局參數非循環參數,則任務執行前計算出該全局參數值再循環運作,容器中節點引用該參數時不重複計算參數值。

2)任務執行:
該定時任務使用到的全局參數,會在定時任務實體運作前開始執行,先計算出全局參數的值後,再運作設計好的定時任務。
當前任務所有的執行記錄,都包含全局參數的執行程式,比如執行記錄中開始時間從執行全局參數開始;當全局參數的節點在執行時,全局參數執行失敗沒有結果時,當前節點執行報錯。
父、子任務拉起實體時分別計算全局參數。
注:當A任務執行時,運作全局參數得到結果b1,在此期間,C任務也執行了全局參數得到結果b2,在A任務中一直使用結果b1。
3)其餘說明請參見:全局參數
3. 注意事項
針對設定全局參數為 token,重新整理 token 後老 token 會失效的第三方API,如果兩個使用 token 參數在相同時間調度,可能會出現 A 任務在執行時獲取的 token,因為在 B 任務執行時獲取了新的 token,導致 A 任務中使用的 token 失效,導致呼叫失敗。
解決方案:使用同一個 token 作為全局參數的不同任務,不要在同一個時間調度;或者使用一個父任務呼叫多個子任務。
4. 功能說明
例如有一個「參數指派」在多個定時任務中都用到了,不想在多個定時任務中都維護,希望新增一個全局指派參數,在多個定時任務中使用。
4.1 新增全局指派參數
注:所有平台使用者都有權限新增全局參數。
1)進入資料開發介面,點選
按鈕,可進入全局參數配置介面。如下圖所示:

2)點選「新增參數」按鈕,可新增全局指派參數。例如希望從資料庫取出一欄時間作為參數,給多個定時任務使用。
新增「指派參數」,如下圖所示:

3)選擇需要設定參數的資料源,並取出指定資料,如下圖所示:

| 設定項 | 說明 |
|---|---|
| 資料連結權限 |
|
| 參數值 | 在配置資料來源時,只能使用${cyctime}、${workname.opresult}、${workname.jobname.opresult}三個內建參數和全局靜態參數,不能引用其他內建參數、自訂參數、全局動態參數 4.1.14.1 及之後版本,全局參數除錯值的長度,最大為 2000 |
4)然後設定並匯出參數,如下圖所示:
注:這裏的配置項與 參數指派 相同,此處不做贅述。

| 設定項 | 說明 | ||||||
|---|---|---|---|---|---|---|---|
| 參數名稱 |
| ||||||
| 可用範圍 | 4.2.12.4 及之後版本,支援為指派參數設定可用範圍
| ||||||
| 其他設定項 | 與 參數指派 相同,此處不做贅述 |

4.2 使用全局參數
詳情請參見:如何配置並使用參數、参数在FDL中的典型应用场景
4.3 管理全局參數
修改、刪除、重新整理全局參數請參見:全局參數
