Bookshelf Home | Contents | Index | Search | PDF

Siebel Financial Services Connector for VCML Guide > VCML Connector Configuration > FINS VCML XML Transaction Manager >

FINS VCML XML Transaction Manager Methods and Arguments

---

The FINS VCML XML Transaction Manager methods are explained in Table 5.

Table 5. FINS VCML XML Transaction Manager Methods

Method	Display Name	Function
Execute	Execute Transaction	Can be used for inbound or outbound messages when the integration object instance is provided. When only Row Id is available, use the Execute Outbound method.
ExecuteOutbound	Execute Outbound	Executes an outbound operation specified in input arguments.
ExecuteSave	Execute and Save	Executes an outbound operation specified in input arguments and saves the transaction result in memory or in a file. Similar to ExecuteOutbound, but it saves the transaction result to an in-memory cache or to a file. This method is used to save a previous image of the Siebel data, so that if an update to Siebel data generates an error in an external system, you can restore the data.

Table 6 describes the method arguments for the FINS VCML XML Transaction Manager.

Table 6. Method Arguments for the FINS VCML XML Transaction Manager

Name	Value	Description
OnlyIOI	True, False	Default is False. When set to False, every request information is carried over. For details, see Additional Notes on Transaction Manager Method Arguments. If this value is set to True, every nonmessage information from the request message is dropped so that the converter and the DTE do not need to deal with, for example, header information.
XMLHierarchy	Input/Output XML Property Set	The property set holder for input and output hierarchies.
IXMLMapPath	Entry key for the dispatcher map	Stores the key value for dispatcher map. For details on the dispatcher map, see Dispatcher Map Integration Objects. The FINS VCML XML Transaction Manager business service uses it to look up the value for the integration object instances.
PrimaryRowId	Row Id of a Siebel object	The primary Row Id of the Siebel object that is used by the EAI Siebel Adapter to execute a query operation on the Siebel Database.
SiebelFINS OperationOut	Operation name from user property	The operation to be used by the FINS VCML XML Transaction Manager business service that is predefined in the user properties of the FINS VCML XML Transaction Manager business service. This value must match one of the user properties that reference business service operations described in Table 4.
SearchSpec	Search specification	The search specification for a query that is used by the EAI Siebel Adapter to execute a query operation on the Siebel Database.
ReportErrInMsg	True, False	Default is False. When set to False, no error object is generated in the output hierarchy, even if an error occurs in the invoked business service. If it is set to True the FINS VCML XML Transaction Manager business service generates an error object within the output hierarchy. Used for inbound flows only.
PlaceToSave	File or Mem	Default is Mem. Used only by the ExecuteSave method. The before image of the Siebel data is generated by querying and saving the resulting integration object instance. When saving to memory, the FINS VCML XML Transaction Manager business service saves the previous image to a session level cache, identified by the key specified by the SaveInMemForRollback user property. Setting this to Mem prevents file conflicts.
RollbackInError	True, False	Default is False. This argument indicates whether or not the transaction should be rolled back. For details, see Additional Notes on Transaction Manager Method Arguments.

Additional Notes on Transaction Manager Method Arguments

This section provides additional notes on the two method arguments listed in Table 6.

OnlyIOI. For an inbound message, the integration object instance for request may contain header, body, and envelope portions. When the FINS VCML XML Transaction Manager business service takes the proper operation against the Siebel Database, the integration object instance for response is generated as well.

RollbackInError. If this method argument is set to False, and the error node is present in the incoming integration object instance, then the FINS VCML XML Transaction Manager business service sets the business service error code and error message to the values in the error object. If multiple error nodes are present in the incoming instance, then the business service error code is set to the value of the first error code encountered, and the business service error message is set to the concatenation of all error messages in every error nodes. When a business service terminates with a nonzero error code, the default behavior of the workflow engine is to terminate the workflow process and return the error message to the calling process. If no error node is present, then the FINS VCML XML Transaction Manager business service performs the requested action.

If set to True, and the error node is present in the incoming integration object instance, then the FINS VCML XML Transaction Manager business service ignores the input XMLHierarchy input argument and upserts Siebel Database with the previous image saved in memory by the ExecuteSave method. If no error node is present, then the FINS VCML XML Transaction Manager business service performs the requested action.

Table 7 lists the arguments for the Execute method.

Table 7. Arguments for Execute Method

Argument	Display Name	Data Type	Type	Optional
OnlyIOI	Only produce Integration Object Instance	String	Input	Yes
ReportErrInMsg	Report Error In Message	String	Input	Yes
RollbackInError	Rollback In Error	String	Input	Yes
XMLHierarchy	XML Property Set	Hierarchy	Input/Output	No

Table 8 lists the attributes for the arguments for the Execute Outbound method.

Table 8. Arguments for Execute Outbound Method

Name	Display Name	Data Type	Type	Optional
IXMLMapPath	IXMLMapPath	String	Input	No
PrimaryRowId	PrimaryRowId	String	Input	Yes
SearchSpec	SearchSpec	String	Input	Yes
SiebelFINSOperationOut	SiebelFINSOperationOut	String	Input	No
XMLHierarchy	XMLHierarchy	Hierarchy	Output	No

Table 9 lists the attributes for the arguments for the Execute and Save method.

Table 9. Arguments for Execute and Save Method

Name	Display Name	Data Type	Type	Optional
IXMLMapPath	IXML Map Path	String	Input	No
PlaceToSave	Save into File/Mem	String	Input	Yes
PrimaryRowId	Primary Row Id	String	Input	Yes
SearchSpec	Search Specification	String	Input	Yes
SiebelFINS OperationOut	Outbound Operation	String	Input	No
XMLHierarchy	XML Hierarchy	Hierarchy	Output	No

Bookshelf Home | Contents | Index | Search | PDF