11.01.2013 Views

Oracle Forms Developer – Form Builder Reference, Volume 1

Oracle Forms Developer – Form Builder Reference, Volume 1

Oracle Forms Developer – Form Builder Reference, Volume 1

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Pre-Logout trigger<br />

Description<br />

Fires once before <strong>Form</strong> <strong>Builder</strong> initiates a logout procedure.<br />

Definition Level form<br />

Legal Commands<br />

SELECT statements, unrestricted built-ins<br />

Enter Query Mode no<br />

Usage Notes<br />

Use a Pre-Logout trigger to prepare the form for logging out from the data source, particularly a non-<br />

ORACLE data source.<br />

If you call certain built-ins from within one of the Logout triggers, the results are undefined. For<br />

example, the COPY built-in cannot be called from a Pre-Logout trigger because Pre-Logout fires after<br />

the Leave the <strong>Form</strong> event. Because the form is no longer accessible at this point, the COPY operation is<br />

not possible.<br />

On Failure<br />

The results of a failure depend on which of the following conditions applies:<br />

• If <strong>Form</strong> <strong>Builder</strong> is exiting the form and the trigger fails, the form is exited gracefully, but no other<br />

triggers are fired.<br />

• If the trigger fails while <strong>Form</strong> <strong>Builder</strong> is attempting to execute the LOGOUT built-in from within the<br />

trigger, <strong>Form</strong> <strong>Builder</strong> raises the FORM_TRIGGER_FAILURE exception.<br />

If an exception is raised in a Pre-Logout trigger, <strong>Form</strong> <strong>Builder</strong> does not fire other triggers, such as On-<br />

Logout and Post-Logout .<br />

Fires In<br />

LOGOUT<br />

See Process Flowcharts<br />

485

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!