'Default' service plan for SAP Cloud Platform Enterprise Messaging
With immediate effect, SAP Cloud Platform Enterprise Messaging supports a new and improved 'Default' service plan available when you create a new Enterprise Messaging service instance. (Please note that the 'Default' service plan is not available as part of SAP Cloud Platform trial accounts). Technically, the 'Default' plan differs from the former 'Lite' plan in that the message bus exists at subaccount level and only service instances/message clients from this subaccount can access this bus. The 'Default' service plan replaces the previous 'Lite' plan and ensures that your messaging infrastructure is optimized and can fully support scalable and versatile event-driven extension scenarios.
Coinciding with the introduction of this new and improved 'Default' service plan, the previous 'Lite' plan will no longer be available to purchase. We strongly recommend you create new Enterprise Messaging service instances based on the new 'Default' service plan. By creating new messaging instances with the 'Default' plan, you benefit from an upgraded messaging and eventing infrastructure. These setup changes enable you to extend SAP solutions with greater ease and efficiency without disrupting performance or core processes.
Create new Enterprise Messaging service instance
Prerequisite: check your global account entitlements
To create a new service instance, you must ensure that you have the relevant entitlements for SAP Cloud Platform Enterprise Messaging in your global account.
- In your SAP Cloud Platform Cockpit, open your global account and choose Entitlements, Subaccount Assignments.
- In the dropdown list, select your subaccount and choose Go.
- Choose Configure Entitlements and then Add Service Plans.
- In the Subaccount Entitlements dialog box, select the Enterprise Messaging service.
- In the Service Details: Enterprise Messaging screen area, select the default service plan for Enterprise Messaging.
- Press the Add 1 Service Plans button to add this entitlement for the Enterprise Messaging service for your subaccount.
- Press Save.
How to create new service instance using Default service plan
When you create a new service instance for Enterprise Messaging and select the service plan, you create a new message client, which will enable you to receive events from your registered backend/LoB systems. Each service instance is a message client that contains a name, namespace, and a set of rules.
- In the SAP Cloud Platform Cockpit, open your global account and navigate to the subaccount in which the development space where you want to create the service instance resides.
- In the Navigation area, choose Services -> Service Marketplace where all the services available for your space are displayed.
- Choose the Enterprise Messaging tile.
- Choose Instances and then press the New Instance button.
- Select the Default service plan and choose Next.
- To create the service instance, you maintain JSON syntax parameters, which define the service descriptor attributes. You need to enter your message client name ("emname") and the namespace and maintain the options to define the access channel and the rules for your message client. For more information about the syntax, see Syntax for Service Descriptor.
Example:
{
"emname": "<yourmessageclientname>",
"namespace": "<yourorgname>/<yourmessageclientname>/<uniqueID>",
"version": "1.1.0",
"options": {
"management": true,
"messagingrest": true,
"messaging": true
},
"rules": {
"queueRules": {
"publishFilter": [
"${namespace}/*"
],
"subscribeFilter": [
"${namespace}/*"
]
},
"topicRules": {
"publishFilter": [
"${namespace}/*"
],
"subscribeFilter": [
"${namespace}/*"
]
}
}
}
- Enter the service instance name and choose Finish.
Note: If you need to delete an Enterprise Messaging service instance from the table, select the row and choose
Delete from the
Actions column.
New UI for the Default service plan
A new Enterprise Messaging UI is available with the Default service plan. The new UI enables you to manage your message clients and explore events.
Note: With Enterprise Messaging Default service, plan, the Cloud Foundry dashboard is not directly provided. You need to subscribe to the Enterprise Messaging application in the subscriptions section of the subaccount.
Prerequisite: subscribe to Enterprise Messaging
How to access new UI
Note: only administrators of the global account can set up subscriptions.
- In the SAP Cloud Platform Cockpit, navigate to the subaccount (of which you are an administrator).
- Choose Subscriptions from the navigation pane on the left and click on the Enterprise Messaging tile. If you are not already subscribed, open this tile and press the Subscribe button.
- After you have subscribed to Enterprise Messaging, new Role Collections are available inside your subaccount that need to be assigned to your user so that you can access the Enterprise Messaging UI.
For further details, see Assign Roles to Users
- After you have assigned the Role Collections, click on Go to Application link.
- Log on using your email address and password to access Enterprise Messaging. The new UI for managing message clients and event exploration is displayed.
- On the Message Clients screen, you can select the message client (emname) you have created.
- The UI reflects the attributes you specified in the JSON parameters when you created the new service instance (message client).
Example 1: Message client attributes defined in Service Descriptor
Example 2: Message client rules defined in Service Descriptor
For more information about subscription, see
Subscribe to Multitenant Business Applications in the Cloud Foundry Environment Using the Cockpit.
How to create a queue and a queue subscription
To complete the setup for your new Enterprise Messaging service instance, you need to create a queue and a queue subscription for your new message client.
- On the Enterprise Messaging UI, click on the name of your new message client.
- Select the Queues tab and press Create Queue.
- Enter a queue name (e.g. BusinessPartnerQueue) and choose Create. The namespace from the service descriptor parameters (JSON) is appended.
- To manage the queue subscriptions, choose Queue Subscriptions under Actions.
In this step, you subscribe your queue to a topic to where your system will send the events.
- Enter the topic name or pattern from the service descriptor.
- Choose Add to subscribe your queue to the topic name/pattern.
- Choose Close.
Summary
After completing these steps, you have created a new Enterprise Messaging service instance (message client) based on the new Default service plan, and set up a queue and a queue subscription.
For more detailed information, see:
If you have any questions, please don't hesitate to reach out to us via SAP Community.