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 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.
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
Hi Siva,
Can you kindly elaborate your question?
Thanks
Deepak
Hello Deepak,
I am referring to 2nd point "selecting Mapping definition based on xPath".
Regards,
Siva
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
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
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
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
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
Hi Deepak, yes that way I can manually edit a mapping.
However this is no option if
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
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.
Hello Sir,
Did this error got resolved. Please help me on the solution.
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
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
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
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
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
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
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
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
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
HI Arun,
Did you find solution to this problem? I am facing same issue while importin operation mapping in CPI.
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
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
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
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
Thanks a lot, Deepak Govardhanrao Deshpande
I found the edit key at the right bottom corner.
Regards,
Pavan
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
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
Thanks Deepak for the update!
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.
Thanks
Deepak
Yes I found the button. Who would put the button all the way down there?
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.
Thanks
Deepak
Thanks Deepak!
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
Hi Javier,
Thanks for the input. The relevant document has been updated with required paths.
Thanks
Deepak
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