Skip to Content
Last modified by Artur K. on 2026/05/29 14:28
From version 1.11
edited by Helena K.
on 2026/01/15 15:16
Change comment: There is no comment for this version
To version 2.1
edited by Artur K.
on 2026/05/29 14:28
Change comment: Copied from sdmxsrlocalization:Methodology.Guidelines on the Versioning of SDMX Artefacts.WebHome

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -xwiki:XWiki.helena
1 +xwiki:XWiki.arturkryazhev
Content
... ... @@ -191,23 +191,19 @@
191 191  1011 Pure bred breeding horses, live
192 192  1012 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.
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.
195 195  
196 196  |(% colspan="2" %)**REORGANISATION OF EXISTING CODES**
197 197  |**Old version**|**New version**
198 198  |(((
199 199  **3010** Fowls, weighing ≤ 185 g
200 -
201 201  **3020** Ducks, , weighing ≤ 185 g
202 -
203 203  **3030** Other poultry, weighing ≤ 185 g
204 -
205 205  **3040** Fowls, weighing > 185 g
206 -
207 207  **3050** Ducks, , weighing > 185 g
208 -
209 209  **3060** Other poultry, weighing > 185 g
210 -)))|**3025** Poultry, weighing ≤ 175 g **3045** Poultry, weighing > 175 g
205 +)))|**3025** Poultry, weighing ≤ 175 g
206 +**3045** Poultry, weighing > 175 g
211 211  |(% colspan="2" %)Codes **3010**, **3020**, **3030**, **3040**, **3050** and **3060** are fully removed and replaced with two brand new codes; furthermore the criterion for the classification used in the old version has been changed in the new version (185 g criterion versus 175 g criterion), so that it is not possible to exactly aggregate the codes from the old version to the codes of the new version (e.g. a part of **3010** goes to **3025**, another part to **3045**). In this case there is a m to n correspondence between the two sets of codes
212 212  
213 213  **Example 5 – Changes to hierarchies in a Code List. Major impact: +.0**
... ... @@ -214,8 +214,16 @@
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**
213 +|(((
214 +* 0213 - Beer
215 +** 02131 - Lager beer
216 +** 02132 - Other alcoholic beer
217 +)))|(((
218 +* 0213 - Beer
219 +** 02131 - Lager beer
220 +** 02132 - Other alcoholic beer
221 +* **02133 - Low and non-alcoholic beer**
222 +)))
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,69 +223,58 @@
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)
227 -
228 -ES - Spain FR - France
229 -
230 -GR - Greece
231 -
232 -IT - Italy o E4 - Africaetc.
230 +* A1 - World (codelist ref. ECB@CL_AREAS@1.0)
231 +** E1 - Europe (ECB@CL_COUNTRIES@1.0)
232 +*** ES - Spain FR - France
233 +*** GR - Greece
234 +*** IT - Italy
235 +** E4 - Africa
236 +*** etc.
233 233  )))|(((
234 -A1=World (codelist ref. ECB@CL_AREAS@1.0) o E1 =Europe (ECB@CL_COUNTRIES@1.0)
235 -
236 -ES = Spain FR = FranceGR = Greece
237 -
238 -IT = Italy
239 -
240 -**DE= Germany**
241 -
242 -o E4 =Africaetc.
238 +* A1=World (codelist ref. ECB@CL_AREAS@1.0)
239 +** E1 =Europe (ECB@CL_COUNTRIES@1.0)
240 +** ES = Spain FR = FranceGR = Greece
241 +** IT = Italy
242 +** **DE= Germany**
243 +* E4 =Africa
244 +** etc.
243 243  )))
244 244  |(% colspan="2" %)The id of the hierarchical codes are assumed to be equal to those of the code lists referenced. The code DE has been added to hierarchy E1
245 245  
246 246  **Example 7.1 – Dependencies between artefacts: Concept Scheme and Code List. Minor impact: N.+**
247 247  
248 -|**Id:Artefact Type:Details**|**Change type**|**Version Impact**|**Old version**|(((
249 -**New**
250 -
251 -**version**
250 +|(% style="width:492px" %)**Id:Artefact Type:Details**|(% style="width:732px" %)**Change type**|(% style="width:558px" %)**Version Impact**|(% style="width:139px" %)**Old version**|(% style="width:151px" %)(((
251 +**New version**
252 252  )))
253 -|**CL_OBS_STATUS:Code List**|Addition of a new code X|**Minor: N.+**|**1.0**|**1.1**
254 -|**CS_TRADE:Concept Scheme: References CL_OBS_STATUS v1.0 above**|(((
253 +|(% style="width:492px" %)**CL_OBS_STATUS:Code List**|(% style="width:732px" %)Addition of a new code X|(% style="width:558px" %)**Minor: N.+**|(% style="width:139px" %)**1.0**|(% style="width:151px" %)**1.1**
254 +|(% style="width:492px" %)**CS_TRADE:Concept Scheme: References CL_OBS_STATUS v1.0 above**|(% style="width:732px" %)(((
255 255  Adoption of new code X
256 256  
257 -**//Change type//**: Replacement of a child artefact having a different version, but the same id and
258 -
259 -Agency
260 -)))|(((
257 +**//Change type//**: Replacement of a child artefact having a different version, but the same id and Agency
258 +)))|(% style="width:558px" %)(((
261 261  **Minor: N.+**
260 +The child version impact is replicated in the parent artefact
261 +)))|(% style="width:139px" %)**2.0**|(% style="width:151px" %)**2.1**
262 262  
263 -The child version impact is replicated in the parent
264 -
265 -artefact
266 -)))|**2.0**|**2.1**
267 -
268 268  **Example 7.2 – Dependencies between artefacts: Concept Scheme and Code List. Major impact: +.0**
269 269  
270 -|**Id:Artefact Type:Details**|**Change type**|**Version Impact**|**Old version**|(((
271 -**New**
272 -
273 -**version**
265 +|(% style="width:489px" %)**Id:Artefact Type:Details**|(% style="width:734px" %)**Change type**|(% style="width:562px" %)**Version Impact**|**Old version**|(((
266 +**New version**
274 274  )))
275 -|**CL_OBS_STATUS:Code List**|Removal of code U|**Major: +.0**|**1.0**|**2.0**
276 -|(((
268 +|(% style="width:489px" %)**CL_OBS_STATUS:Code List**|(% style="width:734px" %)Removal of code U|(% style="width:562px" %)**Major: +.0**|**1.0**|**2.0**
269 +|(% style="width:489px" %)(((
277 277  **CS_TRADE:Concept**
278 278  
279 279  **Scheme:References**
280 280  
281 281  **CL_OBS_STATUS v1.0 above**
282 -)))|(((
275 +)))|(% style="width:734px" %)(((
283 283  Adoption of new CL_OBS_STATUS without U.
284 284  
285 285  **//Change type//**: Replacement of a child artefact having a different version, but the same id and
286 286  
287 287  Agency
288 -)))|(((
281 +)))|(% style="width:562px" %)(((
289 289  **Major: +.0**
290 290  
291 291  The child version impact is replicated in the parent artefact.
... ... @@ -293,51 +293,41 @@
293 293  
294 294  **Example 7.3 – Dependencies between artefacts: Concept Scheme and Code List. Variable impact (see below)**
295 295  
296 -|**Id:Artefact Type:Details**|**Change type**|**Version Impact**|**Old version**|(((
297 -**New**
298 -
299 -**version**
289 +|(% style="width:489px" %)**Id:Artefact Type:Details**|(% style="width:736px" %)**Change type**|(% style="width:555px" %)**Version Impact**|(% style="width:146px" %)**Old version**|(% style="width:146px" %)(((
290 +**New version**
300 300  )))
301 -|(% rowspan="3" %)**CL_XYZ: Code List**|(((
292 +|(% rowspan="3" style="width:489px" %)**CL_XYZ: Code List**|(% style="width:736px" %)(((
302 302  a) Maintenance agency changes from A to B for governance reasons.
303 -
304 304  Nothing else changes in the code list.
305 -)))|(% rowspan="3" %)**New artefact**|(% rowspan="3" %)(((
295 +)))|(% rowspan="3" style="width:555px" %)**New artefact**|(% rowspan="3" style="width:146px" %)(((
306 306  **CL_XYZ**
307 307  
308 308  **(Agency A)**
309 -)))|(% rowspan="3" %)(((
299 +)))|(% rowspan="3" style="width:146px" %)(((
310 310  **CL_XYZ**
311 311  
312 -**(Agency B)**
313 -
314 -**(new maintenance agency)**
302 +**(Agency B)
303 +(new maintenance agency)**
315 315  )))
316 -|b) Maintenance agency changes from A to B and at the same time new codes are added
317 -|c) Maintenance agency changes from A to B. Since B has different coding rules, the code list itself changes as well.
318 -|(% rowspan="3" %)(((
319 -**CS_TRADE: Concept Scheme: References**
320 -
321 -**CL_XYZ (Agency A) **
322 -)))|(% rowspan="3" %)(((
323 -Replacement of a child artefact having a different Agency.
324 -
305 +|(% style="width:736px" %)b) Maintenance agency changes from A to B and at the same time new codes are added
306 +|(% style="width:736px" %)c) Maintenance agency changes from A to B. Since B has different coding rules, the code list itself changes as well.
307 +|(% rowspan="3" style="width:489px" %)(((
308 +**CS_TRADE: Concept Scheme: References CL_XYZ (Agency A) **
309 +)))|(% rowspan="3" style="width:736px" %)(((
310 +Replacement of a child artefact having a different Agency.
325 325  CL_XYZ (Agency A) changes to CL_XYZ (Agency B).
326 -)))|(((
312 +)))|(% style="width:555px" %)(((
327 327  **Case a): Patch: N.M.+**
328 -
329 329  There is no impact on data exchange
330 -)))|**2.0**|**2.0.1**
331 -|(((
315 +)))|(% style="width:146px" %)**2.0**|(% style="width:146px" %)**2.0.1**
316 +|(% style="width:555px" %)(((
332 332  **Case b): Minor: N. +**
333 -
334 334  The impact is the same as a new minor version of the code list
335 -)))|**2.0**|**2.1**
336 -|(((
319 +)))|(% style="width:146px" %)**2.0**|(% style="width:146px" %)**2.1**
320 +|(% style="width:555px" %)(((
337 337  **Case c) Major: +.0**
338 -
339 339  The impact is the same as a new major version of the code list.
340 -)))|**2.0**|**3.0**
323 +)))|(% style="width:146px" %)**2.0**|(% style="width:146px" %)**3.0**
341 341  
342 342  **Example 7.4 – Dependencies between artefacts: Concept Scheme and DSD. Variable impact (see below)**
343 343  
... ... @@ -344,44 +344,36 @@
344 344  |**Id:Artefact Type:Details**|**Change type**|**Version Impact**|**Old version**|**New version**
345 345  |**CS_TRADE: Concept Scheme containing Concepts C1, C2, C3**|Addition of new Concept C4|**Minor: N.+**|**1.4**|**1.5**
346 346  |(((
347 -**TRADE: Data Structure Definition:**
348 -
349 -**references Concepts C1 and C2**
330 +**TRADE: Data Structure Definition:
331 +references Concepts C1 and C2**
350 350  )))|(((
351 351  None
352 -
353 353  Concept C3 is not used
354 354  )))|**None**|**1.0**|**1.0**
355 355  |** **| |** **|** **|** **
356 356  |**CS_TRADE: Concept Scheme containing Concepts C1, C2, C3**|Change of description in Concept C3 (typo)|**Patch: N.M.+**|**1.4**|**1.4.1**
357 357  |(((
358 -**TRADE: Data Structure Definition:**
359 -
360 -**references Concepts C1 and C2**
339 +**TRADE: Data Structure Definition:
340 +references Concepts C1 and C2**
361 361  )))|(((
362 362  None
363 -
364 364  Concept C3 is not used
365 365  )))|**None**|**1.0**|**1.0**
366 366  |(% colspan="5" %)
367 367  |**CS_TRADE: Concept Scheme containing Concepts C1, C2, C3**|Removal of Concept C3|**Major: +.0**|**1.4**|**2.0**
368 368  |(((
369 -**TRADE: Data Structure Definition:**
370 -
371 -**references Concepts C1 and C2**
348 +**TRADE: Data Structure Definition:
349 +references Concepts C1 and C2**
372 372  )))|None concept C3 is not used|**None**|**1.0**|**1.0**
373 373  |(% colspan="5" %)**Remark: **Once a new version of the DSD is needed for some other reasons (e.g. a change in a code list), it is recommended to update all concept references to the newest available concept scheme if possible: i.e. DSD version 1.1 would then update its concept scheme references from 1.4 to 2.0.
374 374  |(% colspan="5" %)
375 375  |**CS_TRADE: Concept Scheme containing Concepts C1, C2, C3**|Change of description in Concept C2 (typo)|**Patch: N.M.+**|**1.4**|**1.4.1**
376 376  |(((
377 -**TRADE: Data Structure Definition:**
378 -
379 -**references Concepts C1 and C2**
355 +**TRADE: Data Structure Definition:
356 +references Concepts C1 and C2**
380 380  )))|Correction should be taken into account, concept C2 is used|(((
381 -**Patch: N.M.+**
382 -
383 -**//or//**
384 -
358 +**Patch: N.M.+
359 +//or //**
385 385  **None**
386 386  )))|**1.0**|(((
387 387  **1.0.1 //or//**
... ... @@ -390,8 +390,6 @@
390 390  )))
391 391  |(% colspan="5" %)**Remark: **Since the change of a typo in a Concept of the Concept Scheme does not have a direct impact on the DSD itself (the link is by reference), there is strictly speaking no need to update the DSD. Both DSDs (1.0 and 1.0.1) will have exactly the same syntax. However, if maintainers want to highlight the correction for users of the DSD or for some other reason the DSD is updated anyway; it should reference the newer Concept Scheme.
392 392  
393 -**~ **
394 -
395 395  ----
396 396  
397 397  {{putFootnotes/}}
© Semantic R&D Group, 2026