Integration Platform Technologies: Siebel Enterprise Application Integration > External Business Components >

About Using Specialized Business Component Methods for EBCs

The following are the specialized business component methods that are supported for use with EBCs:

• IsNewRecordPending
• GetOldFieldValue
• SetRequeryOnWriteFlag (PreWriteRecord event)
• SetRequeryOnWriteFlag (WriteRecord event)

About the IsNewRecordPending Business Component Method

This method can be invoked by using a script in the PreWriteRecord event to determine if the current record is newly created. If the record is a new record, this method returns the value TRUE.

An example script for the use of this method follows:

var isNewRecord = this.InvokeMethod("IsNewRecordPending");

About the GetOldFieldValue Business Component Method

This method can be invoked by using a script in the PreWriteRecord event to retrieve an old field value if needed. This invoke method takes an input parameter, which must be a valid field name, and returns a string containing the old field value.

An example script for the use of this method follows:

var oldLoc = this.InvokeMethod("GetOldFieldValue", "Location");

About the SetRequeryOnWriteFlag (PreWriteRecord event) Business Component Method

In the PreWriteRecord event, this method can be used to put the business component into a mode where the current record refreshes from the data source after the write operation. EBCs typically use this method to refresh database sequencing column values on new record operations. This invoke method takes an input parameter of TRUE or FALSE.

An example script for the use of this method follows:

var requery = this.InvokeMethod("SetRequeryOnWriteFlag", "TRUE");

About the SetRequeryOnWriteFlag (WriteRecord event) Business Component Method

In the WriteRecord event, this method informs the object manager that the write operation to the data source is processed by using a script rather than a database connector. At the end of the operation, the business component invoke method, SetRequeryOnWriteFlag, can be invoked again with the FALSE parameter to reset the requery on write mode, if needed.

An example script for the use of this method follows:

var extWrite = this.InvokeMethod("SetRequeryOnWriteFlag", "TRUE");
// insert script here to commit the record via an mechanism channel
var resetWrite = this.InvokeMethod("SetRequeryOnWriteFlag", "FALSE");