Sottomodulo

Un frammento di modulo riutilizzabile per campi list, campi yaml e pagine di wizard


Un sottomodulo è un frammento di modulo riutilizzabile. Non compare nella vista a riquadri e non può essere inviato direttamente. Viene invece richiamato da:

  • Un campo list: apre il sottomodulo come editor di drilldown per ogni riga
  • Un campo yaml con la proprietà subform: apre il sottomodulo come editor di drilldown per un singolo oggetto
  • Un passo di wizard: mostra il sottomodulo come una pagina del wizard

A reusable form fragment used as the per-row editor of a list field, or as the single-object editor of a yaml field with the subform property.
Subforms are not shown in the tile view and cannot be submitted directly.
They share the same field types and validation rules as regular forms.

Address subform

- name: Address
  type: subform
  fields:
    - name: street
      type: text
      label: Street
      required: true
    - name: city
      type: text
      label: City
      required: true
    - name: country
      type: text
      label: Country
      required: true
- name: My Main Form
  type: ansible
  playbook: site.yml
  roles:
    - default
  fields:
    - name: addresses
      type: list
      label: Addresses
      subform: Address

Proprietà

I sottomoduli non hanno proprietà specifiche del tipo. Usano solo le proprietà comuni dei moduli: name, description, help, type e fields.

Quando un sottomodulo fa da pagina di un wizard, description e help forniscono i valori predefiniti per title e help del passo. Può anche impostare showHelp per espandere quell’aiuto al caricamento della pagina.

Le proprietà di esecuzione (playbook, template, roles, inventory, ecc.) non si applicano ai sottomoduli, perché un sottomodulo non viene mai inviato direttamente.