Calls the form with the specified name and displays any resulting HTML page to the user.
This provides the ability to call another Ebase Xi form and then return to the calling form using method #returnFromForm().
Parameters are passed to the called form via form fields. Any such fields must have the URL Parameter property set in the called form.
When passing a form field value from the calling form, the field's stringValue property should be used (see examples below).
Parameters are returned from the called form using form fields with the Return field property set. All form fields in the called
form that have this property setting are returned to the calling form.
These fields must have the same name in both the calling and called forms.
Execution of the current script is suspended and resumes with the next statement when the called form returns.
The current transaction is committed prior to calling the form, and a new transaction is started when the called form returns.
Javascript example: Note: In form ORDER_DISPLAY, fields ORDER_ID, CUSTOMER_ID and CREDIT_LIMIT have property URL Parameter set and field ORDER_UPDATED has property Return field set.
var parms = {};
parms.ORDER_ID = fields.ORDER.stringValue;
parms.CUSTOMER_ID = fields.CUSTOMER.stringValue;
parms.CREDIT_LIMIT = 9999;
form.callForm("ORDER_DISPLAY", parms);
/// ..process returned field values
if (fields.ORDER_UPDATED.value)
..
Parameters are passed to the called form via form fields. Any such fields must have the URL Parameter property set in the called form. When passing a form field value from the calling form, the field's
stringValueproperty should be used (see examples below).Parameters are returned from the called form using form fields with the Return field property set. All form fields in the called form that have this property setting are returned to the calling form. These fields must have the same name in both the calling and called forms.
Execution of the current script is suspended and resumes with the next statement when the called form returns. The current transaction is committed prior to calling the form, and a new transaction is started when the called form returns.
Javascript example:
Note: In form ORDER_DISPLAY, fields ORDER_ID, CUSTOMER_ID and CREDIT_LIMIT have property URL Parameter set and field ORDER_UPDATED has property Return field set.
var parms = {}; parms.ORDER_ID = fields.ORDER.stringValue; parms.CUSTOMER_ID = fields.CUSTOMER.stringValue; parms.CREDIT_LIMIT = 9999; form.callForm("ORDER_DISPLAY", parms); /// ..process returned field values if (fields.ORDER_UPDATED.value) ..