bor_update

General Purpose

This service is used to create and update the user details (Z312) record.

Input Parameters

1. ID PICTURE X(20).
2. VERIFICATION PICTURE X(20).
3. INSTITUTE PICTURE X(30).
4. LNG PICTURE X(3).
5. NAME PICTURE X(200).
6. TITLE PICTURE X(10).
7. GROUP PICTURE 9(2).
8. PROFILE-ID PICTURE X(12).
9. ADDRESS-1 PICTURE X(50).
10. ADDRESS-2 PICTURE X(50).
11. ADDRESS-3 PICTURE X(50).
12. ADDRESS-4 PICTURE X(50).
13. ADDRESS-5 PICTURE X(50).
14. ZIP PICTURE X(9).
15. EMAIL-ADDRESS PICTURE X(60).
16. TELEPHONE-1 PICTURE X(30).
17. TELEPHONE-2 PICTURE X(30).
18. BIRTH-DATE PICTURE 9(8).
19. EXPIRY-DATE PICTURE 9(8).

  • ID: User login name.
  • VERIFICATION: User password.
  • INSTITUTE: Currently not used.
  • LNG: Language to be used for correspondence with the user.
  • NAME: User’s name.
  • TITLE: This is the form of address, such as Ms. or Professor.
  • GROUP: The group to which the user belongs. Access rights can be assigned to objects by groups.
  • PROFILE-ID: User’s profile. The profile contains the user’s preferences for display and retrieval of information in the RD. The profile is also used to define the user’s permissions to upload personal objects.
  • ADDRESS-1: User’s address.
  • ADDRESS-2: Additional user address.
  • ADDRESS-3: Additional user address.
  • ADDRESS-4: Additional user address.
  •  ADDRESS-5: Additional user address.
  • ZIP: ZIP code of user.
  • EMAIL_ADDRESS: Electronic mail address of the user for correspondence via e-mail.
  • TELEPHONE-1: Telephone number of the user.
  • TELEPHONE-2: Additional telephone number of the user.
  • BIRTH-DATE: User’s date of birth. Format: YYYYMMDD.
  • EXPIRY-DATE: User’s account will not be usable after this date. Format: YYYYMMDD.

Output XML Format

The output XML includes the all information for the patron ID you enter.

Example:
To update patron information, enter the following URL:

http://il-dtldev01:8881/X?op=bor-update&session_id=U6XJH49694PA8LJNRGQHVRUGSS5U4K8UK6XV5QKNHH6HC56R4Y&id=dep&VERIFICATION=dep&name=dep&ADDRESS-1=geti&EMAIL-ADDRESS=tziki.fridman@exlibris.co.il

If successful, the example above generates XML output containing all relevant information:

<?xml version="1.0" encoding="UTF-8" ?>
<bor-update>
<z312>
  <z312-bor-id>PATRON1</z312-bor-id>
  <z312-source-id>dep</z312-source-id>
  <z312-verification />
  <z312-institute />
  <z312-name-key>dep PATRON1</z312-name-key>
  <z312-open-date>20080416</z312-open-date>
  <z312-update-date>20050411</z312-update-date>
  <z312-con-lng />
  <z312-name>dep</z312-name>
  <z312-title />
  <z312-group>00</z312-group>
  <z312-type>2</z312-type>
  <z312-profile-id />
  <z312-address-0>geti</z312-address-0>
  <z312-zip />
  <z312-email-address>tziki.fridman@exlibris.co.il</z312-email-address>
  <z312-telephone-1 />
  <z312-telephone-2 />
  <z312-birth-date>00000000</z312-birth-date>
  <z312-expiry-date>20090416</z312-expiry-date>
  <z312-last-action-date>00000000</z312-last-action-date>
  <z312-confirmation>Y</z312-confirmation>
  </z312>
  <session-id>U6XJH49694PA8LJNRGQHVRUGSS5U4K8UK6XV5QKNHH6HC56R4Y</session-id>
</bor-update>

Possible Error Codes

1. If this X-Service is activated without an email address having been entered, the following error message appears in the XML output:

<error>Missing Email Address</error>

2. If this X-Service is activated without a patron ID having been entered, the following error message appears in the XML output:

<error>ID is missing</error>

3. If this X-Service is activated without verification having been entered, the following error message appears in the XML output:

<error>Missing Verification</error>

4. If this X-Service is activated without ADDRESS-1 having been entered, the following error message appears in the XML output:

<error>Missing address</error>