Skip to Content
Last modified by Artur K. on 2026/05/29 14:28
From 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
To version 1.13
edited by Helena K.
on 2026/01/15 15:17
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -xwiki:XWiki.arturkryazhev
1 +xwiki:XWiki.helena
Content
... ... @@ -210,16 +210,8 @@
210 210  
211 211  |(% colspan="2" %)**ADDING A NEW CODE IN AN EXISTING HIERARCHY – CODE LIST**
212 212  |**Old version**|**New version**
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 -)))
213 +|• 0213 - Beer o02131 - Lager beer o02132 - Other alcoholic beer|0213 - Beer o02131 - Lager beer o 02132 - Other alcoholic beer
214 +**02133 - Low and non-alcoholic beer**
223 223  |(% colspan="2" %)Code 02133 has been added to hierarchy 0213
224 224  
225 225  **Example 6 – Changes to hierarchies in a Hierarchical Code List. Major impact: +.0**
... ... @@ -227,58 +227,69 @@
227 227  |(% colspan="2" %)**ADDING A NEW CODE IN AN EXISTING HIERARCHY – HIERARCHICAL CODE LIST**
228 228  |**Old version**|**New version**
229 229  |(((
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.
222 + A1 - World (codelist ref. ECB@CL_AREAS@1.0) o E1 - Europe (ECB@CL_COUNTRIES@1.0)
223 +
224 +ES - Spain FR - France
225 +
226 +GR - Greece
227 +
228 +IT - Italy o E4 - Africaetc.
237 237  )))|(((
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.
230 +A1=World (codelist ref. ECB@CL_AREAS@1.0) o E1 =Europe (ECB@CL_COUNTRIES@1.0)
231 +
232 +ES = Spain FR = FranceGR = Greece
233 +
234 +IT = Italy
235 +
236 +**DE= Germany**
237 +
238 +o E4 =Africaetc.
245 245  )))
246 246  |(% 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
247 247  
248 248  **Example 7.1 – Dependencies between artefacts: Concept Scheme and Code List. Minor impact: N.+**
249 249  
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**
244 +|**Id:Artefact Type:Details**|**Change type**|**Version Impact**|**Old version**|(((
245 +**New**
246 +
247 +**version**
252 252  )))
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" %)(((
249 +|**CL_OBS_STATUS:Code List**|Addition of a new code X|**Minor: N.+**|**1.0**|**1.1**
250 +|**CS_TRADE:Concept Scheme: References CL_OBS_STATUS v1.0 above**|(((
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 Agency
258 -)))|(% style="width:558px" %)(((
253 +**//Change type//**: Replacement of a child artefact having a different version, but the same id and
254 +
255 +Agency
256 +)))|(((
259 259  **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  
259 +The child version impact is replicated in the parent
260 +
261 +artefact
262 +)))|**2.0**|**2.1**
263 +
263 263  **Example 7.2 – Dependencies between artefacts: Concept Scheme and Code List. Major impact: +.0**
264 264  
265 -|(% style="width:489px" %)**Id:Artefact Type:Details**|(% style="width:734px" %)**Change type**|(% style="width:562px" %)**Version Impact**|**Old version**|(((
266 -**New version**
266 +|**Id:Artefact Type:Details**|**Change type**|**Version Impact**|**Old version**|(((
267 +**New**
268 +
269 +**version**
267 267  )))
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" %)(((
271 +|**CL_OBS_STATUS:Code List**|Removal of code U|**Major: +.0**|**1.0**|**2.0**
272 +|(((
270 270  **CS_TRADE:Concept**
271 271  
272 272  **Scheme:References**
273 273  
274 274  **CL_OBS_STATUS v1.0 above**
275 -)))|(% style="width:734px" %)(((
278 +)))|(((
276 276  Adoption of new CL_OBS_STATUS without U.
277 277  
278 278  **//Change type//**: Replacement of a child artefact having a different version, but the same id and
279 279  
280 280  Agency
281 -)))|(% style="width:562px" %)(((
284 +)))|(((
282 282  **Major: +.0**
283 283  
284 284  The child version impact is replicated in the parent artefact.
... ... @@ -286,41 +286,51 @@
286 286  
287 287  **Example 7.3 – Dependencies between artefacts: Concept Scheme and Code List. Variable impact (see below)**
288 288  
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**
292 +|**Id:Artefact Type:Details**|**Change type**|**Version Impact**|**Old version**|(((
293 +**New**
294 +
295 +**version**
291 291  )))
292 -|(% rowspan="3" style="width:489px" %)**CL_XYZ: Code List**|(% style="width:736px" %)(((
297 +|(% rowspan="3" %)**CL_XYZ: Code List**|(((
293 293  a) Maintenance agency changes from A to B for governance reasons.
299 +
294 294  Nothing else changes in the code list.
295 -)))|(% rowspan="3" style="width:555px" %)**New artefact**|(% rowspan="3" style="width:146px" %)(((
301 +)))|(% rowspan="3" %)**New artefact**|(% rowspan="3" %)(((
296 296  **CL_XYZ**
297 297  
298 298  **(Agency A)**
299 -)))|(% rowspan="3" style="width:146px" %)(((
305 +)))|(% rowspan="3" %)(((
300 300  **CL_XYZ**
301 301  
302 -**(Agency B)
303 -(new maintenance agency)**
308 +**(Agency B)**
309 +
310 +**(new maintenance agency)**
304 304  )))
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.
312 +|b) Maintenance agency changes from A to B and at the same time new codes are added
313 +|c) Maintenance agency changes from A to B. Since B has different coding rules, the code list itself changes as well.
314 +|(% rowspan="3" %)(((
315 +**CS_TRADE: Concept Scheme: References**
316 +
317 +**CL_XYZ (Agency A) **
318 +)))|(% rowspan="3" %)(((
319 +Replacement of a child artefact having a different Agency.
320 +
311 311  CL_XYZ (Agency A) changes to CL_XYZ (Agency B).
312 -)))|(% style="width:555px" %)(((
322 +)))|(((
313 313  **Case a): Patch: N.M.+**
324 +
314 314  There is no impact on data exchange
315 -)))|(% style="width:146px" %)**2.0**|(% style="width:146px" %)**2.0.1**
316 -|(% style="width:555px" %)(((
326 +)))|**2.0**|**2.0.1**
327 +|(((
317 317  **Case b): Minor: N. +**
329 +
318 318  The impact is the same as a new minor version of the code list
319 -)))|(% style="width:146px" %)**2.0**|(% style="width:146px" %)**2.1**
320 -|(% style="width:555px" %)(((
331 +)))|**2.0**|**2.1**
332 +|(((
321 321  **Case c) Major: +.0**
334 +
322 322  The impact is the same as a new major version of the code list.
323 -)))|(% style="width:146px" %)**2.0**|(% style="width:146px" %)**3.0**
336 +)))|**2.0**|**3.0**
324 324  
325 325  **Example 7.4 – Dependencies between artefacts: Concept Scheme and DSD. Variable impact (see below)**
326 326  
... ... @@ -327,36 +327,44 @@
327 327  |**Id:Artefact Type:Details**|**Change type**|**Version Impact**|**Old version**|**New version**
328 328  |**CS_TRADE: Concept Scheme containing Concepts C1, C2, C3**|Addition of new Concept C4|**Minor: N.+**|**1.4**|**1.5**
329 329  |(((
330 -**TRADE: Data Structure Definition:
331 -references Concepts C1 and C2**
343 +**TRADE: Data Structure Definition:**
344 +
345 +**references Concepts C1 and C2**
332 332  )))|(((
333 333  None
348 +
334 334  Concept C3 is not used
335 335  )))|**None**|**1.0**|**1.0**
336 336  |** **| |** **|** **|** **
337 337  |**CS_TRADE: Concept Scheme containing Concepts C1, C2, C3**|Change of description in Concept C3 (typo)|**Patch: N.M.+**|**1.4**|**1.4.1**
338 338  |(((
339 -**TRADE: Data Structure Definition:
340 -references Concepts C1 and C2**
354 +**TRADE: Data Structure Definition:**
355 +
356 +**references Concepts C1 and C2**
341 341  )))|(((
342 342  None
359 +
343 343  Concept C3 is not used
344 344  )))|**None**|**1.0**|**1.0**
345 345  |(% colspan="5" %)
346 346  |**CS_TRADE: Concept Scheme containing Concepts C1, C2, C3**|Removal of Concept C3|**Major: +.0**|**1.4**|**2.0**
347 347  |(((
348 -**TRADE: Data Structure Definition:
349 -references Concepts C1 and C2**
365 +**TRADE: Data Structure Definition:**
366 +
367 +**references Concepts C1 and C2**
350 350  )))|None concept C3 is not used|**None**|**1.0**|**1.0**
351 351  |(% 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.
352 352  |(% colspan="5" %)
353 353  |**CS_TRADE: Concept Scheme containing Concepts C1, C2, C3**|Change of description in Concept C2 (typo)|**Patch: N.M.+**|**1.4**|**1.4.1**
354 354  |(((
355 -**TRADE: Data Structure Definition:
356 -references Concepts C1 and C2**
373 +**TRADE: Data Structure Definition:**
374 +
375 +**references Concepts C1 and C2**
357 357  )))|Correction should be taken into account, concept C2 is used|(((
358 -**Patch: N.M.+
359 -//or //**
377 +**Patch: N.M.+**
378 +
379 +**//or//**
380 +
360 360  **None**
361 361  )))|**1.0**|(((
362 362  **1.0.1 //or//**
... ... @@ -365,6 +365,8 @@
365 365  )))
366 366  |(% 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.
367 367  
389 +**~ **
390 +
368 368  ----
369 369  
370 370  {{putFootnotes/}}
© Semantic R&D Group, 2026