Subform

Un fragmento de formulario reutilizable para campos list, campos yaml y páginas de asistente

---

Un subformulario es un fragmento de formulario reutilizable. No aparece en la vista de mosaicos y no se puede enviar directamente. En su lugar, se hace referencia a él desde:

• Un campo list: abre el subformulario como editor de detalle para cada fila
• Un campo yaml con la propiedad subform: abre el subformulario como editor de detalle para un único objeto
• Un paso de wizard: muestra el subformulario como una página del asistente

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

---

Propiedades

Los subformularios no tienen propiedades específicas de tipo. Solo usan las propiedades comunes de los formularios: name, description, help, type y fields.

Cuando un subformulario sirve como página de un asistente, su description y su help dan los valores predeterminados del title y el help del paso. También puede definir showHelp para desplegar esa ayuda al cargar la página.

Las propiedades de ejecución (playbook, template, roles, inventory, etc.) no se aplican a los subformularios, porque un subformulario nunca se envía directamente.