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 > Lotus Domino > Overview of WebSphere Adapter for Lotus Domino > Technical overview > Outbound processing > Outbound operations

Update operation

The Update operation updates a document in the Lotus Domino server based on the request from the SCA.

The adapter receives the update request from the SCA application along with the Universal ID of the document. The adapter processes the request and makes the specified updates to the document.

A document in the Lotus Domino server has a Universal ID and a If ID associated with it. The adapter uses the value set in the Universal ID to search the document in the Domino database. If the Universal ID is not provided in the request business object, the adapter tries to use the value set in the If ID. The adapter throws an error when both the Universal ID and the If ID are not provided in the request business object.

By default, the adapter updates only those items in the document that have valid data in the business object. The remaining items are not updated in the document. The items in a document in the Lotus Domino server correspond to the fields in a business object of the WebSphere Adapter for Lotus Domino. During update, if the value of a business object field is explicitly set to null, the adapter updates the document by removing the item from the document.

After the document is updated, it is sent back to the calling component to indicate that the document was updated successfully.

The response sent back to the calling component has the same business object structure as the request business object. The response also has attributes that include the Universal ID and information about the result of the operation.

No response documents (children) to the actual documents are removed during the Update operation.

The Update operation might throw the InvalidRequestFault, the DocumentNotFoundFault, or the InvalidParentDocumentFault fault depending upon the processing error. For more information about these business faults, refer to Fault business objects.

Outbound operations


Related reference:

Fault business objects