Skip to Content

Introduction

SAP Cloud Platform Integration version 2.40 improves message mapping with multi mapping feature. Multi mapping enables you to use more than one message in the source or target of your mapping.

Let us understand multi mapping further with a simple integration flow.

Clicking on the resource link (MultiMappingDemo.mmap in this case) opens the message mapping editor

It already has one message in the source and target message structures.

Click on the pen icon to Edit message for source and/or target

 

This opens up the source and target messages editor. If you have already worked with it, you might observe the below changes

  1. Add icon ‘+’ has been introduced, to add more messages
  2. Occurrence table column has been introduced, to change the occurrence of message
  3. Action column has been introduced with
    1. Icon to Replace the message
    2. Icon to Delete the message

 

Occurrence

You can use the occurrence column to change the occurrence of the message. By default, the occurrence ‘1..1’ shall be selected. If you select the occurrence ‘0..1’ or ‘1..n’, the multi mapping for this message shall be enabled. For example, set the message occurrence to “0..1” click on OK header action. Go back to message mapping editor.

 

 

You will now observe the root element of the message is enclosed with ns0:Messages and ns0:Message1 elements as shown in the below screenshots. This indicates multi mapping.

 

The similar structure could also be observed in the target side as well.

 

Multiple Messages

Multi mapping is also enabled when you select more than one messages as the source or target in your mapping. Consider the same example of source and target message editor. Click on ‘+’ icon at Source Message and select a schema file.

 

Once the schema is added, you observe the same in source messages list shown below

 

 

Now, click OK. It will take you to the message mapping editor.

 

You can observe that elements for multi mapping has been populated in the source message with ns0:Messages root element and ns0:Message1 for existing EmployeeDetails element along with ns0:Message2 for newly added schema’s Levels element

Now, you can perform the required mapping definition for the multi mapping elements as per your scenario.

Note: Multi mapping support for EDMX is not enabled.

To report this post you need to login first.

1 Comment

You must be Logged on to comment or reply to a post.

  1. Eng Swee Yeoh

    Hi Deepak

     

    Thanks for sharing this update. This functionality was one of the few gaps that made us still needing to develop some integration in Eclipse. Glad to know this is now available.

     

    One question on the multimapping feature – when using a 1-N mapping, the mapping requires the source to have the Messages & Message1 elements. In PI, this is automatically handled during runtime, e.g. the actual payload do not need to have those elements. However in CPI, this doesn’t seem to be automatically handled, and we have to add a script before the multimapping step to wrap the payload with those elements. Any idea if this could be enhanced to handle it automatically?

     

    Regards

    Eng Swee

    (2) 

Leave a Reply