retrieve_my_ejournals

This X-Service retrieves a list of ‘My e-Journals’ for a logged-in user and includes information about each e-Journal.

• login – Called once by the calling application with valid /X user name and password. The session-id retrieved should be passed to all other API calls
• Authentication (either local or remote)
  • bor_auth – for local authentication of the user and to retrieve a valid borrower’s ID
  • PDS authentication – for remote authentication of the user and to obtain a pds handleor bor_info
• retrieve_my_ejournals

Mandatory

1. SESSION_ID – X(50)

2. User ID Options:

• Option 1
  • SOURCE_ID – X(40)
  • INSTITUTE – X(30)
  • VERIFICATION – X(20)
• Option 2
  • BOR_ID – X(12)
  • VERIFICATION – X(20)
• Option 3
  • PDS_HANDLE – X(50)

Explanation of the mandatory and optional parameters:

• session_id – The session ID is the unique identifier of the login.
• user id – One of the following:
  • source_id – source_ID of user requesting My e-Journals.
    institute – User’s institution.
    verification – User’s password
  • bor_id – User_ID of the user requesting My e-Journals.
    verification – User’s password
  • pds_handle – User’s unique token returned by the remote authentication system

Example:

<?xml version = "1.0" encoding = "UTF-8"?>
<x_server_request>
  <retrieve_my_ejournals>
    <session_id>32GS85B67MEX93N5PX6AAH8PYEXI1XPNPMQU8SCHJ9QR1R5I5D</session_id>
      <source_id>david</source_id>
      <verification>david123</verification>
      <institute>METALIB</institute>
  </retrieve_my_ejournals>
</x_server_request>

In order to retrieve My e-Journals, the input parameters must be embedded within the appropriate URL syntax:

MetalibPath:port/X?op=retrieve_my_ejournals&bor_id=patron num&verification=***&session_id=session_id

Example:

http://ram47:8334/X?op=retrieve_my_ejournals&source_id=david&verification=david123&institute=metalib&session_id=L9UUHVLPA7LUTEQYM7YJX8GLH6FDR2V77GRG6TIQ21UIXQEXH2

• Number of e-Journals – A number representing the amount of e-Journals saved for the specified user.
• e-Journal title – Name of the e-Journal.
• e-Journal ISSN – The unique ISSN for the e-Journal.
• e-Journal SFX-ID – The unique SFX identifier number for the e-Journal.
• e-Journal Full-Text link – A direct link to the e-Journal’s full-text, if available.
• e-Journal SFX link – A link to the e-Journal’s SFX menu.

<?xml version = "1.0" encoding = "UTF-8"?>
<x_server_response metalib_version="4.01 (42)">
<retrieve_my_ejournals_response>
  <no_of_ejournals>000000002</no_of_ejournals>
  <info_data>
    <ejournal_title>AACE International transactions</ejournal_title>
    <ejournal_issn>1528-7106</ejournal_issn>
    <ejournal_sfx_id>111027618397000</ejournal_sfx_id>
    <ejournal_sfx_fulltext_link></ejournal_sfx_fulltext_link>
    <ejournal_sfx_link></ejournal_sfx_link>
  </info_data>
  <info_data>
    <ejournal_title>AACE journal</ejournal_title>
    <ejournal_issn>1551-3696</ejournal_issn>
    <ejournal_sfx_id>1000000000023034</ejournal_sfx_id>
    <ejournal_sfx_fulltext_link></ejournal_sfx_fulltext_link>
    <ejournal_sfx_link></ejournal_sfx_link>
    </info_data>
<session_id new_session="N">L44A7TJESN3YMTDFJ8C4MNF7AYHUJ3V6LF8DBCGSTCCEP56GGH</session_id>
</retrieve_my_ejournals_response>
</x_server_response>

<error_code>6060</error_code>
<error_text>INSTITUTE must be given along with the source_id</error_text>

<error_code>6001</error_code>
<error_text>User does not exist</error_text>

<error_code>6025</error_code>
<error_text>Institution does not exist</error_text>

<error_code>0129</error_code>
<error_text>User cannot be authenticated locally</error_text>

<error_code>0130</error_code>
<error_text>Your password pincode is not equal to the verification pincode - enter these fields again</error_text>

<error_code>2038</error_code>
<error_text>Missing mandatory element from XML request <element_name>.</error_text>