全局參數-指派參數

  • 文檔創建者:Roxy
  • 編輯次數:12
  • 最近更新:Nikozhan 于 2025-12-02
  • 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 管理全局參數

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


    附件列表


    主題: 資料開發-定時任務
    • 有幫助
    • 沒幫助
    • 只是瀏覽
    • 评价文档,奖励 1 ~ 100 随机 F 豆!