CommonDataModel » History » Version 64
Andreas Müller, 10/11/2011 01:25 PM
1 | 62 | Niels Hoffmann | [|{{>toc}} |
---|---|---|---|
2 | 1 | ||
3 | 62 | Niels Hoffmann | ] |
4 | |||
5 | 1 | ||
6 | |||
7 | |||
8 | |||
9 | 13 | Markus Döring | # Common Data Model |
10 | 1 | ||
11 | 31 | Markus Döring | The Common Data Model (CDM) is the domain model for the core EDIT components. The CDM is primarily based on the [TDWG Ontology](http://rs.tdwg.org/ontology/voc/.) But other models and standards (see [[TaxonomicDataStandards]], [[BibliographicalDataStandards]], [[SpecimenOrObservationStandards]]) have influenced the modelling too. |
12 | 2 | Markus Döring | |
13 | 1 | ||
14 | 30 | Markus Döring | |
15 | 1 | ## Scope |
|
16 | 30 | Markus Döring | |
17 | 49 | Markus Döring | 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. |
18 | 1 | ||
19 | 63 | Andreas Müller | The [CDM](http://wp5.e-taxonomy.eu/cdm/latest/) covers the following object types (classes), grouped by packages: |
20 | 19 | Markus Döring | |
21 | 1 | ||
22 | 61 | Katja Luther | ![](model_overview.GIF) |
23 | 1 | ||
24 | 27 | Markus Döring | |
25 | 1 | ||
26 | 26 | Markus Döring | ---- |
27 | 1 | ||
28 | 31 | Markus Döring | |
29 | 45 | Markus Döring | ## Model Documentation |
30 | 31 | Markus Döring | |
31 | 1 | ||
32 | 38 | Markus Döring | ### CDM Version 1.0 |
33 | 36 | Markus Döring | |
34 | 55 | Anahit Babadshanjan | The [**first version**](http://wp5.e-taxonomy.eu/cdm/v1/) of the CDM has been completed and version:"CDM UML 1.0" reached. The modelling was done with Enterprise Architect and resulted in annotated UML class diagrams. The model is also available for download: attachment:"edit_cdm.eap". |
35 | 50 | Andreas Müller | |
36 | |||
37 | |||
38 | ### CDM Version 1.4 |
||
39 | |||
40 | 55 | Anahit Babadshanjan | [**Version 1.4**](http://wp5.e-taxonomy.eu/cdm/v14/) of the CDM has been completed together with the deliverable D11. The modelling was done in Java and import into Enterprise Architect. The model is also available for download: attachment:"edit_cdm_14.eap". |
41 | 21 | Markus Döring | |
42 | 40 | Markus Döring | |
43 | 56 | Anahit Babadshanjan | Since the first version of the CDM was purely modelled in UML with implementation in mind, but no real world use yet, implementing the model in Java code has required changes all over. |
44 | 1 | ||
45 | 56 | Anahit Babadshanjan | |
46 | Since the freeze of version 1.0 we are primarily maintaining the model in the source:"trunk/cdmlib/cdmlib-model/src/main/java/eu/etaxonomy/cdm/model" and derive the UML documentation in Enterprise Architect from the source code. |
||
47 | 1 | ||
48 | 56 | Anahit Babadshanjan | To generate the UML model automatically from the Java code EA's import source-code feature was used that synchronizes classes by namespace (_in EA7 project browser "Common Data Model"-"Java Model" -> right click ->Code Engineering->Import Source Directory_). |
49 | 1 | ||
50 | |||
51 | |||
52 | 56 | Anahit Babadshanjan | ### CDM Version 2.0 |
53 | 49 | Markus Döring | |
54 | 56 | Anahit Babadshanjan | |
55 | 59 | Katja Luther | [**Version 2.0**](http://wp5.e-taxonomy.eu/cdm/v20/) of the CDM. |
56 | 1 | ||
57 | |||
58 | 59 | Katja Luther | |
59 | |||
60 | ### CDM Version 2.2 |
||
61 | |||
62 | |||
63 | 64 | Andreas Müller | [**Version 2.2**](http://wp5.e-taxonomy.eu/cdm/v22/) of the CDM. |
64 | 59 | Katja Luther | |
65 | 1 | ||
66 | |||
67 | 64 | Andreas Müller | ### CDM Version 3.0 |
68 | 63 | Andreas Müller | |
69 | |||
70 | 64 | Andreas Müller | [**Version 3.0**](http://wp5.e-taxonomy.eu/cdm/v30/) of the CDM. |
71 | 63 | Andreas Müller | |
72 | 1 | ||
73 | |||
74 | 64 | Andreas Müller | ### CDM Version 3.1 |
75 | 1 | ||
76 | 63 | Andreas Müller | |
77 | 64 | Andreas Müller | [**Version 3.1**](http://wp5.e-taxonomy.eu/cdm/v31/) of the CDM is the most current version. |
78 | |||
79 | |||
80 | The latest documentation of the model can be found in *JavaDocs:cdmlib-model*. We also keep track of the major *CdmChanges*. |
||
81 | 59 | Katja Luther | |
82 | 1 | ||
83 | |||
84 | 45 | Markus Döring | |
85 | 43 | Markus Döring | ### FAQ |
86 | 45 | Markus Döring | |
87 | Additionally to the UML and Java documentation we maintain a *CdmFaq*. |
||
88 | |||
89 | |||
90 | 8 | Markus Döring | |
91 | 1 | ||
92 | ---- |
||
93 | |||
94 | 45 | Markus Döring | |
95 | 3 | Markus Döring | ## Contributing |
96 | 49 | Markus Döring | |
97 | 1 | This wiki describes the latest stage of the modelling efforts. Discussions are being held on a mailing list dedicated only to the CDM. We invite everyone to join the mailinglist to follow discussions, raise questions or even suggest changes to the model. |
|
98 | 47 | Markus Döring | |
99 | 1 | ||
100 | **mailto:cdm-edit@mnhn.fr** |
||
101 | 18 | Markus Döring | |
102 | |||
103 | 1 | 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: |
|
104 | |||
105 | 49 | Markus Döring | |
106 | 18 | Markus Döring | https://webmail.mnhn.fr/wws/arc/cdm-edit |
107 | 1 | ||
108 | 45 | Markus Döring | |
109 | As we sometimes cannot apply changes immediately to the model, we also keep track of issues to be done. |
||
110 | 1 | ||
111 | 18 | Markus Döring | All notes regarding changes or additions to the CDM are managed with [[report13|tickets in TRAC]]. |
112 | 1 | ||
113 | |||
114 | 18 | Markus Döring | |
115 | 45 | Markus Döring | |
116 | 38 | Markus Döring | ## Partner |
117 | 49 | Markus Döring | |
118 | 46 | Markus Döring | We try to collaborate with other projects outside of EDIT to base its development on a stable long-term perspective. Apart from shared software development it is essential that we test the CDM with different, diverse datasets. |
119 | |||
120 | Our main collaborators so far are: |
||
121 | |||
122 | * EDIT WP6 Exemplar groups, see also [[CdmDataportal]] |
||
123 | |||
124 | * [Palmweb](http://www.palmweb.org,) Kew |
||
125 | |||
126 | * [Cichorieae](http://wp6-cichorieae.e-taxonomy.eu,) BGBM |
||
127 | |||
128 | 45 | Markus Döring | * [Milichiidae](http://www.milichiidae.info/,) NHM |
129 | 1 | ||
130 | 44 | Markus Döring | * [CATE project](http://www.cate-project.org/,) London |
131 | 45 | Markus Döring | |
132 | 1 | * PESI, "Pan European Species-directories Infrastructure" |
|
133 | 45 | Markus Döring | |
134 | 1 | * [Euro+Med PlantBase](http://www.emplantbase.org) |
|
135 | 45 | Markus Döring | |
136 | 1 | * [Fauna Europaea](http://www.faunaeur.org/) |
|
137 | 49 | Markus Döring | |
138 | 1 | * [European Register of Marine Species (ERMS)](http://www.marbef.org/data/erms.php) |
|
139 | 45 | Markus Döring | |
140 | 44 | Markus Döring | * [Key2Nature](http://www.key2nature.eu) |
141 | |||
142 | |||
143 | 45 | Markus Döring | |
144 | 44 | Markus Döring | ## Releases |
145 | 45 | Markus Döring | |
146 | 44 | Markus Döring | The CDM is released as part of the [[CdmLibrary]] |
147 | |||
148 | |||
149 | |||
150 | 45 | Markus Döring | |
151 | 44 | Markus Döring | ---- |
152 | |||
153 | |||
154 | ## Background Information |
||
155 | |||
156 | * [[TaxonomicGlossary]] - general taxonomic & nomenclatural glossary |
||
157 | |||
158 | 1 | * [[ZoologicalAdaptation]] - changes required for the [[BerlinModel]] to deal with zoological data |
|
159 | |||
160 | * [[ZooCode]] - the difference of the zoological code compared to the botanical code |
||
161 | 2 | Markus Döring | |
162 | 1 | * [[NomenclaturalStatus]] - descriptions of the different nomenclatural status codes both for botany and zoology |
|
163 | |||
164 | * [[TaxonomicDataStandards]] - other taxonomic models and standards |
||
165 | |||
166 | 45 | Markus Döring | * [[BibliographicalDataStandards]] - bibliographical models and standards |
167 | |||
168 | |||
169 | |||
170 | ### Modelling Guidelines |
||
171 | |||
172 | * [[BestPractices]] - best practices for the EDIT UML modelling and coding conventions for developers |
||
173 | |||
174 | 1 | * [[OntologyModelling]] - general remarks and links to OWL |