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

FORM_SUCCESS Built-in

Description

Returns the outcome of the action most recently performed during the current Runform session.

Outcome

Returned Value

success

TRUE

failure

FALSE

fatal error

FALSE

Syntax

FUNCTION FORM_SUCCESS;

Built-in Type unrestricted function

Return Type:

BOOLEAN

Enter Query Mode yes

Parameters

None.

Usage Notes

FORM_SUCCESS Examples

/*

** Built-in: FORM_SUCCESS
** Example: Check whether the most-recently executed Built-in
** succeeded.
*/
BEGIN
/*
** Force validation to occur
*/
Enter;
/*
** If the validation succeeded, then Commit the data.
**

*/
IF Form_Success THEN
Commit;
IF :System.Form_Status <> 'QUERY' THEN
Message('Error prevented Commit');
RAISE Form_Trigger_Failure;
END IF;
END IF;
END;


About Evaluating the Success or Failure of Built-ins

FORM_FAILURE Built-in

FORM_FATAL Built-in