1. 概述编辑
1.1 版本
| FineDataLink 版本 | 功能變動 |
|---|---|
| 4.1.8.1 | 新增動態指派參數設定功能 |
| 4.1.13.2 | 配置方式為「選表」時,支援選欄位 |
| 4.1.14.1 | 全局參數除錯值的長度,最大為 2000 |
1.2 應用場景
當多個定時任務需要使用相同的參數指派時,如果參數需要修改,每個定時任務都需要進行修改,實現程式比較麻煩;希望多個定時任務可以呼叫同一個參數,這樣只需要修改該參數就可以達到修改所有定時任務參數的目的,提高維護任務的效率。
例如有一個「參數指派」在多個定時任務中都用到了,不想在多個定時任務中都維護;或者在多個定時任務中都需要呼叫API,在正式呼叫API前都需要呼叫獲取token的API。
1.3 功能簡介
支援設定指派全局參數,該動態參數可在多個定時任務中使用。
2. 使用需知编辑
1)全局參數可被當前工程所有定時任務使用。
2)全局參數的使用與其他已有類型參數(動態參數、父任務參數、任務參數、內建參數)一致,在支援引用參數的配置項中,透過${參數名稱}或'${參數名稱}'進行引用。
3)當全局參數與其他類型參數同名時,優先如下:
「參數指派」設定的參數>呼叫任務中父任務參數>「自訂參數」>全局參數>「內建參數」
4)資源遷移 中,暫不支援全局參數的匯入/匯出。
5)「循環容器」遍歷物件支援選擇動態全局參數。
若循環容器使用該全局參數遍歷執行&循環容器裏有全局參數非循環參數,則任務執行前計算出該全局參數值再循環運作,容器中節點引用該參數時不重複計算參數值。

6)資料連結權限說明:
定義全局參數時,可選資料連結取決於該使用者的資料連結使用權限,同定時任務選擇資料源。
使用者可以查看/引用所有全局參數,即使沒有對應資料連結的權限。
引用全局參數時,如果沒有對應資料連結權限,任務也可以正常運作使用。
7)任務執行:
所有全局參數在整個定時任務實際開始運作前執行,計算出所有全局參數值後,再運作設計好的定時任務。
當前任務所有的執行記錄,都包含全局參數的執行程式,比如執行記錄中開始時間從執行全局參數開始;當全局參數的節點在執行時,全局參數執行失敗沒有結果時,當前節點執行報錯。
注:當A任務執行時,運作全局參數得到結果b1,在此期間,C任務也執行了全局參數得到結果b2,在A任務中一直使用結果b1。
8)參數在 FDL 中的應用場景請參見:参数在FDL中的典型应用场景
3. 注意事項编辑
針對設定全局參數為 token,重新整理 token 後老 token 會失效的第三方API,如果兩個使用 token 參數在相同時間調度,可能會出現 A 任務在執行時獲取的 token,因為在 B 任務執行時獲取了新的 token,導致 A 任務中使用的 token 失效,導致呼叫失敗。
解決方案:使用同一個 token 作為全局參數的不同任務,不要在同一個時間調度;或者使用一個父任務呼叫多個子任務。
3. 操作步驟编辑
例如有一個「參數指派」在多個定時任務中都用到了,不想在多個定時任務中都維護,希望新增一個全局指派參數,在多個定時任務中使用。
3.1 新增全局指派參數
注:所有平台使用者都有權限新增全局參數。
1)進入資料開發介面,點選
按鈕,可進入全局參數配置介面。如下圖所示:

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

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

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

3)參數新增成功後,介面如下圖所示:

3.2 修改/刪除全局參數
3.2.1 修改全局參數
1)進入資料開發介面,點選
按鈕,可進入全局參數配置介面。如下圖所示:

2)點選「修改」按鈕,即可修改全局參數。如下圖所示:

3)修改全局參數後,「修改記錄」列點選「展開」按鈕,可查看修改記錄。如下圖所示:

3.2.2 刪除全局參數
點選「刪除」按鈕即可。如下圖所示:

3.3 搜尋全局參數
1)進入資料開發介面,點選
按鈕,可進入全局參數配置介面。如下圖所示:

2)可在搜尋框中搜尋全局參數。如下圖所示:

4. 後續步驟编辑
設定好的全局參數即可在資料開發的定時任務中使用,如下圖所示:


