Integration Platform Technologies: Siebel eBusiness Application Integration Volume ll > External Business Components > Configuring External Business Components >

About Using Specialized Business Component Methods for EBCs

Following are 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 will return 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, that should 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 write. This is typically used by EBCs 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 into 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");