You are here: Case management > Building a form > Adding a repeating group of fields to a form

Adding a repeating field group to a form

Add a repeating field group to a form to store the values of a list of related fields in a page list data structure.

For example, you can capture a list of names and addresses from your work history in the Previous Employers repeating field group.

To add a repeating field group to a form:

  1. Open a case type in Case Designer, and click a step in a stage.

  2. Click Configure form to open Form Builder.

  3. Click + Add field.

    In the autocomplete field that is displayed, enter a unique label.

    Do not use px, py, or pz prefixes in a label because they are reserved.

  4. From the first drop-down list that is displayed, select Field group (repeating).

  5. Optional: Add fields to the repeating field group, by reusing properties in an existing class or configuring an advanced data reference.

    ClosedTo reuse properties from a class:

    1. Click the gear icon.

    2. Clear the value in the Data type field.

    3. Press the Down Arrow key and select the name of a class.

    4. Click OK.

      The properties in the class are displayed as fields on the form. You can reorder or remove them as needed.

    ClosedTo configure an advanced data reference:

    Tip: Follow these steps when the data reference is sourced by a data-page list that accepts parameters.

    1. Click the gear icon.

    2. Clear the value in the Data type field.

    3. Press the Down Arrow key and select the name of a class that has at least one data-page list defined.

    4. Select the Is this a data reference? check box.

    5. In the Select the source list, select the name of a data-page list.

    6. Enter values in the fields that are displayed in the Parameters section.

    7. Click OK.

  6. Click + Add field to [repeating field group].

  7. Configure the single-value field. See: Adding a field to a form.

  8. Repeat steps 6 through 7 to add more fields to the field group.

  9. Click Submit.

At run time, users interact with your repeating group of fields based on your selected display modes. The visual appearance of each field and how its value is validated are determined by the field type.

Values from each group of fields are stored in a page list property in the [Your organization]-[Your application name]-Data-[Repeating field-group name] class.

Related Topics Link IconRelated information

Open topic with navigation