This service authenticates a staff user.
The X-Server does not change any data.
Product Version Compatibility
Version 18 and later
1. STAFF_USER X(10).
2. STAFF_PASS X(10).
3. LIBRARY X (5).
Staff_user: The ID of the authenticated staff.
Staff_pass: The password of the authenticated staff.
Library: ADM library for which the user is to be authenticated.
Both Staff_user and staff_pass can be inserted in lowercase and uppercase letters. As the system always saves this data in uppercase letters, the X-Server handles the data correctly in any event.
Output XML Format
The output XML includes a message indicating success or a descriptive error code. If the authorization is successful, then the Z66 record will also be returned. All Z66 fields that might contain user name/user password are discarded from the XML.
To authenticate the user TREK, enter the following URL:
If all goes well, the output XML contains a reply and the Z66 record:
<?xml version = "1.0" encoding = "UTF-8"?> <user-auth> <reply>ok</reply> <z66> <z66-user-library>USM50</z66-user-library> <z66-name>John Smith</z66-name> <z66-department>Science</z66-department> <z66-email>email@example.com</z66-email> <z66-address></z66-address> <z66-telephone></z66-telephone> <z66-note-1></z66-note-1> <z66-note-2></z66-note-2> <z66-user-cat-level>00</z66-user-cat-level> <z66-function-proxy></z66-function-proxy> <z66-catalog-proxy></z66-catalog-proxy> <z66-budget-proxy></z66-budget-proxy> <z66-order-unit-proxy></z66-order-unit-proxy> <z66-user-own-create>PUBLIC</z66-user-own-create> <z66-user-own-check>PUBLIC</z66-user-own-check> <z66-user-circ-level>00</z66-user-circ-level> <z66-ill-unit>ILL_LAW</z66-ill-unit> <z66-open-date></z66-open-date> <z66-update-date></z66-update-date> <z66-expiry-date>01/11/2019</z66-expiry-date> <z66-last-alert-date></z66-last-alert-date> <z66-last-login-date></z66-last-login-date> <z66-block>N</z66-block> <z66-block-reason></z66-block-reason> <z66-no-fail>0</z66-no-fail> </z66> <session-id>SHYXEMFNRNPE39LG9PJ1H63I9T1342GNT7T6K2PHGD6XCLBL31</session-id> </user-auth>
Possible Error Codes
1. If a staff member is blocked, an error message stating that he/she is blocked is retrieved along with the reason for blocking taken from the relevant field in the Z66 record:
< error>User is blocked by the system due to the following reason:
staff is blocked for testing.</error>
2. If a non-existing staff_user / staff_pass is / are given, the following message appears in the XML output:
< error>No such staff member exists. Make sure both user and password are correct.</error>
3. If a staff member’s access rights have expired, the following message appears in the XML output (with the date the access rights expired):
< error>User login has expired on 03\10\2006.</error>
4. When PASSWORD-NO-USE-PERIOD in tab100 indicates that too much time has elapsed since the last login of the staff member, the following message appears in the XML output (with the last login date):
< error>User login has not been in use since 01\09\2006, and has been blocked.</error>