Installation of Cloud Connector
Note

Determination of Trusted Connection
Prerequisite
Configuration of principal propagation required inclusive creation of technical user for basic authentication.
Note

Description
- Scenarion end-to-end SSL encryption (termination of SSL at back end)
- Exchange of certificate is mandatory
- SAP Intelligent Clinical Supply Management Portal to Cloud Connector (SSL termination) from Cloud Connector to back end HTTP
- Certificate is not required
- Cloud-based LDAP service provide (for example, Microsoft, Google, Oracle)
Exchange of certificate is mandatory
Configure ICM to Trust the Cloud Connector If Required ++Customizing Request Required++
- Go to transaction code RZ10.
- Select Default Profile and Latest Activated Version.
- Choose Extended Maintenance.
- Choose Create New Parameter and add the following entries:
- Parameter Name: login/certificate_mapping_rulebased Parameter Value: 1
- Parameter Name: icm/HTTPS/trust_client_with_subject Parameter Value: *
- Parameter Name: icm/HTTPS/trust_client_with_issuer Parameter Value: CN=SCC, OU=ICSM, O=SAP SE, C=DE
- Parameter Name: icm/HTTPS/verify_client Parameter Value: 1
Upload Missing SSL Browser Certificates
- In transaction code SM59, on the Logon & Security tab, check that SSL is set to active.
- Check which SSL certificate is selected. It should be <DFAULT SSL Client (Standard)>.
- Download the missing browser certificates from the front-end URL or Cloud Connector on SAP BTP and import them in transaction code STRUST into <SSL client SSL Client (Standard)>.
- Within this view, choose <Add to Certificate List> and save the settings.
Restart ICM Server
- Go to transaction code SMICM
- In the toolbar, select Administration → ICM → Exit Soft → Global.
- Confirm to restart all ICM processes.
Principle Propagation Enablement
Prerequisite
Check the federation of IDP setup principle propagation within SAP S/4HANA (B1S).
Note
For additional information on the technical user and the federation of user identities to use principle propagation, refer to: Setting up Principal Propagation - SAP Community.

SAP BTP service and on-premise users should be available to corporate IdP.
Configure System Destinations
Prerequisite
Enable connection to all SAP S/4HANA services accessed by end users and by technical users.
Note

Workflow Setup and Roles
Prerequisite
Workflow destination for the mail server has been set up
Note

Description
Add the following standard workflow roles as part of ICSM PoC:
- WorkflowInitiator (global role)
- WorkflowParticipant (global role)
- WorkflowAdmin (global role)
Check if the related ICSM standard roles are part of the ICSM role collection:
- WorkflowSettingEditor
- WorkflowSettingViewer Role
Create an Instance of the Integration Broker
Prerequisite
Note
- PreProd: icsm-integration-preprod
- Prod: icsm-integration

Authentication of service keys shall be set to client credentials (client ID + client secret).
Note
Integration Cloud - SAP S/4HANA
Note

Description
- Set Up Cloud Integration to enable synchronization of study data.
- Create Your OAuth 2.0 Client Profile.
- Configure connection parameters.
Procedure
- RFC Connection (transaction code SM59)
Make sure that the host URL is maintained correctly.
Make sure that the RFC connection name is not longer than 14 characters.
On the Logon & Security tab, select the following options:
- Do not use user
- Do not send logo ticket
- SSL - active
- SSL Certificate: SSL Anonymous
- OAuth Profile Maintenance (transaction code OA2C_CONFIG)
- Maintain OAuth profile for standard integration service plan.
- Client ID and secret are retrieved from service keys (provided by BTP subaccount admin)
- Make sure that when you maintain the authorization and token endpoint to only copy and paste the URL without https://
- Change Selected Grant Type to Client Credentials.
- Select SSL Anonymous in the field SSL Client PSE.
- Configuration Connection Parameters (transaction code SM59)
Perform Customizing according to 3296156 - ICSM : Study sync issue due to CONTACTS key field
+++TR required+++
- Transaction code to verify:/N/CTCO/SYNC_STUDY
Enable Consumption of SAP Event Mesh Events for Data Synchronization
Note

Description
- Set Up SAP Event Mesh
- Create a queue and a queue subscription for the following events Manage Queues.
- Study change (creation or change to a study)
- Status configuration change
- Type configuration change
- Phase configuration change
- Study status change
- Create a webhook for each of the events Manage Webhooks.
Procedure
SICF Service activation for default/host → sap → bc → icsm_event_wb.
Enable alternative Login Procedures in SICF and activate Event Mesh Services to support sync of study and notifications (Consumption of Event Mesh Events)
- Go to transaction code SICF.
- Search for Service Paths:
- /sap/opu/odata/ctco
- /sap/opu/odata/sap
- /sap/bc/icsm_event_wb
- Double-click on the last node displayed, and in the Logon Data tab, enable Use All Logon Procedures.
- Activate any services that have been inactive so far.
Note
SAP S/4HANA Outbound Event Communication Setup

