Main entry page for documenting the latest version of the common data model

• Table of contents
• Common Data Model
  • Introduction
  • Scope
  • Roadmap
    • To Do Notes
    • CDM Java Library
  • Latest CDM
    • UML documentation
    • Enterprise Architect Repository
  • Communication Rules
  • Modelling Guidelines
  • Background Information

---

Common Data Model¶

Introduction¶

The CommonDataModel (CDM) will be the domain model for the core EDIT components. The modelling of the CDM will be done with Enterprise Architect and results in annotated [*UML class diagrams](http://wp5.e-taxonomy.eu/cdm/). The model is available for edit_cdm.eap* too.

It directly serialises into a canonical XML format that can be used to exchange data between PlatformComponents.

The CDM will primarily be based on the BerlinModel and the TdwgLsidVocabularies, but other models and standards (see TaxonomicDataStandards, BibliographicalDataStandards) have influenced the modelling too.

Scope¶

Basically the CDM covers all the data exchanged in the platform. As most applications require additional data, options to extend the model need to be provided.

The current CDM covers the following object types (classes), grouped by packages:

The final CDM v1 release is expected to cover approximately the same type of data, though a rearrangement of classes is likely to occur at the current stage of the modeling.

Roadmap¶

• 4Q/2007 CDM UML 1.0

• 4Q/2008 CDM UML 2.0

To Do Notes¶

All notes regarding changes or additions to the CDM are managed with tickets in TRAC.

See planned milestones above for current tickets.

CDM Java Library¶

We are simultanously working on an independent CDM java library that covers persistency, XML bindings and some basic business logic.

---

Latest CDM¶

UML documentation¶

UML documentation from Enterprise Architect

Enterprise Architect Repository¶

The model is hosted on an SQL Server at the BGBM in Berlin. People that would like to gain access to it please provide a fix IP adress to Markus m.doering@bgbm.org to open up the firewall.

We provide a copy of the entire CDM in the Enterprise Architect edit_cdm.eap. It corresponds to the version in the above UML documentation.

---

Communication Rules¶

This wiki describes the latest stage of the modelling efforts. Discussions are being held on a mailing list dedicated only to the CDM:

cdm-edit@mnhn.fr

The list has a public online archive that stores the discussions so decisions can be tracked back in time. We invite anyone to participate in the discussion, you can subscribe to the mailing list through the webinterface of the archive:

https://webmail.mnhn.fr/wws/arc/cdm-edit

We like to ask people posting to the list to stick to the following common rules to keep the discussion organised and create threads about a single subject in the archive later:

• write a separate post for every major subject you like to discuss

• Reply to previous posts without changing the subject line

• start a new post if the subject of a thread changes

---

Modelling Guidelines¶

• BestPractices - best practices for the EDIT UML modelling and coding conventions for developers

• OntologyModelling - general remarks and links to OWL

Background Information¶

• TaxonomicGlossary - general taxonomic & nomenclatural glossary

• ZoologicalAdaptation - changes required for the BerlinModel to deal with zoological data

• ZooCode - the difference of the zoological code compared to the botanical code

• NomenclaturalStatus - descriptions of the different nomenclatural status codes both for botany and zoology

• TaxonomicDataStandards - other taxonomic models and standards

• BibliographicalDataStandards - bibliographical models and standards