任務參數類型

任務範本parameterDefinitions清單中的每個項目都會宣告一個任務參數。每個參數都有 name和 type，而且可以有 description、 default和 userInterface區塊，以及 label、 groupLabel和 control。類型會決定參數接受哪些值、其支援哪些限制欄位，以及依預設顯示哪些控制提交對話方塊。範本將值稱為 {{Param.Name}}。類型如下所示。

有些類型是基本開放任務描述規格的一部分。其餘部分由 EXPR延伸項目新增，使用它們的範本必須列在其 EXPR中extensions。如需每種類型的field-by-field定義，請參閱 GitHub 網站上的開啟任務描述任務參數定義。

INT

整數，以數字或數字字串表示。限制條件：allowedValues、minValue、maxValue。控制項：SPIN_BOX設定 DROPDOWN_LIST 時為 或 allowedValues 。

FLOAT

數字，以數字或數字字串表示。限制條件：allowedValues、minValue、maxValue。控制項：SPIN_BOX設定 DROPDOWN_LIST 時為 或 allowedValues 。decimals 欄位會設定可編輯的小數位數。

STRING

字串。限制條件：allowedValues、minLength、maxLength。控制：LINE_EDIT設定 DROPDOWN_LIST時為 或 allowedValues 。也接受 MULTILINE_EDIT，當 allowedValues保留 true/false 配對，例如 CHECK_BOX時["true", "false"]。

PATH

檔案或目錄路徑。路徑映射規則會套用至工作者上的 值。限制條件：allowedValues、minLength、maxLength、objectType、dataFlow。控制項：CHOOSE_INPUT_FILE、 CHOOSE_OUTPUT_FILE或 CHOOSE_DIRECTORY，取決於 objectType和 dataFlow。

BOOL （需要 EXPR)

true 或 false；數字1或 0；或字串 true、yes、on、1false、no、、off，0以任何字母為例。沒有限制條件。控制：CHECK_BOX。

RANGE_EXPR （需要 EXPR)

整數範圍表達式，例如 "1-100"、 "1-100:10"或 "1,3,5-9"。限制條件：minLength、maxLength。控制：LINE_EDIT。

LIST[STRING] （需要 EXPR)

字串清單。限制條件：清單maxLength為 minLength和 ；每個項目item.maxLength為 item.allowedValuesitem.minLength、 和 。控制：LINE_EDIT_LIST。

LIST[PATH] （需要 EXPR)

路徑清單。路徑映射規則會套用至每個值。限制條件： 的清單和項目限制條件LIST[STRING]，加上 objectType和 dataFlow。控制項：CHOOSE_INPUT_FILE_LIST、 CHOOSE_OUTPUT_FILE_LIST或 CHOOSE_DIRECTORY_LIST，取決於 objectType和 dataFlow。

LIST[INT]、 LIST[FLOAT]（需要 EXPR)

號碼清單。限制條件：清單maxLength為 minLength和 item.allowedValues；每個項目item.maxValue為 item.minValue、 和 。控制：SPIN_BOX_LIST。

LIST[BOOL] （需要 EXPR)

布林值清單，每個都接受與 相同的值BOOL。限制條件：minLength、maxLength。控制：CHECK_BOX_LIST。

LIST[LIST[INT]] （需要 EXPR)

整數清單清單，用於結構式輸入，例如相鄰清單。限制條件：巢狀item限制條件。控制項：HIDDEN；此類型沒有視覺化控制項。

每種類型也會接受 HIDDEN做為其控制項，讓 參數保持在提交對話方塊之外。HIDDEN 為管道以程式設計方式提供的值設定 。

PATH 和 LIST[PATH]類型具有兩個額外的欄位。 objectType 為 FILE或 DIRECTORY，而 dataFlow為 IN、INOUT、 OUT或 NONE。任務附件會讀取這些欄位，以決定要上傳哪些路徑做為輸入，以及要監看哪些輸出。PATH 參數也支援 檔案對話方塊fileFilterDefault的 fileFilters和 。如需詳細資訊，請參閱任務套件的任務範本元素。

下列定義顯示核取方塊、影格範圍、攝影機名稱清單，以及輸入檔案清單。範本會列出，EXPR因為最後四種類型需要它。

specificationVersion: 'jobtemplate-2023-09'
extensions:
  - EXPR
parameterDefinitions:
  - name: Samples
    type: INT
    default: 64
    minValue: 1
    maxValue: 4096
  - name: UseGpu
    type: BOOL
    default: false
    userInterface:
      label: Render on GPU
  - name: Frames
    type: RANGE_EXPR
    default: "1-100"
    userInterface:
      label: Frame Range
  - name: Cameras
    type: LIST[STRING]
    default: ["main", "closeup"]
    minLength: 1
    userInterface:
      label: Cameras to Render
  - name: Textures
    type: LIST[PATH]
    objectType: FILE
    dataFlow: IN
    default: []

在具有 EXPR 延伸的範本中，每個參數都有相符的表達式類型：int、float、string、path、bool、 range_expr或 list[T]。RANGE_EXPR 或清單參數可以直接是任務參數range的 ，讓每個影格或項目成為任務。對於 PATH和 LIST[PATH]， RawParam.Name 是路徑映射之前提交做為字串的值。

steps:
  - name: Render
    parameterSpace:
      taskParameterDefinitions:
        - name: Camera
          type: STRING
          range: "{{Param.Cameras}}"
        - name: Frame
          type: INT
          range: "{{Param.Frames}}"
    script:
      actions:
        onRun:
          command: render
          args:
            - "--camera"
            - "{{Task.Param.Camera}}"
            - "--frame"
            - "{{Task.Param.Frame}}"
            - "--samples"
            - "{{Param.Samples}}"
            - "{{ '--gpu' if Param.UseGpu else null }}"
            - "{{ ['--textures', Param.Textures.join(',')] if len(Param.Textures) > 0 else null }}"

最後兩個引數是表達式。null 結果不會新增任何引數，而清單結果會將每個項目新增為個別引數。如需詳細資訊，請參閱任務範本中的表達式。

若要提交使用 EXPR 參數類型的任務套件， 中的截止日期雲端 CLI 和提交對話方塊deadline bundle gui-submit，以及截止日期雲端監視器必須是支援延伸模組的版本。較舊的用戶端會拒絕具有這些類型的範本。