Save Forms and Form Properties

In Forms Builder individual Fields and/or Components are assembled in the Layout pane and saved as a Form. Forms are then grouped into sequences. End users view the saved sequences.

To create a form:

  1. Access the Form Designer workspace.

  2. Click the New Form button.

  3. Select the number of Columns you want to use for each row on the form.

  4. Drag one or more Fields or Components into the Layout pane. Position the Fields/Components in the selected column/row grid.

  5. Select or specify values in the Control Property Settings pane for each Field/Component. For more information, see Fields and Components.

  6. Select or specify values in the Form Properties pane. For more information, see Form Property Settings.

  7. Click Save Sequence. The Unsaved Changes dialog is displayed.

Unsaved Changes Dialog

Each form in a sequence has a Form Name and optional properties such as Title, Description, and End State. You specify these properties in the Unsaved Changes dialog when saving a form.

Unsaved Form Changes

  1. Specify a Form Name (required).

  2. Specify the Title (optional) you want users to see on the webpage when the form is rendered.

  3. Specify a Description (optional) that helps you identify the form.

    The Form Name, Title, and Description are displayed in the Sequence List and can be used as search and filter criteria.

  4. Select the End State (optional) check box if the form is used as a Confirmation form in a sequence. See Welcome and Confirmation Forms.

  5. Click Save.

The form is validated before it is saved. For more information, see Validation on Form Save.

Form Property Settings

You can assign additional form properties in the Form Property Settings pane which is displayed when:

  • A form is loaded from the Forms fly-out tab.

  • A form title is clicked above the Layout pane.

    Form Properties

Form Property Settings
Property Required Description
Form Name Yes The Form Name will be the name of the State in a workflow. The Form Name is not editable after the initial save. Specify the value in the Property Settings pane or in the Unsaved Changes dialog.
Id Yes Globally unique identifier (GUID) for the form. It is automatically created by Forms Builder.
Title No Displayed at the top of the form when the form is rendered. Specify the value in the Property Settings pane or in the Unsaved Changes dialog.
Class No CSS class (or space separated classes) specific to the form. The class must be defined in a Renderer CSS file. For more information, see Custom Styles.
Description No This is a convenience field to describe a form. Specify the value in the Property Settings pane or in the Unsaved Changes dialog.
End State No Set to false (cleared) by default. Specify the value in the Property Settings pane or in the Unsaved Changes dialog.

If you select this check box, the form will be available in the list of End State forms for a sequence. Clearing the check box does not affect sequences where the form is defined as an End State form. This only adds or removes it from the End State form list in Sequence Designer. For more information, see Welcome and Confirmation Forms.

Include in View Summary Yes Set to true (selected) by default. If the View Summary component is present in a sequence, the form will be included in the forms rendered by the component. Clear this check box if you do not want to include this form in the View Summary.

Forms Builder 3.4 and later provides enhanced validation when saving a sequence. A sequence cannot be saved if at least one form in the sequence has a View Summary component, but the Include in View Summary property is not selected on any of the forms in the sequence.

Form Tag Management No Use this field to create a tag or associate an existing tag with the form. The assigned tags are available for selection in the Forms flyout and make it easier to locate forms.

To create a tag, type the tag name in the Form Tag Management field, click Add Tag, and save the form.

Form Tag

To find a tagged form, on the Forms fly-out menu, click the Select Form Tags to Search field, and select a tag. The tag will be used to filter the list of forms.

Find Form Tag