OpenEdge Development: Mobile Applications - Product ...

login( ) method
username
A string expression containing a user ID for the method to send to the Web server
for authentication.
password
Note: The userName property returns the most recent value passed to this
method for the current Session object.
A string expression containing a password for the method to send to the Web
server to authenticate the specified user.
login-target
A string expression that when appended to service-uri specifies a Mobile Web
application resource against which the specified user is authenticated. If you do
not specify a value for login-target, the value is set to "/static/home.html"
by default.
Note: The value returned by the loginTarget property of the Session object is
either the value of the login-target parameter or the default
("/static/home.html").
When the method completes, it returns one of the following numeric constants to
indicate the result:
• progress.data.Session.SUCCESS — User login session started successfully.
After you have downloaded JSDO catalogs using the addCatalog( ) method for
supported Mobile services, you can create JSDOs for each Mobile resource
provided by these services.
• progress.data.Session.AUTHENTICATION_FAILURE — User login failed
because of invalid user credentials (username or password).
• progress.data.Session.GENERAL_FAILURE — User login failed because of a
non-authentication failure.
You can also return the result for the most recent login attempt on the current Session
object by reading the loginResult property. For a more specific status code returned
in the HTTP response, you can check the value of the loginHttpStatus property.
The general Web server interaction with and response to this method depends on the
authentication model that the Web server uses and how resources are accessed and
protected. You configure the authentication model for each Mobile Web application
deployed to the Apache Tomcat.
228 OpenEdge ® Development: Mobile Applications