

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Tipi di parametri Job
<a name="build-job-bundle-parameter-types"></a>

Ogni voce nell'`parameterDefinitions`elenco di un modello di lavoro dichiara un parametro di lavoro. Ogni parametro ha un `name` e a `type` e può avere a `description``default`, a e un `userInterface` blocco con a `label``groupLabel`, a e a`control`. Il tipo determina quali valori il parametro accetta, quali campi di vincoli supporta e quali controlli vengono visualizzati nella finestra di dialogo di invio per impostazione predefinita. Un modello si riferisce al valore come. `{{Param.{{Name}}}}` I tipi sono i seguenti.

Alcuni tipi fanno parte della specifica Open Job Description di base. Gli altri vengono aggiunti dall'`EXPR`estensione e un modello che li utilizza deve essere elencato `EXPR` nella sua`extensions`. Per la definizione campo per campo di ogni tipo, consultate le [definizioni dei parametri di lavoro Open Job Description sul sito Web](https://github.com/OpenJobDescription/openjd-specifications/wiki/2023-09-Template-Schemas#2-jobparameterdefinition). GitHub 

`INT`  
Un numero intero, come numero o stringa numerica. Vincoli:,,. `allowedValues` `minValue` `maxValue` Controllo: `SPIN_BOX` o `DROPDOWN_LIST` quando `allowedValues` è impostato.

`FLOAT`  
Un numero, come numero o stringa numerica. Vincoli:`allowedValues`,,. `minValue` `maxValue` Controllo: `SPIN_BOX` o `DROPDOWN_LIST` quando `allowedValues` è impostato. Il `decimals` campo imposta il numero di cifre decimali modificabili.

`STRING`  
Una stringa. Vincoli:`allowedValues`,,`minLength`. `maxLength` Controllo: `LINE_EDIT` o `DROPDOWN_LIST` quando `allowedValues` è impostato. Accetta anche`MULTILINE_EDIT`, e `CHECK_BOX` quando ne `allowedValues` tiene in mano, una true/false coppia come`["true", "false"]`.

`PATH`  
Un percorso di file o directory. Le regole di mappatura dei percorsi vengono applicate al valore sul lavoratore. Vincoli:`allowedValues`,,,`minLength`,`maxLength`. `objectType` `dataFlow` Controllo:`CHOOSE_INPUT_FILE`, o `CHOOSE_OUTPUT_FILE``CHOOSE_DIRECTORY`, a seconda `objectType` di e. `dataFlow`

`BOOL`(richiede`EXPR`)  
`true`oppure`false`; i numeri `1` o`0`; o le stringhe`true`,,,`yes`,`on`,`1`, `false` `no``off`, `0` in qualsiasi lettera maiuscola. Nessun vincolo. Controllo:. `CHECK_BOX`

`RANGE_EXPR`(richiede`EXPR`)  
Un'espressione di intervallo intero come `"1-100"``"1-100:10"`, o`"1,3,5-9"`. Vincoli:,. `minLength` `maxLength` Controllo:. `LINE_EDIT`

`LIST[STRING]`(richiede`EXPR`)  
Un elenco di stringhe. Vincoli: `minLength` e `maxLength` per l'elenco;`item.allowedValues`,`item.minLength`, e `item.maxLength` per ogni elemento. Controllo:. `LINE_EDIT_LIST`

`LIST[PATH]`(richiede`EXPR`)  
Un elenco di percorsi. Le regole di mappatura dei percorsi vengono applicate a ciascun valore. Vincoli: i vincoli di elenco e elemento di, plus e. `LIST[STRING]` `objectType` `dataFlow` Controllo:`CHOOSE_INPUT_FILE_LIST`, o `CHOOSE_OUTPUT_FILE_LIST``CHOOSE_DIRECTORY_LIST`, a seconda di and. `objectType` `dataFlow`

`LIST[INT]`, `LIST[FLOAT]` (richiede`EXPR`)  
Un elenco di numeri. Vincoli: `minLength` e `maxLength` per l'elenco;`item.allowedValues`,`item.minValue`, e `item.maxValue` per ogni elemento. Controllo:. `SPIN_BOX_LIST`

`LIST[BOOL]`(richiede`EXPR`)  
Un elenco di valori booleani, ognuno dei quali accetta gli stessi valori di. `BOOL` Vincoli:,. `minLength` `maxLength` Controllo:. `CHECK_BOX_LIST`

`LIST[LIST[INT]]`(richiede`EXPR`)  
Un elenco di elenchi di numeri interi, per input strutturati come un elenco di adiacenze. Vincoli: vincoli annidati. `item` Controllo: `HIDDEN` non esiste un controllo visivo per questo tipo.

Ogni tipo accetta anche `HIDDEN` come controllo, il che mantiene il parametro fuori dalla finestra di dialogo di invio. Impostato `HIDDEN` per i valori che una pipeline fornisce a livello di codice.

I `LIST[PATH]` tipi `PATH` and contengono due campi aggiuntivi. `objectType`è `FILE` o`DIRECTORY`, ed `dataFlow` è `IN``OUT`,`INOUT`, o`NONE`. Gli allegati Job leggono questi campi per decidere quali percorsi caricare come input e quali controllare per gli output. Un `PATH` parametro supporta anche `fileFilters` e `fileFilterDefault` per la finestra di dialogo dei file. Per ulteriori informazioni, consulta [Elementi del modello di lavoro per i pacchetti di lavoro](build-job-bundle-template.md).

Le seguenti definizioni mostrano una casella di controllo, un intervallo di fotogrammi, un elenco di nomi di telecamere e un elenco di file di input. Il modello elenca `EXPR` perché gli ultimi quattro tipi lo richiedono.

```
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: []
```

In un modello con `EXPR` estensione, ogni parametro ha un tipo di espressione corrispondente: `int``float`,`string`,`path`,`bool`,`range_expr`, o`list[{{T}}]`. Un parametro `RANGE_EXPR` o list può appartenere direttamente a un parametro `range` di attività, in modo che ogni frame o elemento diventi un'attività. For `PATH` and`LIST[PATH]`, `RawParam.{{Name}}` è il valore inviato, come stringa, prima della mappatura del percorso.

```
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 }}"
```

Gli ultimi due argomenti sono espressioni. Un `null` risultato non aggiunge alcun argomento e un risultato di elenco aggiunge ogni elemento come argomento separato. Per ulteriori informazioni, consulta [Espressioni nei modelli di lavoro](build-job-bundle-expressions.md).

Per inviare un pacchetto di lavori che utilizza i tipi di `EXPR` parametri, la CLI di Deadline Cloud e la finestra di dialogo di invio e il monitor Deadline Cloud devono essere una versione che supporti l'estensione. `deadline bundle gui-submit` I clienti più anziani rifiutano i modelli con questi tipi.