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. After you add a repeating field group to a form, you can reuse it on other forms in your case type.

To add a repeating field group to a form:

1. Open a case type in Case Designer.

2. On the Life cycle tab, click an assignment or an approval step.

3. Click Configure view.

4. 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.

5. From the first list that is displayed, select Field group (list).

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

   To 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.

   To 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.

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

8. Configure the single-value field.

   For more information, see: Adding a single-value field to a form

   Note: You cannot reuse the single-value fields that you define in a repeating field group on other forms.

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 information

Open topic with navigation