Changes for page Guidelines on the Versioning of SDMX Artefacts
Last modified by Artur K. on 2026/05/29 14:28
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -127,40 +127,51 @@ 127 127 The replacement of a reference with a different reference has the same impact for every artefact. 128 128 129 129 |(% colspan="3" %)**ALL ARTEFACTS** 130 -| (% style="width:492px" %)**Type of change**|(% style="width:441px" %)**Impact**|**Comments**131 -|( % style="width:492px" %)(((132 -**Replacement of a child artefact having a different version, but same id and Agency**133 - )))|(% style="width:441px" %)(((134 -** The child artefact version changeis replicated inthe parent artefact**130 +|**Type of change**|**Impact**|**Comments** 131 +|((( 132 +**Replacement of a child artefact having a different version, but same id and** 133 + 134 +**Agency** 135 135 )))|((( 136 +**The child artefact version change is replicated in the** 137 + 138 +**parent artefact** 139 +)))|((( 136 136 If a child artefact (e.g. a Code List) has a minor version change, then the parent artefact (e.g. a Concept Scheme) should also have a minor version change. 141 + 137 137 If there are several child artefact version changes, the most severe impact is replicated in the parent artefact. For example, if two Code Lists have minor changes, and one Code List has a major change at the same time, the parent Concept Scheme has a major version change 138 138 ))) 139 -|(% style="width:492px" %)((( 140 -**Replacement of a referenced child artefact having a different id or Agency** 141 -)))|(% style="width:441px" %)**The parent artefact version impact depends on the backward/ forward compatibility as shown in the tables above**|Technically, the child artefact is not considered to be related to the previous child artefact. It needs to be checked whether exchange contracts can still be guaranteed (backward/forward compatibility principle) 144 +|((( 145 +**Replacement of a referenced child artefact having a** 142 142 147 +**different id or Agency** 148 +)))|**The parent artefact version impact depends on the backward/ forward compatibility as shown in the tables above**|Technically, the child artefact is not considered to be related to the previous child artefact. It needs to be checked whether exchange contracts can still be guaranteed (backward/forward compatibility principle) 149 + 143 143 ==== b. Addition or removal of referenced artefacts ==== 144 144 145 -|(% colspan="3" style="width:876px" %)**CONCEPT SCHEME (CS)** 146 -|(% style="width:845px" %)**Type of change**|(% style="width:156px" %)**Impact**|(% style="width:1071px" %)**Comments** 147 -|(% style="width:845px" %)((( 148 -**Addition or removal of a child Code List** 149 -)))|(% style="width:156px" %)**Minor: N.+**|(% style="width:1071px" %)The child Code Lists in a Data Structure Definition have priority over those referenced in a Concept Scheme. Child Code Lists added to or removed from a Concept Scheme do not have a direct impact on the data exchange. Backward/forward compatibility depends on the way Code Lists are referenced in Data Structure Definitions referencing the concept scheme. This needs to be taken into account when creating a new version of a DSD accordingly 152 +| |(% colspan="2" %)**CONCEPT SCHEME (CS)** 153 +|**Type of change**|**Impact**|**Comments** 154 +|((( 155 +**Addition or removal of a child** 150 150 157 +**Code List** 158 +)))|**Minor: N.+**|The child Code Lists in a Data Structure Definition have priority over those referenced in a Concept Scheme. Child Code Lists added to or removed from a Concept Scheme do not have a direct impact on the data exchange. Backward/forward compatibility depends on the way Code Lists are referenced in Data Structure Definitions referencing the concept scheme. This needs to be taken into account when creating a new version of a DSD accordingly 151 151 152 152 153 -|(% colspan="3" %)**DATA STRUCTURE DEFINITION (DSD)** 161 + 162 +| |(% colspan="2" %)**DATA STRUCTURE DEFINITION (DSD)** 154 154 |**Type of change**|**Impact**|**Comments** 155 155 |**Addition or removal of a child Code List**|((( 156 -**If same id and Agency, then the child artefact version change is replicated in the parent artefact. 157 -If different id or Agency, impact wil depend on the backward/forward compatibility as shown in the tables above** 165 +**If same id and Agency, then the child artefact version change is replicated in the parent artefact.** 166 + 167 +**If different id or Agency, impact wil depend on the backward/forward compatibility as shown in the tables above** 158 158 )))|((( 159 159 If a child Code List has a minor version change, then the DSD should also have a minor version change. 170 + 160 160 If there are several Code List version changes, the most severe impact is replicated in the DSD. For example, if two Code Lists have minor changes, and one Code List has a major change at the same time, the parent DSD has a major version change 161 161 ))) 162 162 163 -= 6. Appendix - Examples = 174 +=== 6. Appendix - Examples === 164 164 165 165 **Example 1 – Change to a Code List name, for clarification purposes**. **Patch Impact: N.M.+** 166 166 ... ... @@ -182,8 +182,10 @@ 182 182 |(% colspan="2" %)**AGGREGATION OF EXISTING CODES** 183 183 |**Old version**|**New version** 184 184 |**2011** Heifers (female bovine that never calved), live **2012** Cows, live|**2010** Heifers and cows, live 185 -|(% colspan="2" %)Codes **2011** and **2012** are fully{{footnote}}i.e. without integration into or combination with another existing code.{{/footnote}} __**removed**__and replaced with one__**brand new**__code. In this case there is a many to 1 correspondence between the codes.196 +|(% colspan="2" %)Codes **2011** and **2012** are fully{{footnote}}i.e. without integration into or combination with another existing code.{{/footnote}} **removed** and replaced with one **brand new** code. In this case there is a many to 1 correspondence between the codes. 186 186 198 + 199 + 187 187 |(% colspan="2" %)**DISAGGREGATION OF EXISTING CODES** 188 188 |**Old version**|**New version** 189 189 |**1010** Live horses|((( ... ... @@ -190,8 +190,10 @@ 190 190 1. Pure bred breeding horses, live 191 191 1. Other horses, live 192 192 ))) 193 -|(% colspan="2" %)Code __**1010**__is fully__**removed**__and replaced with two__**brand new**__codes. In this case there is a 1 to m correspondence between the codes.206 +|(% colspan="2" %)Code **1010** is fully **removed** and replaced with two **brand new** codes. In this case there is a 1 to m correspondence between the codes. 194 194 208 + 209 + 195 195 |(% colspan="2" %)**REORGANISATION OF EXISTING CODES** 196 196 |**Old version**|**New version** 197 197 |((( ... ... @@ -221,17 +221,17 @@ 221 221 |(% colspan="2" %)**ADDING A NEW CODE IN AN EXISTING HIERARCHY – HIERARCHICAL CODE LIST** 222 222 |**Old version**|**New version** 223 223 |((( 224 - A1 - World (codelist ref. ECB@CL_AREAS@1.0) o E1 - Europe (ECB@CL_COUNTRIES@1.0) 239 +• A1 - World (codelist ref. ECB@CL_AREAS@1.0) o E1 - Europe (ECB@CL_COUNTRIES@1.0) 225 225 226 -ES - Spain FR - France 241 + ES - Spain FR - France 227 227 228 228 GR - Greece 229 229 230 230 IT - Italy o E4 - Africaetc. 231 231 )))|((( 232 -A1=World (codelist ref. ECB@CL_AREAS@1.0) o E1 =Europe (ECB@CL_COUNTRIES@1.0) 247 +• A1=World (codelist ref. ECB@CL_AREAS@1.0) o E1 =Europe (ECB@CL_COUNTRIES@1.0) 233 233 234 -ES = Spain FR = FranceGR = Greece 249 + ES = Spain FR = FranceGR = Greece 235 235 236 236 IT = Italy 237 237