Update verb

Process logic for the Update verb.

Flow

  1. A MessageStore collaboration object is triggered by the receipt of a UCCnetGBO_storable business object. The triggering business object passed into the MessageStore collaboration object must contain values for all the fields that make up the ObjectKey attribute of the stored SerialMessage application specific business object, as defined by the value of the OBJECT_KEY configuration property in the MessageStore 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 MessageStore collaboration object with the modified business object and the Update verb.
  2. The MessageStore collaboration object copies the triggering UCCnetGBO_storable business object into a high-level object called DataStoreUCCnetGBO_storable. 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 UCCnetGBO_storable business object passed into the collaboration object.
  3. The MessageStore collaboration object builds an application specific business object called SerialMessage, 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 UCCnetGBO_storable business object and the value of the MessageStore collaboration object's OBJECT_KEY property. This attribute holds the unique key used to store the object in the database.
  4. The completed SerialMessage is sent to the To port of the MessageStore collaboration object, which is bound to a JDBCConnector. The JDBCConnector overwrites the existing SerialMessage 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