Connectors

SAP Event Mesh Connector

Publish and consume events on SAP Event Mesh and SAP Advanced Event Mesh – the native event broker for SAP BTP. Ideal for SAP-to-SAP BTP integration and event-driven BTP extension scenarios.

Overview

SAP Event Mesh is SAP BTP's managed message broker service, part of SAP Integration Suite. It provides queues, topics, and webhooks with enterprise-grade reliability. SAP Advanced Event Mesh (AEM), powered by Solace technology, extends Event Mesh with enterprise mesh capabilities for large-scale, multi-region deployments.

ASAPIO supports both:

Prerequisites

Getting the Service Key

The service key JSON contains all credentials and endpoint URLs needed for the ASAPIO connector. Obtain it from the BTP Cockpit:

Open BTP Cockpit

Log in to account.hana.ondemand.com. Navigate to your subaccount and select the Space where your Event Mesh instance resides.

Find the Event Mesh instance

Go to Services → Service Instances. Find your Event Mesh instance (service name: enterprise-messaging). Click on it.

Create a service key

Click Service Keys → Create. Give it a name (e.g. asapio-key). Leave parameters empty for a standard key. Click Create.

Download the JSON

Click the key name to view its JSON content. Copy the full JSON or download it. The key looks like this:

{
  "namespace": "default/asapio.com/integration/",
  "instanceid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "messaging": [
    {
      "oa2": {
        "clientid": "sb-clone-xxxx",
        "clientsecret": "xxxx-xxxx-xxxx",
        "tokenendpoint": "https://xxx.authentication.eu10.hana.ondemand.com/oauth/token",
        "granttype": "client_credentials"
      },
      "protocol": ["httprest"],
      "broker": {
        "type": "sapmgw"
      },
      "uri": "https://enterprise-messaging-pubsub.cfapps.eu10.hana.ondemand.com"
    }
  ],
  "serviceinstanceid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "xsappname": "clone-xxxx"
}

Configuration in ASAPIO

In ASAPIO Event Studio, open the SAP Event Mesh connector properties. You have two configuration options:

Option 1: Paste full service key JSON

Click Import Service Key and paste the entire JSON from BTP. ASAPIO parses the JSON and extracts all required fields automatically.

Option 2: Manual field entry

Enter each field individually:

FieldSource in Service KeyExample Value
Token Endpointmessaging[0].oa2.tokenendpointhttps://xxx.authentication.eu10.hana.ondemand.com/oauth/token
Client IDmessaging[0].oa2.clientidsb-clone-xxxx
Client Secretmessaging[0].oa2.clientsecretstored in SAP Secure Storage
REST URLmessaging[0].urihttps://enterprise-messaging-pubsub.cfapps.eu10.hana.ondemand.com
Namespacenamespacedefault/asapio.com/integration/

Queue and Topic Configuration

SAP Event Mesh uses a namespace-prefixed naming convention for topics and queues.

Namespace format

The namespace is defined in the service key and follows the pattern: default/<domain>/<system>/

Example: default/asapio.com/integration/

Topic naming

Topics must start with the namespace. ASAPIO recommends the following convention:

default/asapio.com/sap/<SID>/<module>/<event-type>

Example: default/asapio.com/sap/PRD/mm/goodsmovement

Queue vs. Topic Subscription

ℹ️
Create queues before publishing

SAP Event Mesh does not auto-create queues. Create queues in the Event Mesh cockpit (or via the Management API) before activating your ASAPIO flow. Topics are created on first publish.

CloudEvents Integration

SAP Event Mesh natively supports CloudEvents 1.0 as the message format. When publishing via ASAPIO, the following CloudEvents attributes are set:

AttributeValueNotes
specversion1.0Always 1.0
sourceurn:asapio:s4hana:<SID>e.g. urn:asapio:s4hana:PRD
typecom.asapio.sap.<module>.<event>e.g. com.asapio.sap.s4hana.mm.goodsmovement
idUUID v4, auto-generatedUnique per message
timeISO 8601 UTCPosting time in SAP
datacontenttypeapplication/jsonAlways JSON for Event Mesh connector

Advanced Event Mesh

SAP Advanced Event Mesh (AEM) extends Event Mesh with Solace-based enterprise features. To configure the AEM connector in ASAPIO, obtain the AEM service key from BTP (service: enterprise-messaging with AEM plan, or the dedicated AEM service).

Additional AEM-specific settings:

💡
AEM for multi-region SAP landscapes

If you have SAP systems in multiple regions (e.g. EU and US), AEM's mesh topology allows events published from the EU SAP system to be automatically replicated to the US event broker, so US consumers can subscribe locally without cross-region latency.

Testing

Use the SAP Event Mesh cockpit (accessible from BTP Cockpit → Services → Event Mesh → Manage) to:

After activating your ASAPIO flow, trigger a test event using Event Studio's Test Run function and then verify the message appears in the Event Mesh cockpit queue browser.