How to: Configure a Repeater Block

Release 4.11 introduces a new type of structural block in the EForm Designer: The Repeater Block. This type of block is used for simple multiplicity structures in EForm design, for example a list of attendees on a Meeting eform. Repeater Blocks will duplicate their contents as many times as needed to enter a list of items into a record. Lines can be added or removed as needed by using the new hovering control panels on the right and bottom of the block.

repeaterblock

Adding a Repeater Block into an EForm is much like adding a normal block. Drag from the Repeater Block bucket and drop it in the desired order on the form.

drag

Next using the Controls editor, add the controls required for a single line on the block:

config

Note: It’s important to remember that any data fields that are used in the Repeater Block have their Header flag set to ‘No’.

The Repeater Block has additional properties for Initial Row Count (the number of rows that a block should show for new records) and Maximum Height (the largest height a block can reach before it begins scrolling).

When you’re finished, open up the Preview tab to view the results.

runtime

The Repeater Block has special controls for adding and removing rows. At the bottom of the block there are two ‘+’ buttons. The first adds a single row to the bottom of the block, while the second adds 5 rows. The red ‘x’ button removes the bottom row. When mousing over a specific row, a second control panel appears on the right side of the row, allowing users to add a row above the current one, or remove the current row.

Repeater Blocks are useful for storing multi-line data in forms where it is unclear how many lines of data are required, as they allow any number of lines to be entered.

Related Articles