历史版本12 :全局參數-指派參數 返回文檔
編輯時間: 內容長度:图片数:目录数: 修改原因:

目錄:

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)進入資料開發介面,點選1696643783452615.png按鈕,可進入全局參數配置介面。如下圖所示:

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

新增「指派參數」,如下圖所示:

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

設定項
說明
參數名稱
  • 全局參數不能同名

  • 參數名稱中不允許包含${}

參數值

在配置資料來源時,只能使用${cyctime}、${workname.opresult}、${workname.jobname.opresult}三個內建參數和全局靜態參數,不能引用其他內建參數、自訂參數、全局動態參

4.1.14.1 及之後版本,全局參數除錯值的長度,最大為 2000

然後設定並匯出參數,如下圖所示:

注:這裏的配置項與 參數指派 相同,此處不做贅述。

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

3.2 修改/刪除全局參數

3.2.1 修改全局參數

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

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

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

3.2.2 刪除全局參數

點選「刪除」按鈕即可。如下圖所示:

3.3 搜尋全局參數

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

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

4. 後續步驟编辑

設定好的全局參數即可在資料開發的定時任務中使用,如下圖所示: