A script-enabled browser is required for this page to function properly.

GO_FORM Built-in

Description

In a multiple-form application, navigates from the current form to the indicated target form. When navigating with GO_FORM, no validation occurs and no triggers fire except WHEN-WINDOW-DEACTIVATED, which fires for the form that initiates navigation, and WHEN-WINDOW-ACTIVATED, which fires for the target window in the target form.

Attempting to navigate to a form that has not yet been opened raises an error.

Syntax

PROCEDURE GO_FORM
(form_id FORMMODULE);

PROCEDURE GO_FORM
(form_name VARCHAR2);

Built-in Type restricted procedure

Enter Query Mode no

Parameters

form_id 
 
The unique ID that is assigned to the form dynamically when it is instantiated at runtime. Use the FIND_FORM Built-in to return the ID to an appropriately typed variable. The data type of the ID is FORMMODULE.
 
form_name 
 
The name of the target form. The data type of name is VARCHAR2. The GO_FORM Built-in attempts to search for the form module name, not the name of the .fmx file.

GO_FORM Restrictions

The target form cannot be a form that is currently disabled as a result of having invoked another form with CALL_FORM.