The Update verb

This flow shows the process logic for this collaboration template's Retrieve and Delete verbs:

Update flow

The following flow shows the process logic for this collaboration template's Update verb:
  1. A DataStore collaboration object is triggered by the receipt of a SampleObject business object from a source collaboration object. The triggering business object passed into the DataStore collaboration object must contain values for all the fields that make up the ObjectKey attribute of the stored SerialObject application specific business object, as defined by the value of the OBJECT_KEY configuration property in the DataStore collaboration object.
    Note: The entire business object in the database will be replaced by this operation. Therefore, the calling collaboration object might want to first retrieve the business object from the database , modify any attributes which need to be updated, and then again invoke the DataStore collaboration object with the modified business object and the Update verb. See The Retrieve verb.
  2. The DataStore collaboration object copies the triggering SampleObject business object into a high-level object called DataStoreSampleObject. This object is passed into the IBM® WebSphere® Business Integration Data Handler for XML. By default, it contains the application specific information needed by the data handler. The data handler outputs a string, which contains an XML representation of the SampleObject business object passed into the collaboration object.
  3. The DataStore collaboration object builds an application specific business object called SerialObject, which includes two attributes:
    • ObjectData, which is set equal to the XML output from the data handler.
    • ObjectKey, which is created from the key information in the SampleObject business object and the value of the DataStore collaboration object's OBJECT_KEY property (by default, uniqueId). This attribute holds the unique key used to store the object in the database.
  4. The completed SerialObject is sent to the To port of the DataStore collaboration object, which is bound to a JDBCConnector. The JDBCConnector overwrites the existing SerialObject in the database with the updated one. If the object does not already exist in the database, a ServiceCall exception is thrown and the Update operation fails.

Parent topic: Overall process logic