Preparing Technical Communication Settings in SAP Sales Cloud and SAP Service Cloud Version 2

The Communication System represents the communication partner, in our case: SAP S/4HANA. You can maintain communication systems using the similarly named system settings entry: System Settings→All Settings→Integration card→Communication Systems. Besides adding new communication systems or editing existing ones, you can also find the system ID for your SAP Sales and Service Cloud Version 2 tenant here, which is the Own system ID from this system's perspective. The following screenshot shows this view.

The following two screenshots display the dialog for editing the communication system that represents SAP S/4HANA in the demo environment. The dialog offers general system-related settings at the top and two tabs for inbound and outbound settings at the bottom.

• The Display ID refers to the logical System ID of SAP S/4HANA
• The Technical ID should be left blank when creating the entry. It is generated automatically by the cloud CRM and used for internal purposes.
• The Inbound and Outbound tabs must be activated before entering details. Depending on the use case, you might not need to maintain both tabs (for example, when no outbound communication is necessary).
• The Inbound tab shows your username and lets you either set a password for that user or upload a certificate. The username is automatically generated based on the Display ID of the communication system.
• The Outbound tab allows you to set a default protocol for outbound communication and requires the hostname of the communication partner on the network layer, which is the runtime hostname of Cloud Integration. Finally, you can select the authentication method to use when calling integration flows from the cloud CRM.

• System ID for IDoc and Web Service communication can be different (Logical System ID, Business System ID)

  Generally, the SAP S/4HANA system administrator should be able to tell the relevant system ID(s), otherwise, do the following

• Web Service-based communication:
  • With SLD: Run transaction SLDCHECK
  • Without SLD: Implement BAdI MDG_IDM_GET_LCL_SYSTEM (Determination of Local System Name)
• IDoc-based communication:
  • Transaction SCC4(Display View "Clients")
  • Additionally, you can see the system ID in transactions such as BD87(Select IDocs) or BD64(Display Distribution Model)

SAP S/4HANA can have different system IDs for various protocols, such as Web Services or IDocs and the methods to obtain the relevant system ID vary. Since all the integration scenarios in this course use Web Services, we focus on that. Generally, the system administrator of the SAP S/4HANA system should be able to identify the system ID.

The system ID in this course’s demo environment is T41CLNT400.

If the SAP S/4HANA system uses a System Landscape Directory (SLD), you can also run transaction SLDCHECK to determine the system ID. If SLD is not used, the BAdI (Business Add-In) Determination of Local System Name (MDG_IDM_GET_LCL_SYSTEM) must be implemented. You can find more details in the Knowledge Base Article 2646544 - Sender Party is Missing in Header of SOAP Messages.

There are different ways to obtain the runtime hostname of the Cloud Integration.

Without Deployed Integration Flows

As long as you haven't deployed integration flows, you can open a service key in the SAP BTP cockpit and find the runtime hostname in the URL field, as shown in the following screenshot.

With Deployed Integration Flows

Once you have deployed integration flows, you can get the hostname from the endpoint path of one of the deployed flows in Cloud Integration by navigating to Monitor→Manage Integration Content and selecting any integration flow.

In the demo scenario of this course, client certificates are used for connections to and from the cloud CRM. The certificates for the communication system’s inbound and outbound channels have been prepared in the previous lesson and need to be uploaded accordingly.

Client Certificate for Inbound Connections

The certificate for inbound connections has been downloaded from the Cloud Integration’s keystore. It is the default client certificate and key pair with the alias sap_cloudintegrationcertificate. Since this download does not include the private key, the file is not password protected. Typical file extensions are *.pem or *.crt.

Client Certificate for Outbound Connections

The certificate for outbound connections can be generated in the SAP BTP cockpit via a Service Key of type Certificate and needs to be converted into an encrypted *.pfx or *.p12 file containing the private key. You can find further details about how to do that in the blog post Convert SAP BTP Certificate Service Keys to PFX Files

Communication Configurations group inbound and outbound services along with some additional settings relevant for specific integration scenarios, such as Product Replication from SAP S/4HANA or Business Partner replication from or to SAP S/4HANA. They are located in the Settings area under the matching entry: Communication Configuration.

There are two types of communication setups:

• Templates that contain inbound and outbound services but are not yet configured for a specific system. They can be copied and then adjusted for a particular communication system.
• Communication Configurations that are configured for a communication system.

The following screenshot shows the template and a configured version of the communication setup, "Integrate Master Data with SAP S/4HANA", which is also used in this course.

Once the communication configuration is set up, it’s useful to filter by the communication system to find it quickly.

To copy a communication configuration, open a template (or an existing one) and click the Copy button in the upper right corner, as shown in the following screenshot. Then, you can assign the communication system.

That’s it for the communication configuration setup in this lesson. There are additional settings, such as the Value Mapping Group or the inbound and outbound services, that you can add or remove based on the required integration scope. These will be configured in later lessons, where the communication configuration will also be activated.

This video shows how to set up a communication system for SAP S/4HANA within SAP Sales and Service Cloud Version 2 and how to create a communication configuration with basic settings. Additional settings will be covered in later lessons of this course.