SAP Enterprise Messaging for SAP ERP: HowTo-Guide (Part 1 – Connectivity)

This blog post is about the first steps to set-up and enable the SAP NetWeaver Event-Enablement Add-on, a new component from SAP for SAP Cloud Platform Enterprise Messaging connectivity.

Features of the Add-on:

• Add-on to SAP NetWeaver ABAP systems, operates within the established SAP infrastructure of the underlying system in all aspects (application management, security, logging
• Allows to enhance or create custom content (extractors, formatters) and connectors
• Uses highly scalable techniques to bring customer data and events into the cloud
  • event based triggers
  • delta loads / change pointers
  • parallel data processing (in multiple SAP work processes)
  • data splitting
• BAPI calls for data selection are possible
• Supports outbound AND inbound data flows
• Supports interface clustering for efficient provisioning to multiple cloud applications

Before You Start: Preparation Steps & Installation

• Make sure you have signed-up and you can access your SAP Cloud Platform instance
• Activate the “Enterprise Messaging” Service

Please note: this Service is available on Cloud Foundry instances only

• If you have an active subscription of the Enterprise Messaging service, you should be able to download the Add-on component from the Software Center at: https://launchpad.support.sap.com/#/products/73554900100900005152
• Install the Add-on. Installation and Set-Up Documentation can be found at: https://help.sap.com/viewer/e966e6c0e61443ebaa0270a4bae4b363/1.0/enUS/3eba827c531344eb879d8e35022d90ba.html

What’s coming up in Part 1?

• We will define connection between SAP Cloud Platform and SAP ERP
• This is a one time action, required per cloud (e.g. EU10, EU20, ..) and per subaccount
• For convenience, copy the service key from your Enterprise Messaging instance into e.g. a notepad for easier copy and paste. This connection is using REST, not e.g. AMQP or MQTT.

–> Update: Part 2 will guide you through configuration of an actual Enterprise Messaging use-case, based on an SAP business object even. Please find it at https://blogs.sap.com/2020/10/08/sap-enterprise-messaging-for-sap-erp-howto-guide-part-2-first-use-case/

Step 1: Setting up basic connectivity in SM59

• Create RFC Connection with connection type ‘G’ pointing, to the URI from the
  service key (from the httprest section)
• Enter the URI without the ‘https://’, like
  

  “enterprise-messaging-pubsub.cfapps.eu10.hana.ondemand.com”

• This is the connection towards the data center, e.g. EU10
• Save

SM59 Settings (Example)

Step 2: Setting up OAuth connectivity in SM59

• Create a second RFC Connection ‘G’, pointing to the “tokenendpoint ” from the
  Subaccount
• Enter ‘/ oauth /token’ in second line (Path Prefix)
• In ‘Logon and Security’ –> ‘Security option’, select ‘active’ and ‘Anonym ssl client (Anonym)’
• Make sure certificates were exchanged earlier (other ppt with more details on SSL Trust settings / certificates exchange available)

SM59 – OAuth Settings (Example)

Step 3: Set-up sending in ‘ACI: Connection Customizing File Transfer’

• Create a connection instance and point it to the SAP Cloud Platform instance
• Enter RFC destination for main service

ACI Configuration for Connection Setup

Step 4: Configure ‘File Transfer’ Connection Instance

• Enter Client ID (SAP_EM_CLIENT_ID) from Service Key
• Enter RFC destination for OAuth you created earlier (SAP_EM_TOKEN_DESTINATION)

File Transfer Instance Configuration

Step 5: Map the expected error codes from the Enterprise Messaging Service

• Please note: Also return codes other to 200 could mean ‘success’

Map webservice error codes

Step 6: Set cloud connection password (‘clientsecret’)

• Enter password from Service key ‘clientsecret” into the secure data store

Set cloud connection password

Congratulations! You have set-up the connectivity of the Add-on.

–> Part 2 will guide you through configuration of an actual Enterprise Messaging use-case, based on an SAP business object even. Please find it at https://blogs.sap.com/2020/10/08/sap-enterprise-messaging-for-sap-erp-howto-guide-part-2-first-use-case/