Data Repeaters
  • 03 Jan 2024
  • 6 Minutes to read
  • Dark
    Light

Data Repeaters

  • Dark
    Light

Article summary

Overview

Feature Details

Introduced in Version

Modified in Version

8.18

The Data Repeater is a Form Control that shows the data in a tabular format directly from the user-defined Data Structure. Data Repeater can be configured to give users full control over the data, allowing them to create new rows, modify existing ones, and delete rows as required. This flexibility ensures efficient data management and customization within the Data Structure, enhancing the overall user experience and data manipulation capabilities.

The following video demonstrates the core functionality of Data Repeater, where the user adds a new Row to add an Item.


Data Repeater Use-Case in an Inventory Management System

In an inventory management system, the Data Repeater control can be used to handle product inventory data, providing users with comprehensive control over their inventory.

View Inventory Data: The Data Repeater will display a list of products in the inventory, with each row representing a specific product's details, such as name, SKU, quantity, and price. Users can quickly scroll through the list to view and analyze the available inventory.

Update Product Information: Users can edit and update product details by selecting a row within the Data Repeater. They can modify fields like quantity, price, or product description, ensuring real-time synchronization with the underlying data structure.

Add New Products: The Data Repeater allows users to add new product entries on the fly. Users can click an "Add Product" button or similar control, which generates a blank row within the Data Repeater. They can input the necessary information for the new product, such as name, SKU, and price.

Delete Products: Users can remove product entries directly from the Data Repeater. Selecting a row and utilizing a "Delete" button or similar functionality removes the corresponding product's information from the data structure, ensuring accurate inventory management.

Related Information:

Following are a few example lab articles for reference, 


Data Repeater Settings

The following table describes all the settings available in the Properties Panel for the Data Repeater Form Control.

Data Repeater Setting Name

Description

Selection Type

Modifies the visual indicator that separates a selected line item from the unselected. It is highly recommended to use a Selection Type for easier reading of the Data Repeater by the end-user, especially if the Designer anticipates large data.

  • None: No visual indicator separates the selected line item.

  • Visual Indicator: A bar to the left of the Repeater appears next to each item, and its color changes to the assigned color when selected.

  • Line Number: Each line number added is successively enumerated.

  • Highlight Row: The selected row gets highlighted with the assigned color.

Is Read Only

Displays the data within the Repeater as an uneditable list.

Auto Add New Row 

When enabled, it opens a new field to specify a Form component. Once the end-user hits the Tab key on the specified component, a new line item is added in the end.

Insert Row on FocusOut From

Specifies which component spawns new rows if the user enters the Tab key.

Show Separator

Enabled by default, this setting automatically generates a line break between line items when adding a new line item. Disabling this removes these line breaks.

Override Required Message

Allows the Designer to customize the error text displayed when an end-user attempts to submit missing required data in the component.


Short Key Set-Up 

Promotes smoother navigation and accessibility of the Repeater by assigning hotkeys for movement between line items. Up and Down arrow keys are usually assigned for their respective movements.

Add Button

If the ‘Data Repeater Add Button’ control is used in the Form. This will allow you to pick the button for this specific Data Repeater.

Remove Button

If the ‘Data Repeater Remove Button’ control is used in the Form. This will allow you to pick the button for this specific Data Repeater.


Form Controls Used in Conjunction with Data Repeaters

Data Repeaters can be configured to let end users add or remove a data row. This can be done using the following Form controls in conjunction with the Data Repeater.

Control Name

Description

Data Repeater Add Button

This is a Form control button which, when clicked by the end users, will add a new row to the Data Repeater.

This Form control will not add a new row in between of two rows, this will only add at the bottom of the data view.

Data Repeater Remove Button

This is a Form Control Button which, when clicked by the end users, will remove any of the selected rows from the Data Repeater.

Remove Data Repeater Row

This control is availbale in v8.18 and above

This is an alternative option to the ‘Data Repeater Remove Button’. The only difference is this Form Control works independently of the row selection. This is a button type control that gets added with each row of the data repeater where users can click on this button to remove that respective row from the data repeater.

This control is not located in the toolbox of the Form which host the Data Repeater, but it is located in the toolbox of the source of the Data Repeater.

Click on the Edit Source → Toolbox → User Controls → Remove Data Repeater Row.


Example

In this example, a Data Repeater Form Control will be created and added to a Form. The example Data Repeater will populate a list of Accounts with options to add and remove data.

  1. In the Flow Designer, add a Get All step from the INTEGRATION > INTERNAL SERVICES > ACCOUNT SERVICES category. This step is going to populate the Data Repeater with existing information.

  2. After the Get All step, add a Show Form step from the FAVORITE STEPS category. Select PICK OR CREATE FORM and create a Form.

  3. In the Toolbox, navigate to the USER CONTROLS category. Drag and drop a Data Repeater, Data Repeater Add Button, and a Data Repeater Remove Button onto the Form.

  4. In the Properties panel of the Data Repeater, select PICK OR CREATE SOURCE. Select Create New and create a new Data Repeater control.

  5. Click outside the Form surface to open the Properties Panel of the Form. In the Properties panel of the Repeater Control editor, navigate to FORM DATA > Input Type, and select PICK. Search for and select Account.

  6. Open the Toolbox panel on the left-hand side of the Designer. Drag and drop the Text Box control onto the Form. 

  7. From the Properties panel of the Text Box Control, click Pick From Data located under the Data Name field box. Select EmailAddress from the Pick Data dialog box. 

  8. Save and Close the Repeater Designer.

  9. Back in the Form Designer, in the Properties panel of the Data Repeater, select Visual Indicator for the Selection Type

  10. Under INPUT DATA > Add Button, select DataRepeaterAddButton.

  11. Under  INPUT DATA > Remove Button, select DataRepeaterRemoveButton.

  12.  Under Common Properties, type "Account Email" for the Data Name.

  13. Save and close the Form Designer. Back in the Flow Designer, select the Show Form step. 

  14. In the Properties panel under INPUTS > Account Email, choose the output of the Get All step, "GetAll1_Output". Select Ignore for the selected Account Email List.

  15. Select Debug in the top action menu. 


Debug

  1. Select Start Debugging. The Form that holds the Account Repeater Control is displayed.

  2. Practice adding and removing data. Select the Submit button to apply the changes. These added Accounts are not automatically saved. The Outcome Data from the Data Repeater Control lives only within the current Flow execution and can be used for testing. To add data to the User-defined data structure, refer to Data Structure CRUD Overview.

  3. Select View Input/Output Data on the Show Form step to see the list of Emails. The Data Repeater automatically updates or refreshes when records are added individually.


Feature Changes

Description

Version

Developer Task

Added a new control that allows users to add the Remove Button on every row of the data repeater.

8.18

[DT-039306]


Was this article helpful?