Documentation created on 5. March 2002; last update: 2005-03-30, email address revised 2010-08-05.
By G. Hagedorn & T. Gräfenhan, GLOPP-IT, 2002
This document contains a complete list of all entities and attributes used in the information model of this application module. It is primarily intended as a technical reference. It can also be helpful, however, in understanding the scope and usage of certain attributes. When you have a question like 'where does this information fit in', reading the attribute description may help you.
Besides the human readable documentation provided below, three more technical documents are provided:
(You can click on the entities to go to the attribute tables.)
| TaxonomyActionOnName TaxonomyCitedSpecimen TaxonomyConcept TaxonomyConceptChanges TaxonomyHierarchy |
TaxonomyNameChanges TaxonomyNameVariants TaxonomyRank TaxonomyRevision TaxonomySynonymy |
See also the separate alphabetical index to attribute names.
Taxonomy: Secondary action, affecting the status of a taxon. Examples are neo-, lecto- or epitypifications and conservation/rejection.
| Name | Type | Description / Default value & validation | Rqrd./Index | |
|---|---|---|---|---|
| ActionID | Autonum | Unique ID for this record. | R | I (P) |
| NomID | Long | The taxon concerning this action. Refers to the NomID code of TaxonomyName (= foreign key). | R | I/I(F) |
| ActionType | Text | Type of nomenclatural action: conservation, rejection, neo-, lecto- or epitypification, emendation. The sanctioning of a name should not be recorded here. | R | - |
| InternalNote | Memo | Additional information regarding the typification or conservation/rejection. | - | - |
| RefID | Text | Reference ID of the reference containing the nomenclatural action defined in ActionType. Refers to the ID code of the main ReferenceTitle table in the reference module (= foreign key). | R | I |
| RefDescriptionCache | Text | A short human readable description of the reference, obtained through the RefID from the reference subsystem (calculated field). | - | - |
| RefPage | Text | Relevant detail in a nomenclatural action reference; usually number of the page on which the action is described. | - | - |
| LogCreated_User | Text | Name of user who first entered (typed or imported) the data. This is the operator (or typist) name, which may be different from the person responsible. | R | - |
| LogCreated_Date | Date/Time | Date and time when record was first entered (typed or imported) into this system. Default value: Now() |
R | - |
| TypificationSpecimenDescription | Text | Only for typification actions: A user readable description of the specimen to which the typification refers (collection acronym + storage code / name under which specimen is stored). | - | - |
| TypificationSpecimenID | Text | Only for typification actions: If a specimen collection database subsystem is available, the relevant specimen unit identifier in that system is stored here (added in addition to a user readable TypificationSpecimenDescription). | - | I |
| Index name: | Attributes & index properties | |||
| {GUID}: | NomID (Foreign key; Duplicates OK) | |||
| NomID: | NomID (Duplicates OK) | |||
| PrimaryKey: | ActionID (Primary key; Unique values) | |||
| RefID: | RefID (Duplicates OK) | |||
| TypificationSpecimenID: | TypificationSpecimenID (Duplicates OK) | |||
| Relation type: | Fields involved | |||
| Deletions cascade | TaxonomyName.NomID « TaxonomyActionOnName.NomID | |||
Taxonomy: Specimen (esp. type specimens) that have been studied or shall be cited in a taxonomic monograph.
| Name | Type | Description / Default value & validation | Rqrd./Index | |
|---|---|---|---|---|
| CitedSpecimenID | Autonum | Unique ID for a cited specimen (primary key). | R | I (P) |
| OpinionID | Long | All cited specimens must refer to a taxonomic opinion that defines a NomID, project marker, and responsible scientist (foreign key). | R | I/I(F) |
| CollectionAcronym | Text | Standard abbreviation of the collection from which the studied specimen was obtained (e.g. 'B' for Berlin herbarium). The full name is used if no acronym is available. | - | - |
| CollectionSpecimenID | Text | Used only when a specimen record is available in a compatible collection database subsystem; refers to CollectionSpecimenID in that system (foreign key). | - | I |
| CollectionSpecimenDescription | Text | Optionally used for accession number or storage location name (which may be different from current scientific name!), esp. if CollectionSpecimenID can not be used because no compatible collection database subsystem is available. | - | - |
| TypeStatus | Text | Type, holotype, syntype, paratype, isotype, lectotype, neotype, epitype, etc. | - | - |
| ReportedNote | Memo | Annotation regarding the studied specimen that will be output after the taxon in a report. | - | - |
| InternalNote | Memo | An internal note of the responsible person concerning the studied specimen. This information is NOT included in any report. | R | - |
| Studied | Boolean | False = the specimen is known to exist, but has not (perhaps not yet) been studied by the person named under Responsible. Default value: 0 |
R | - |
| IncludeInReport | Boolean | False = the information on the studied specimen is suppressed in reports, but is maintained in the database. Default value: True |
R | - |
| Index name: | Attributes & index properties | |||
| {GUID}: | OpinionID (Foreign key; Duplicates OK) | |||
| CollectionSpecimenID: | CollectionSpecimenID (Duplicates OK) | |||
| OpinionID: | OpinionID (Duplicates OK) | |||
| PrimaryKey: | CitedSpecimenID (Primary key; Unique values) | |||
| Relation type: | Fields involved | |||
| Updates & deletions cascade | TaxonomyRevision.RevisionID « TaxonomyCitedSpecimen.OpinionID | |||
Taxonomy: Concept of taxa.
| Name | Type | Description / Default value & validation | Rqrd./Index | |
|---|---|---|---|---|
| TaxonID | Autonum | Unique ID code for a taxonomic concept (primary key). Default value: GenUniqueID() |
R | I (P) |
| NomID | Long | The ID of the name on which the concept is based. Each name has at least a default concept. Refers to the NomID code of TaxonomyName (= foreign key). | R | I/I(UM)/I(F) |
| ConceptQualifier | Text | Empty for default and primary concept; else 's. lat.'/'s. str.' (usually used without a ConceptReference); the qualifier is not limited to the picklist shown! | - | - |
| ConceptCitationPrefix | Text | Empty for default and primary concept; else 'sec.', 'sensu', 'emend.'; if a prefix is set a concept citation has to be given. | - | I(UM) |
| ConceptCitation | Text | Empty for default concept, 'primary' if concept known to be identical with original publication of name, else author(s) of secondary concept (including the publication year, if possible). Validation rule: (Not Left([ConceptCitation],6)="sensu " And Not Left([ConceptCitation],5)="sec. " And Not Left([ConceptCitation],7)="emend. " And Not Left([ConceptCitation],4)="non ") Or Is Null |
- | I(UM) |
| RefID | Text | Reference ID of the concept publication. Refers to the ID code of the main ReferenceTitle table in the reference module (= foreign key). | - | I |
| RefNotes | Text | Additional information regarding reference, esp. if doubtful or not yet present in reference subsystem. All other notes should be in the user specific TaxonomyOpinions. | - | - |
| NameCache | Text | Calculated: Full, standardized name for the new taxon, calculated from genus, species and infraspecific epithet and authors. The value is unique, since it includes the author for higher taxa (genera, families) as well as for species. | R | I (U) |
| NameCache_html | Text | Calculated: Like NameCache, but italic and plain text is formatted using xhtml markup (/). | R | I (U) |
| NameCache_NoAuthors | Text | Calculated: Like NameCache, but without any authors. Duplicates may occur here, and taxa with homonyms can be detected using this attribute. Where no homonyms are found, names from other data sources may be compared based on this field alone. | R | I |
| NameCache_inverted | Text | Calculated: Like NameCache, but for species or infraspecific taxa the lowest rank name is printed first ('species-epitheton, Genus' or 'variety (var.) species-epitheton, Genus'). | R | I (U) |
| NameCache_PlusYear | Text | Calculated: Like NameCache, but with year of publication. Duplicates may occur here, and taxa with homonyms can be detected using this attribute. Where no homonyms are found, names from other data sources may be compared based on this field alone. | R | I |
| Table validation rule: | (IsNull([ConceptCitationPrefix]) And IsNull([ConceptCitation])) Or (Not IsNull([ConceptCitationPrefix]) And Not IsNull([ConceptCitation])) | |||
| Index name: | Attributes & index properties | |||
| CandidateKey: | NomID; ConceptCitationPrefix; ConceptCitation (Unique values) | |||
| NameCache: | NameCache (Unique values) | |||
| NameCache_html: | NameCache_html (Unique values) | |||
| NameCache_inverted: | NameCache_inverted (Unique values) | |||
| NameCache_NoAuthors: | NameCache_NoAuthors (Duplicates OK) | |||
| NameCache_PlusYear: | NameCache_PlusYear (Duplicates OK) | |||
| NomID: | NomID (Duplicates OK) | |||
| PrimaryKey: | TaxonID (Primary key; Unique values) | |||
| ProtologueRefID: | RefID (Duplicates OK) | |||
| TaxonomyNameTaxonomyConcept: | NomID (Foreign key; Duplicates OK) | |||
| Relation type: | Fields involved | |||
| Updates & deletions cascade | TaxonomyConcept.TaxonID « TaxonomyConceptChanges.TaxonID | |||
| Updates & deletions cascade | TaxonomyConcept.TaxonID « TaxonomyHierarchy.TaxonID | |||
| Updates & deletions cascade | TaxonomyConcept.TaxonID « TaxonomyHierarchy.Parent_TaxonID | |||
| Updates & deletions cascade | TaxonomyConcept.TaxonID « TaxonomyNameVariants.TaxonID | |||
| Referential integrity | TaxonomyConcept.TaxonID « TaxonomyRevision.TaxonID | |||
| Referential integrity | TaxonomyConcept.TaxonID « TaxonomySynonymy.TaxonID | |||
| Referential integrity | TaxonomyConcept.TaxonID « TaxonomySynonymy.Accepted_TaxonID | |||
| Referential integrity | TaxonomyName.NomID « TaxonomyConcept.NomID | |||
Taxonomy: A technical log of changes of taxonomic or nomenclatural information maintained automatically by the database (user, date, entities & attributes affected).
| Name | Type | Description / Default value & validation | Rqrd./Index | |
|---|---|---|---|---|
| TaxonID | Long | The ID of the taxonomic concept (TaxonID) that was changed by the user. Refers to the NomID code of TaxonomyName (= foreign key). | R | I/I(PM)/I(F) |
| Changes | Memo | Attributes and data affected by changes, details of changes. | R | - |
| LogUpdated_User | Text | Name of user who last updated the record. This is the operator (or typist) name, which may be different from the person responsible. | R | - |
| LogUpdated_Date | Date/Time | Date and time of last update of the record. | R | I(PM) |
| Index name: | Attributes & index properties | |||
| NomID: | TaxonID (Duplicates OK) | |||
| PrimaryKey: | LogUpdated_Date; TaxonID (Primary key; Unique values) | |||
| TaxonomyConceptTaxonomyConc...: | TaxonID (Foreign key; Duplicates OK) | |||
| Relation type: | Fields involved | |||
| Updates & deletions cascade | TaxonomyConcept.TaxonID « TaxonomyConceptChanges.TaxonID | |||
Taxonomy: Hierarchy above the species. Each responsible user can create an independent taxonomic system.
| Name | Type | Description / Default value & validation | Rqrd./Index | |
|---|---|---|---|---|
| ProjectMarker | Text | Each project can implement a different taxonomic hierarchy. Refers to the common project definition in the user module. | R | I(PM) |
| TaxonID | Long | Unique ID code of the higher taxon. Refers to the TaxonID code of TaxonomyConcept (= foreign key). | R | I/I(PM)/I(F) |
| Parent_TaxonID | Long | Next higher taxon (e.g. the family or subfamily if this taxon is a genus). | - | I/I(F) |
| ReportedNote | Text | A note of the responsible person concerning this hierarchization that will be output in a report, e.g. 'fide Author 1999'. | - | - |
| InternalNote | Memo | An internal note of the responsible person concerning this hierarchization. This information is NOT included in any report. | - | - |
| RefID | Text | If the classification is based on a publication: the reference ID of that work. | - | I |
| RefDescriptionCache | Text | If the classification is based on a publication: a short human readable description of the reference, obtained through the RefID from the reference subsystem (calculated field). | - | - |
| RefPage | Text | If the classification is based on a publication: relevant detail; usually page number where the opinion is published. | - | - |
| Responsible | Text | The person responsible for grouping this taxon into a higher taxon. Validation rule: Not Is Null, validation message: Each taxonomic opinion must be signed by a responsible person. |
R | - |
| LogCreated_User | Text | Name of user who first entered (typed or imported) the data. This is the operator (or typist) name, which may be different from the person responsible. | - | - |
| LogCreated_Date | Date/Time | Date and time when record was first entered (typed or imported) into this system. Default value: Now() |
- | - |
| HierarchyListCache | Text | CALCULATED FIELD: List of higher taxa for faster access: "div.; class; ord.; fam.". | - | - |
| Index name: | Attributes & index properties | |||
| Parent_TaxonID: | Parent_TaxonID (Duplicates OK) | |||
| PrimaryKey: | ProjectMarker; TaxonID (Primary key; Unique values) | |||
| RefID: | RefID (Duplicates OK) | |||
| TaxonID: | TaxonID (Duplicates OK) | |||
| TaxonomyConceptTaxonomyHier...: | TaxonID (Foreign key; Duplicates OK) | |||
| TaxonomyConceptTaxonomyHier...: | Parent_TaxonID (Foreign key; Duplicates OK) | |||
| Relation type: | Fields involved | |||
| Updates & deletions cascade | TaxonomyConcept.TaxonID « TaxonomyHierarchy.TaxonID | |||
| Updates & deletions cascade | TaxonomyConcept.TaxonID « TaxonomyHierarchy.Parent_TaxonID | |||
Taxonomy: Supertype entity, providing a nomenclatural ID for all names introduced as taxa (infraspecific, species, genus, family, etc.). Contains only objective information; all scientific opinion is placed in ...Opinion, ...Synonymy, & ...Hierarchy.
| Name | Type | Description / Default value & validation | Rqrd./Index | |
|---|---|---|---|---|
| NomID | Autonum | Unique ID code for the nomenclatural name (primary key). Default value: GenUniqueID() |
R | I (P) |
| CreationType | Text | T: taxon based on new type; C: combination based on a previously publ. name ('comb. nov.'), N: new name ('nom.nov.') introduced to replace a homonym (may occur for genera!), V: validation of previously invalidly publ. taxon name ('ex'), or U: for unknown. Default value: "U" |
R | - |
| TaxonomicRank | Byte+ | Taxonomic rank of the taxon (var., subsp., species, genus, family, order, etc.). The rank must be selected from the associated list of ranks (= TaxonomyRank). | R | I(F) |
| HigherTaxonName | Text | If rank is above species: Name of taxon above species level (currently accepted spelling). Includes infrageneric taxon names, genera, families, etc. | - | I (U) |
| SpeciesGenusID | Long | If rank is species or below: NomID code of the Genus name. Refers to TaxonomyName (= foreign key) where TaxonomicRank = genus. | - | I/I(F) |
| SpeciesEpithet | Text | If rank is species or below: Species epithet, for example 'alba' in 'Abies alba Miller' (currently accepted spelling). | - | I |
| TaxonAuthors | Text | For all taxonomic ranks: Author(s) of the taxon, abbreviated according to authors standard, including validating authors ('ex'), optionally including sanctioning authors or "in" authors, excluding basionym authors in '()' (see TaxonBasionymAuthors). | - | - |
| TaxonBasionymAuthors | Text | For all taxonomic ranks, only for 'comb. nov.' or 'nom. nov.': Author(s) of the basionym (will be displayed in in '()', do not enter the parentheses), abbreviated according to authors standard. | - | - |
| BasionymNomID | Long | Basionym: If CreationType is 'comb. nov.' or replacement ('nom. nov.'), of another name based on the same type material. Refers to ID code of corresponding TaxonomyName (= foreign key). | - | I/I(F) |
| ValidatedNomID | Long | Validated name: If CreationType is validation ('ex') of another name based on the same type material. Refers to ID code of invalidly publ. TaxonomyName (= foreign key). | - | I/I(F) |
| InfraspecificEpithet | Text | If rank is infraspecific: Infraspecific epithet (currently accepted spelling). Note: the rank is known from required attribute TaxonomicRank in TaxonomyName (= the supertype entity). | - | I |
| TypeGenus_NomID | Long | If rank is suprageneric: Type genus of taxon. Refers to the ID code of TaxonomyName (= foreign key). | - | I/I(F) |
| TypeSpecies_NomID | Long | If rank is genus or infrageneric: Type species of genus or infrageneric taxon. Refers to the NomID code of TaxonomyName (= foreign key). | - | I/I(F) |
| TypeSpecimenDeposition | Text | If rank is species or below: Information on deposition of type material in a collection, entered exactly as written in the protologue (original taxon description). | - | - |
| TypeSpecimenLocation | Memo | If rank is species or below: Optional information on the geographic location of type material, entered exactly as written in the protologue (i.e. not as known from type specimen studied elsewhere!). | - | - |
| TypeSpecimenSubstrate | Memo | If rank is species or below: Optional information on substrate (anorganic, or living/dead plant, animal, or fungus) of type material, entered exactly as written in the protologue (i.e. not as known from type specimen studied elsewhere!). | - | - |
| TypeSpecimenCollectors | Memo | If rank is species or below: Optional information on collector(s) of type material (separate multiple collectors with a ";"), entered exactly as written in the protologue (i.e. not as known from type specimen studied elsewhere!). | - | - |
| TypeSpecimenInformation | Memo | If rank is species or below: Optional further information on type material, esp. collection date and number, entered exactly as written in the protologue (i.e. not as known from type specimen studied elsewhere!). | - | - |
| GenusIsAsexual | Boolean | If rank is genus: Checked (or true) ® this an anamorph genus, containing asexual forms only (relevant for fungi). The information can also be obtained from the taxonomic hierarchy; it is always added here to be available when the hierarchy is incomplete. Default value: Null |
- | - |
| ReportedCitation | Text | Optional text of citation (without year); used only when default reference description is unsatisfactorily (esp. abbreviated tax. book titles, exsiccata references). If present, this information is used in preference over the RefDescriptionCache. | - | - |
| RefID | Text | Reference ID of the original nomenclatural citation/protologue. Refers to the ID code of the main ReferenceTitle table in the reference module (= foreign key). | - | I |
| RefDescriptionCache | Text | A short human readable description of the reference, obtained through the RefID from the references subsystem (calculated field). | - | - |
| RefPage | Text | Page on which the nomenclatural citation/protologue of name starts in the reference. | - | - |
| RefHasReprintPagination | Boolean | If checked (or 'True'), the true page number is unknown and only a reprint page number (pagination starting w. 1...) is entered in RefPage. In tax. monographs this situation is often indicated by 'extr.' or 'extractum' after the page number. Default value: 0 |
R | - |
| RefYear | Long | Publication year of taxonomic name, will be automatically entered if a RefID is selected from the reference module. (Note: synonym output is sorted by this year). Validation rule: >1700 Or Is Null |
- | - |
| IsHybrid | Boolean | If checked (or 'True'), the new taxon is a hybrid with or without a hybrid epithet. | - | - |
| HybridNomID1 | Long | If IsHybrid is checked (or 'True'): Name of hybrid species 1. Refers to NomID code of publ. TaxonomyName (= foreign key). | - | I(F) |
| HybridNomID2 | Long | If IsHybrid is checked (or 'True'): Name of hybrid species 2. Refers to NomID code of publ. TaxonomyName (= foreign key). | - | I(F) |
| OriginalNameSpelling | Text | Original spelling of taxonomic name in the protologue publication. Recorded only, if different from current taxon name. | - | - |
| OriginalTaxonPlacement | Text | Taxonomic placement (e.g. family or division) mentioned in the original description. This is NOT the current taxonomic placement! | - | - |
| OriginalDiagnosisLatin | Memo | Optional: The full text of the Latin description/diagnosis in the protologue. | - | - |
| OriginalDiagnosisOther | Memo | Optional: The full text of the original description/diagnosis in the protologue, if a diagnosis in another language than Latin was provided. To be entered into the database only if no copyright is violated. | - | - |
| OriginalPublScan | Text | Optional: a URL under which the scanned text/illustrations of the nomenclatural publication for the name can be found. | - | - |
| IndexingReference | Text | Optional: A secondary reference indexing this taxon, e.g. Saccardo, Index of Fungi, etc. Entered as text, not as reference ID! | - | - |
| ImportedFrom | Text | If imported from another database: The name of the database system or provider. Otherwise empty. | - | - |
| ImportedID | Text | If imported from another database: An ID value to later re-identify the record in that database may be stored here. | - | - |
| IneditedResponsible | Text | Empty for published names, filled w. the name of the responsible person for unpublished ('inedited') names entered in the database. These may not appear in any reports, until specifically requested for a report that will be used to publish the name. | - | - |
| Problem | Text | Problem with data entry (not with the taxon). | - | - |
| LogCreated_User | Text | Name of user who first entered (typed or imported) the data. This is the operator (or typist) name, which may be different from the person responsible. | - | - |
| LogCreated_Date | Date/Time | Date and time when record was first entered (typed or imported) into this system. Default value: Now() |
R | - |
| Table validation rule: | Not (IsNull([HigherTaxonName]) And IsNull([TaxonAuthors]) And IsNull([TaxonBasionymAuthors])) | |||
| Index name: | Attributes & index properties | |||
| {GUID}: | SpeciesGenusID (Foreign key; Duplicates OK) | |||
| {GUID}: | BasionymNomID (Foreign key; Duplicates OK) | |||
| {GUID}: | TaxonomicRank (Foreign key; Duplicates OK) | |||
| BasionymNomID: | BasionymNomID (Duplicates OK) | |||
| HigherTaxonName: | HigherTaxonName (Unique values) | |||
| InfraspecificEpithet: | InfraspecificEpithet (Duplicates OK) | |||
| PrimaryKey: | NomID (Primary key; Unique values) | |||
| ProtologueRefID: | RefID (Duplicates OK) | |||
| SpeciesEpithet: | SpeciesEpithet (Duplicates OK) | |||
| SpeciesGenusID: | SpeciesGenusID (Duplicates OK) | |||
| TaxonomyNameTaxonomyName: | ValidatedNomID (Foreign key; Duplicates OK) | |||
| TaxonomyNameTaxonomyName1: | TypeSpecies_NomID (Foreign key; Duplicates OK) | |||
| TaxonomyNameTaxonomyName2: | TypeGenus_NomID (Foreign key; Duplicates OK) | |||
| TaxonomyNameTaxonomyName3: | HybridNomID1 (Foreign key; Duplicates OK) | |||
| TaxonomyNameTaxonomyName4: | HybridNomID2 (Foreign key; Duplicates OK) | |||
| TypeGenus_NomID: | TypeGenus_NomID (Duplicates OK) | |||
| TypeSpecies_NomID: | TypeSpecies_NomID (Duplicates OK) | |||
| ValidatedNomID: | ValidatedNomID (Duplicates OK) | |||
| Relation type: | Fields involved | |||
| Referential integrity | TaxonomyName.NomID « TaxonomyName.SpeciesGenusID | |||
| Referential integrity | TaxonomyName.NomID « TaxonomyName.BasionymNomID | |||
| Updates cascade | TaxonomyRank.RankID « TaxonomyName.TaxonomicRank | |||
| Deletions cascade | TaxonomyName.NomID « TaxonomyActionOnName.NomID | |||
| Referential integrity | TaxonomyName.NomID « TaxonomyNameChanges.NomID | |||
| Referential integrity | TaxonomyName.NomID « TaxonomyConcept.NomID | |||
| Referential integrity | TaxonomyName.NomID « TaxonomyName.ValidatedNomID | |||
| Referential integrity | TaxonomyName.NomID « TaxonomyName.TypeSpecies_NomID | |||
| Referential integrity | TaxonomyName.NomID « TaxonomyName.TypeGenus_NomID | |||
| Referential integrity | TaxonomyName.NomID « TaxonomyName.HybridNomID1 | |||
| Referential integrity | TaxonomyName.NomID « TaxonomyName.HybridNomID2 | |||
| Updates cascade | TaxonomyName.NomID « TaxonomyNameVariants.NomID | |||
Taxonomy: A technical log of changes of taxonomic or nomenclatural information maintained automatically by the database (user, date, entities & attributes affected).
| Name | Type | Description / Default value & validation | Rqrd./Index | |
|---|---|---|---|---|
| NomID | Long | The ID of the taxonomic name that was changed by the user. Refers to the NomID code of TaxonomyName (= foreign key). | R | I/I(PM)/I(F) |
| Changes | Memo | Attributes and data affected by changes, details of changes. | R | - |
| LogUpdated_User | Text | Name of user who last updated the record. This is the operator (or typist) name, which may be different from the person responsible. | R | - |
| LogUpdated_Date | Date/Time | Date and time of last update of the record. | R | I(PM) |
| Index name: | Attributes & index properties | |||
| NomID: | NomID (Duplicates OK) | |||
| PrimaryKey: | LogUpdated_Date; NomID (Primary key; Unique values) | |||
| TaxonomyNameTaxonomyChanges: | NomID (Foreign key; Duplicates OK) | |||
| Relation type: | Fields involved | |||
| Referential integrity | TaxonomyName.NomID « TaxonomyNameChanges.NomID | |||
Taxonomy: Name variants of NomID's and TaxonID's (different concepts).
| Name | Type | Description / Default value & validation | Rqrd./Index | |
|---|---|---|---|---|
| NomID | Long | Unique ID code for the nomenclatural name (= foreign key). | R | I/I(PM)/I(F) |
| TaxonID | Long | Unique ID code for a taxonomic concept (= foreign key). | R | I/I(PM)/I(F) |
| TaxonNameVariant | Text | Name variant: a complete name with or without authors that could be associated with a NomID as it has been used, e.g. if different orthographic opinions exist, original spelling ('Evonymus' vs. 'Euonymus') or name variants used by concept authors. | R | I/I(PM) |
| Source | Text | Source for name variant: user name when entered directly, description of data import, 'Original Spelling', or 'NameBuilder' for names creates from TaxonomyName information (each change in NameCache is copied as a name variant). | - | - |
| LogCreated_User | Text | Name of user who first entered (typed or imported) the data. This is the operator (or typist) name, which may be different from the person responsible. | - | - |
| LogCreated_Date | Date/Time | Date and time when record was first entered (typed or imported) into this system. Default value: Now() |
R | - |
| Index name: | Attributes & index properties | |||
| NomID: | NomID (Duplicates OK) | |||
| PrimaryKey: | NomID; TaxonNameVariant; TaxonID (Primary key; Unique values) | |||
| TaxonID: | TaxonID (Duplicates OK) | |||
| TaxonNameVariant: | TaxonNameVariant (Duplicates OK) | |||
| TaxonomyConceptTaxonomyName...: | TaxonID (Foreign key; Duplicates OK) | |||
| TaxonomyNameTaxonomyNameVar...: | NomID (Foreign key; Duplicates OK) | |||
| Relation type: | Fields involved | |||
| Updates & deletions cascade | TaxonomyConcept.TaxonID « TaxonomyNameVariants.TaxonID | |||
| Updates cascade | TaxonomyName.NomID « TaxonomyNameVariants.NomID | |||
Taxonomy: taxonomic ranks ranging from subforma to superregnum.
| Name | Type | Description / Default value & validation | Rqrd./Index | |
|---|---|---|---|---|
| RankID | Byte+ | The logical order of ranks (and display order), can be tested to find false hierarchizations or combinations Do not change the code, it is used in several restriction queries! | R | I (P) |
| RankCode | Text | A unique user readable code for the taxonomic rank that is used in TaxonomyName. | R | I |
| Description | Text | Single line description of the rank. | - | - |
| Output | Text | Output elements for the rank, stored as a list of two elements (prefix string-semicolon-postfix string). | - | - |
| Notes | Text | Internal development notes regarding the taxonomic rank. | - | - |
| DisplayOrder | Long | The order in which the entries are displayed. | R | I (U) |
| DisplayEnable | Boolean | The entries are displayed only if marked here. | R | - |
| Index name: | Attributes & index properties | |||
| DisplayOrder: | DisplayOrder (Unique values) | |||
| PrimaryKey: | RankID (Primary key; Unique values) | |||
| RankCode: | RankCode (Duplicates OK) | |||
| Relation type: | Fields involved | |||
| Updates cascade | TaxonomyRank.RankID « TaxonomyName.TaxonomicRank | |||
Taxonomy: Information defining a revision, opinion or comment relating to the status (valid, accepted, etc.) of a nomenclatural name.
| Name | Type | Description / Default value & validation | Rqrd./Index | |
|---|---|---|---|---|
| RevisionID | Autonum | Unique ID code for the opinion (primary key). Note that the combination of NomID, ProjectMarker, and Responsible must also be unique and not null (candidate key). Default value: GenUniqueID() |
R | I (P) |
| TaxonID | Long | The taxon this opinion refers to. Refers to the NomID code of TaxonomyName (= foreign key). | R | I(UM)/I(F) |
| ProjectMarker | Text | Each project can have a different opinion regarding synonmy. Refers to the common project definition in the user module. | R | I(UM) |
| Responsible | Text | The person responsible for this opinion/assessment on a taxon. Validation rule: Not Is Null, validation message: Any opinion must be signed by a responsible person. |
R | I(UM) |
| WorkingStatus | Text | Working status of taxonomic name in current project: I=Included, D=Doubtful, E=Excluded, etc. Synonyms of accepted taxa should have status I. The report may be grouped by these attributes. | - | I |
| NomenclaturalStatus | Text | ... categories for effective/valid/legitimate... esp. 'nom. illeg.', 'nom. inval.', 'nom. nudum', etc. | - | - |
| ReportedNote | Memo | Taxonomic remarks that will be output after the taxon in a report. This includes an explanation, esp. the relevant articles in the code of nomenclature. | - | - |
| InternalNote | Memo | An internal note of the responsible person concerning this name. This information is NOT included in any report. | R | - |
| RefID | Text | If the opinion is based on a publication: the reference ID of that work. | - | I |
| RefDescriptionCache | Text | If the opinion is based on a publication: a short human readable description of the reference, obtained through the RefID from the reference subsystem (calculated field). | - | - |
| RefPage | Text | If the opinion is based on a publication: relevant detail; usually page number where the opinion is published. | - | - |
| UserMarker1 | Text | A temporary marker or keyword assigned by user for searching and sorting purposes while a group is reviewed. Any information can be entered here, but it will be visible only internally. | - | I |
| UserMarker2 | Text | A temporary marker or keyword assigned by user for searching and sorting purposes while a group is reviewed. Any information can be entered here, but it will be visible only internally. | - | I |
| Problem | Text | Temporary problem with data entry (not with the taxon, cmp. ReportedNote/InternalNote for permanent notes on problems). | - | - |
| CheckPlausible_User | Text | Name of user responsible for a first plausibility or consistency check of the name and taxon concepts. User and Date are automatically filled if 'Original check' performed directly. | - | - |
| CheckPlausible_Date | Date/Time | Date and time when plausibility/consistency was checked (i.e. data entry rules and spelling errors checked, no comparison with original publication). | - | - |
| CheckOriginal_User | Text | Name of user responsible for comparison of name and taxon concept records with original publication. | - | - |
| CheckOriginal_Date | Date/Time | Date and time when entry was compared with the original publication. | - | - |
| FinalCheck_User | Text | Name of user responsible for final review of taxon name, the presence of a name here indicates that the record is ready for publication. | - | - |
| FinalCheck_Date | Date/Time | Date and time when final check was performed. Note: it is possible to set FinalCheck without CheckOriginal, e.g. when another users has already checked the original publication. | - | - |
| LogCreated_User | Text | Name of user who first entered (typed or imported) the data. This is the operator (or typist) name, which may be different from the person responsible. | R | - |
| LogCreated_Date | Date/Time | Date and time when record was first entered (typed or imported) into this system. Default value: Now() |
R | - |
| Index name: | Attributes & index properties | |||
| PrimaryKey: | RevisionID (Primary key; Unique values) | |||
| ProjectMarker: | ProjectMarker; Responsible; TaxonID (Unique values) | |||
| RefID: | RefID (Duplicates OK) | |||
| Status: | WorkingStatus (Duplicates OK) | |||
| TaxonomyConceptTaxonomyOpinion: | TaxonID (Foreign key; Duplicates OK) | |||
| UserMarker1: | UserMarker1 (Duplicates OK) | |||
| UserMarker2: | UserMarker2 (Duplicates OK) | |||
| Relation type: | Fields involved | |||
| Updates & deletions cascade | TaxonomyRevision.RevisionID « TaxonomyCitedSpecimen.OpinionID | |||
| Referential integrity | TaxonomyConcept.TaxonID « TaxonomyRevision.TaxonID | |||
Taxonomy: Synonymization of species. Each responsible user can create an independent system.
| Name | Type | Description / Default value & validation | Rqrd./Index | |
|---|---|---|---|---|
| ProjectMarker | Text | Each project can have a different opinion regarding synonmy. Refers to the common project definition in the user module. | R | I(PM) |
| TaxonID | Long | Synonym name. Refers to the TaxonID code of TaxonomyConcept (= foreign key). | R | I(PM)/I(F) |
| Accepted_TaxonID | Long | Accepted name within a project. Refers to the TaxonID code of TaxonomyConcept (= foreign key). | R | I/I(F) |
| ReportedNote | Text | A note of the responsible person concerning this synonymization that will be output in a report, e.g. 'fide Author 1999'. | - | - |
| InternalNote | Memo | An internal note of the responsible person concerning this synonymization. This information is NOT included in any report. | R | - |
| RefID | Text | If the synonymization is based on a publication: the reference ID of that work. Refers to the ID code of the main ReferenceTitle table in the reference module (= foreign key). | - | I |
| RefDescriptionCache | Text | If the synonymization is based on a publication: a short human readable description of the reference, obtained through the RefID from the reference subsystem (calculated field). | - | - |
| RefPage | Text | If the synonymization is based on a publication: relevant detail; usually page number where the synonymization is published. | - | - |
| Responsible | Text | The person responsible for this synonymy opinion. Validation rule: Not Is Null, validation message: Each synonymization must be signed by a responsible person. |
R | - |
| ConSynCongruence | Boolean | A = B: regarding taxa descriptions taxon A and B are absolutely congruent. If no information about a specific concept is available, neither Yes nor No can be checked. Questionable/No or Questionable/Yes/No ??? | - | - |
| ConSynInclusion | Boolean | A > B: regarding taxa descriptions taxon A is "larger" than taxon B (A includes B completely); (Note: hierarchy is special type of inclusion!). | - | - |
| ConSynProParte | Boolean | A < B: regarding description taxon A is "smaller" than taxon B (A is completely included in B); the description of A is just partly transferrable to taxon B. | - | - |
| ConSynIntersection | Boolean | A <> B: taxon A and B are partly congruent; their descriptions overlap. | - | - |
| ConSynDisjunction | Boolean | A ≠ B: there is no correspondence between taxon A and B; their description do not overlap. | - | - |
| LogCreated_User | Text | Name of user who first entered (typed or imported) the data. This is the operator (or typist) name, which may be different from the person responsible. | R | - |
| LogCreated_Date | Date/Time | Date and time when record was first entered (typed or imported) into this system. Default value: Now() |
R | - |
| Index name: | Attributes & index properties | |||
| Accepted_TaxonID: | Accepted_TaxonID (Duplicates OK) | |||
| PrimaryKey: | ProjectMarker; TaxonID (Primary key; Unique values) | |||
| RefID: | RefID (Duplicates OK) | |||
| TaxonomyConceptTaxonomySyno...: | TaxonID (Foreign key; Duplicates OK) | |||
| TaxonomyConceptTaxonomySyno...: | Accepted_TaxonID (Foreign key; Duplicates OK) | |||
| Relation type: | Fields involved | |||
| Referential integrity | TaxonomyConcept.TaxonID « TaxonomySynonymy.TaxonID | |||
| Referential integrity | TaxonomyConcept.TaxonID « TaxonomySynonymy.Accepted_TaxonID | |||
General development notes (documentation of concepts, ideas, etc.).
| Name | Type | Description / Default value & validation | Rqrd./Index | |
|---|---|---|---|---|
| Title | Text | The title of the development note. The title should be concise, but not a list of keywords. It may be output as a formatted title in a development documentation. | R | - |
| Topic | Text | An optional keyword phrase. Examples: data import, export, interface, name of an editing form, etc. Useful to sort notes! | - | - |
| Note | Memo | The text of the development note. Basic xhtml character codes (, , etc.) are permitted. | R | - |
| Responsible | Text | Name of person(s) responsible for the note. | R | - |
| LogCreatedWhen | Date/Time | Date and time when record was created. Default value: Now() |
R | I (P) |
| LogUpdatedWhen | Date/Time | Date and time of last update of the record. | - | - |
| Index name: | Attributes & index properties | |||
| PrimaryKey: | LogCreatedWhen (Primary key; Unique values) | |||
A list of development tasks: bug fixes, necessary enhancements, and requests for additional features.
| Name | Type | Description / Default value & validation | Rqrd./Index | |
|---|---|---|---|---|
| ID | Autonum | Unique number identifying the development task. | - | I (U) |
| Urgency | Byte+ | Definition of urgency of feature. Default value: 0 |
R | - |
| Description | Memo | Description of bug, problem, or requested feature. | - | - |
| Notes | Memo | Notes about steps already taken, or necessary prerequisites to solve problem. | - | - |
| Responsible | Text | Name of person(s) responsible for entering a bug, problem, or feature request. | R | - |
| LogCreatedWhen | Date/Time | Date and time when record was first entered (= typed or imported) into this system. Default value: Now() |
R | - |
| LogUpdatedWhen | Date/Time | Date and time of last update of the record. | - | - |
| Index name: | Attributes & index properties | |||
| PrimaryKey: | ID (Unique values) | |||
This entity contains two records, describing the title, version number, and description of schema (= information model) and content (= data collection) of a database component (Workbench Framework 1.0).
| Name | Type | Description / Default value & validation | Rqrd./Index | |
|---|---|---|---|---|
| Type | Text | Only two records possible: 'Content' (defined by the user) and 'Schema' (= information model, defined by developer, must be compatible with the application). Default value: "Content"; Validation rule: "Schema" Or "Content" |
R | I (P) |
| MajorVersion | Long | The major version number of the schema or content data collection. Example: '2' for version 2.1. Default value: 1 |
R | - |
| MinorVersion | Long | The minor version number of the schema or content data collection. Example: '1' for version 2.1. Default value: 0 |
R | - |
| Revision | Long | The revision version number of the schema or content data collection. Example: '5' for version 2.1.0005. Displayed only if > 0. Default value: 0 |
R | - |
| VersionSuffix | Text | An optional string to identify special versions. Examples: 'beta', 'rc' = release candidate, etc. | - | - |
| Signature | Long | A number that uniquely identifies a schema or content data collection (used by other components to identify object identifiers as belonging to this data collection; content signature values must be 1-524287, schema 1-4095). Default value: CLng(Rnd()*524287) |
R | - |
| Title | Text | A title for the schema or content data collection. Example: 'Mycological Literature collected by the Mycology.Net initiative'. | R | - |
| Description | Memo | An optional description of the entire information schema or data collection (will be displayed in the 'About' dialog box). | - | - |
| CopyrightStatement | Text | A copyright statement concerning the data. | - | - |
| PublicLicense | Text | Type of public licence (none, GPL, LGPL, etc.). Default value: "GPL" |
- | - |
| Authors | Text | A list of author(s). | - | - |
| AuthorsAddress | Text | An address applying to the Authors and Copyright statements. | - | - |
| AuthorsURL | Text | A URL web address applying to the Authors or the database content. | - | - |
| Index name: | Attributes & index properties | |||
| PrimaryKey: | Type (Primary key; Unique values) | |||
Footnotes: The following abbreviations have been used in the tables: R: It is required to enter data in this field. I: The field is indexed to enable faster searching. Different types of indices are denoted by additional letters in parentheses: P = attribute is part of the primary key (values in the index must be unique), F = the attribute is part of a foreign key index (the database engine may create such indices automatically for the entity relations defined), U = values in the index must be unique, N = Null values are ignored in the index, M = the index contains more than one attribute, + = the attribute is involved in more than one multiple-field index. The names of attributes that are part of the primary key are underlined in the first column.
Data types: 'Text (255)' indicates a text of varying length for which no specific design restrictions have been formulated. 255 characters should be read as a proposed technical maximum limit, that can be changed if required by the database management system. In contrast, 'Memo' is explicitly defined as text of unlimited length. Numeric types: BigInt = 8 byte integer, Long = 4 byte integer, Integer or Int = 2 byte integer, Byte = 1 byte integer. A + (e.g. Byte+) indicates that the integer is unsigned and only positive values are allowed.
We are interested in your opinion. If you see any problems with the model that you would like to bring to our attention, please contact us by sending an email to name@gmail.com, please replace name with g.m.hagedorn!
Documentation created on 5. March 2002; last update: 2005-03-30, email address revised 2010-08-05.