rap-business-events

RAP Business Events & Enterprise Eventing

Guide for implementing event-driven patterns using RAP business events and SAP Event Mesh in ABAP Cloud.

Workflow

1. Determine the user's goal:

   • Defining business events in a RAP BO
   • Raising events from RAP handler methods
   • Binding events for consumption
   • Consuming events from external systems
   • Integrating with SAP Event Mesh
   • Understanding event-driven architecture in ABAP

2. Identify the scenario:

   • Local event (within the same ABAP system)
   • Enterprise event (cross-system via Event Mesh)
   • Event producer vs. event consumer

3. Guide implementation following RAP eventing patterns

Business Events Overview

Concept	Description
Business Event	Declared in BDEF; raised when something significant happens
Event Definition	Formal declaration with parameters in the behavior definition
Event Raising	Triggered in handler/saver methods via RAISE ENTITY EVENT
Event Binding	Maps RAP event to an enterprise event topic for external delivery
Event Consumption	External systems subscribe and react to published events

Defining Business Events

In the Behavior Definition (BDL)

managed implementation in class zbp_r_travel unique;
strict ( 2 );

define behavior for ZR_Travel alias Travel
persistent table ztravel_tab
lock master
authorization master ( instance )
etag master LocalLastChangedAt
{
  create;
  update;
  delete;

  "Define business events
  event travel_created parameter ZD_TravelCreatedEvt;
  event travel_accepted;
  event travel_rejected;
}

Event Parameter Structure

Define a CDS abstract entity for the event payload:

@EndUserText.label: 'Travel Created Event'
define abstract entity ZD_TravelCreatedEvt
{
  travel_id   : /dmo/travel_id;
  agency_id   : /dmo/agency_id;
  customer_id : /dmo/customer_id;
  description : /dmo/description;
  total_price : /dmo/total_price;
  currency    : /dmo/currency_code;
}