Prototype

FORM_SHOW(FORM_REF, [DO_SHOW = 1])

Changes the visibility of a FORM making it visible or invisible depending on the value of the parameter doShow

Special considerations:

If the visibility is set to TRUE but it is already visible, then the function does nothing
If the visibility is set to TRUE and it is currently hidden, its status can be set either to OPEN or CLOSED depending on
- If the FORM has no question that needs interaction from the USER, then its status will be set to CLOSED
- If the FORM has at least one question that needs interaction from the USER, then its status will be set to OPEN (no matter if the question is completed or not)

Input Parameters

FORM_REF

reference to a FORM OBJECT

Accepted values:

Numeric value: it is considered to be a direct FORM reference
Alphanumeric string: it is considered a FORM_CODE. The FORM is searched only in the current TASK (the one where the formula is executed). The wildcard '%' is supported since API version 2.7.21
Array of form references
A formula expression that returns valid FORM references (array or single value)

Special values:

"THIS": hides the FORM from where the formula is executed
"NEXT": hides the next FORM following the one where the formula is executed
"NEXT:form_code": (introduced in API version 2.7.21) hides the next FORM following the one where the formula is executed that has the FORM_CODE specified. Wildcard '%' is supported.

DO_SHOW

integer

This parameter is optional. The default value is 1

Execution

Immediate unless the FORMULA is defined in an ITEM of type 'ACTION' (which are always executed when a FORM is closed)

Examples

Formula	Description
FORM_SHOW(12322)	Makes visible the FORM with reference 12322
FORM_SHOW(12322, 0)	Hides the FORM with reference 12322
FORM_SHOW([12322,12323], 0)	Hides the FORMs with references 12322 and 12323
FORM_SHOW("NEXT")	Makes visible the next FORM in the TASK
FORM_SHOW("MANEUVER:BAS")	Makes visible all the FORMs of the current TASK whose FORM_CODE is "MANEUVER:BAS"
FORM_SHOW("MANEUVER:%")	Makes visible all the FORMs of the current TASK whose FORM_CODE starts with "MANEUVER"
FORM_SHOW("NEXT:MANEUVER%")	Makes visible the next FORM in the TASK that has a FORM_CODE starting with "MANEUVER"
FORM_SHOW($2, 0)	Hides the FORM whose reference is the one stated in question $1
FORM_SHOW(ADMISSION.FORM{MANEUVER:BAS}.REF, 0)	Hides all the FORMs in the current ADMISSION whose FORM_CODE is "MANEUVER:BAS" (see OBJECT CODES)

Browser not supported