CollectionModel v2.05.17
Contents
- 1 DiversityCollection Information Model (version 2.05.17, 15 February 2012)
- 1.1 ER Diagrams
- 1.1.1 Overview over all entities and relations used in the database model
- 1.1.2 A short introduction:
- 1.1.3 Description of the tables
- 1.1.4 Table: Analysis
- 1.1.5 Table: AnalysisResult
- 1.1.6 Table: AnalysisTaxonomicGroup
- 1.1.7 Table: Collection
- 1.1.8 Table: CollectionAgent
- 1.1.9 Table: CollectionEvent
- 1.1.10 Table: CollectionEventImage
- 1.1.11 Table: CollectionEventLocalisation
- 1.1.12 Table: CollectionEventProperty
- 1.1.13 Table: CollectionEventSeries
- 1.1.14 Table: CollectionEventSeriesImage
- 1.1.15 Table: CollectionExternalDatasource
- 1.1.16 Table: CollectionImage
- 1.1.17 Table: CollectionProject
- 1.1.18 Table: CollectionSpecimen
- 1.1.19 Table: CollectionSpecimenImage
- 1.1.20 Table: CollectionSpecimenPart
- 1.1.21 Table: CollectionSpecimenProcessing
- 1.1.22 Table: CollectionSpecimenRelation
- 1.1.23 Table: CollectionSpecimenTransaction
- 1.1.24 Table: Identification
- 1.1.25 Table: IdentificationUnit
- 1.1.26 Table: IdentificationUnitAnalysis
- 1.1.27 Table: IdentificationUnitGeoAnalysis
- 1.1.28 Table: IdentificationUnitInPart
- 1.1.29 Table: LocalisationSystem
- 1.1.30 Table: Processing
- 1.1.31 Table: ProcessingMaterialCategory
- 1.1.32 Table: Property
- 1.1.33 Table: Transaction
- 1.1.34 Table: TransactionDocument
- 1.2 Project related tables
- 1.3 Annotations
- 1.4 Entity tables
- 1.5 Template for enumeration tables
- 1.6 Known problems
- 1.1 ER Diagrams
DiversityCollection Information Model (version 2.05.17, 15 February 2012)
Authors | M. Weiss, G. Hagedorn & D. Triebel 2012 |
License | ![]() |
Suggested citation | M. Weiss, G. Hagedorn & D. Triebel (2012). DiversityCollection information model (version 2.05.17). http://www.diversityworkbench.net/Portal/CollectionModel_v2.05.17 |
Notes | The models currently reside in MS SQL Server, so knowledge of some SQL Server ER-diagram conventions will be helpful.
Besides the screen shots below, a Microsoft T-SQL-Script for the generation of the tables is provided. |
ER Diagrams
Overview over all entities and relations used in the database model
(enumeration tables are not included)
The colors in the diagram indicate the logical group of the tables as described in the legend. Some “housekeeping” fields and tables for the documentation when and by whom the data were inserted or changed are not shown in the overview or the detail diagrams.
A short introduction:
- “CollectionSpecimen” is the central entity, containing the information directly related to the collected specimen. The field ExsiccataID relates to the module DiversityExsiccate within the Diversity Workbench.
- “CollectionProject” keeps the relation to the projects. Each specimen may be included in several projects.
- “CollectionAgent”. The people or groups responsible for the collection of the specimen are stored in the table CollectionAgent. There may be several collectors for one specimen. The sequence of the collectors (e.g. for print on a label) is stored with the CollectorsSequence. The CollectorsAgentURI refers to the module DiversityAgent within the Diversity Workbench.
- “CollectionSpecimenImage” keeps the images for a specimen. The ResourceURI refers to the module DiversityResources within the Diversity Workbench.
- “CollectionEvent” is the central entity, containing the information for the collection event. Specimen stored in a collection are gathered during a collection event. The tables associated with collection event keep informations about the geographic locality, the habitat, the date etc. During an collection event, several specimen may have been collected.
- “CollectionEventSeries”. An event series can contain other series and collection events. The event series should be used to organise your collection events.
- “CollectionLocalisation”. The geographic localisation of each collection event can be documented with several localisation systems. One option are entries linked to the module DiversityGazetteer within the Diversity Workbench, providing information on geographical names.
- “LocalisationSystem” lists the localisation systems used to document a geographical locality.
- “CollectionEventProperty”. Properties of the collection site, e.g. the habitat found during a collectoin event can be documented with several habitats derived from standard habitat list like e.g. EUNIS.
- “CollectionEventImage” keeps the images related to a collection event, e.g. a map or a photograph of the habitat.
- “IdentificationUnit”. The items in one collection specimen are regarded as identification units. One specimen can contain several identification units, e.g. an insect (1) feeding on a fungus (2) growing as a parasit on a plant (3).
- “Identification” keeps the identifications of the identification units in a collection specimen. Each identification unit may have been identified several times. For relation to the module DiversityTaxonNames the field NameURI is used.
- “CollectionSpecimenPart”. This tables keeps the informations about the parts of a specimen and the actual location of a specimen within e.g. a herbarium. A specimen may be located in several herbaria with several duplicates.
- “Collection” lists the collections where the specimen can be found.
- “CollectionSpecimenRelation” documents the relations between specimen.
- “CollectionSpecimenTransaction” documents the exchange with other herbaria.
Entities ending with “_Enum” (“CollRelationType_Enum”, “CollTypeStatus_Enum” etc.) contain enumerated values or strings; all have the same fields shown in the last ER diagram further below.
Description of the tables
Table: Analysis
Analysis types used within the database
Column | Data type | Description |
---|---|---|
AnalysisID | int | ID of the analysis (Primary key) |
AnalysisParentID | int | Analysis ID of the parent analysis if it belongs to a certain type documented in this table |
DisplayText | nvarchar (50) | Name of the analysis as e.g. shown in user interface |
Description | nvarchar (MAX) | Description of the analysis |
MeasurementUnit | nvarchar (50) | The measurement unit used for the analysis, e.g. mm, µmol, kg |
Notes | nvarchar (MAX) | Notes concerning this analysis |
AnalysisURI | varchar (255) | URI referring to an external documentation of the analysis |
OnlyHierarchy | bit | If the entry is only used for the hierarchical arrangement of the entries DefaultValue: (0) |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: AnalysisResult
Value lists for analysis types with predefined values, e.g. "0, 1, 2, 3, ..." for Red list category. Includes description etc. for the values in the list.
Column | Data type | Description |
---|---|---|
AnalysisID | int | ID of the analysis (Primary key) |
AnalysisResult | nvarchar (255) | The categorized value of the analysis |
Description | nvarchar (500) | Description of enumerated object, displayed in the user interface |
DisplayText | nvarchar (50) | Short abbreviated description of the object, displayed in the user interface |
DisplayOrder | smallint | The order in which the entries are displayed. The order may be changed at any time, but all values must be unique. |
Notes | nvarchar (500) | Internal development notes about usage, definition, etc. of an enumerated object |
LogInsertedBy | nvarchar (50) | Name of user who first entered (typed or imported) the data. DefaultValue: user_name() |
LogInsertedWhen | smalldatetime | Date and time when the data were first entered (typed or imported) into this database. DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Name of user who last updated the data. DefaultValue: user_name() |
LogUpdatedWhen | smalldatetime | Date and time when the data were last updated. DefaultValue: getdate() |
Table: AnalysisTaxonomicGroup
The types of analysis that are available for a taxonomic group
Column | Data type | Description |
---|---|---|
AnalysisID | int | Analysis ID, foreign key of table Analysis. |
TaxonomicGroup | nvarchar (50) | Taxonomic group the organism identified by this unit belongs to. Groups listed in table CollTaxonomicGroup_Enum (= foreign key) |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: Collection
The collections where the specimen are stored
Column | Data type | Description |
---|---|---|
CollectionID | int | Unique reference ID for the collection (= Primary key) |
CollectionParentID | int | For a subcollection within another collection: CollectionID of the collection to which the subcollection belongs. Empty for an independent collection |
CollectionName | nvarchar (255) | Name of the collection (e. g. 'Herbarium Kew') or subcollection (e. g. 'cone collection', 'alcohol preservations'). This text should be kept relatively short, use Description for additional information |
CollectionAcronym | nvarchar (10) | A unique code for the Collection, e.g. the herbarium code from Index Herbariorum |
AdministrativeContactName | nvarchar (500) | The name of the person or organisation responsible for this collection |
AdministrativeContactAgentURI | varchar (255) | The URI of the person or organisation responsible for the Collection e.g. as provided by the module DiversityAgents |
Description | nvarchar (MAX) | A short description of the collection |
Location | nvarchar (255) | Optionally location of the collection, e.g. the number within a file system or a description of the room(s) housing the (sub)collection |
CollectionOwner | nvarchar (255) | The owner of the collection as e.g. printed on a label, should be given if CollectionParentID is null |
DisplayOrder | smallint | The order in which the entries are displayed. The order may be changed at any time, but all values must be unique. |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: CollectionAgent
The collector(s) of collection specimens
Column | Data type | Description |
---|---|---|
CollectionSpecimenID | int | Refers to ID of CollectionEvent (= Foreign key and part of primary key) |
CollectorsName | nvarchar (255) | Name of the Collector |
CollectorsAgentURI | varchar (255) | The URI of the Agent, e.g. as stored within the module DiversityAgents |
CollectorsSequence | datetime | The order of collectors in a team. Automatically set by the database system DefaultValue: getdate() |
CollectorsNumber | nvarchar (50) | Number assigned to a specimen or a batch of specimens by the collector during the collection event (= 'field number') |
Notes | nvarchar (MAX) | Notes about the collector, e.g. if the name is uncertain |
DataWithholdingReason | nvarchar (255) | If the dataset is withhold, the reason for withholding the data, otherwise null |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: CollectionEvent
The collection event where the specimen was collected
Column | Data type | Description |
---|---|---|
CollectionEventID | int | Unique ID for the collection event (= Primary key) |
Version | int | The version of the dataset. Automatically set by the system. DefaultValue: (1) |
SeriesID | int | The ID of the related expedition. Relates to the PK of the table CollectionExpedition (Foreign key). |
CollectorsEventNumber | nvarchar (50) | Number assigned to a collection event by the collector (= 'field number') |
CollectionDate | datetime | The date of the event calulated from the entries in CollectionDay, -Month and -Year. |
CollectionDay | tinyint | The day of the date of the event or when the collection event started |
CollectionMonth | tinyint | The month of the date of the event or when the collection event started |
CollectionYear | smallint | The year of the date of the event or when the collection event started |
CollectionDateSupplement | nvarchar (100) | Verbal or additional collection date information, e.g. 'end of summer 1985', 'first quarter', '1888-1892'. The end date if the collection event comprises a period. The time of the event if necessary. |
CollectionDateCategory | nvarchar (50) | Category of the date of the identification e.g. "system", "estimated" (= foreign key, see in table CollEventDateCategory_Enum) |
CollectionTime | varchar (50) | The time of the event or when the collection event started |
CollectionTimeSpan | varchar (50) | The time span e.g. in seconds of the collection event |
LocalityDescription | nvarchar (MAX) | Locality description of the locality, exactly as written on the original label (i.e. without corrections during data entry) |
HabitatDescription | nvarchar (MAX) | Geo-ecological description of the locality, exactly as written on the original label (i.e. without corrections during data entry) |
ReferenceTitle | nvarchar (255) | The title of the publication where the collection event was published. Note this is only a cached value where ReferenceURI is present |
ReferenceURI | varchar (255) | URI (e.g. LSID) of the source publication where the collection event is published, may e.g. refer to the module DiversityReferences |
ReferenceDetails | nvarchar (50) | The exact location within the reference, e.g. pages, plates |
CollectingMethod | nvarchar (MAX) | Description of the method used for collecting the samples, e.g. traps, moist chambers, drag net |
Notes | nvarchar (MAX) | Notes about the collection event |
CountryCache | nvarchar (50) | The country where the collection event took place. Cached value derived from an entry in CollectionGeography |
DataWithholdingReason | nvarchar (255) | If the dataset is withhold, the reason for withholding the data, otherwise null |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: CollectionEventImage
The images showing the site of the collection event
Column | Data type | Description |
---|---|---|
CollectionEventID | int | Unique ID for the collection event (= Primary key) |
URI | varchar (255) | The complete URI address of the image. This is only a cached value if ResourceID is available referring to the module DiversityResources |
ResourceURI | varchar (255) | The URI of the resource (e.g. see module DiversityResources) |
ImageType | nvarchar (50) | Type of the image, e.g. map |
Notes | nvarchar (MAX) | Notes to this image concerning the collection event |
Description | xml (MAX) | Description of the image |
DataWithholdingReason | nvarchar (255) | If the dataset is withhold, the reason for withholding the data, otherwise null |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: CollectionEventLocalisation
The geographic localisation of a collection event
Column | Data type | Description |
---|---|---|
CollectionEventID | int | Refers to the ID of CollectionEvent (= Foreign key and part of primary key) |
LocalisationSystemID | int | Refers to the ID of LocalisationSystem (= Foreign key and part of primary key) |
Location1 | nvarchar (255) | Either a named location selected from a thesaurus (e. g. 'Germany, Bavaria, Kleindingharting') or altitude range or other values (e. g. 100-200 m) |
Location2 | nvarchar (255) | Corresponding value to Location1 e.g. ID or URI of gazetteer or thesaurus |
LocationAccuracy | nvarchar (50) | The accuracy of the determination of this locality |
LocationNotes | nvarchar (MAX) | Notes on the location |
DeterminationDate | smalldatetime | Date of the determination of the geographical localisation |
DistanceToLocation | varchar (50) | Distance from the specified place to the real location of the collection event (m) |
DirectionToLocation | varchar (50) | Direction from the specified place to the real location of the collection event (Degrees rel. to north) |
ResponsibleName | nvarchar (255) | The name of the agent (person or organization) responsible for this entry. DefaultValue: [dbo].[CurrentUserName]() |
ResponsibleAgentURI | varchar (255) | URI of the person or organisation responsible for the data (see e.g. module DiversityAgents) |
Geography | geography | The geography of the localisation |
AverageAltitudeCache | float | Calculated altitude as parsed from the location fields |
AverageLatitudeCache | float | Calculated latitude as parsed from the location fields |
AverageLongitudeCache | float | Calculated longitude as parsed from the location fields |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
RecordingMethod | nvarchar (500) | The method or device used for the recording of the localisation |
Table: CollectionEventProperty
A property of a collection site, e.g. exposition, slope, vegetation. May refer to Diversity Workbench module DiversityScientificTerms
Column | Data type | Description |
---|---|---|
CollectionEventID | int | Refers to the ID of CollectionEvent (= Foreign key and part of primary key) |
PropertyID | int | The ID of the descriptor of the collection event, foreign key, see table Descriptor |
DisplayText | nvarchar (255) | The text for the property as shown e.g. in a user interface |
PropertyURI | varchar (255) | URI referring to an external datasource e.g. DiversityTerminology |
PropertyHierarchyCache | nvarchar (MAX) | A cached text of the complete name of the descriptor including superior categories if present |
PropertyValue | nvarchar (255) | The value of a captured feature e.g. temperature, pH, vegetation etc. If there is a range this is the lower or first value |
ResponsibleName | nvarchar (255) | The name of the agent (person or organization) responsible for this entry. |
ResponsibleAgentURI | varchar (255) | URI of the person or organisation responsible for the data (see e.g. module DiversityAgents) |
Notes | nvarchar (MAX) | Notes about the property of the colletion site. |
AverageValueCache | float | For numeric values - a cached average value according to the |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: CollectionEventSeries
The series whithin which collection events take place
Column | Data type | Description |
---|---|---|
SeriesID | int | Primary key. The ID for this expedition (= Primary key) |
SeriesParentID | int | The ID of the superior expedition |
Description | nvarchar (MAX) | The description of the expedition as it will be printed on e.g. the label |
SeriesCode | nvarchar (50) | The user defined code for an expedition |
Notes | nvarchar (MAX) | Notes about this expedition |
Geography | geography | The geography of the collection event series |
DateStart | datetime | The date and time when the collection event series started |
DateEnd | datetime | The date and time when the collection event series ended |
DateCache | datetime | The first date of the depending events, used for sorting the expeditions [controlled by the database] |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: CollectionEventSeriesImage
The images showing the sites of a collection event series, e.g. an expedition or sampling plot
Column | Data type | Description |
---|---|---|
SeriesID | int | Unique ID for the collection event series (= Foreign key and part of primary key) |
URI | varchar (255) | The complete URI address of the image. This is only a cached value if ResourceID is available referring to the module DiversityResources |
ResourceURI | varchar (255) | The URI of the resource (e.g. see module DiversityResources) |
ImageType | nvarchar (50) | Type of the image, e.g. map |
Notes | nvarchar (MAX) | Notes to this image concerning the collection event |
Description | xml (MAX) | Description of the image |
DataWithholdingReason | nvarchar (255) | If the dataset is withhold, the reason for withholding the data, otherwise null |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: CollectionExternalDatasource
CollectionExternalDatasource document the sources of the names.
Column | Data type | Description |
---|---|---|
ExternalDatasourceID | int | An ID to identify an external data collection of collection specimen (primary key, the ID has no meaning outside of the DiversityWorkbench system) |
ExternalDatasourceName | nvarchar (255) | The name of the data collection that has been integrated or can be linked to for further analysis |
ExternalDatasourceVersion | nvarchar (255) | The version of this data collection (either official version number, or dates when the collection was integrated) |
Rights | nvarchar (500) | A description of copyright agreements or permission to use data from the external database |
ExternalDatasourceAuthors | nvarchar (200) | The persons or institutions responsible for the external database |
ExternalDatasourceURI | nvarchar (300) | The URI of the database provider resp. the external database |
ExternalDatasourceInstitution | nvarchar (300) | The institution responsible for the external database |
InternalNotes | nvarchar (1500) | Additional notes concerning this data collection |
ExternalAttribute_NameID | nvarchar (255) | The table and field name in the external data collection to which CollectionExternalID refers |
PreferredSequence | tinyint | For selection in e.g. picklists: of several equal names only the name from the source with the lowest preferred sequence will be provided. |
Disabled | bit | If this source should be disabled for selection of names e.g. in picklists |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: CollectionImage
The images showing the collection
Column | Data type | Description |
---|---|---|
CollectionID | int | Refers to the ID of Collection (= Foreign key and part of primary key) |
URI | varchar (255) | The complete URI address of the image. |
ImageType | nvarchar (50) | Type of the image, e.g. label |
Notes | nvarchar (MAX) | Notes about the collection image |
Description | xml (MAX) | Description of the image |
DataWithholdingReason | nvarchar (255) | If the dataset is withhold, the reason for withholding the data, otherwise null |
LogInsertedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogInsertedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: CollectionProject
The projects within which the collection specimen were placed
Column | Data type | Description |
---|---|---|
CollectionSpecimenID | int | Refers to the ID of CollectionSpecimen (= Foreign key and part of primary key) |
ProjectID | int | ID of the project to which the specimen belongs (Projects are defined in DiversityProjects) |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: CollectionSpecimen
The data directly attributed to the collection specimen
Column | Data type | Description |
---|---|---|
CollectionSpecimenID | int | Unique reference ID for the collection specimen record (primary key) |
Version | int | The version of the dataset DefaultValue: (1) |
CollectionEventID | int | Refers to the ID of CollectionEvent (= Foreign key and part of primary key) |
CollectionID | int | ID of the Collection as stored in table Collection (= foreign key, see table Collection) |
AccessionNumber | nvarchar (50) | Accession number of the specimen within the collection, e.g. "M-29834752" |
AccessionDate | datetime | The date of the accession calculated from the entries in AccessionDay, -Month and -Year |
AccessionDay | tinyint | The day of the date when the specimen was acquired in the collection |
AccessionMonth | tinyint | The month of the date when the specimen was acquired in the collection |
AccessionYear | smallint | The year of the date when the specimen was acquired in the collection |
AccessionDateSupplement | nvarchar (255) | Verbal or additional accession date information, e.g. 'end of summer 1985', 'first quarter', '1888-1892' |
AccessionDateCategory | nvarchar (50) | Category of the date of the identification e.g. "system", "estimated" (= foreign key, see in table xColl_DateCategory_Enum) |
DepositorsName | nvarchar (255) | The name of the depositor(s) (person or organization responsible for deposition). Where entire collections are deposited, this should also contain the collection name (e.g. 'Herbarium P. Döbbler') |
DepositorsAgentURI | varchar (255) | The URI of the depositor(s) (person or organization responsible for deposition) |
DepositorsAccessionNumber | nvarchar (50) | Accession number of the specimen within the previous or original collection, e.g. 'D-23948' |
LabelTitle | nvarchar (255) | The title of the label e.g. for printing labels. |
LabelType | nvarchar (50) | Printed, typewritten, typewritten with handwriting added, entirely in handwriting, etc. |
LabelTranscriptionState | nvarchar (50) | The state of the transcription of a label into the database: 'Not started', 'incomplete', 'complete' |
LabelTranscriptionNotes | nvarchar (255) | User defined notes concerning the transcription of the label into the database |
ExsiccataURI | varchar (255) | If specimen is an exsiccata: The URI of the Exsiccata series, e.g. as stored within the DiversityExsiccata module |
ExsiccataAbbreviation | nvarchar (255) | If specimen is an exsiccata: Standard abbreviation of the exsiccata (not necessarily a unique identifier; editors or publication places may change over time) |
OriginalNotes | nvarchar (MAX) | Notes found on the label of the specimen, by the original collector or from a later revision |
AdditionalNotes | nvarchar (MAX) | Additional notes made by the editor of the specimen record, e. g. 'doubtful identification/locality' |
ReferenceTitle | nvarchar (255) | The title of the publication where the specimen was published. Note this is only a cached value where ReferenceURI is present |
ReferenceURI | varchar (255) | URI (e.g. LSID) of reference where specimen is published, e.g. referring to the module DiversityReferences |
ReferenceDetails | nvarchar (50) | The exact location within the reference, e.g. pages, plates |
Problems | nvarchar (255) | Description of a problem that occurred during data editing. Typically these entries should be deleted after help has been obtained. Do not enter scientific problems here; use AdditionalNotes for such permanent problems! |
DataWithholdingReason | nvarchar (255) | If the dataset is withhold, the reason for withholding the data, otherwise null |
InternalNotes | nvarchar (MAX) | Internal notes that should not be published e.g. on websites |
ExternalDatasourceID | int | An ID to identify an external data collection of collection specimen (primary key, the ID has no meaning outside of the DiversityWorkbench system) |
ExternalIdentifier | nvarchar (100) | The identifier of the external specimen as defined in the external datasource |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: CollectionSpecimenImage
The images of a collection specimen or of an identification unit within this specimen
Column | Data type | Description |
---|---|---|
CollectionSpecimenID | int | Refers to the ID of CollectionSpecimen (= Foreign key and part of primary key) |
URI | varchar (255) | The complete URI address of the image. This is only a cached value if ResourceID is available referring to the module DiversityResources |
ResourceURI | varchar (255) | The URI of the image, e.g. as stored in the module DiversityResources. |
SpecimenPartID | int | Optional: If the dataset is not related to a part of a specimen, the ID of a related part (= foreign key) |
IdentificationUnitID | int | If image refers to only on out of several identification units for a specimen, refers to the ID of an IdentificationUnit for a CollectionSpecimen (= foreign key) |
ImageType | nvarchar (50) | Type of the image, e.g. photograph |
Notes | nvarchar (MAX) | Notes about the specimen image |
Description | xml (MAX) | Description of the image |
DataWithholdingReason | nvarchar (255) | If the dataset is withhold, the reason for withholding the data, otherwise null |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: CollectionSpecimenPart
Parts of a collection specimen. Includes a possible hierarchy of the parts
Column | Data type | Description |
---|---|---|
CollectionSpecimenID | int | Refers to the ID of CollectionSpecimen (= Foreign key and part of primary key) |
SpecimenPartID | int | ID of the collection specimen part (= part of Primary key). |
DerivedFromSpecimenPartID | int | SpecimenPartID of the specimen from which the current specimen is derived from |
PreparationMethod | nvarchar (MAX) | The method used for the preparation of the part of the specimen, e.g. the inoculation method for cultures |
PreparationDate | datetime | The date and time when the part was preparated e.g when it was separated from the source object |
AccessionNumber | nvarchar (50) | Accession number of the part of the specimen within the collection if it is different from the accession number of the specimen as stored in the table CollectionSpecimen, e.g. "M-29834752" |
PartSublabel | nvarchar (50) | The label for a part of a specimen, e.g. if duplicats of a specimen have a separate number |
CollectionID | int | ID of the Collection as stored in table Collection (= foreign key, see table Collection) |
MaterialCategory | nvarchar (50) | Material category of specimen. Examples: 'herbarium sheets', 'drawings', 'microscopic slides' etc. (= foreign key, see table CollMaterialCategory_Enum) DefaultValue: N'specimen' |
StorageLocation | nvarchar (255) | A code identifying the place where the specimen is stored within the collection. Frequently the accepted scientific name is used as storage location code. |
Stock | float | Number of stock units if the specimen is stored in separated units e.g. several boxes or vessels (max. 255) |
StockUnit | nvarchar (50) | If empty the stock is given as a count, else it contains the unit in which stock is expressed, e.g. µl, ml, kg etc. |
StorageContainer | nvarchar (500) | The container in which the part is stored |
Notes | nvarchar (MAX) | Notes concerning the storage of the sample |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: CollectionSpecimenProcessing
The processing that was applied to a collection specimen
Column | Data type | Description |
---|---|---|
CollectionSpecimenID | int | Refers to ID of CollectionSpecimen (= Foreign key and part of primary key) |
ProcessingDate | datetime | Date and time of the start of the processing DefaultValue: getdate() |
ProcessingID | int | ID of the processing. Refers to ProcessingID in table Processing (foreign key) DefaultValue: (1) |
Protocoll | nvarchar (100) | The label of the processing protocoll |
SpecimenPartID | int | Optional: If the dataset is related to a part of a specimen, the ID of a related part (= foreign key, see table CollectionSpecimenPart) |
ProcessingDuration | varchar (50) | The duration of the processing including the unit (e.g. 5 min) or the end of the processing starting at the processingDate (e.g. 23.05.2008) |
ResponsibleName | nvarchar (255) | Name of the person or institution responsible for the determination DefaultValue: [dbo].[CurrentUserName]() |
ResponsibleAgentURI | varchar (255) | URI of the person or institution responsible for the determination (= foreign key) as stored in the module DiversityAgents. |
Notes | nvarchar (MAX) | Notes about the processing |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: CollectionSpecimenRelation
The relations of a collection specimen to other collection specimen
Column | Data type | Description |
---|---|---|
CollectionSpecimenID | int | Unique reference ID for the collection specimen record (primary key) |
RelatedSpecimenURI | varchar (255) | URI of the related specimen |
RelatedSpecimenDisplayText | varchar (255) | The name of a related specimen as shown e.g. in a user interface |
RelationType | nvarchar (50) | Type of the relation between the specimen (= foreign key, see table CollRelationType_Enum) |
RelatedSpecimenCollectionID | int | ID of the Collection as stored in table Collection (= foreign key, see table Collection) |
RelatedSpecimenDescription | nvarchar (MAX) | Description of the related specimen |
Notes | nvarchar (MAX) | Notes on the relation to the specimen |
IsInternalRelationCache | bit | If the relation represents a connection between specimen in this database DefaultValue: (1) |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: CollectionSpecimenTransaction
The transactions in which a specimen was involved
Column | Data type | Description |
---|---|---|
CollectionSpecimenID | int | Refers to ID of CollectionSpecimen (= Foreign key and part of primary key) |
TransactionID | int | Unique ID for the transaction (= Foreign key and part of primary key) |
SpecimenPartID | int | Optional: If the dataset is related to a part of a specimen, the ID of a related part (= foreign key, see table CollectionSpecimenPart) |
IsOnLoan | bit | True if a specimen is on loan |
LogInsertedBy | nvarchar (50) | Name of user who first entered (typed or imported) the data. DefaultValue: user_name() |
LogInsertedWhen | smalldatetime | Date and time when the data were first entered (typed or imported) into this database. DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Name of user who last updated the data. DefaultValue: user_name() |
LogUpdatedWhen | smalldatetime | Date and time when the data were last updated. DefaultValue: getdate() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: Identification
The identifications of the organisms within a specimen
Column | Data type | Description |
---|---|---|
CollectionSpecimenID | int | Refers to the ID of CollectionSpecimen (= Foreign key and part of primary key) |
IdentificationUnitID | int | Refers to the ID of IdentficationUnit (= foreign key and part of primary key) |
IdentificationSequence | smallint | The sequence of the identifications. The last identification (having the highest sequence) is regarded as valid DefaultValue: (1) |
IdentificationDate | datetime | The date of the identification calculated from the entries in IdentificationDay, -Month and -Year |
IdentificationDay | tinyint | The day of the identification event |
IdentificationMonth | tinyint | The month of the identification event |
IdentificationYear | smallint | The year of the identification event. The year may be empty if only the day or month are known. |
IdentificationDateSupplement | nvarchar (255) | Verbal or additional identification date information, e.g. 'end of summer 1985', 'first quarter', '1888-1892' |
IdentificationDateCategory | nvarchar (50) | Category of the date of the identification e.g. "system", "estimated" (= foreign key, see in table CollDateCategory_Enum) |
VernacularTerm | nvarchar (255) | Name or term other than a taxonomic (= scientific) name, e.g. 'pine', 'limestone', 'conifer', 'hardwood' |
TaxonomicName | nvarchar (255) | Valid name of the species (including the taxonomic author where available). Example: 'Rosa canina L.' |
NameURI | varchar (255) | The URI of the taxonomic name, e.g. as provided by the module DiversityTaxonNames. |
IdentificationCategory | nvarchar (50) | Category of the identification e.g. 'determination', 'confirmation', 'absence' (= foreign key, see table CollIdentificationCategory_Enum) |
IdentificationQualifier | nvarchar (50) | Qualification of the identification e.g. "cf."," aff.", "sp. nov." (= foreign key, see table CollIdentificationQualifier_Enum) |
TypeStatus | nvarchar (50) | If identification unit is type of a taxonomic name: holotype, syntype, etc. (= foreign key, see table CollTypeStatus_Enum) |
TypeNotes | nvarchar (MAX) | Notes concerning the typification of this specimen |
ReferenceTitle | nvarchar (255) | Publications or authoritative opinions of scientist used during the identification process. Example: enter 'Schmeil-Fitschen 1995' if this field flora was used. |
ReferenceURI | varchar (255) | The URI of the reference e.g. as provided by the module DiversityReferences |
ReferenceDetails | nvarchar (50) | The exact location within the reference, e.g. pages, plates |
Notes | nvarchar (MAX) | User defined notes, e.g. the reason for a re-determination / change of the name, etc. |
ResponsibleName | nvarchar (255) | Name of the person or institution responsible for the determination DefaultValue: [dbo].[CurrentUserName]() |
ResponsibleAgentURI | varchar (255) | URI of the person or institution responsible for the determination (= foreign key) as stored in the module DiversityAgents. |
LogCreatedWhen | datetime | Date and time when the dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Login of the user who created the dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | Date and time when the dataset was changed DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Login of the user who changed the dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: IdentificationUnit
Organism that is present in or on a collection specimen
Column | Data type | Description |
---|---|---|
CollectionSpecimenID | int | Refers to the ID of CollectionSpecimen (= Foreign key and part of primary key) |
IdentificationUnitID | int | ID of the identification unit (= part of Primary key). Usually one of possibly several organisms present on the collection specimen. Example: parasite with hyperparasite on plant leaf = 3 units, |
LastIdentificationCache | nvarchar (255) | The last identification as entered in table Identification |
FamilyCache | nvarchar (255) | A cached value of the family of the taxon of the last identification. Can be set by the editor if NameURI in table Identification is NULL, otherwise set by the system. |
OrderCache | nvarchar (255) | A cached value of the order of the taxon of the last identification. Can be set by the editor if NameURI in table Identification is NULL, otherwise set by the system. |
TaxonomicGroup | nvarchar (50) | Taxonomic group the organism identified by this unit belongs to. Groups listed in table CollTaxonomicGroup_Enum (= foreign key) |
OnlyObserved | bit | True if the organism was only observed rather than collected. It is therefore not present on the preserved specimen. Example: Tree under which the collected mycorrhizal fungus grew. DefaultValue: (0) |
RelatedUnitID | int | The IdentificationUnitID of the organism or substrate, on which this organism is growing (= foreign key) |
RelationType | nvarchar (50) | The relation of an unit to its substrate, e.g. parasitism, symbiosis etc. as stored in CollRelationType_Enum (= foreign key) |
ColonisedSubstratePart | nvarchar (255) | If a substrate association exists: part of the substrate that is affected in the interaction (e.g. 'leaves' if a fungus is growing on the leaves of an infected plant) |
LifeStage | nvarchar (255) | Examples: 'II, III' for spore generations of rusts or 'seed', 'seedling' etc. for higher plants |
Gender | nvarchar (50) | The gender of the identification unit, e.g. 'male' |
NumberOfUnits | smallint | The number of units of this identification unit, e.g. 400 beetle in a bottle |
ExsiccataNumber | nvarchar (50) | If specimen is an exsiccata: Number of current specimen within the exsiccata series |
ExsiccataIdentification | smallint | Refers to the IdentificationSequence in Identification (= foreign key). The name under which the collection specimen resp. this unit is published within an exsiccata. |
UnitIdentifier | nvarchar (50) | An identifier for the identification of the unit e.g. a number painted on a tree within an experimental plot |
UnitDescription | nvarchar (50) | Description of the unit, esp. if not the an organism but parts or remnants of it were present or observed, e.g. a nest of an insect or a song of a bird |
Circumstances | nvarchar (50) | Circumstances of the occurence of the organism |
DisplayOrder | smallint | The sequence in which the units within this specimen will appear on e.g. a label where the first unit may be printed in the header and others in the text below. 0 means the unit should not appear on a label. DefaultValue: (1) |
Notes | nvarchar (MAX) | Further information on the identification unit or interaction, e. g. infection symptoms like 'producing galls' |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: IdentificationUnitAnalysis
The analysis values taken from an identification unit
Column | Data type | Description |
---|---|---|
CollectionSpecimenID | int | Refers to the ID of CollectionSpecimen (= Foreign key and part of primary key) |
IdentificationUnitID | int | Refers to the ID of IdentficationUnit (= foreign key and part of primary key) |
AnalysisID | int | Analysis ID, foreign key of table Analysis. |
AnalysisNumber | nvarchar (50) | Number of the analysis |
AnalysisResult | nvarchar (MAX) | The result of the analysis |
ExternalAnalysisURI | varchar (255) | An URI for an analysis as defined in an external datasoure |
ResponsibleName | nvarchar (255) | Name of the person or institution responsible for the determination DefaultValue: [dbo].[CurrentUserName]() |
ResponsibleAgentURI | varchar (255) | URI of the person or institution responsible for the determination (= foreign key) as stored in the module DiversityAgents. |
AnalysisDate | nvarchar (50) | The date of the analysis |
SpecimenPartID | int | ID of the part of a specimen (optional, Foreign key) if the analysis was done with a part of the specimen (see table CollectionSpecimenPart). |
Notes | nvarchar (MAX) | Notes concerning this analysis |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: IdentificationUnitGeoAnalysis
The geographical position or region of an organism at a certain time
Column | Data type | Description |
---|---|---|
CollectionSpecimenID | int | Refers to the ID of CollectionSpecimen (= Foreign key and part of primary key) |
IdentificationUnitID | int | Refers to the ID of IdentficationUnit (= foreign key and part of primary key) |
AnalysisDate | datetime | The date of the analysis |
Geography | geography | The geography of the identification unit according to WGS84, e.g. a point (latitide, longitude and altitude) |
Geometry | geometry (MAX) | The geometry of the identifiction unit, e.g. an area |
ResponsibleName | nvarchar (255) | Name of the person or institution responsible for the determination |
ResponsibleAgentURI | varchar (255) | URI of the person or institution responsible for the determination (= foreign key) as stored in the module DiversityAgents. |
Notes | nvarchar (MAX) | Notes concerning this analysis |
LogCreatedWhen | datetime | The time when this dataset was created |
LogCreatedBy | nvarchar (50) | Who created this dataset |
LogUpdatedWhen | datetime | The last time when this dataset was updated |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: IdentificationUnitInPart
The list of the organisms that are found in a part of the specimen
Column | Data type | Description |
---|---|---|
CollectionSpecimenID | int | Refers to the ID of CollectionSpecimen (= Foreign key and part of primary key) |
IdentificationUnitID | int | ID of the identification unit (= part of Primary key). Usually one of possibly several organisms present on the collection specimen. Example: parasite with hyperparasite on plant leaf = 3 units, |
SpecimenPartID | int | ID of the part of a specimen (optional, Foreign key) if the identification unit is located on a part of the specimen (see table CollectionSpecimenPart). |
DisplayOrder | smallint | The sequence in which the units within this part will appear on e.g. a label where the first unit may be printed in the header and others in the text below. 0 means the unit should not appear on a label. DefaultValue: (1) |
Description | nvarchar (500) | A description of the unit, esp. if not a whole unit but e.g. parts of it are stored in the collection, e.g. a nest of a bird |
LogInsertedBy | nvarchar (50) | Name of user who first entered (typed or imported) the data. DefaultValue: user_name() |
LogInsertedWhen | smalldatetime | Date and time when the data were first entered (typed or imported) into this database. DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Name of user who last updated the data. DefaultValue: user_name() |
LogUpdatedWhen | smalldatetime | Date and time when the data were last updated. DefaultValue: getdate() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: LocalisationSystem
The geographic localisation systems, e.g. coordinates
Column | Data type | Description |
---|---|---|
LocalisationSystemID | int | Unique ID for the localisation system (= Primary key) |
LocalisationSystemParentID | int | LocalisationSystemID of the superior LocalisationSystem |
LocalisationSystemName | nvarchar (100) | Name of the system used for the determination of the place of the collection, e. g. Gauss-Krüger, MTB, GIS |
DefaultAccuracyOfLocalisation | nvarchar (50) | The default for the accuracy of values that can be reached with this method |
DefaultMeasurementUnit | nvarchar (50) | The default measurement unit for the localisation system, e.g. m, geograpic coordinates |
ParsingMethodName | nvarchar (50) | Internal value, specifying a programming method used for parsing text in fields Location1/Location2 in table CollectionLocalisation |
DisplayText | nvarchar (50) | Short abbreviated description of the localisation system as displayed in the user interface |
DisplayEnable | bit | Specifies if this item is enabled to be used within the database. LocalisationSystems can be disabled to avoid seeing them, but to keep the definition for the future. |
DisplayOrder | smallint | The order in which the entries are displayed. The order may be changed at any time, but all values must be unique. |
Description | nvarchar (255) | Description of the localisation method |
DisplayTextLocation1 | nvarchar (50) | Short abbreviated description of the attribute Location1 in the table CollectionGeography as displayed in the user interface |
DescriptionLocation1 | nvarchar (255) | Description of the attribute Location1 in the table CollectionGeography as displayed in the user interface |
DisplayTextLocation2 | nvarchar (50) | Short abbreviated description of the attribute Location2 in the table CollectionGeography as displayed in the user interface |
DescriptionLocation2 | nvarchar (255) | Description of the attribute Location2 in the table CollectionGeography as displayed in the user interface |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: Processing
The processings of the specimen
Column | Data type | Description |
---|---|---|
ProcessingID | int | ID of the processing (Primary key) |
ProcessingParentID | int | The ID of the superior type of the processing |
DisplayText | nvarchar (50) | The display text of the processing as shown e.g. in a user interface |
Description | nvarchar (MAX) | Description of the processing |
Notes | nvarchar (MAX) | Notes about the processing |
ProcessingURI | varchar (255) | An URI for a processing as defined in an external datasource |
OnlyHierarchy | bit | If the entry is only used for the hierarchical arrangement of the entries DefaultValue: (0) |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: ProcessingMaterialCategory
The processings that are possible for a certain material category
Column | Data type | Description |
---|---|---|
ProcessingID | int | ID of the processing. Refers to ProcessingID in table Processing (foreign key) DefaultValue: (1) |
MaterialCategory | nvarchar (50) | Material category of specimen. Examples: 'herbarium sheets', 'drawings', 'microscopic slides' etc. DefaultValue: N'specimen' |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: Property
The list of the properties that can be specified for the collection site
Column | Data type | Description |
---|---|---|
PropertyID | int | Unique ID for the localisation system (= Primary key) |
PropertyParentID | int | LocalisationSystemID of the superior LocalisationSystem |
PropertyName | nvarchar (100) | Name of the system used for the determination of the place of the collection, e. g. Gauss-Krüger, MTB, GIS |
DefaultAccuracyOfProperty | nvarchar (50) | The default for the accuracy of values that can be reached with this method |
DefaultMeasurementUnit | nvarchar (50) | The default measurement unit for the characterisation system, e.g. pH |
ParsingMethodName | nvarchar (50) | Internal value, specifying a programming method used for parsing text in fields Location1/Location2 in table CollectionLocalisation |
DisplayText | nvarchar (50) | Short abbreviated description of the localisation system as displayed in the user interface |
DisplayEnabled | bit | Specifies if this item is enabled to be used within the database. LocalisationSystems can be disabled to avoid seeing them, but to keep the definition for the future. |
DisplayOrder | smallint | The order in which the entries are displayed. The order may be changed at any time, but all values must be unique. |
Description | nvarchar (255) | Description of the localisation method |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: Transaction
Transactions like loan, borrow, gift, exchange etc. of specimen if they are e.g. permanently or temporary transfered from one collection to another
Column | Data type | Description |
---|---|---|
TransactionID | int | Unique ID for the transaction (= Primary key) |
ParentTransactionID | int | The ID of a preceeding transaction of a superior transaction if transactions are organized in a hierarchy |
TransactionType | nvarchar (50) | Type of the transaction e.g. gift in or out, exchange in or out, purchase in or out DefaultValue: N'exchange' |
TransactionTitle | nvarchar (200) | The title of the transaction as e.g. shown in an user interface |
ReportingCategory | nvarchar (50) | A group defined for the transaction, e. g. a taxonomic group as used for exchange balancing |
AdministratingCollectionID | int | ID of the collection thas is responsible for the administration of the transaction. |
MaterialDescription | nvarchar (MAX) | ID of the project to which the transaction belongs (Projects are defined in DiversityProjects) |
MaterialCategory | nvarchar (50) | Material category of specimen. Examples: 'herbarium sheets', 'drawings', 'microscopic slides' etc. DefaultValue: N'specimen' |
MaterialCollectors | nvarchar (MAX) | The collectors of the material |
FromCollectionID | int | The ID of the collection from which the specimen were transfered, e.g. the donating collection of a gift |
FromTransactionPartnerName | nvarchar (255) | Name of the person or institution from which the specimen were transfered, e.g. the donator of a gift |
FromTransactionPartnerAgentURI | varchar (255) | The URI of the transaction partner (see e.g. module DiversityAgents) |
FromTransactionNumber | nvarchar (50) | Number or code by which a transaction may be recorded by the administration of the source of the specimen, e.g. the donating collection of a gift |
ToCollectionID | int | The ID of the collection to which the specimen were transfered, e.g. the receiver of a gift |
ToTransactionPartnerName | nvarchar (255) | Name of the person or institution to which the specimen were transfered, e.g. the receiver of a gift |
ToTransactionPartnerAgentURI | varchar (255) | The URI of the transaction partner (see e.g. module DiversityAgents) |
ToTransactionNumber | nvarchar (50) | Number or code by which a transaction may be recorded by the administration of the destination of the specimen, e.g. the receiving collection of a gift |
NumberOfUnits | smallint | The number of units that were (initially) included in the transaction |
Investigator | nvarchar (50) | The investigator for whose study a transacted material was sent |
TransactionComment | nvarchar (MAX) | Comments about the exchanged material addressed to the transaction partner |
BeginDate | datetime | Date when the transaction started |
AgreedEndDate | datetime | End of the transaction period, e.g. if the time for borrowing the specimen is restricted |
ActualEndDate | datetime | Actual end of the transaction when e.g. the borrowed specimen were returned to the owner |
InternalNotes | nvarchar (MAX) | Internal notes about this transaction, not to be published e.g. on a web page |
ResponsibleName | nvarchar (255) | The person responsible for this transaction |
ResponsibleAgentURI | varchar (255) | The URI of the person, team or organisation responsible for the data (see e.g. module DiversityAgents) |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: TransactionDocument
The history of transactions resp. the documents connected to the transactions
Column | Data type | Description |
---|---|---|
TransactionID | int | Unique ID for the Transaction, refers to table Transaction (= Part of primary key and foreign key) |
Date | datetime | The date of the event of a transaction |
TransactionText | nvarchar (MAX) | The text of a transaction document |
TransactionDocument | image (2147483647) | A scanned document connected to this transaction event |
InternalNotes | nvarchar (MAX) | Internal notes about this transaction event |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Footnotes: The following conventions and abbreviations have been used in the tables: Columns of primary key:underlined
The access to the data is managed via projects where every collection specimen may be included in several projects. The details about projects and users are stored in separate modules while DiversityCollection contains the tables UserProxy and ProjectProxy to allow a independent administration of the basic functions related to projects and users.
Table: CollectionProject
The projects within which the collection specimen were placed
Column | Data type | Description |
---|---|---|
CollectionSpecimenID | int | Refers to the ID of CollectionSpecimen (= Foreign key and part of primary key) |
ProjectID | int | ID of the project to which the specimen belongs (Projects are defined in DiversityProjects) |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: ProjectAnalysis
The types of the analysis that are available for a project
Column | Data type | Description |
---|---|---|
AnalysisID | int | ID of the analysis (Primary key) |
ProjectID | int | ID of the project to which the specimen belongs (Projects are defined in DiversityProjects) |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: ProjectProcessing
The types of processing available within a project
Column | Data type | Description |
---|---|---|
ProcessingID | int | ID of the Processing (Primary key) |
ProjectID | int | ID of the project to which the specimen belongs (Projects are defined in DiversityProjects) |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: ProjectProxy
The projects as stored in the module DiversityProjects
Column | Data type | Description |
---|---|---|
ProjectID | int | ID of the project to which the specimen belongs (Projects are defined in DiversityProjects) |
Project | nvarchar (50) | The name or title of the project as shown in a user interface (Projects are defined in DiversityProjects) |
ImageDescriptionTemplate | xml (MAX) | Template for the description of images |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: ProjectUser
The projects that a user can access
Column | Data type | Description |
---|---|---|
LoginName | nvarchar (50) | A login name which the user uses for access the DivesityWorkbench, Microsoft domains, etc.. |
ProjectID | int | ID of the project to which the specimen belongs (Projects are defined in DiversityProjects) |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: UserProxy
The user as stored in the module DiversityUsers
Column | Data type | Description |
---|---|---|
LoginName | nvarchar (50) | A login name which the user uses for access the DivesityWorkbench, Microsoft domains, etc.. |
CombinedNameCache | nvarchar (255) | The short name of the user, e.g. P. Smith |
UserURI | varchar (255) | URI of a user in a remote module, e.g. refering to UserInfo.UserID in database DiversityUsers |
AgentURI | varchar (255) | |
Queries | xml (MAX) | Queries created by the user |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Footnotes: The following conventions and abbreviations have been used in the tables: Columns of primary key:underlined
Annotations
For Users without access to the main data, the table Annotation provides the possiblity to add annotations to collection events, collection specimen, identification units and collection specimen parts
Table: Annotation
Annotations to datasets in the database
Column | Data type | Description |
---|---|---|
AnnotationID | int | ID of the annotation (Primary key) |
ReferencedAnnotationID | int | If an annotation refers to another annotation, the ID of the referred annotation |
AnnotationType | nvarchar (50) | The type of the annotation as defined in AnnotationType_Enum, e.g. Reference |
Title | nvarchar (50) | Title of the annotation |
Annotation | nvarchar (MAX) | The annotation entered by the user |
URI | varchar (255) | The complete URI address of a resource related to the annotation. May be link to a module, e.g. for the annotation type reference |
ReferenceDisplayText | nvarchar (500) | The title of the reference. If the entry is linked to an external module like DiversityReferences, the cached display text of the referenced dataset |
ReferenceURI | varchar (255) | If the entry is linked to an external module like DiversityReferences, the link to the referenced dataset |
SourceDisplayText | nvarchar (500) | The name of the source. If the entry is linked to an external module like DiversityAgents, the cached display text of the referenced dataset |
SourceURI | varchar (255) | If the entry is linked to an external module like DiversityAgents, the link to the referenced dataset |
IsInternal | bit | If an annotation is restricted to authorized users of the database |
ReferencedID | int | The ID of the dataset in the table the annotation refers to |
ReferencedTable | nvarchar (500) | The name of the table the annotation refers to |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Entity tables
For adaption to a context the descriptions, titles, visibility etc. of tables, columns etc. in the database can be changed according to the definitions within the context. Use these tables e.g. to document the visibility of certain parts of the database in a user interface like a mobile device or to translate the descriptions etc. in any language.
Table: Entity
The entities in an application e.g. the tables and columns in a database
Column | Data type | Description |
---|---|---|
Entity | varchar (500) | The name of the entity, e.g. Table.Column.Content within the database or a unique string for e.g. a message within the DiversityWorkbench e.g. "DiversityWorkbench.Message.Connection.NoAccess", PK |
DisplayGroup | nvarchar (50) | If DiversityWorkbench entities should be displayed in a group, the name of the group |
Notes | nvarchar (MAX) | Notes about the entity |
Obsolete | bit | True if an entity is obsolete. Obsolete entities may be kept to ensure compatibility with older modules |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: EntityRepresentation
The description of the entity in a certain context in different languages
Column | Data type | Description |
---|---|---|
Entity | varchar (500) | The name of the entity. Foreign key, relates to table Entity |
LanguageCode | nvarchar (50) | ISO 639: 2-letter codes for the language of the content |
EntityContext | nvarchar (50) | The context for the representation, e.g. "Exchange with ABCD", "collection management" or "observation" as defined in table EntityContext_Enum |
DisplayText | nvarchar (50) | The text for the entity as shown e.g. in a user interface |
Abbreviation | nvarchar (20) | The abbreviation for the entity as shown e.g. in a user interface |
Description | nvarchar (MAX) | The description of the entity |
Notes | nvarchar (MAX) | Notes about the representation of the entity |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Table: EntityUsage
The usage of an entity in a certain context, e.g. hidden, readonly
Column | Data type | Description |
---|---|---|
Entity | varchar (500) | The name of the entity. Foreign key, relates to table Entity |
EntityContext | nvarchar (50) | The context for the representation, e.g. "Exchange with ABCD", "collection management" or "observation" as defined in table EntityContext_Enum |
Accessibility | nvarchar (50) | If the access of entity is resticted to e.g. read only or it can be edited without restrictions |
Determination | nvarchar (50) | If a value is determined e.g. by the system or the user |
Visibility | nvarchar (50) | If the entity is visible or hidden from e.g. a user interface |
PresetValue | nvarchar (500) | If a value is preset the value resp. SQL statement for the value, e.g. 'determination' for identifications when using a mobile device during an expedition |
Notes | nvarchar (MAX) | Notes about the usage of the entity |
LogCreatedWhen | datetime | The time when this dataset was created DefaultValue: getdate() |
LogCreatedBy | nvarchar (50) | Who created this dataset DefaultValue: user_name() |
LogUpdatedWhen | datetime | The last time when this dataset was updated DefaultValue: getdate() |
LogUpdatedBy | nvarchar (50) | Who was the last to update this dataset DefaultValue: user_name() |
RowGUID | uniqueidentifier | DefaultValue: newsequentialid() |
Footnotes: The following conventions and abbreviations have been used in the tables: Columns of primary key:underlined
Template for enumeration tables
Unfortunately, some labels in the diagram are in German. “Spaltenname” translates to “column name”, “Datentyp-Kurzform” to “data type”, and “Beschreibung” to “column description”.
Overview including all enumeration tables in the database
Known problems
URI for connection to DiversityTaxonNames, DiversityAgents, DiversityReferences and DiversityGazetteer.