ParseImports

NAME
    ParseImports : Accept a file of imported bibliographic data, try to work
    out what format it is in and then return an XML structure for that data.

DESCRIPTION
    The ParseImports CGI script is designed to allow front end code to hand
    off a file of bibliographic data which this script will then attempt to
    parse and return in a known structure. The front end can then take this
    structure and use it to all a user to populate one or more reading
    lists.

PARAMETERS
  Standard
    *username* - Name of user running this CGI script.
    *password* - Password for the user.
    *security_hash* - An opaque value used to authenticate the user without
    requiring the password to be sent. Optional.
    *session_id* - An opaque string as far as the server is concerned that
    is intended solely to allow async clients to differentiate different
    results more easily. Optional.

  Specific for this script
    *bib_file* - The file containing the data to be parsed

RESULTS
    The script returns an XML document in the standard LUMP response format
    (as documented in LUMP-XML-Response). The <returns> section's contents
    obey the following DTD fragment:

     <!ELEMENT returns (import_format, works)>
     <!ELEMENT import_format (#PCDATA)>
     <!ELEMENT works (work+)>
     <!ELEMENT work (type|author|title|part_author|part_title|pubdate|publisher|note|url|isbn|issn|pages|issue|volume|edition)>
     <!ELEMENT type (#PCDATA)>
     <!ELEMENT author (#PCDATA)>
     <!ELEMENT title (#PCDATA)>
     <!ELEMENT part_author (#PCDATA)>
     <!ELEMENT part_title (#PCDATA)>
     <!ELEMENT pubdate (#PCDATA)>
     <!ELEMENT publisher (#PCDATA)>
     <!ELEMENT pages (#PCDATA)>
     <!ELEMENT note (#PCDATA)>
     <!ELEMENT url (#PCDATA)>
     <!ELEMENT issue (#PCDATA)>
     <!ELEMENT edition (#PCDATA)>
     <!ELEMENT volume (#PCDATA)>
     <!ELEMENT isbn (#PCDATA)>
     <!ELEMENT issn (#PCDATA)>

    The <error> section contains SUCCESS in the <error_code> if the
    operation finishes successfully, or a failure error code if it doesn't.
    The <error_message> element contains a human readable message that can
    be used to inform the user of problems if desired.

SEE ALSO
    FindSuid

    LUMP-XML-Response

COPYRIGHT
    Copyright 2011 Loughborough University Library <library@lboro.ac.uk>.

    Permission is granted to copy, distribute and/or modify this document
    under the terms of the GNU Free Documentation License, Version 1.2 or
    any later version published by the Free Software Foundation; with no
    Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
    Texts.
Go to Top