Difference between revisions of "XML:TitleMerge"

From ISFDB
Jump to navigation Jump to search
(New page: ==Introduction== The TitleMerge submission merges 2 or more titles into a single title. ==Required Tags== The submission contains one required tag: * '''KeepId''' - Required tag. Speci...)
 
 
(3 intermediate revisions by 3 users not shown)
Line 5: Line 5:
 
==Required Tags==
 
==Required Tags==
  
The submission contains one required tag:
+
The submission contains two required tags:
  
* '''KeepId''' - Required tag. Specifies which title record to retain. All others will be discarded after the merge.
+
* '''KeepId''' - Specifies which title record to retain. All others will be discarded after the merge.
 +
* '''DropId''' - Specifies which title to drop. Multiple DropIds may be included in a single submission.
  
 
==Optional Tags==
 
==Optional Tags==
  
The TitleMerge submission also contains a number of optional tags. These tags should be used whenever a particular field differs between the merged titles. Each used tag refers to a title record number. When the submission is integrated, the value associated with the named record will be retained. For instance, say there are 3 titles being merged which have copyright years of 1952, 1953, and 1980. A '''Year''' merge tag is generated which selects the record associated with the year 1952. When the submission is integrated, if the retained title record has a year value other than 1952, then that value will be copied into the retained record. The tags contain only record numbers; they do not contain data values.
+
The TitleMerge submission also supports a number of optional tags. These tags should be used whenever a particular field differs between the merged titles. Each used tag refers to a title record number. When the submission is integrated, the value associated with the named record will be retained. For instance, say there are 3 titles being merged which have copyright years of 1952, 1953, and 1980. A '''Year''' merge tag is generated which selects the record associated with the year 1952. When the submission is integrated, if the retained title record has a year value other than 1952, then that value will be copied into the retained record. Note that the tags contain '''only record numbers'''; they do '''not''' contain data values.
  
The following section describes the tags are supported in the metadata section. You should refer to [[Editing:Merging_Titles]] for more detailed information on data entry:
+
The following section describes the tags that are supported in the metadata section. Refer to [[Editing:Merging_Titles]] for more detailed information on data entry:
  
 
* '''Title''' - Record number with the desired title.
 
* '''Title''' - Record number with the desired title.
Line 22: Line 23:
 
* '''Seriesnum''' - Record number with the desired series number.
 
* '''Seriesnum''' - Record number with the desired series number.
 
* '''Storylen''' - Record number with the desired length.
 
* '''Storylen''' - Record number with the desired length.
 +
* '''Language''' - Record number with the desired language.
 
* '''Synopsis''' - Record number with the desired synopsis.
 
* '''Synopsis''' - Record number with the desired synopsis.
* '''Wikipedia''' - Record number with the desired wikipedia URL.
 
 
* '''Note''' - Record number with the desired note.
 
* '''Note''' - Record number with the desired note.
 
* '''Parent''' - Record number with the desired parent (for variant titles).
 
* '''Parent''' - Record number with the desired parent (for variant titles).
Line 29: Line 30:
 
==Example==
 
==Example==
  
 +
<source lang="xml">
 
  <?xml version="1.0" encoding="iso-8859-1" ?>
 
  <?xml version="1.0" encoding="iso-8859-1" ?>
 
  <IsfdbSubmission>
 
  <IsfdbSubmission>
Line 35: Line 37:
 
     <DropId>170262</DropId>
 
     <DropId>170262</DropId>
 
     <Title>7287</Title>
 
     <Title>7287</Title>
 +
    <Language>170262</Language>
 
     <Year>7287</Year>
 
     <Year>7287</Year>
 
     <Series>7287</Series>
 
     <Series>7287</Series>
Line 40: Line 43:
 
   </TitleMerge>
 
   </TitleMerge>
 
  </IsfdbSubmission>
 
  </IsfdbSubmission>
 +
</source>
 +
 +
 +
[[Category:Data Submission Formats|TitleMerge]]

Latest revision as of 23:40, 13 February 2014

Introduction

The TitleMerge submission merges 2 or more titles into a single title.

Required Tags

The submission contains two required tags:

  • KeepId - Specifies which title record to retain. All others will be discarded after the merge.
  • DropId - Specifies which title to drop. Multiple DropIds may be included in a single submission.

Optional Tags

The TitleMerge submission also supports a number of optional tags. These tags should be used whenever a particular field differs between the merged titles. Each used tag refers to a title record number. When the submission is integrated, the value associated with the named record will be retained. For instance, say there are 3 titles being merged which have copyright years of 1952, 1953, and 1980. A Year merge tag is generated which selects the record associated with the year 1952. When the submission is integrated, if the retained title record has a year value other than 1952, then that value will be copied into the retained record. Note that the tags contain only record numbers; they do not contain data values.

The following section describes the tags that are supported in the metadata section. Refer to Editing:Merging_Titles for more detailed information on data entry:

  • Title - Record number with the desired title.
  • Author - Record number with the desired authors.
  • Year - Record number with the desired copyright year.
  • TitleType - Record number with the desired entry type.
  • Series - Record number with the desired series name.
  • Seriesnum - Record number with the desired series number.
  • Storylen - Record number with the desired length.
  • Language - Record number with the desired language.
  • Synopsis - Record number with the desired synopsis.
  • Note - Record number with the desired note.
  • Parent - Record number with the desired parent (for variant titles).

Example

 <?xml version="1.0" encoding="iso-8859-1" ?>
 <IsfdbSubmission>
   <TitleMerge>
     <KeepId>7287</KeepId>
     <DropId>170262</DropId>
     <Title>7287</Title>
     <Language>170262</Language>
     <Year>7287</Year>
     <Series>7287</Series>
     <Seriesnum>7287</Seriesnum>
   </TitleMerge>
 </IsfdbSubmission>