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

[FlorianFarr]

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/3eba827c531344eb879d8e35022d90...

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-c...

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-c...