DatabaseContext :: executeLogin - Execute login function

The action is called when opening a database in order to verify user's login data. The default implementation requests the user name and password.

The action can be implemented as function in the database context class in order to provide login procedures for console applications. The function will be called from within the login() function, which should be called in the doBeforeOpen() handler of the database context class.

The property handle passed to the function is usually the property handle for the ADM_User extent, but depending on specific login requirements, any other property handle can be passed when calling the functionlogin().

The default implementation prompts the user for entering user name and password. User name is searched for in the collection handled by rProperty. The collection has to be ordered by login name. The password is assumed to be stored in the password attribute defined for user instances in rProperty. When no password has been defined so far, the password entered by the user has to be confirmed and will be stored in the password attribute for the user.