Publish events to Pub/Sub

The document describes how to publish events to Pub/Sub through the Business Eventing Toolkit for SAP.

Prerequisites

Make sure that you or your administrators have completed the following prerequisites:

  • Enabled the Pub/Sub API. For information about how to enable Google Cloud APIs, see Enabling APIs.
  • Created a Pub/Sub topic. For information about how to create a Pub/Sub topic, see Create a topic.
  • Configured a client key for authentication. For information about how to set up authentication in the on-premises or any cloud edition of ABAP SDK for Google Cloud, see Authentication overview.
  • The service account configured in the client key for authentication must have the following role: Pub/Sub Publisher(roles/pubsub.publisher).

  • Configured target Google Cloud services with the following details:

    • Event Processor Class: /GOOG/CL_PUBLISHER_PUBSUB
    • Google Cloud Key Name: The client key for authentication.
    • Event Parameter 1: The name of the Pub/Sub topic.

    For information about how to configure target Google Cloud services, see Configure target Google Cloud services.

Publish events

To publish event data to Pub/Sub, call the publish() method:

DATA: lt_data TYPE /goog/if_ce_publisher=>tt_messages.

" Write logic to populate LT_DATA.
lt_data = VALUE #( ( data = 'Hello World!' ) ).

/goog/cl_event_publisher=>publish_event(
      EXPORTING
        iv_event_key = 'EVENT_KEY'
        it_data      = lt_data
      IMPORTING
        et_output    = DATA(lt_output)
    ev_ret_code  = DATA(lv_ret_code)
ev_err_text  = DATA(lv_err_text)
).

Replace EVENT_KEY with the event key configured for publishing events to Pub/Sub.

To send an event as a CloudEvent, you can configure the Cloud Event Default Attribute Key and attach this key to your Event key when configuring the target Google Cloud services. The Business Eventing Toolkit for SAP then picks up the default attribute values for the CloudEvent.