Bookshelf v7.5: Outcalls

The Siebel Connector for IFX XML provides default behaviors for a variety of methods (shown in Table 21). If the default behaviors do not suit your needs, the Siebel Connector for IFX XML allows outcalls to override the defaults.

For example, the Siebel default for the <SignonRq> method is user name and password. The configurator can provide an outcall function for a certificate instead.

The outcall function is activated by the IFX Application Business Service Name parameter. If you want to use an outcall, you define a business service that encloses the outcall functionality, and then enter the business service name in the IFX Application Business Service Name parameter.

If the connector cannot find the business service identified in the IFX Application Business Service Name parameter, default functionality is used instead.

Siebel Connector for IFX XML Outcall Methods

This section lists all methods that the Siebel Connector for IFX XML can use for outcalls. You can implement them using either eScript or VB. For more details, see Siebel eScript Language Reference and Siebel VB Language Reference.

In Table 21, the input argument values are provided by the Siebel Connector for IFX XML, and the output argument values are returned to the Siebel Connector for IFX XML.

Table 21. Connector Outcall Methods
Method	Input Argument	Output Argument	Remarks
GenerateSignonRq	An empty property set	Property set contains <SignonRq> aggregate in property set format	Generate a customized <SignonRq> aggregate instead of having the IFX connector generate a default <SignonRq> aggregate.
GenerateSignonRs	Complete IFX request document in property set format	Property set contains <SignonRs> aggregate	Generate a customized <SignonRs> aggregate instead of having the IFX connector generate a default <SignonRs> aggregate.
GenerateSignoffRq	An empty property set	Property set contains <SignoffRq> aggregate in property set format	Generate a customized <SignoffRq> aggregate instead of having the IFX connector generate a default <SignoffRq> aggregate.
GenerateSignoffRs	Complete IFX request document in property set format.	Property set contains <SignoffRs> aggregate.	Generate a customized <SignoffRs> aggregate instead of having the IFX connector generate a default <SignoffRs> aggregate.
GenerateUUID	A property set with Type = GUID	A property set with generated GUID stored as its <Value>	Generate a valid GUID to be <RqUID>.
ProcessSignonRq	Complete IFX request document in property set format	Not required1	Process <SignonRq>.
ProcessSignonRs	Complete IFX request document in property set format	Not required	Process <SignonRs>.
ProcessSignoffRq	Complete IFX request document in property set format	Not required	Process <SignoffRq>.
ProcessSignoffRs	Complete IFX response document in property set format	Not required	Process <SignoffRs>.
ProcessStatus	An IFX response message	Not required	Process <Status>. This method is called once for every response message.
FormatFieldFromXML	A property set with Type: IFX data type for this element Value: Element value in IFX data format	A property set with Value: Element value in Siebel data format	Convert element value from IFX data format to Siebel data format. This method is called for every element when data formatting is enabled.
FormatFieldToXML	A property set with Type: IFX data type for this element Value: Element value in Siebel data format	A property set with Value: Element value in IFX data format	Convert element value from Siebel data format to IFX data format. This method is called for every element when data formatting is enabled.

1Process methods do not require output values because the connector is not expecting any value in return. For example, if StatusCode is not 0, you may want to process the information in your own application, but no value is expected by the FINS IFX XML Converter.