Siebel Financial Services Connector for VCML Guide > VCML Connector Configuration >

FINS VCML XML Transaction Manager

The FINS VCML XML Transaction Manager business service is responsible for data transactions with a Siebel Database. It may invoke the EAI Siebel Adapter or another business service configured in its user properties. It is an adapter that resides logically between the Siebel Object Manager and the rest of the connector. It executes operations specified in an XML message instance as Siebel Database transactions.

The FINS VCML XML Transaction Manager business service translates XML command elements into EAI Siebel Adapter operations. The FINS VCML XML Transaction Manager business service either carries out the operation or finds another business service to carry out the operation.

The FINS VCML XML Transaction Manager business service also combines return results as a single property set. A property set is an intermediate data store that can be used in subsequent operations within the connector.

For inbound processing, the FINS VCML XML Transaction Manager business service accepts a VCML XML property set, which may contain multiple integration object instances for multiple transactions. It pairs each individual transaction request with an integration object instance and invokes methods in EAI Siebel Adapter.

For outbound processing, the FINS VCML XML Transaction Manager business service pairs a transaction request with an integration object instance and sends a VCML XML property set to the FINS VCML XML DTE business service.

The FINS VCML XML Transaction Manager business service enhances the existing rollback functionality of the EAI Siebel Adapter. The EAI Siebel Adapter automatically rolls back any update, delete, or insert transaction if it encounters an error.

When integrating with external systems, there are times when you need to roll back changes made to the Siebel application because of an error in an external system. For example, if an update to the Siebel application triggers an integration message to an external system, and the external system experiences an error, then you either need to roll back the Siebel data to the state before the update, or inform the user. Because the error occurs outside of the Siebel application, the EAI Siebel Adapter rollback cannot be used. In such cases the FINS VCML XML Transaction Manager business service can be configured to save a previous image of Siebel data to be used to roll back the Siebel data.

The FINS VCML XML Transaction Manager business service examines the XMLHierarchy input argument for a node with a special user property value set by the FINS VCML XML Dispatcher business service. This node identifies whether or not the external system had an error in the message, and it includes the error code and the error message from the external system. The node to use as the error node is identified by user properties on the FINS VCML XML Dispatcher business service with the XMLFaultObject user property.


 Siebel Financial Services Connector for VCML Guide 
 Published: 18 April 2003