Creating Mapping Guidelines (MAGs)

After completing this lesson, you will be able to:

After completing this lesson, you will be able to:

  • Creating a MAG on the previously built MIGs

Create and Edit a Mapping Guideline: Exercise Overview


A MAG (mapping guideline) is a specification of a mapping between a source and target MIG (message implementation guideline). A MAG is used to create a complete mapping at the semantic level that covers the aspects, constraints, and parameters from the source and target MIGs.

After creating the MIGs for both source (eCarHero) and target (eCarHero's supplier), the corresponding MAG with the 'actual' mapping can now be created using the Integration Advisor's (IA) proposal service which offers possible mapping entities that have a very high usage confidence based on actual, productive integration artifacts contributed to the integration knowledge graph.

Task Flow

In this exercise, you will create a MAG using IA's proposal service to map OData to SOAP message format.


You have successfully completed the exercise Create Message Implementation Guidelines.

Create and Edit a Mapping Guideline

Task 1: Create and Edit a Mapping Guideline


  1. Create the MAG.

    1. Choose the Mapping Guideline icon in the left navigational bar and choose Add to create a new MAG.

    2. Select the OData MIG you created in the last lesson as source MIG and choose Next on the bottom right of the screen.

    3. Select the SOAP MIG you created in the last lesson as target MIG and choose Create on the bottom right of the screen.

    4. A notification of the successful execution will be displayed and you are automatically guided to an overview page. You can optionally change the Name or add a Summary about the MAG background and purpose, then navigate to Mapping from the top menu bar.

    5. In the mapping editor, you can now see the data elements of both the source and target systems. Expand all nodes.

    6. In the top right corner of the screen, choose Proposal → Get Proposal to be provided with a mapping recommendation by IA.

    7. You will now see the mapping suggestions in the Mapping List. It is possible to go through these one by one to validate the mapping proposal. In this case, you will select the best proposal available by choosing Proposal → Select Best Proposal.

      Depending on how closely you followed the configuration instructions you might receive a different mapping or no mapping at all. This is because the data from which the IA draws within the trial is extremely limited. This will not happen in a productive tenant and more extensive mappings will be available. Nevertheless, if this is the case in your trial, perform the mapping manually.

    8. Take a look at the provided mapping.

    9. When using the IA proposal service, you can also adapt the mapping. For this, select any node from the source structure and drag your mouse to the corresponding node in the target structure. For example, select IncotermsVersion from the source structure and map it to IncotermsVersion on the target structure.

    10. Perform additional mappings at your leisure, depending on what you deem important for the scenario. You also have the option to perform supplementary operations during the mapping if necessary, for example, converting date formats. This is not needed in this lesson.

    11. Choose Save to secure your progress.

Summary of the Lesson: Creating Mapping Guidelines (MAGs) and Related Resources


You have successfully created a mapping guideline for the PO OData to SOAP scenario. This mapping can now be exported and added to your iFlow.

Further Reading

You can find more information about MAG creation in the following blog:

Related Resources

Read the blog Integration Content Advisor: Create a Mapping Using MAG Editor for more information on MAG creation.

Save progress to your learning plan by logging in or creating an account

Login or Register