How to use the For-Each function on Cloud Integration Gateway (CIG) Mapping Tool?

The For-Each function works as a looping in the mapping. Follow the steps below to perform the mapping:

1. Click in the repeatable segment on target structure with the right button;
2. Select For-Each;
3. Select the repeatable segment on source structure;
4. Save the mapping.

It is also possible to perform a Inner Loop on the For-Each by adding a Target Position Variable into it. For this, please follow the below steps:

1. Right-click on the For-Each line;
2. Click Target Variable > Add Position Variable;
3. Click field father of the target field;
4. Repeat step 1 and click Add Source Condition;
5. Place the condition on the respect father field on source structure;
6. Click Position Variable > OK.

A source condition can be also set for the For-Each to happen. For this, please follow the below steps:

1. Right-click on For-Each line;
2. Click on Add Condition to For-Each; 
3. Select the segment desired on Source structure;
4. Set the condition based on the business need;
5. Click OK.

Please note that the For-Each function purpose is to create new repeatable structures, and not to update the existing values of a looped structure. This means that the For-Each will only work for non-standardly mapped segments (e.g. PO_EXTENSIONIN for PurchaseOrderExportRequest). If the structure needed is already mapped by standard, then the Position / Variable loop should be used. For more information about how to perform this loop, please refer to Why target field is showing multiple values if I have more than one line item? 

SAP Ariba Buying and Invoicing