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

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)

IsNewRecordPending Business Component Method

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

An example script for the use of this method follows:

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

GetOldFieldValue Business Component Method

This method can be called by using a script in the PreWriteRecord event to retrieve an old field value if needed. This 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");

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 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");

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 method, SetRequeryOnWriteFlag, can be called 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");