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:
- String Userid – i.e "amarx"
- String password – i.e. "A_marx"
- 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:
