Difference between revisions of "Data Submission Formats"
Jump to navigation
Jump to search
DESiegel60 (talk | contribs) m (+cat) |
(→Title Related Submissions: Note about LinkReview and LinkSerial) |
||
| Line 46: | Line 46: | ||
* [[XML:MakeVariant]] - Makes the current title a variant title. | * [[XML:MakeVariant]] - Makes the current title a variant title. | ||
* [[XML:VariantTitle]] - Adds a variant title to the current title. | * [[XML:VariantTitle]] - Adds a variant title to the current title. | ||
| − | * [[XML:LinkReview]] - | + | * [[XML:LinkReview]] - not yet online at this time. |
| − | * [[XML:LinkSerial]] - | + | * [[XML:LinkSerial]] - not yet online at this time. |
==Series Related Submissions== | ==Series Related Submissions== | ||
Revision as of 15:31, 21 May 2008
Introduction
The data submitted to the ISFDB must be a well-formed XML string. All submissions must contain the following:
- An xml header utilizing version 1.0, and a recommended encoding of iso-8859-1.
- The data must be enclosed within a set of IsfdbSubmission tags.
- The data must contain a valid registered user within a set of Submitter tags.
- The data must contain a subject heading within a set of Subject tags. This subject is displayed in the moderator queue, and is not integrated into the ISFDB data.
A stubbed out version of a generic submission looks like this:
<?xml version="1.0" encoding="iso-8859-1" ?>
<IsfdbSubmission>
<...Type...>
<Submitter>Registered_User_Name</Submitter>
<Subject>Subject Line That Will Appear in Moderator Queue</Subject>
...
</...Type...>
</IsfdbSubmission>
Author Related Submissions
There are two data submission types necessary for the upkeep of the authors table:
- XML:AuthorMerge - handles merging two authors together; it does have side effects on publication and title mapping tables, as one of the authors is replaced with the other.
- XML:AuthorUpdate - handles changes made to the author-related tables; it has no side effects on other tables.
- XML:MakePseudonym
Note that there are no submission types to create or delete author entries. Author entries are created on demand when a title or publication requires them. Likewise author entries are deleted when no other records refer to them.
Publication Related Submissions
There are four data submission types necessary for the upkeep of the pubs table:
- XML:NewPub - Adds a new publication record.
- XML:PubDelete - Deletes a publication record.
- XML:PubUpdate - Modifies a publication record.
- XML:TitleRemove - Removes one or more titles from a publication record.
Title Related Submissions
- XML:TitleUpdate - Modifies a title record.
- XML:TitleDelete - Deletes a title record.
- XML:TitleMerge - Merges two or more title records.
- XML:TitleUnmerge - Unmerges one or more title records.
- XML:MakeVariant - Makes the current title a variant title.
- XML:VariantTitle - Adds a variant title to the current title.
- XML:LinkReview - not yet online at this time.
- XML:LinkSerial - not yet online at this time.