Repeat settings
Form Builder supports grids and sections with repeated content.
- With grids, you can repeat a single row (which is the most common case), or multiple heterogeneous rows (with different controls).
- With sections, you can repeat the entire content of the section a number of times.
Both repeated grids and repeated sections have repeat settings in the "Section/Grids Settings" dialog's "Repeated Content" tab.
Repeated Content
Select this checkbox to enable repeated content. This enables a series of detailed options below in the same dialog.
[SINCE Orbeon Forms 2019.1]
By default, the form user is allowed to add, remove, or move repetitions. To disable this behavior, deselect the "Allow the user to add, remove, or move repetitions" option. When the checkbox is deselected, the user does not have direct access to buttons, icons or menus to change repetitions.
Allow the user to add, remove, or move repetitions
When this option is deselected, the minimum, maximum and frozen repetitions settings do not apply.
Deselecting this option makes sense in particular when the number of repetitions:
- is defined at design-time,
[SINCE Orbeon Forms 2021.1]
For grids only, selecting this option automatically shows a row number at the beginning of each grid repetition.
Show repetition number
This is how the repetition number appears at runtime.
Repetition number at runtime
These settings can be predefined numbers or formulas when selecting "Other". Here is an example of using a firmula for the maximum number of repetitions.
Formula for the maximum number of repetitions
[SINCE Orbeon Forms 2018.2]
This setting can be a predefined number or a formula.
This allows freezing the first N iterations of a repeated grid or repeated section. Frozen iterations cannot be removed or moved by the user. The grid menus and buttons reflect that those operations are not possible.
The number of frozen iterations must be at most the minimal number of repetitions. If that's not the case, the number of frozen iterations will be reset to the minimal number of repetitions.
[SINCE Orbeon Forms 2019.1]
When selected, this enables a simplified appearance for a repeated grid or section.
The default is the "full" appearance, which features:
- visible borders
- menus for inserting, removing, and moving rows
When enabled, the simplified (or "minimal") appearance features:
- no visible borders
- no ability to insert a new row at a specific position
- no ability to reorder rows
- simple buttons/icons to add/remove rows
Before Orbeon Forms 2019.1, the simplified appearance was available but only controllable via a property. See Appearance of repeated grids and Appearance of repeated sections.
[SINCE Orbeon Forms 2016.1]
The "Apply initial value formulas when adding iterations" option specifies whether the "Initial Value" formulas for controls within the grid are evaluated for new iterations.
With the option enabled, new iterations can have dynamic initial values:
Initial Values
With Orbeon Forms 2016.1, the option is enabled by default for new forms and new repeated grids. The option is disabled by default for grids created with previous versions of Orbeon Forms.
[SINCE Orbeon Forms 2016.1]
The "Initial Number of Iterations Uses Template" option specifies, when an enclosing repeated section creates a new iteration, how many iterations this repeated grid will contain:
- when enabled: the number of iterations shown in Form Builder (which can be no iterations at all, one iteration, two iterations, etc.)
- when disabled: exactly one iteration
The following screenshot shows a case with a repeated grid within nested repeated sections. At first, when the form shows, there are two iterations of the repeated grid.
With the option enabled on the grid, adding a new iteration of Repeated section 2 causes the new iteration to contain a new repeated grid with two iterations:
While, with the option disabled on the grid, adding a new iteration of Repeated section 2 causes the new iteration to contain a new repeated grid a single iterations:
[SINCE Orbeon Forms 2019.1]
This option can be selected only when the "Allow the user to add, remove, or move repetitions" option is deselected.
Last modified 2yr ago