Loughborough Online Reading List System
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 <firstname.lastname@example.org>. 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.