Skip to Content
Product Information
Author's profile photo Deepak G Deshpande

Importing Message Mapping from ES Repository in SAP Cloud Integration

UPDATE: With SAP Cloud Integration version 2.40, you can also import Service Interfaces from ES Repository.

 

UPDATE: With SAP Cloud Integration version 2.39, you can also import Operation Mappings from ES Repository. For more information, see documentation

 

SAP Cloud Integration version 2.37 onwards comes with new enhancements for message mapping. Going forward, you can import your message mapping resources from Enterprise Service Repository (ES Repository).

Note: ESR version 7.3 and onwards is supported.

Here’s how you can configure the ES Repository and import message mapping resources.

 

Configuring Cloud Connector

The first step is to configure SAP Cloud Connector with on premise ES Repository. Cloud connector is an installable application that allows you to establish communication between on premise and cloud applications. To know more about SAP Cloud Connector, see https://help.sap.com/viewer/cca91383641e40ffbe03bdc78f00f681/Cloud/en-US/e6c7616abb5710148cfcf3e75d96d596.html

Connecting to the ES Repository

The Settings section of SAP Cloud Integration comes with a tab where you can configure connection to ES Repository. You need tenant administrator role to access this. If you are not a tenant administrator, you can contact your tenant administrator to obtain that role or ask your administrator to configure this. You need to provide information for the ES Repository connection. In this case, you connect to the ES Repository through the cloud connector as you are connecting from a cloud application (SAP Cloud Integration) to an on premise application (ES Repository).

Here is the sample screenshot of ES Repository settings:

 

Name: Any custom name to identify the connection name for your reference.

Address: URL configured in the cloud connector which connects to the ES repository.

Credential Name: It is an alias, deployed in the via the SAP Cloud Integration Operations (Monitor) view -> Manage Security Material. Sample screenshot of the same below

Location ID: It is the location ID information provided in your cloud connector configuration

 

Integration Flow Project

Once the ES Repository configurations are completed, you can import the message mapping resources from your ES Repository. Here’s how you can do it:

Create a new integration flow or edit an existing integration flow project. In the Resources view, select Add -> Mapping -> Message Mapping.

 

This opens Add Message Mapping dialog.

Source will be ES Repository by default. The other fields (Name, Address and Location ID) will be displayed in read-only mode and these values are from the ES Repository settings configuration.

Note: If no value for Location ID is provided in ES Repository settings tab, this field will not be shown in Add Message Mapping dialog

Click Connect. It will make a call to configured ES Repository system and fetch all the message mappings.

 

Select the row of message mapping which you want import and then click Select.

A summary dialog will open with the resources which will be imported/added along with message mapping.

 

Click Add.  It will import/add all the resources in the Integration Flow Resources view.

 

You can now add a new message mapping integration flow step (or use the existing message mapping flow step of your integration flow project) and assign the imported/added message mapping, ‘abcd’.

 

Click on abcd.mmap. It will open the Message Mapping editor where you can make changes, if required.

 

Summary

With 2.37 version of SAP Cloud Integration, the new feature of importing message mapping resources from ES Repository is available. You can now reuse the existing mappings in your ES Repository directly by importing them.

 

