XML:AuthorUpdate

From ISFDB
Jump to navigation Jump to search

Introduction

The AuthorUpdate submission updates author information for a single specific author.

Required Tags

The submission contains one required tag:

  • Record - Specifies which author record to update.

Optional Tags

The AuthorUpdate 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 unchaged, it should not be included in the submission. If a field value needs to be deleted (for instance a webpage is decommissioned), the tag value should be empty. The following tags are supported:

  • Canonical - Should contain the author's canonical name.
  • Legalname - Should contain the author's legal name in Lastname, Firstname format.
  • Lastname - Contains the author's last name. It is used to determine which page within the Author Directory the author's name will appear on. For example, setting the value of this field to "von Ruff" instead of "Ruff" will make the author record appear on the "Vo" page rather than on the "Ru" page.
  • Birthplace - Should contain the author's birthplace, in City, State/Province, Country format.
  • Birthdate - Should contain the author's birth date in YYYY-MM-DD format. If the month and day are unknown, YYYY-00-00 should be used.
  • Deathdate - Should contain the author's death date in YYYY-MM-DD format. If the month and day are unknown, YYYY-00-00 should be used. If the author is known to be dead, but the death date is unknown 0000-00-00 is acceptable.
  • Language - Should contain the primary working language of the author. The list languages currently recognized by ISDFB can be found on the My Preference page.
  • Emails - Should contain a list of the child tag Email, which should contain the author's email addresses. There should be a separate Email tag (enclosed within a single Emails tag) for each email address.
  • Webpages - Should contain a list of the child tag Webpage, which should contain the author's website URL. There should be a separate Webpage tag (enclosed within a single Webpages tag) for each website.
  • Image - Should contain the URL to an author picture.

Example

 <?xml version="1.0" encoding="iso-8859-1" ?>
 <IsfdbSubmission>
   <AuthorUpdate>
     <Record>347</Record>
     <Subject>David Duncan</Subject>
     <Submitter>ErnestoVeg</Submitter>
     <Birthdate>1913-02-17</Birthdate>
     <Deathdate>1999-12-26</Deathdate>
   </AuthorUpdate>
 </IsfdbSubmission>