Skip to Content
Product Information

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

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.



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.


You must be Logged on to comment or reply to a post.
  • 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?




  • 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.





      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.




      • 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.







          • 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.


            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.




  • 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.

  • 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?






    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



  • 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.


  • 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?



  • 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.



  • 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?



    Anita Desai

    • 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.




  • 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.




  • 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?



  • 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?

    • 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.




  • 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

    • 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.