ApplyChanges operation

During this operation, the adapter processes any business object requiring a create, update, or delete operation.

This operation offers processing efficiency and it also simplifies data mapping between business objects. If the top-level verb exists in the business object, then the business object is processed as an after-image. If no top-level verb exists in the business object, then the ChangeSummary is processed.

When the ApplyChanges operation is used for create or delete transactions, the processing is the same as for those operations except that the ChangeSummary contains information about the object and the operation, and the verb is not set.

When the ApplyChanges operation is used for an update transaction, the adapter performs delta update processing if the verb is not set in the business object. The adapter inspects the ChangeSummary to identify the update operation for each business object in the input hierarchy, and then it performs those operations on the objects. For the top-level object, the operation must be update, but for child objects, the operation can be either create, update, or delete.

Therefore, the ApplyChanges operation offers processing efficiency because it can appropriately process an input business object to the adapter that only contains child objects within the hierarchy that require action. The update operation that is processed as a snapshot update, by comparison, requires that the entire business object hierarchy be input to the adapter.

Related concepts
Create operation
Retrieve operation
Update operation
Delete operation
Exist operation
RetrieveAll operation

Terms of use |

Last updated: Sun Mar 12 11:24:18 2006

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