Difference between revisions of "XML:TitleUpdate"

From ISFDB
Jump to navigation Jump to search
m (+cat)
(→‎Optional Tags: REVIEW and INTERVIEW clarification)
 
(2 intermediate revisions by 2 users not shown)
Line 11: Line 11:
 
==Optional Tags==
 
==Optional Tags==
  
−
The TitleUpdate submission also contains a number of optional tags. These tags should be used whenever an update is made to a particular field. If a particular field is unchanged, it should not be included in the submission. If a field value needs to be deleted, the tag should be included, but the value should be empty. The following section describes the tags are supported in the metadata section. You should refer to [[Help:Screen:EditTitle]] for more detailed information on data entry. The bold text in the description refers to specific labels found in the Help article:
+
The TitleUpdate submission also supports a number of optional tags. These tags should be used whenever an update is made to a particular field. If a particular field is unchanged, it should not be included in the submission. If a field value needs to be deleted, the tag should be included, but the value should be empty. The following section describes the tags that are supported in the metadata section. You should refer to [[Help:Screen:EditTitle]] for more detailed information on data entry. The bold text in the description refers to specific labels found in the Help article:
  
 
* '''Title''' - The '''Title''' of the title.
 
* '''Title''' - The '''Title''' of the title.
 
* '''Authors''' - The '''Author''' list associated with the title. This XML tag will enclose:
 
* '''Authors''' - The '''Author''' list associated with the title. This XML tag will enclose:
 
** '''Author''' - There should be one '''Author''' entry for each individual who wrote or edited the title.
 
** '''Author''' - There should be one '''Author''' entry for each individual who wrote or edited the title.
−
* '''BookAuthors''' - The '''Author''' list associated with the authors who's work appeared in this review. This XML tag will enclose:
+
* '''Year''' - The '''Date''' of publication using the YYYY-MM-DD format.
−
** '''BookAuthor''' - There should be one '''Author''' entry for each individual who wrote the title being reviewed.
 
−
* '''Interviewees''' - The '''Author''' list associated with who was interviewed. This XML tag will enclose:
 
−
** '''Interviewee''' - There should be one '''Author''' entry for each individual who was interviewed.
 
−
* '''Year''' - The '''Date''' of publication.
 
 
* '''Series''' - The '''Series Name''' this title is associated with.
 
* '''Series''' - The '''Series Name''' this title is associated with.
 
* '''Seriesnum''' - The '''Series Number''' of this title.
 
* '''Seriesnum''' - The '''Series Number''' of this title.
 
* '''Storylen''' - The '''Length''' of this title.
 
* '''Storylen''' - The '''Length''' of this title.
−
* '''Wikipedia''' - A URL to a '''Wikipedia Entry''' on this title.
+
* '''Language''' - The '''Language''' of this title. See "My Preferences" for a list of supported languages.
 
* '''TitleType''' - The '''Entry Type''' of this title.
 
* '''TitleType''' - The '''Entry Type''' of this title.
 +
* '''Webpages''' - A list of '''Webpage''' entries for this title. This XML tag will enclose:
 +
** '''Webpage''' - A web page associated with this title
 
* '''Synopsis''' - The '''Synopsis''' of this title.
 
* '''Synopsis''' - The '''Synopsis''' of this title.
−
* '''Note''' - A '''Note''' associated with this title.
+
* '''Note''' - A permanent '''Note''' associated with this title.
 +
* '''ModNote''' - A note to the approving moderator. This note will disappear after the submission has been approved or rejected.
 +
 
 +
For REVIEW titles '''only''', the following tags are also supported:
 +
 
 +
* '''BookAuthors''' - The '''BookAuthor''' list associated with the authors who's work was reviewed in this review. This XML tag will enclose:
 +
** '''BookAuthor''' - There should be one '''BookAuthor''' entry for each individual who wrote the title being reviewed.
 +
 
 +
For INTERVIEW titles '''only''', the following tags are also supported:
 +
 
 +
* '''Interviewees''' - The '''Interviewee''' list associated with the people who were interviewed. This XML tag will enclose:
 +
** '''Interviewee''' - There should be one '''Interviewee''' entry for each individual who was interviewed.
  
 
==Example==
 
==Example==
  
 +
<source lang="xml">
 
  <?xml version="1.0" encoding="iso-8859-1" ?>
 
  <?xml version="1.0" encoding="iso-8859-1" ?>
 
   <IsfdbSubmission>
 
   <IsfdbSubmission>
Line 40: Line 50:
 
   </TitleUpdate>
 
   </TitleUpdate>
 
  </IsfdbSubmission>
 
  </IsfdbSubmission>
 +
</source>
  
  
 
[[Category:Data Submission Formats|TitleUpdate]]
 
[[Category:Data Submission Formats|TitleUpdate]]

Latest revision as of 23:51, 13 February 2014

Introduction

The TitleUpdate submission updates title information for a single specific title.

Required Tags

The submission contains one required tag:

  • Record - Required tag. Specifies which title record to update.

Optional Tags

The TitleUpdate submission also supports a number of optional tags. These tags should be used whenever an update is made to a particular field. If a particular field is unchanged, it should not be included in the submission. If a field value needs to be deleted, the tag should be included, but the value should be empty. The following section describes the tags that are supported in the metadata section. You should refer to Help:Screen:EditTitle for more detailed information on data entry. The bold text in the description refers to specific labels found in the Help article:

  • Title - The Title of the title.
  • Authors - The Author list associated with the title. This XML tag will enclose:
    • Author - There should be one Author entry for each individual who wrote or edited the title.
  • Year - The Date of publication using the YYYY-MM-DD format.
  • Series - The Series Name this title is associated with.
  • Seriesnum - The Series Number of this title.
  • Storylen - The Length of this title.
  • Language - The Language of this title. See "My Preferences" for a list of supported languages.
  • TitleType - The Entry Type of this title.
  • Webpages - A list of Webpage entries for this title. This XML tag will enclose:
    • Webpage - A web page associated with this title
  • Synopsis - The Synopsis of this title.
  • Note - A permanent Note associated with this title.
  • ModNote - A note to the approving moderator. This note will disappear after the submission has been approved or rejected.

For REVIEW titles only, the following tags are also supported:

  • BookAuthors - The BookAuthor list associated with the authors who's work was reviewed in this review. This XML tag will enclose:
    • BookAuthor - There should be one BookAuthor entry for each individual who wrote the title being reviewed.

For INTERVIEW titles only, the following tags are also supported:

  • Interviewees - The Interviewee list associated with the people who were interviewed. This XML tag will enclose:
    • Interviewee - There should be one Interviewee entry for each individual who was interviewed.

Example

 <?xml version="1.0" encoding="iso-8859-1" ?>
   <IsfdbSubmission>
     <TitleUpdate>
     <Record>11114</Record>
     <Submitter>DESiegel60</Submitter>
     <Subject>Breed to Come</Subject>
     <Year>1972-00-00</Year>
   </TitleUpdate>
 </IsfdbSubmission>
Retrieved from "https://isfdb.org/wiki/index.php?title=XML:TitleUpdate&oldid=342321"