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 > Adapter Toolkit > Implementing code from the IBM WebSphere Adapter Toolkit > Data model > Business object standards > Standard processing logic

After-image Delete operation

The after-image Delete operation removes an existing entity and any contained child entities from the EIS.


Processing overview

The after-image Delete operation is processed as follows:

  1. Perform a recursive retrieve on the input business object to obtain all data in the EIS that is associated with the top-level business object.

  2. Perform a recursive delete on the entities represented by the input business object, starting from the lowest-level entities and ascending to the top-level entity; non-contained entities should be left intact although any relationships to deleted objects should be removed if explicitly defined in the EIS.

Adapters should also delete any and all contained children whether or not they are reflected in the input business object.

For example, if just a top-level business object is provided with keys and no children, the adapter should still check for contained children in the EIS and delete them.


Operation return value

Since the deletion of an entity in the EIS only requires a return that indicates the success (or failure) of the operation, the goal is to convey this with as little overhead as possible. The Delete operation might or might not return anything. The adapter should handle the case where the output record is initialized with the same metadata as the input cursor. In this case, it is not necessary to populate the output data on getNext, apart from the key information.


Error handling

The RecordNotFoundException exception is thrown if the EIS does not contain an entity with the same key values as the business object to be deleted.

The InvalidRequestException exception is thrown if input to the operation is not supported.

The EISSystemException exception is thrown if the EIS reports any unrecoverable errors.

Standard processing logic