Assigned Tags

      38 Comments
      You must be Logged on to comment or reply to a post.
      Author's profile photo Siva Chandolu
      Siva Chandolu

      Hello Deepak,

      Thanks for the blog.This is a nice feature to import ES repository contents from the iFlows.

      Would there be any possibility to configure the message mapping dynamically based on xpath expression in the iFlow?

       

      Regards,

      Siva

      Author's profile photo Deepak G Deshpande
      Deepak G Deshpande
      Blog Post Author

      Hi Siva,

      1. Are you looking for message routing to a particular message mapping via xPath? Or
      2. Mapping definition based on xPath?

      Can you kindly elaborate your question?

       

      Thanks

      Deepak

      Author's profile photo Siva Chandolu
      Siva Chandolu

      Hello Deepak,

      I am referring to 2nd point "selecting Mapping definition based on xPath".

       

      Regards,

      Siva

      Author's profile photo Deepak G Deshpande
      Deepak G Deshpande
      Blog Post Author

      Hi Siva,

      Need more info, I am not able to get your statement of "select mapping definition based....". Is it possible for your to explain your requirements in detail with a sample content?

       

      Thanks

      Deepak

      Author's profile photo Tobias Träger
      Tobias Träger

      Hello Deepak,

      will it be possible to upload mappings also from the filesystem or import them from other iFlows?

      Currenty I see only the ES Repository option.

       

      Regards

      Tobias

      Author's profile photo Deepak G Deshpande
      Deepak G Deshpande
      Blog Post Author

       

      Hi Tobias,

      As of now we have enabled import from ES Repository. In future releases, we will enable the support from importing/copying from other iFlows as well.

      Import from file system needs dependent resources like wsdls, xsds etc (which are used in the mapping source/target) to get uploaded along with message mapping. We will work on the feasibility and update you in upcoming releases.

       

      Thanks

      Deepak

      Author's profile photo Tobias Träger
      Tobias Träger

      Hi Deepak,

       

      alright that would really help.

      We have ERP<->C4C Integration Implementation in HCI with a lot of slighty modified iFlows (mainly because we have 2 ERP Backends connected to 1 C4C).

      I now wanted to update the Mapping of one of the iflows with a newer version from the default iflow, but had no change to do it within WebUI, as I could not upload any mappings.

       

      Regards

      Tobias

       

       

       

      Author's profile photo Deepak G Deshpande
      Deepak G Deshpande
      Blog Post Author

      Hi Tobias,

      If you are using message mapping, you can open the integration flow in edit mode and then you can change the message mapping.

      What is the exact issue you are facing?

       

      Thanks

      Deepak

      Author's profile photo Tobias Träger
      Tobias Träger

      Hi Deepak, yes that way I can manually edit a mapping.

      However this is no option if

      1. I want to "re-import" the updated default mapping of a standart iFlow in my copy of that iflow.

      OR

      2. I want to import a mapping in an iFlow, which was changed and tested on the test tenant and now should be deployed in production.

       

      With eclipse it is easily possible to copy and assign the mapping, as I can copy it in the filesystem.

      However in WebEDI there is currently no possibility to import mappings, as you stated before.

       

      Regards

      Tobias

      Author's profile photo Satish Areti
      Satish Areti

      Hi Deepak

      Thanks for the blog. I'm able to connect to ESR, but getting this error while trying to import the mapping to CPI. Is there anything that I can do to resolve this issue.

      Author's profile photo Anil Yakkali
      Anil Yakkali

      Hello Sir,

       

      Did this error got resolved. Please help me on the solution.

       

      Author's profile photo Deepak G Deshpande
      Deepak G Deshpande
      Blog Post Author

      Hi Anil,

      I request you to raise the ticket for this issue. You can check with your tenant administrator for the component on which the ticket could be raised.

       

      Also, have a look at the document for the restrictions on the mapping imports at https://help.sap.com/viewer/368c481cd6954bdfa5d0435479fd4eaf/Cloud/en-US/e18fc05c3ae04c4bb40f12923aaa908c.html

       

      Thanks

      Deepak

      Author's profile photo Divya Malik
      Divya Malik

      Hi Deepak ,

      I am also getting the same error " Error occure in download resoruces from ESR ssytem. " Where can I see the log or trace to resolve this error.

      I have another question : which user should be mentioned in the ESR user credential section?

      Br

      Divya

       

       

      Author's profile photo Deepak G Deshpande
      Deepak G Deshpande
      Blog Post Author

      Hi Divya,

      I request you to raise the ticket for this issue. You can check with your tenant administrator for the component on which the ticket could be raised.

       

      Thanks

      Deepak

      Author's profile photo Divya Malik
      Divya Malik

       

      Hi Deepak,

      This error got resolved by making changes in the config as per the SAP note 2681589

      Thanks a lot for you blog and guidance

      Br

      Divya

      Author's profile photo Anurag Garg
      Anurag Garg

      Hi Deepak,

      I am calling Value mapping in my message mapping.
      If I import this mm into my CPI-iFlow, where do I need to maintain my value mapping groups?

      IN PI- We maintain them at Integration Directory.

      In CPI- at runtime, how mapping will refer value maps maintained at PI-ID which is there at on-premise?
      Please give me suggestions.

      Thanks,
      Anurag

      Author's profile photo Prasanna Vittal
      Prasanna Vittal

      Hello Deepak,

      In SCPI, under Tenant Settings->ES repository, I tried to remove entries all the fields (Name, address, credential name). But it wouldn’t allow me to save the page. Before I configured this page, the fields were blank. Once we enter values and save, is there no way to remove all the entries and leave all the fields blank?

      Thanks,

      Prasanna

      Author's profile photo Hari Sonnenahalli
      Hari Sonnenahalli

      Deepak-

      Deepak-

      Hope all is well. I am trying to import a mapping which has parametrization defined in the mapping under signature tab. When am trying to import the mapping CPI it is throwing an error saying "Mapping containing parameters are not supported"

      Please let me know if you have seen this before and how to resolve this issue. The note 268159 is outdated as eclipse is unable to install any integration tools.

      Regards

      HS

      Author's profile photo Deepak G Deshpande
      Deepak G Deshpande
      Blog Post Author

      Hi Hari,

      As described in the documentation https://help.sap.com/viewer/368c481cd6954bdfa5d0435479fd4eaf/Cloud/en-US/e18fc05c3ae04c4bb40f12923aaa908c.html, as of now we don't support importing of mappings with parameters.

       

      Thanks

      Deepak

      Author's profile photo Arun Kumar K S
      Arun Kumar K S

      Hi Deepak,

      We are trying to impot operational mapping to CPI but we are facing the below issue:

       

      Cannot import operation mapping *** ; response does not have target message

      Regards,

      Arun

      Author's profile photo Sonam Ramsinghani
      Sonam Ramsinghani

      HI Arun,

       

      Did you find solution to this problem? I am facing same issue while importin operation mapping in CPI.

      Author's profile photo Anita Barge
      Anita Barge

      Hello Deepak,

      Is there any way to import Message Mapping and Operation Mapping from PI ESR to CPI without using cloud connector? Can we do it using forward/reverse proxy from the on premise system?

       

      Thanks,

      Anita Desai

      Author's profile photo Deepak G Deshpande
      Deepak G Deshpande
      Blog Post Author

      Hi Anita,

      As of now, you need to have cloud connector to import mappings from ESR, because the inbuilt connectivity needs it.

      But, we will consider your point and will plan to enhance the support to allow forward/reverse proxy.

       

      Thanks

      Deepak

      Author's profile photo Pavan G
      Pavan G

      Hi Deepak,

      Thanks for the very detailed blog.

      ES Repository setting is greyed out in my CPI tenant.

      I have 'AuthGroup.Administrator' role assigned to my user and Cloud Connector Configuration for PI is completed.

      Please let me know if I am missing something or do I need any specific roles added to my user.

       

      Regards,

      Pavan

      Author's profile photo Deepak G Deshpande
      Deepak G Deshpande
      Blog Post Author

      Hi Pavan,

      The grayed out screen might be due to read-mode. Did you try editing the screen? Meaning, clicking on Edit of the settings tab/Es Repository page, provide values and then save the settings.

       

      Hope it helps

      Thanks

      Deepak

      Author's profile photo Pavan G
      Pavan G

      Thanks a lot, Deepak Govardhanrao Deshpande

      I found the edit key at the right bottom corner.

       

      Regards,

      Pavan

       

      Author's profile photo Vidyadhar Kurmala
      Vidyadhar Kurmala

      Hi Deepak,

      Thanks for your blog and it is nicely explained!!

      After importing the ESR message mapping into CPI, CPI mapping is not allowing to modify the custom UDFs that were developed using PI ESR swing tool.

      I know custom UDFs can be replaced with Java/Groovy Scripts and however do we have any option to modify the custom UDFs that were brought into CPI from ESR?

      Thanks,

      Vidyadhar

      Author's profile photo Deepak G Deshpande
      Deepak G Deshpande
      Blog Post Author

      Hi Vidyadhar,

      As mentioned in the documentation at https://help.sap.com/viewer/368c481cd6954bdfa5d0435479fd4eaf/Cloud/en-US/e18fc05c3ae04c4bb40f12923aaa908c.html , under the Restriction section, the modification of UDFs is not supported.

       

      Thanks

      Deepak

      Author's profile photo Vidyadhar Kurmala
      Vidyadhar Kurmala

      Thanks Deepak for the update!

      Author's profile photo Iddo Rijsdijk
      Iddo Rijsdijk

      I am not able to change the settings in the ES Repository tab. I do have administrator settings on all three levels of SAP Cloud Platform. Can anyone point out which particular authorisation I might be missing?

      Author's profile photo Deepak G Deshpande
      Deepak G Deshpande
      Blog Post Author

      Hi Iddo,

      I think you have not clicked on the Edit button on right bottom corner the Web UI of Settings section.

      The Edit button allows you to edit the section of ES Repository tab.

      Once you provide the details of ES Repository, you need to Save the settings and once you are done editing, you can click on Cancel button to cancel/exit the edit mode. (Save and Cancel will appear on the same place of Edit button, once you click on edit)

      Hope this helps. Let me know otherwise.

       

      Thanks

      Deepak

      Author's profile photo Iddo Rijsdijk
      Iddo Rijsdijk

      Yes I found the button. Who would put the button all the way down there?

      Author's profile photo Bruno Vianna
      Bruno Vianna

      Hello Deepak, thanks for the nice blog!

       

      Is there any blog like this describing, how to import Services interfaces according to the 2.40 update ?

       

      Many thanks

      Author's profile photo Deepak G Deshpande
      Deepak G Deshpande
      Blog Post Author

      Hi Bruno,

      To import ESR/PI Service Interfaces/WSDLs in SAP Cloud Integration, you need to select Resources view of the integration flow, and select Add -> Schema -> WSDL, a dialog gets opened and then select ES Repository in the Source drop-down control. I assume you already know how to configure the ES repository system in the tenant admin settings of SAP Cloud Integration UI.

       

      Thanks

      Deepak

      Author's profile photo Bruno Vianna de Souza
      Bruno Vianna de Souza

      Thanks Deepak!

      Author's profile photo Javier Garcia
      Javier Garcia

      Hello Deepak,

       

      I cannot find in the documentation which directories needs to be available from PO to limit the paths in Cloud Connector to only the ones that are really required, Of course if you allow / Path and all subpaths...  works fine but it is not ideal...

       

      For other products, like the Migration assessment capability, the documentation provides all the paths that are required (https://help.sap.com/docs/SAP_INTEGRATION_SUITE/51ab953548be4459bfe8539ecaeee98d/5f7672334ca74f90843d38375220d757.html)

       

      Could you please provide the ones needed for this functionality?

      Many thanks in advance

      Best regards

      Javier

      Author's profile photo Deepak G Deshpande
      Deepak G Deshpande
      Blog Post Author

      Hi Javier,

      Thanks for the input. The relevant document has been updated with required paths.

       

      Thanks

      Deepak

      Author's profile photo Javier Garcia
      Javier Garcia

      Thanks Deepak,

       

      May I ask you where did you add the information? I cannot find it...

      I believe it should be here:

       

      https://help.sap.com/docs/CLOUD_INTEGRATION/368c481cd6954bdfa5d0435479fd4eaf/53db5fb382b54bba86abb413bd3711a7.html?q=Import%20mappings%20from%20PO

      Or one of the child pages.

      Thanks again

      BR
      Javier