This method is used to validate a user¿s 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 user's account information.
The getUserInfo() takes several arguments:1.
- 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)
...
String xml = ws.getUserInfo(¿amarx¿, ¿A_marx¿, ¿2.1¿"amarx", "A_marx", "2.1");
If you went to http://elandingstest.alaska.gov/elandings/Login
EnterEnter:
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:
Code Block |
---|
<?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