Event processing for a single IDoc

An IDoc corresponds to a single business object. The adapter can process an ALE event that contains just one IDoc.

The following steps describe how the adapter processes an inbound event for a single IDoc.

  1. When the SAP system pushes the Transaction ID (TID) to the adapter, the adapter checks the status of the event.
    • If this is a new event, the adapter stores the TID along with a status of CREATED in the event recovery table.
    • If the event status is ROLLBACK, the adapter updates the status to CREATED.
    • If the event status is EXECUTED, the adapter returns a return code of SUCCESS to the SAP system.
  2. The SAP system pushes the single IDoc to the adapter, which parses and converts the IDoc to a business object and stores it in memory.
  3. The adapter sends the business object to the appropriate message endpoint. Note that the adapter can deliver objects to endpoints that support transactions as well as endpoints that do not support transactions:
    • For endpoints that support transactions, the adapter delivers the business object as part of a unique XA transaction (a two-phase commit transaction) controlled by the application server. When the endpoint receives the event and the transaction is committed, the status of the event is updated to EXECUTED. The message endpoint must be configured to support XA transactions.
    • For endpoints that do not support transactions, the adapter delivers the business object to the endpoint and updates the status of the event to EXECUTED.
  4. If an exception occurs while either the adapter processes the event or the endpoint receives the object, the adapter throws an exception to the SAP system.
  5. The SAP system sends a ROLLBACK call to the adapter and the event status is updated to ROLLBACK.
  6. If no exception occurs, the SAP system sends a COMMIT call to the adapter, and the event is updated to EXECUTED.
  7. The SAP system sends a CONFIRM call to the adapter.
  8. The adapter deletes the records with an EXECUTED status and logs a common event infrastructure (CEI) event that can be used for tracking and auditing purposes.

Terms of use |

Last updated: Sun Mar 12 11:15:17 2006

(c) Copyright IBM Corporation 2005.
This information center is powered by Eclipse technology (http://www.eclipse.org)