IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Services and service-related functions > Access external services with adapters > Configure and using adapters > IBM WebSphere Adapters > SAP Software > SAP interfaces > Advanced event processing interface

Inbound processing for the Advanced event processing interface

The adapter uses the Advanced event processing interface to poll for events on the SAP server, to process the events, and to send them to an endpoint.

The following list describes the sequence of processing actions that result from an inbound request using the Advanced event processing interface.

  1. A triggered event enters the event table with an initial status of pre-queued.

  2. When the adapter polls for events, the status of the event changes from pre-queued to queued if there are no database locks for the combination of the user who created the event and the event key.

  3. After the event is retrieved from the event table, the status of the event is updated to InProgress.

    If locks exist, the status of the event is set to locked and the event is re-queued into the queue. Every event with a pre-queued or locked status is updated with every poll. You can configure the polling frequency using the Poll Frequency property.

  4. After preprocessing all pre-queued events, the adapter selects the events.

    The property Poll Quantity determines the maximum number of events returned for a single poll call.

  5. For each event, the adapter uses the remote function specified for the Retrieve operation to retrieve the data and send it to the endpoint.

    If the AssuredOnceDelivery property is set to true, an XID value is set for each event in the event store. After each event is picked up for processing, the XID value for that event is updated in the event table.

    If the connection to the SAP system is lost or the application is stopped before the event is delivered to the endpoint, the event is consequently not processed completely. The XID column ensures that the event is reprocessed and sent to the endpoint. After the SAP connection is reestablished or the adapter starts up again, it first checks for events in the event table that have a value in the XID column. It then processes these events first and then polls the other events during the poll cycles.

  6. After each event is processed, it is updated or archived in the SAP application.

    When the event is processed successfully, it is archived and then deleted from the event table.

    The adapter can also filter the events to be processed by business object type. The filter is set in the Event Filter Type property. This property has a comma-delimited list of business object types, and only the types specified in the property are picked for processing. If no value is specified for the property, no filter is applied and all the events are picked up for processing.

The Advanced event processing interface