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
-
... ... @@ -142,25 +142,29 @@ 142 142 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 145 +| |(% colspan="2" %)**CONCEPT SCHEME (CS)** 146 +|**Type of change**|**Impact**|**Comments** 147 +|((( 148 +**Addition or removal of a child** 150 150 150 +**Code List** 151 +)))|**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)** 154 + 155 +| |(% 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** 158 +**If same id and Agency, then the child artefact version change is replicated in the parent artefact.** 159 + 160 +**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. 163 + 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 = 167 +=== 6. Appendix - Examples === 164 164 165 165 **Example 1 – Change to a Code List name, for clarification purposes**. **Patch Impact: N.M.+** 166 166 ... ... @@ -181,18 +181,21 @@ 181 181 182 182 |(% colspan="2" %)**AGGREGATION OF EXISTING CODES** 183 183 |**Old version**|**New version** 184 -|**2011** Heifers (female bovine that never calved), live 185 -**2012** Cows, live|**2010** Heifers and cows, live 186 -|(% 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. 188 +|**2011** Heifers (female bovine that never calved), live **2012** Cows, live|**2010** Heifers and cows, live 189 +|(% 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. 187 187 191 + 192 + 188 188 |(% colspan="2" %)**DISAGGREGATION OF EXISTING CODES** 189 189 |**Old version**|**New version** 190 190 |**1010** Live horses|((( 191 -1 011Pure bred breeding horses, live192 -1 012Other horses, live196 +1. Pure bred breeding horses, live 197 +1. Other horses, live 193 193 ))) 194 -|(% 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.199 +|(% 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. 195 195 201 + 202 + 196 196 |(% colspan="2" %)**REORGANISATION OF EXISTING CODES** 197 197 |**Old version**|**New version** 198 198 |((( ... ... @@ -214,8 +214,7 @@ 214 214 215 215 |(% colspan="2" %)**ADDING A NEW CODE IN AN EXISTING HIERARCHY – CODE LIST** 216 216 |**Old version**|**New version** 217 -|• 0213 - Beer o02131 - Lager beer o02132 - Other alcoholic beer|0213 - Beer o02131 - Lager beer o 02132 - Other alcoholic beer 218 -**02133 - Low and non-alcoholic beer** 224 +|• 0213 - Beer o02131 - Lager beer o02132 - Other alcoholic beer|• 0213 - Beer o02131 - Lager beer o 02132 - Other alcoholic beer o **02133 - Low and non-alcoholic beer** 219 219 |(% colspan="2" %)Code 02133 has been added to hierarchy 0213 220 220 221 221 **Example 6 – Changes to hierarchies in a Hierarchical Code List. Major impact: +.0** ... ... @@ -223,17 +223,17 @@ 223 223 |(% colspan="2" %)**ADDING A NEW CODE IN AN EXISTING HIERARCHY – HIERARCHICAL CODE LIST** 224 224 |**Old version**|**New version** 225 225 |((( 226 - A1 - World (codelist ref. ECB@CL_AREAS@1.0) o E1 - Europe (ECB@CL_COUNTRIES@1.0) 232 +• A1 - World (codelist ref. ECB@CL_AREAS@1.0) o E1 - Europe (ECB@CL_COUNTRIES@1.0) 227 227 228 -ES - Spain FR - France 234 + ES - Spain FR - France 229 229 230 230 GR - Greece 231 231 232 232 IT - Italy o E4 - Africaetc. 233 233 )))|((( 234 -A1=World (codelist ref. ECB@CL_AREAS@1.0) o E1 =Europe (ECB@CL_COUNTRIES@1.0) 240 +• A1=World (codelist ref. ECB@CL_AREAS@1.0) o E1 =Europe (ECB@CL_COUNTRIES@1.0) 235 235 236 -ES = Spain FR = FranceGR = Greece 242 + ES = Spain FR = FranceGR = Greece 237 237 238 238 IT = Italy 239 239