Promoting Groups

Edit online

About this task

The Promote function extracts one iteration (instance) of one of the following map components:

  • Group
  • Repeating record
  • Repeating element
  • Repeating composite

Promote is a specialized version of the Split function. For example, if you have a group with 50 iterations and you select Promote, you then have two groups: one group with an iteration of 1 and a group that iterates 49 times.

This function enables you to map unique data from a document and to type a specialized definition. The translator specifies that only one-to-one (no loop) or many-to-many (loop) mapping relationships are valid. The Promote function is available only if a group or repeating record, element, or composite is selected.

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

Procedure

  1. In the Sterling B2B Integrator Map Editor, select an item from which you want to extract one iteration.
  2. In the Main toolbar, click Promote.

Results

The Sterling B2B Integrator Map Editorextracts one iteration (instance) of the looping structure.

Note: Promoting is the same as splitting off one iteration. You can use the Copy and Paste functions (and change the number in the Maximum usage box on the appropriate Properties dialog box of the map component) to accomplish the same task. Depending on the circumstances, you can use the Split or Copy and Paste functions instead.