WebForm.gotoForm

Transfers control to the form with the specified name, terminates execution of the current form and commits the current transaction. Form memory is freed, and return to the current form is not possible by any method including the browser back button. Navigation back to the current form using the browser back button is not possible.

Execution of this method immediately terminates the event currently being executed, no statements past this method call will be executed.

This method can only be called within the context of a web form event. When called from any other context, e.g. a JSP, a RuntimeException is thrown.

Parameters are passed to the target 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).

Javascript example: Note: In form ORDER_DISPLAY, fields ORDER_ID, CUSTOMER_ID and CREDIT_LIMIT have property URL Parameter set.

 var parms = {};
 parms.ORDER_ID = fields.ORDER.stringValue;
 parms.CUSTOMER_ID = fields.CUSTOMER.stringValue;
 parms.CREDIT_LIMIT = 9999;
 form.gotoForm("ORDER_DISPLAY", parms);
 

Parameters

java.lang.String  formName,  java.util.Map  parameters,