Using Cloud Integration to consume and publish in SAP Integration Suite, advanced event mesh

👉 Access the event broker service that you want to connect to and create or clone a queue for the exclusive access of Cloud Integration. If cloning an existing queue, make sure to also clone the subscriptions, see screenshot below. In the tutorial, Queues and subscriptions in SAP Integration Suite, advanced event mesh, you can see how you can create a queue from scratch.

You will be connecting to the queue from Cloud Integration, to consume the events received by the queue.

Before you can receive message from the queue, you need to set up a few things in Cloud Integration:

1. Create a secure parameter for the Solace Messaging password.
2. Import the Advanced Event Mesh adapter from the SAP Business Accelerator Hub.
3. Import the integration flow available in the assets folder.

Create a secure parameter for the Solace Messaging password

👉 Go to your SAP Integration Suite instance and create a secure parameter in Monitor > Integration and APIs > Manage Security section > Security Material. Then from the Create menu select Secure Parameter. Provide the details below and deploy.

Take note of the secure parameter name as you will be using it in the integration flow when configuring the flow before deployment.

Import the Advanced Event Mesh adapter

Importing the Advanced Event Mesh adapter from the SAP Business Accelerator Hub to the tenant might not be always necessary, as the adapter might be already available in the tenant. For example, if you have already used the adapter in a different integration flow, then the adapter will be available in the tenant. Also, the first time you set up a Sender/Receiver to use the AdvancedEventMesh adapter, it will automatically get the adapter from the SAP Business Accelerator Hub and deploy it in the tenant. Not the case in this exercise as you are importing an existing integration flow and you aren’t setting up the connections from scratch. The steps below are provided for the case when the adapter is not available in the tenant.

👉 Go to your SAP Integration Suite instance and navigate to Discover > Integrations, search for Advanced Event Mesh and select the Advanced Event Mesh adapter for SAP Integration Suite.

👉 Once in the adapter details, choose the Copy button in the top right-hand corner. This action will copy the adapter to your SAP Integration Suite tenant.

Now the AEM adapter is in the tenant and you can see that there is a new integration package called Advanced Event Mesh Adapter for SAP Integration Suite, within its artifacts is the adapter itself. Let’s deploy it.

👉 Choose the Actions button for the integration adapter and select Deploy.

You will be able to see the deployed content in Monitor > Integrations and APIs > Manage Integration Content > All.

Import the integration package

Now you will go ahead and import the sample integration package available here.

Ensure that you’ve downloaded the aem-iflow-sample.zip file from the assets folder in the GitHub repository. The integration package is available here: https://github.com/sap-tutorials/eda/blob/main/tutorials/aem-integrate-cloud-integration-iflow/assets/aem-iflow-sample.zip.

👉 Go to your SAP Integration Suite instance and navigate to Design > Integrations and APIs and choose the Import button in the top right hand corner, select the aem-iflow-sample.zip file and choose the Open button.

Once imported, you will see the Consume_Publish_Events_AEM integration flow, in the Artifacts tab, of the AEM iFlow Sample integration package.

As stated at the beginning, the integration flow is very simple, it consumes the events from the queue in AEM, enriches the message and publishes it to a topic.

🧭 Take some time to explore the integration flow itself…Some ideas:
- Check the tabs and configuration options available in the sender adapter (Connection, Processing).
- Check the tabs and configuration options available in the sender adapter (Connection, Processing, Message properties).
- What are you doing in the Groovy script that’s enriching the message?
- Which is the Transport Protocol used by the adapters?
- Which is the Message Protocol used by the adapters?

Now that you are familiar with the Consume_Publish_Events_AEM integration flow, let’s configure it.

👉 Choose the Actions button for the integration flow and Configure its externalised parameters with the details below:

👉 Once you’ve configured the externalised parameters, choose the Deploy button to deploy the integration flow.

If you are using SAP Integration Suite in the BTP trial environment, it might take a few minutes to deploy the integration flow. Also, you might get an error message stating that it has failed to deploy. You can safely ignore this error message if it is the first time deploying as it just takes some time the first time you deploy an integration flow.

You can monitor the deployment status in Monitor > Integrations and APIs > Manage Integration Content > All tile or in the integration flow itself under the Deployment status tab.

Now, our integration flow is ready to process the purchased tickets events from AEM. The service which is simulating the ticket purchased events is continuously sending events to the topic configured in the receiver adapter, for example your/topic/abc and in a matter of seconds you will see our integration flow processing the events.

👉 Go to the Monitor > Integrations and APIs > Monitor Message Process > All Artifacts tile and see the messages being processed.

Also, you can check the produced messages in the event broker service by subscribing to the topic where the integration flow is publishing the messages.

👉 Go to the Try Me! UI in the event broker service you are connecting to and subscribe to the topic defined in the AEM receiver adapter. Same as before, you will receive “enriched” messages published on the topic in a matter of seconds.

You’ve covered a lot in this tutorial. You started by creating a separate queue for Cloud Integration and then set up the components in Cloud Integration. You created a secure parameter for the Solace Messaging password, imported the Advanced Event Mesh adapter from the SAP Business Accelerator Hub and imported the integration flow available in the assets folder. Finally, configured the integration flow, deployed it and monitored the messages flowing in Cloud Integration. Hopefully, this gives you a hint on what is possible when connecting Cloud Integration with SAP Integration Suite, advanced event mesh using the AEM adapter.

• Advanced Event Mesh adapter in the SAP Business Accelerator Hub - link.
• Advanced Event Mesh adapter - Help documentation - link.
• Solace Message Format (SMF) - link.