Description
In SAP Event Mesh, queues need to be created with the above topics in queue subscriptions.
Hint
<Namespace>/<Meaningful Name> - <Namespace> + /ce/sap/s4/beh/<repo object>+<repo version> + respective topic name.
For example, Queue-Subscription
z/icsm.saas.consumer/zd8/PPMaterialAlert-z/icsm.saas.consumer/zd8/ce/sap/s4/beh/ctsmprimpackmatlalert/v1/CTSMPrimPackMatlAlert/Created/v1
z/icsm.saas.consumer/zd8/ShelfLifeAlert- z/icsm.saas.consumer/zd8/ce/sap/s4/beh/ctsmshelflifealert/v1/CTSMShelfLifeAlert/Created/v1
The following is the list of ICSM outbound events:
- CTSMInventoryReport/Created/v1
- CTSMMedicationKit/Changed/v1
- CTSMPrimPackMatlAlert/Created/v1
- CTSMShelfLifeAlert/Created/v1
Helpful Transactions
- /IWXBE/EVENT_MONITOR - Event Montior (Only available in SAP S/4HANA 2022; Transaction - /IWXBE/EEE_SUPPORT - EEE can be used in 2021 release)
- SWEQADM - Event Queue Administration
- SWEQADM_1 - Maintain Event Queue Administrator
- SWU3 - Automatic Workflow Customizing
- /IWXBE/EEE_SUPPORT - EEE - Support Reports
- SMDAEMON - ABAP Daemon Table
- /IWXBE/CONFIG - Configure Enterprise Event Channel
- SWUE - Trigger an event
- SWE2 - Display/Maint. Event Type Linkages
- SWEL - Display Event Trace
cFLP (SAP Workzone Standard Edition)
Prerequisite
Before using this procedure, make sure that Cloud Connector, SSO, and principal propagation are set up.
Note

Procedure
Subscribing to the SAP Launchpad Service enables users to access all of the applications that they need to fulfill their tasks from a central point of entry.
- Synchronize with principal propagation
- Subscribe to SAP Launchpad Service
- Configure 2 destinations to connect to the SAP S/4HANA system
- Design-time destination
- Runtime destination
- Add Content Provider to SAP Launchpad Service
- Create SAP Launchpad
- Activate SAP Companion Content and enable it on app level (Enable In-App Help for a Launchpad with Federated Apps)
- Enable the notification service (Integrate the Notification Service)
- Add the SAP Launchpad Service to the HTTP whitelist
- Set the user role
- When you subscribed to the SAP Launchpad Service, 2 role collections were added: Lanchpad_Admin and Launchpad_External_User. To configure the SAP Launchpad Service, you need the Launchpad_Admin role. Map this role collection in Role Collection Mappings to access the SAP Launchpad Service as an admin. In your subaccount, go to Trust Configuration, select the IAS you use, choose Role Collection Mappings, and add the required mapping.
- Expose respective roles by the SAP S/4HANA backend system
- Set user roles for SAP S/4HANA apps
- Add BTP Content Provider and Content Manager role
Role Setup
Prerequisite
Before using this procedure, make sure that the business function xxxx is active.

Description
You use this procedure to xxxx.
Settings are used by ICSM-specific BAdI Implementation xxxx to trigger the corresponding xxxx.
Default settings are delivered to support xxxxx.
Procedure
- In the SAP Customizing Implementation Guide of Intelligent Clinical Supply Management, go to Master Data → ATTP Integration → Assign ATTP Business Functions by Goods Movement Type.
- Establish a mapping between ATTP events and postings of goods movement document types.
- BAdIs
Be aware that there are several BAdIs available to allow the implementation of customer-specific logic:
- ATTP Integration for EWM - Allows you to implement customer-specific logic for ATTP-communication functions in SAP S/4HANA Extended Warehouse Management (EWM).
- ATTP Integration for IM - Allows you to implement customer-specific logic for ATTP communication functions in the SAP S/4HANA inventory management (IM).
- Additional Checks for Master Data Integrated with ATTP - Allows to implement customer-specific logic for additional master data checks, integrated with ATTP
- Control ATTP Access - Allows you to implement a customer-specific logic to disregard the SAP Advanced Track and Trace for Pharmaceuticals (ATTP) connection while using SAP Intelligent Clinical Supply Management functionality.
Refer to the following video explaining the details of integrating Cloud with SAP S/4HANA.