getUserInfo()

This method is used to validate a user's userid and password. The method queries the database for the provided information. If the credentials exist in the database, a record is returned containing the user's account information.

The getUserInfo() takes several arguments:

1. String Userid – i.e "amarx"
2. String password – i.e. "A_marx"
3. String schemaVersionNumber --  i.e. "2.1"

In the web service client we might auto generate a data structure by providing the web service url. In eLandings we use Java – JAX-WS and generate a structure called ReportManager.

ReportManagement ws;
...
...

String xml = ws.getUserInfo(UserID, Password, schemaVersionNumber)

Or

String xml = ws.getUserInfo("amarx", "A_marx", "2.1");

If you went to http://elandingstest.alaska.gov/elandings/Login

Enter:
UserID = amarx
Password = A_marx
Click the Login Button

The following web service call would be made:
String xml = ws.getUserInfo("amarx", "A_marx", "2.1");
If the web service call is successful, you might see a string containing a processor_user_info structure containing one or more authorized operations objects
getUserInfo_result_on_success.txt
If the web service call was unsuccessful, you will recive an error message within the processor_user_info string.
For example, on the eLandings web page login, if you entered userid = amarx and an incorrect password = "A_marx1234".

The following web service call would be made:
String xml = ws.getUserInfo("amarx", "A_marx1234", "2.1");
The resulting string would look something like the following:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<processor_user_info>
    <messages>
        <message severity_desc="ERROR" severity_code="E" msgid="1278">User AMARX could not be authenticated</message>
    </messages>
    <schema_version>2.1</schema_version>
</processor_user_info>

The error is displayed to the user as:

For the list of potential elandings messages see the elandings codes page and click on Message Codes