Oracle Forms Developer – Form Builder Reference, Volume 1

LOGON built-in
Description
Performs the default Form Builder logon processing with an indicated username and password. Call this
procedure from an On-Logon trigger when you want to augment default logon processing.
Syntax
PROCEDURE LOGON
(username VARCHAR2,
password VARCHAR2);
PROCEDURE LOGON
(username VARCHAR2,
password VARCHAR2,
logon_screen_on_error VARCHAR2);
Built-in Type unrestricted procedure
Enter Query Mode yes
Parameters
This built-in takes the following arguments:
username Any valid username of up to 80 characters.
password Any valid password of up to 80 characters, including a database connect
string.
logon_screen_ on_error An optional BOOLEAN parameter that, when set to TRUE (default), causes
Form Builder to automatically display the logon screen if the logon
specified fails (usually because of a incorrect username/password). When
logon_screen_on_error is set to FALSE and the logon fails, the logon
screen will not display and FORM_FAILURE is set to TRUE so the
designer can handle the condition in an appropriate manner.
Usage Notes:
272
When using LOGON to connect to an OPS$ database use a slash ’/’ for the user.name and the
database name for the password..
LOGON restrictions
• If you identify a remote database, a SQL*Net connection to that database must exist at runtime.
• Form Builder can connect to only one database at a time. However, database links may be used to
access multiple databases with a single connection.
LOGON examples
/*
** Built-in: LOGON
** Example: Perform Form Builder standard logon to the ORACLE
** database. Decide whether to use Form Builder