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 Create operation
The after-image Create operation generates a new entity in the EIS that matches the data and structure of the input business object. The business object returned by this operation should accurately reflect the newly created entity in the EIS.
Processing overview
The processing of the after-image create operation, which starts at the top-level business object, is as follows:
- Create an entity in the EIS corresponding to the type of the input business object
- If the EIS does not generate its own primary key (or keys), insert the key values from the input business object into the appropriate key column (or columns) of the EIS entity.
- Update the output business object to reflect the values of the newly created EIS entity; this includes any EIS-generated key values or properties marked as having potential side-effects (see property-level metadata).
- Recursively create the EIS entities corresponding to the first-level child business objects, and continue recursively creating all child business objects at all subsequent levels in the business object hierarchy.
Operation return value
The output written to the output cursor should contain any newly-created key values and other side effects.
Error handling
The DuplicateRecordException exception is thrown if the EIS already contains an entity with the same key values as a business object to be created.
The InvalidRequestException exception is thrown if any of the following inputs to the operation are not supported:
- If key values are specified in the input business object but the EIS supports auto-creation only
- If key values are not specified in the input business object but the EIS requires them
- If the top-level verb, if provided, is not Create (assertion optional)
The EISSystemException exception is thrown if the EIS reports any unrecoverable errors.