Promoting Groups and Repeating Segments

The Promote function extracts one iteration (instance) of a group or repeating segment. For maps, this enables you to map unique data from your application file, and/or enter a specialized definition. For forms, it also sets the promote flag and places the active elements in the parent frame.

For maps, Sterling Gentran:Server® specifies that only one-to-one (no loops) or many-to-many (loop) mapping relationships are valid. For more information on this action, see the Application Integration tutorials.

Note: The Promote function is only available if a group or repeating segment is selected.

Tip: You can use the Copy and Paste functions (and change the number in the maximum usage box) to accomplish the same task. However, Promote is a specialized function that guarantees the integrity of your EDI structure. Depending on the circumstances, you may want to use the Split function or Copy/Cut and Paste functions instead.

Use this procedure to promote a group or repeating segment.

Select the group or repeating segment from which you want to extract one iteration.
Click Promote on the Main Toolbar.
This extracts one iteration (instance) of the looping structure.