Nomencurator XML schema Copyright (c) 2003 Nozomi `James' Ytow All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions, and the following disclaimer, without modification, immediately at the beginning of the file. 2. The name of the author may not be used to endorse or promote products derived from this software without specific prior written permission. Where this Software is combined with software released under the terms of either the GNU Public License ("GPL") or the Mozilla Public Licence ("MPL"), and the terms of the GPL/MPL would require the combined work to also be released under the terms of the GPL/MPL, the terms and conditions of this License will apply in addition to those of the GPL/MPL with the exception of any terms or conditions of this License that conflict with, or are expressly prohibited by, the GPL/MPL. THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. How to create persistentID The persistent ID has general form of DataTypeName::key1_key2_.... i.e., concatination of key field values by underscore with data type leadeing. If a key field is missing or empty, then it must be treated as null-length string, as "key1__key3" when key2 is missing. In some cases comma- or space-concatinated fields are treated as single key. Following is the list of persistent ID for each data records. Keys are shown by their name. "[ ]" denotes that part may be dropped if empty. Author::[surnamePrefix ]surname[ surnameEpithet][, firstName[ middleNames]]_birth_death for publication, if ISXN available book: Publication::authorNames_year_ISXN_volume_number_firstPage_lastPage else Publication::authorNames_year_abbreviatedTitle_volume_number_firstPage_lastPage where abbreviatedTitle should be defined separately. Appearance::page_lines_publicationsPIDw/oDataTypePart NameUsage::rank_ascribedName_appearancePIDw/oDataTypePart Annotation::linkType_ascribedName_firstAnnotator'sPIDw/oDataTypePart NamedObject is a housekeeping table shared by all exportable data objects type of copyright to override the contributor's preference any notes on the NamedObject reference to the contributor ID who contributed the data object date and time of data creation true if the data is editable a persistent identifier exportable to other data bases; the value must be determined by data contents subclass name of the NamedObject a pseudo pointer to a NamedObject, as either of persistent ID of the NamedObject or its entity persistent ID of the NamedObject, as a pseudo pointer to the NamedObject entity of a NamedObject sequence number representing position of the NamedObject, if necessary a pseudo pointer to an Author, as either of persistent ID of the Author or its entity persistent ID of the , as a pseudo pointer to the Author entity of a Author sequence number representing position of the Author, if necessary a pseudo pointer to a Publication, as either of persistent ID of the Publication or its entity persistent ID of the Publication, as a pseudo pointer to the Publication an entity of Publication sequence number representing position of the Publication, if necessary a pseudo pointer to a NameUsage, as either of persistent ID of the NameUsage or its entity persistent ID of the NameUsage, as a pseudo pointer to the NamedUsage an entity of NameUsage sequence number representing position of the NameUsage, if necessary a pseudo pointer to a Appearance, as either of persistent ID of the Appearance or its entity persistent ID of the Appearance, as a pseudo pointer to the Appearance an entity of Appearance sequence number representing position of the Appearance, if necessary a pseudo pointer to a Annotation, as either of persistent ID of the Annotation or its entity persistent ID of the Annotation, as a pseudo pointer to the Annotation an entity of Annotation sequence number representing position of the Annotation, if necessary Author object representing an author persistent ID of this Author, also reference to the NamedObject surname of the author first name of the author names of the author between surname and first name but prefix to surname title of the author e.g. Sir. Ordinary titles such as Dr., Ms., etc. are beyond scope, but might be useful for mailing purpose prefix to surname, e.g. van, von. postfix of surname, e.g. Jr., Sen. date of birth, if known date of death, if known Publication by the Author Affiliation of the Author represents a publication persistent ID of this Publication, also reference to the NamedObject type of publication verbatim list of authors verbatim list of authors' affiliation title of the publication to be appeared as citation information, e.g. journal title in case of articles title of contents, e.g. title of article in a journal doi string if the publication has one ISBN number if the publication is a book or a part of a book ISSN number if the publication is a periodical or an article of a periodical year of publication volume number or string if the publication or journal has issue number in the volume, if given page number where the publication started page number where the publication ended received date if given revised date if given accepted date if given date of publication if given name of publisher if the publication is a book place of publication if relevant reference to a Publication containing the Publication as its part reference to a contents Publication reference to a Author of the publication reference to a Appearance contained in the publication shelfmark of the publication Annotation retains how name usages and annotations appeared in a publication persistent ID of this Appearance, also reference to the NamedObject page in the publication where name usage(s) appeared at first time line numbers at start and end of the name appearance; multiple column style could be distinguished by suffixes L, R, a, b, c verbatim record of how names appeared on the page reference to, or entity of, the Publication where this Appearance contained reference to, or entity of, a NameUsage appeared in the appearance reference to, or entity of, a Annotation appeared in the appearance Annotation on name usages, e.g. this name usage annotates these previous name usages as sysnonym of the usage persistent ID of this Annotation, also reference to the NamedObject type of Annotation, e.g. synonym reference to, or entity of, a NameUsage annotating via this Annotation reference to, or entity of, a NameUsage annotated via this Annotation reference to, or entity of, the Appearance where this Annotation appeared record of usage of a name appeared in a publication persistent ID of this NameUsage, also reference to the NamedObject language to which the name belongs to, either one of Codes for scientific names or natural languages for vernacular names name of the rank, if given the name used to designate the taxon concept reference to, or entity of, the NameUsage designating the higher taxon reference to, or entity of, a NameUsage designating a lower taxon reference to, or entity of, a NameUsage of which sensu the name used reference to, or entity of, the Appearance where this NameUsage appeared true if assignment of the taxon is uncertain true if the NameUsage represents type taxon of the higher NameUsage type of typeness, e.g. holotype proxy of NameUsage to enable efficient back and forth navigation persistent ID of this NameUsage, also reference to the NamedObject path of NameUsages referring to the NameUsage path of NameUsages referred by the NameUsage path of NameUsages, not as a part of a hierarchy referene to, or entity of, referrer's NameUsage referene to, or entity of, referrant's NameUsage type of Annotation, e.g. synonym cross reference between Publication and shelfmark reference to, or entity of, a Publication having this shelfmark shelfmark of the publication in the library reference to library, may be coded user name who deposited the data when the data last updated detail of contributor reference to, or entity of, a Author giving detail of the contributor default copyright of contributed data by this contributor a unique string identifying the contributor, e.g. e-mail address a pseudo pointer to a contributor, as either of contributer's unique string or contbirutor entity a unique pseudoname of the contributor, as a pseudo pointer to the contributor contributor entity copyright of known type copyright statement itself any notes on the copyright, e.g. originatator, history, difference from other copyright types name of copyright. If it is OSI approved one, name used at OSI is preferred to. See http://www.opencousrce.org/ URL or URI of the copyright if available acronym of the copyright e.g. GPL. It must be unique. May be equal to copyright name object created by parsing relevant data objects reference to, or entity of, a NamedObject created by parsing relevant data objects reference to, or entity of, a NamedObject parsed to create the parsed NamedObject ascribed name with its originating name usage reference to, or entity of, the NamedObject authoritative for the name reference to, or entity of, a NamedObject usind the name ascribed name itself