Confluent Cloud

Synopsis

This quickstart guide shows how to set up the OData Business Events Source Connector on Confluent Cloud.

Preliminary Setup

  1. Make sure to have a working Confluent Cloud environment as described in Confluent Cloud Quickstart Guide.
  2. Ensure that you have a running cluster with AWS or Microsoft Azure as the provider.
  3. Confirm that Confluent Cloud has a network connection to the OData services published by your SAP system.
Note

In order to be able to upload a custom connector to Cloud, a supported AWS or Microsoft Azure provider and region is currently required. For more information and limitations on custom connectors, see Custom Connectors for Confluent Cloud. Check the list of the cloud providers as well as the regions and zones supported by Confluent Cloud.

Connector Installation

  1. Go to the menu item Connectors via the left navigation bar and click on the button “Add plugin”.
  2. Give the connector a name, a description, specify the path to the connector class and select the type of connector.
  3. Upload the zipped connector package init-kafka-connect-odatabusevent-x.x.x.zip via the Connector archive.
  4. Click “Submit”. Now the connector should be displayed as a plugin via the Connector menu list.

Connector Configuration

The Business Events Source Connector can be configured via the Connector menu list.

  1. Select the connector and generate the API Key.
  2. A key and a secret will be generated, write it down/copy it, as it will not be displayed later. Then select “Continue”.
  3. In this overview, the properties can be inserted via the JSON submenu. Nested layers are not recognized, only the pure config is inserted.

Sales Order Business Events

For the connector to extract data for business events of type Sales Order, you need to follow these steps:

  1. Transfer the properties including a minimal configuration to the JSON submenu. Remember to add in your license key.

    name = busevent-source-connector
connector.class = org.init.ohja.kafka.connect.odata.busevent.source.ODataBusinessEventsSourceConnector
tasks.max = 1
sap.odata.license.key = "Your license key here"
sap.odata.host.address = services.odata.org
sap.odata.host.port = 443
sap.odata.host.protocol = https
sap.odata.user.name = anonymous
sap.odata.user.pwd = anonymous
sap.busevent.subscriber.code = KBES
sap.busevent#00.object.type = SalesOrder
sap.busevent#00.object.task-code = Deleted,Created,Changed
sap.busevent#00.topic = Order_Details
sap.busevent#00.event.priority = 1
sap.busevent#00.object.resolve = 0
sap.busevent#00.service = /sap/opu/odata/sap/API_SALES_ORDER_SRV
sap.busevent#00.entityset = A_SalesOrder
  2. Click “Continue” to select how many tasks should be used and launch the connector.
  3. Click “Continue” to get to the Business Events Source Connector overview. The entries can be checked here.
  4. Click “Continue” to launch the connector. It may take a few minutes for the connector to start. After the connector is launched, the new topics and a new topic for the logs appear under the Topics submenu.
1.3.6