Repeating Group Element Properties

A Repeating Group is a group containing repeating elements.

Repeating Groups can be nested (a Repeating Group within a Repeating Group) to support structured data. For example, controls such as repeating tables are bound to repeating group.

When working with Repeating elements of any type (i.e., Repeating Groups and/or Repeating Tables) within a Web Service or elsewhere, ensure the following:

  • Any field within a Repeating Content folder within the Form Data tree is also in the form within a repeating container.

  • All non-repeating fields in the Form Data tree are non-repeating in the form.

Departing from these guidelines may result in unintended behavior while working with repeating elements when running a Web Service.

Back to Form Elements

Related topic: Element Properties

Name

Description

General Settings

Name

The (internal) name for the repeating group.

Read Only

Sets the group to read only (true) or not read only (false).

Columns

The number of columns in the group. Default value is 1.

New Item Location

The location of the (+) Add new item button. Default value is “Top Right.”

Enable Excel Operations

When set to True, this displays available Excel operations to the form user (Export and Upload to Excel) so data can be uploaded to the form from an Excel file present on user's local PC. Default value is False.

  • Export outputs the contents of a repeating table or group to an Excel file.

  • Upload uploads the data into an Excel file.

Excel Upload Operations:

Will be visible only when Enable Excel Operations is set to True. Displays the following available upload options (as radio button selectors) for the form user at run-time:

  • Replace: This will replace the entire contents of the table or group.

  • Update: This will update each row/field while preserving any additional rows already within the table or group.

  • Append: This will preserve all existing rows and append the new content to the end of the table or group.

Enable Validation Results

Displays a Validation link to the user. Clicking Validation will display the number of validation errors found in the Repeating Table/Group. This is typically used with the Paginate Content (see below) property to find validation errors in large tables. Default value is False.

Column Span

The number of columns the group will span. Default value is 1.

Paginate content

Set to False, content in the table will be displayed in a single page. Set to True, content will be paginated according to the Row Count setting. Default value is False.

Row count

Lets you specify the number of rows while paginating content. Works only when Paginate content is set to true. Default value is 10.

Propagate Changes to all Views

When you change style or properties for common labels in a form with multiple views, you will be prompted by a dialog box asking if you want to apply the changes to all views. You can propagate such changes automatically by setting the Element Property Propagate Changes to All Views to True. This automatically propagates style or property changes to all applicable views without prompting.

Group Styles

Border Width

The width of the border around the group. Possible values are None, Thin, Thick, Thicker, and Thickest. Default value is None.

Border Style

The style of the border. Possible values are None, Solid, Dashed, Dotted, Double, Groove, Ridge, Inset and Outset. Default value is None.

Border Color

The color of the border.

Background Color (Even Rows)

The background color for the even rows.

Background Color (Odd Rows)

The background color for the odd rows.

Advanced Settings

Key Column for Merging

This drop-down will contain a list of all fields contained in the Repeating Table/Group. Setting this 'key' will cause the form to perform a merge each time the table data gets updated, but only fields that are actually changed by the user are updated.

The value of the key should be the name of one of the table columns . Each row must have a unique key value. The key value indicates which column contains the key (for example, my:partnumber).