FAQs on the Common Data Model (CDM)

Where are basionym authorteams?

Year of publication and/or basionym authorteams of a scientific name might be known although the nomenclatural reference or the basionym itself is not known. A "dummy" reference and/or a "dummy" basionym will be created that keeps this data to enforce consistency. See #125

How can plain lists of literature references be attached to a taxon?

The recommended way is to create an empty Cdm:description:TaxonDescription for each literature resource and use the source property to hold the reference.

Taxon relations vs Name relations

The CdmLibrary logic does not cross the border between names and taxa. So if you create a new basionym relationship between two names NO homotypic synonym relationship is created automatically. On the contrary if a basionym relationship exists between two names, but no synonym relationship between 2 taxon concepts with the respective names, the 2 taxa are not considered synonyms!

Original Source ID

For importing data from an other source you have to add the an original source. E.g.:

IdentifiableEntity idEntity;
ReferenceBase ref;
int originalId;
OriginalSource originalSource = new OriginalSource();

What is the exact use for the class ReferencedEntityBase? And where are instances stored in the CDM database schema?

ReferencedEntityBase is an abstract super class for all classes that hold information about who is saying something. For example if you want to say that XYZ says that taxon A is a synonym for taxon B you will create a SynonymRelationship which is a subclass of ReferenceEntityBase and set the citation to XYZ. If you even know on which page the information about this relationship was published you will additionally set the micro-reference of the SynonymRelationship.

The same applies to all DescriptionElementBase classes like CategorialData, QuantitativeData etc. If you know in which publication this information is to be found you may add it to the DescriptionElementBase by using DescriptionElementBase.setCitation().

As it is a super class for other classes the instances are not stored directly in the schema but in the classes/tables that inherit from ReferencedEntityBase.

In your case you may find the information for example directly in the DescriptionElementBase table which has attributes like "citation_id", "originalNameString" or "microreference" that come from this class.

Updated by Andreas Müller about 1 year ago · 25 revisions