Integrate SAP S/4HANA Cloud with SAP Cloud Platform Integration using SOAP APIs - Part 1

[MarcelWolf]

SAP Cloud Platform Integration (SAP CPI) simplifies the custom-driven integration with SAP S/4HANA Cloud  by using a wide variety of SAP S/4HANA Cloud APIs. These APIs play the major role in exchanging data with other systems. Offering OData and SOAP protocol based APIs SAP S/4HANA Cloud is perfectly equipped to meet this requirement now and in the future. The central tool to explore all available SAP S/4HANA Cloud APIs is the SAP API Business Hub.

This blog series consists of two Blog posts. In this series the integration possibilities between SAP S/4HANA Cloud and the SAP CPI will be outlined by using a SOAP API of SAP S/4HANA Cloud to replicate business data to the SAP CPI. As SOAP APIs are best suited for a asynchronous exchange of have weight data and is mostly used in the Business-to-Business and Application-to-Application context this blog series uses SOAP APIs.

Deploy the integration flow on the SAP Cloud Platform Integration

The following steps describe how to deploy your integration flow (iFlow):

1. Logon to the SAP CPI with the appropriate user roles assigned. The four appropriate user roles are as follows (for more details visit the SAP CPI help page😞
   
   
   
   1. AuthGroup.Administrator
   
   
   2. AuthGroup.IntegrationDeveloper
   
   
   3. ESBMessaging.Send
   
   
   4. Auth.Group.BusinessExpert
   
   
   
   


2. Switch to the Design menu option in the main menu on the left.


3. Create a Package.


4. Open the Package by clicking on it and create an Integration Flow in the ARTIFACTS tab.


5. Connect the Sender with the Start event by drawing a message flow between them.


6. Select SOAP as adapter type and SOAP 1.X.


7. Open the message flow settings by clicking on it and open the Connection tab. Enter a desired Address for your endpoint on the SAP CPI.


8. Finally deploy the iFlow on the SAP CPI.

 

Important Remark: No WSRM policies allowed!

The SOAP 1.x adapter does not support WSRM. Make sure the used WSDL does not contain such policies or use the adapter without WSDL. In future a check will be introduced raising an error in case WSRM is defined in the WSDL.

Retrieve the endpoint of the iFlow

This step describes where to find the endpoint url of your recently deployed integration flow. Both information will be needed during the setup of the Communication Arrangement in the SAP S/4HANA Cloud system.

1. Switch to the Monitor menu option in the main menu on the left.


2. Navigate to the Manage Integration Content section.


3. Select the iFlow in the Integration Content navigation pane.


4. Copy the complete URL displayed in the Endpoints tab and save it for later. The URL consist of the host name and the specific path of the iFlow.


5. Continue with the SAP S/4HANA Cloud setup which is described in this blog.

Setup the Certificate-to-User-Mapping

To enable the communication between the SAP S/4HANA Cloud system and the SAP CPI system you have to upload your authentication certificate of the SAP S/4HANA Cloud system into the SAP CPI. To do so:

1. Switch to the Monitor menu option in the main menu on the left.


2. Open the Certificate-to-User Mapping App in the Monitor Dashboard.


3. Enter the SAP CPI user name and choose the certificate of the S/4HANA Cloud system downloaded during the setup of the Communication Arrangement.

Monitor replicated data

After replicating the data in the SAP S/4HANA Cloud system (described in this blog) the data was sent to the endpoint configured in the iFlow on the SAP CPI. Proceed as follows to Monitor the data replication:

1. Open the Message Processing Monitor.


2. Select the iFlow in the left navigation pane.

The detailed communication log of the data exchange between the S/4HANA Cloud system and the SAP CPI are shown in the message processing logs which can be found on the right side of the screen.