Splitting Groups

About this task

The Split function enables you to split (break) the following objects into two loops:

Group
Repeating record
Repeating element
Repeating composite

If you split a group (or any one of these map components), the individual iterations of the two groups that you created by splitting a group add up to the original number of iterations of the group before being split. For example, you might have a group with 50 iterations. You could split that group into two groups: one that iterates 20 times and one that iterates 30 times.

Use the Split function when you need more than one instance of a map component that occurs multiple times. The Split function is available only if a group or repeating record, element, or composite is selected.

To split a group or repeating record, element, or composite:

Procedure

In the Sterling B2B Integrator Map Editor, select an item from which you want to extract one iteration.
In the Main toolbar, click Split.
In the First Loop Entries box, type the number of iterations that you want the group or repeating record, repeating element, or repeating composite to split.
The number you type must be greater than zero and less than the maximum number of iterations of the loop.

For example, if the X loop repeats a maximum number of five times, and you type 2, the resulting split generates one X loop that repeats a maximum of two times and a second X loop that repeats a maximum of three times.
Click OK to complete the split.
Note: You can use the Copy and Paste functions (and then change the number in the Maximum usage box on the map component's Properties dialog box) to accomplish the same task.