show / hide menu

Remove Repeater

The ‘RemoveRepeater’ function serves the purpose of eliminating all repeated forms either from an external form or from a specific index within the form structure.

Syntax

RemoveRepeater(ExternalFormName, Index)

Parameters:

  • ExternalFormName: This parameter refers to the name of the external form from which the repeated forms are to be removed.
  • Index: The Index parameter specifies the position or index of the form within the specified external form from which the repeated form is to be removed. It allows for targeted removal of a specific instance of the repeated form.

Functionality:

The ‘RemoveRepeater’ function is designed to facilitate the management and manipulation of form structures within a broader context. It offers the ability to streamline data handling by eliminating redundant or unnecessary repetitions of form instances. This can be particularly useful in scenarios where dynamic or iterative data entry processes are involved, ensuring efficient data organization and processing.

Example:

In the designer:

  • Drag and drop an external form and a button.
  • Configure the navigation form within the external form.
  • Create a rule on the form load trigger: Repeater(ExternalForm1,2). ExternalForm will be repeated based on the count, where the count will be 2.

Figure1: Repeater Rule

Figure2: Attached Trigger for Repeater Rule

  • Create a rule triggered by the button: RemoveRepeater(ExternalForm1,1). This rule removes all repeated forms of an external form starting from index 1.

Figure3: Remove Repeater Rule

Figure4: Attached Trigger for Remove Repeater Rule 

Figure5: Designer

  • In preview, the Repeater(ExternalForm1,2) rule is activated when the form loads. It repeats the external form twice based on a count parameter.

Figure6: Preview- ExternalForm repeated twice

  • In preview, the RemoveRepeater(ExternalForm1,1) rule is activated when the button named ‘RemoveRepeater’ is clicked. It removes all repeated forms of an external form starting from index 1.

Figure7: Preview- Before clicking ”RemoveRepeater”Button

Figure 8: Preview – After clicking the “Remove Repeater” button, the repeated external forms will be removed.