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

目錄:

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

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

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

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

設定項說明
資料連結權限
  • 定義全局參數時,可選資料連結取決於該使用者的資料連結使用權限,同定時任務選擇資料源。

  • 使用者可以查看/引用有使用權限的全局參數,即使沒有對應資料連結的權限

  • 引用全局參數時,如果沒有對應資料連結權限,任務也可以正常運作使用。

參數值

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

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

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

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

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

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

可用範圍
4.2.12.4 及之後版本,支援為指派參數設定可用範圍

可用範圍說明
使用者可用範圍所有人、僅建立者
任務可用範圍所有定時任務、部分定時任務(自訂設定)
  • 在任務的參數列表或者節點內可以選擇參數的地方,僅顯示當前使用者&當前任務可用的全局參數列表

  • 預覽&運作時判斷參數是否可用:資料預覽或者任務實際運作時,對於使用到的參數不在當前任務可用範圍,則預覽或運作報錯——參數不可用

其他設定項與 參數指派 相同,此處不做贅述
5)參數新增成功後,介面如下圖所示:

4.2 使用全局參數

詳情請參見:如何配置並使用參數参数在FDL中的典型应用场景

4.3 管理全局參數

修改、刪除、重新整理全局參數請參見:全局參數