Event Topic Bindings

Event Topic Bindings are used to define a topic on a message broker (e.g., Apache Kafka) to which events are published or consumed from. These event topic bindings are managed in Solution Hub where you can create new bindings to connect to existing topics on one or more message broker (e.g., Apache Kafka) or edit these bindings. In Solution Designer you can then refer to these bindings when creating an Event or you can create new event topic bindings in order to create a new topic on the selected message broker.

Attention: The user specified in the Message Hub Service Binding (see also Configuration Management) must have sufficient permissions to create new topics on the selected message broker in order to create new topics with Solution Designer or Solution Hub. If not, you can only create event topic bindings for existing topics for which the above mentioned user has read/write permissions.

Create Event Topic Bindings

You can create event topic bindings by using the Create capability in the Event Topic Bindings section of the Infrastructure tab on a domain namespace's Overview page. Alternatively, you can create them while creating a new Event. There, the drop-down to select the event topic binding also provides an Add function to create new bindings.

Event topic bindings are defined using the following master data:

  • Binding Name: This is the identifier (name) of the event topic binding. It is unique within a namespace. Please note that only the characters A-z (without special characters), digits and the special character "_" are permitted for naming entities! The binding name cannot be changed after creation (required)

  • Message Hub Service Binding: Determines the message broker (Apache Kafka cluster) that hosts the event topic (required)

  • Topic Name: The name of the event topic on the message broker (required)

  • Retention Hours: Defines how long the event data is saved on a topic before it gets discarded. Possible values are 1 - 720. Default is 24 hrs (optional)

Note: The drop-down for the Topic Name will only list topics on the selected message broker for which the user stated in the Message Hub Service Binding has read/write permissions. In case you can't see the topic you were expecting, please contact your message broker's administrator.

Edit Event Topic Bindings

You can edit the master data of an event topic binding by using the Edit capability of each table row in the Event Topic Bindings section on the Infrastructure tab of a domain namespace's Overview page. Alternatively, you can use the Info capability, navigate to the Master Data section and use the Edit Master Data capability there.

The following field can be edited:

  • Message Hub Service Binding

  • Topic Name

  • Retention Hours

Tip: By changing the Message Hub Service Binding and/or the Topic Name in an Event Topic Binding you can easily use a different event topic whenever needed without touching your implementation code. You can also overwrite these values for different deployment targets and still use the exact same implementation code inside your project.
Note: It's not possible to edit the Binding Name of an event topic binding.

Delete Event Topic Bindings

You can delete event topic bindings by using the Delete capability of each table row in the Event Topic Bindings section on the Infrastructure tab of a domain namespace's Overview page.

Attention: You can only delete an event topic binding if it is not in use. You can check the usages of an event topic binding by using the Info capability and navigating to the Usages section. You will need to confirm the action before the selected event topic binding is permanently deleted.