Repeating section

Use the Repeating section form control to allow form users to add multiple instances (repeating rows) of that section. The Repeating section control contains a set of other controls that can be repeated as necessary. This control is useful when you want to collect multiple instances of the same type of data. For example, you can use a Repeating section on an order form with multiple order items in which each row is an order item.

When you insert a Repeating section control to a form, it is an empty container until you insert other controls inside of it. You can insert a Repeating section inside another Repeating section, if required.

If you add a Repeating section control to a form, you can also reuse it as a start event variable by dragging and dropping it onto a task form. You can adjust the layout and format of the reused repeating section so that it looks the same as it did on the original form and you can add non-input controls, such as Group, Image, and Space controls (the input controls, however, are read-only). You can also reuse a nested Repeating section. This feature allows you to use collection variables created in forms in other task forms in the workflow. The data that is collected in the Repeating section control can be easily reused and displayed in a task form for an assignee. For example, an equipment order start form with a repeating section used to capture item numbers, descriptions, and quantities can be reproduced on a task form so that the order can be approved or further processed.

The Repeating section control includes functionality to compute row-based calculations. The controls in a Repeating section are available as an Object variable that contain the following variables:

  • Collections of all of the controls that are within the Repeating section.
  • An Object type variable that includes properties for each control within the Repeating section that can be inserted into row-based calculations inside a repeating section row.
Important: 
  • Designers can use the Current Row number variable to add row numbering in Repeating Sections and nested Repeating Sections. The Current Row number variable is useful for row-based calculations and can be utilised in Rules as well. To select the variable, go to the Repeating Sections object variable > Current row > Row number

  • Use the Loop for each action to repeatedly run a set of child actions in a Repeating section.

Fields and settings

Section Setting Description
(unlabeled) Title

Field title displayed on the published form.

 

Customize

Switch toggle to Yes to enable customization of the variable Name of the form control.

 

Name

(This field becomes configurable only when you switch the Customize toggle to Yes.)

Customizes the name of the variable A placeholder that stores changes each time the workflow runs, such as the information entered in a form, or the name of a file. You can also create variables to store information you use in the workflow, such as an email address. for the field. If the name is not customized, the Title will be used as the variable name.

 

Visible

Options to show or hide the field in the form.

  • Yes: Displays the field on the form.
  • No: Hides the field on the form.
  Show header

Select Yes or No to specify if you want to display a header for the control on the published form.

  • Yes: Displays the header for the control on the published form. The header text can be defined in the Header text field that becomes available in the configuration panel after you select Yes for Show header.
  • No: No header is displayed for the control on the published form.
 

Header text

(Becomes configurable only when you enable Show header.)

The header text to display for the control on the published form.

 

Formatting options

(Becomes configurable only when you enable Show header.)

Formatting options for the header.

  • Header background: Displays a background for the header.
  • Divider line: Adds a line between the header and the controls contained in the Repeating section control.
  Default number of rows The number of rows to be displayed on the published form by default.
  Minimum number of rows The minimum number of rows to be displayed on the published form.
  Maximum number of rows

The maximum number of rows that can be displayed on the published form.

The Add new row button will be disabled on the published form when the maximum number of rows are added.

  Add row button label Text to display in the add row button.
 

Alternate row color

Switch toggle to Yes to apply a color to alternate rows.

Styling CSS class

Add a CSS class to apply a style to this form control. You can create the CSS class in the CSS code editor in form styles. Enter one class name or multiple class names separated by a space.

For more information, see Add a custom CSS to individual controls.

Note: The CSS Class field is available only if the Custom CSS setting is enabled in Nintex Automation Cloud Form settings.

Border color

Border color to apply to the field.

To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code.

To revert back to the global style, click Reset to global style.

  Background color

The color to fill the background of the field.

To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code.

To revert back to the global style, click Reset to global style.