Oracle Forms Developer – Form Builder Reference, Volume 1

Usage Notes
156
equivalent of concatenating USER_NLS_LANGUAGE,
USER_NLS_TERRITORY, and USER_NLS_CHARACTER_SET.
USER_NLS_LANGUAGE Returns the current value of the language
portion only of the USER_NLS_LANG environment variable defined for
the form operator. If USER_NLS_LANG is not explicitly set, it defaults to
the setting of NLS_LANG.
USER_NLS_TERRITORY Returns the current value of the territory
portion only of the USER_NLS_LANG environment variable defined for
the form operator. If USER_NLS_LANG is not explicitly set, it defaults to
the setting of NLS_LANG
USERNAME Returns the name of the current operator. Note: If the user
connects by using an OPS$ account,
GET_APPLICATION_PROPERTY(USERNAME) will not return the
actual username. In this case, you should use
GET_APPLICATION_PROPERTY(CONNECT_STRING) to retrieve
username information.
To request a complete login, including an appended connect string, use the Username, Password, and
Connect_String properties. For instance, assume that the user has initiated an Microsoft Windows
Runform session specifying the following connect string:
ifrun60 my_form scott/tiger@corpDB1
Form Builder returns the following string as the result of a call to
GET_APPLICATION_PROPERTY(USERNAME):
scott
Form Builder returns the following string as the result of a call to
GET_APPLICATION_PROPERTY(PASSWORD):
tiger
Form Builder returns the following string as the result of a call to
GET_APPLICATION_PROPERTY(CONNECT_STRING):
corpDB1
GET_APPLICATION_PROPERTY restrictions
To retrieve the timer name of the most recently executed timer, you must initiate a call to
GET_APPLICATION_PROPERTY from within a When-Timer-Expired trigger. Otherwise, the results
of the built-in are undefined.
GET_APPLICATION_PROPERTY examples
Example 1
/*
** Built-in: GET_APPLICATION_PROPERTY
** Example: Determine the name of the timer that just
** expired, and based on the username perform a
** task.
** trigger: When-Timer-Expired
*/