Welcome > Form Designer module > Form variants > Create a form variant

Create a form variant

See Form variant.

  1. On the Home page, click Form > Form Variant.

    The Form Variant page appears.

  2. Enter a unique Name for the form variant.
  3. Enter an optional Description for the form variant.
  4. In the Form box, consume the form for which to create the variants.

    The version of the form is displayed. By default, the Desktop form factor is selected and all controls on the form including cells and advanced controls, for the desktop form factor appear on the Consume list.

  5. By default, the state of the controls is none, and the label text is empty. To update the state and label text for the controls, do the following:
    1. In the Form Factors group, select the form factor (default: Desktop) for which to update the state and label text of the form fields.
    2. In the Name box, consume the form field.
    3. On the State list, select the state for the control.

      • None (default)

      • Hidden

      • Disabled

      • Mandatory

      • Optional

      • ReadOnly

      The state options vary based on the control. For example, a cell can only have hidden or disabled state.

    4. In the Label Text box, enter the text for the label to appear at runtime (default: empty). For example, enter the label text for a button as Submit. At runtime, the specified label text is displayed.
    5. Click Add .

      The control name along with the state and label text appear in the table.

  6. Click Save.

    A variant is created in a locked state. Each time a variant is saved, a new major version of the variant is created.

    Note

    • If you add controls to the base form, on releasing the form, these controls are automatically added to the variants of the form. The state of these controls is none, and label text is empty.

    • If you remove controls from the base form and release the form, the controls are automatically removed from the associated form variants and a new version for each updated form variant is created.

    • On exporting a form or package, the form variants are also exported.

    • On importing a form or package, a form variant is only imported if it is of higher version than the one existing on the system.

    • On upgrading TotalAgility, the variants are available for all the associated forms.

    • When deleting a form, all the associated form variants for the form are deleted.