Skip to Content
Last modified by Artur K. on 2026/05/29 14:28
From version 1.14
edited by Helena K.
on 2026/01/15 15:18
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
... ... @@ -227,69 +227,58 @@
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) o E1 - Europe (ECB@CL_COUNTRIES@1.0)
231 -
232 -ES - Spain FR - France
233 -
234 -GR - Greece
235 -
236 -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.
237 237  )))|(((
238 -A1=World (codelist ref. ECB@CL_AREAS@1.0) o E1 =Europe (ECB@CL_COUNTRIES@1.0)
239 -
240 -ES = Spain FR = FranceGR = Greece
241 -
242 -IT = Italy
243 -
244 -**DE= Germany**
245 -
246 -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.
247 247  )))
248 248  |(% 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
249 249  
250 250  **Example 7.1 – Dependencies between artefacts: Concept Scheme and Code List. Minor impact: N.+**
251 251  
252 -|**Id:Artefact Type:Details**|**Change type**|**Version Impact**|**Old version**|(((
253 -**New**
254 -
255 -**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**
256 256  )))
257 -|**CL_OBS_STATUS:Code List**|Addition of a new code X|**Minor: N.+**|**1.0**|**1.1**
258 -|**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" %)(((
259 259  Adoption of new code X
260 260  
261 -**//Change type//**: Replacement of a child artefact having a different version, but the same id and
262 -
263 -Agency
264 -)))|(((
257 +**//Change type//**: Replacement of a child artefact having a different version, but the same id and Agency
258 +)))|(% style="width:558px" %)(((
265 265  **Minor: N.+**
260 +The child version impact is replicated in the parent artefact
261 +)))|(% style="width:139px" %)**2.0**|(% style="width:151px" %)**2.1**
266 266  
267 -The child version impact is replicated in the parent
268 -
269 -artefact
270 -)))|**2.0**|**2.1**
271 -
272 272  **Example 7.2 – Dependencies between artefacts: Concept Scheme and Code List. Major impact: +.0**
273 273  
274 -|**Id:Artefact Type:Details**|**Change type**|**Version Impact**|**Old version**|(((
275 -**New**
276 -
277 -**version**
265 +|(% style="width:489px" %)**Id:Artefact Type:Details**|(% style="width:734px" %)**Change type**|(% style="width:562px" %)**Version Impact**|**Old version**|(((
266 +**New version**
278 278  )))
279 -|**CL_OBS_STATUS:Code List**|Removal of code U|**Major: +.0**|**1.0**|**2.0**
280 -|(((
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" %)(((
281 281  **CS_TRADE:Concept**
282 282  
283 283  **Scheme:References**
284 284  
285 285  **CL_OBS_STATUS v1.0 above**
286 -)))|(((
275 +)))|(% style="width:734px" %)(((
287 287  Adoption of new CL_OBS_STATUS without U.
288 288  
289 289  **//Change type//**: Replacement of a child artefact having a different version, but the same id and
290 290  
291 291  Agency
292 -)))|(((
281 +)))|(% style="width:562px" %)(((
293 293  **Major: +.0**
294 294  
295 295  The child version impact is replicated in the parent artefact.
... ... @@ -297,51 +297,41 @@
297 297  
298 298  **Example 7.3 – Dependencies between artefacts: Concept Scheme and Code List. Variable impact (see below)**
299 299  
300 -|**Id:Artefact Type:Details**|**Change type**|**Version Impact**|**Old version**|(((
301 -**New**
302 -
303 -**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**
304 304  )))
305 -|(% rowspan="3" %)**CL_XYZ: Code List**|(((
292 +|(% rowspan="3" style="width:489px" %)**CL_XYZ: Code List**|(% style="width:736px" %)(((
306 306  a) Maintenance agency changes from A to B for governance reasons.
307 -
308 308  Nothing else changes in the code list.
309 -)))|(% rowspan="3" %)**New artefact**|(% rowspan="3" %)(((
295 +)))|(% rowspan="3" style="width:555px" %)**New artefact**|(% rowspan="3" style="width:146px" %)(((
310 310  **CL_XYZ**
311 311  
312 312  **(Agency A)**
313 -)))|(% rowspan="3" %)(((
299 +)))|(% rowspan="3" style="width:146px" %)(((
314 314  **CL_XYZ**
315 315  
316 -**(Agency B)**
317 -
318 -**(new maintenance agency)**
302 +**(Agency B)
303 +(new maintenance agency)**
319 319  )))
320 -|b) Maintenance agency changes from A to B and at the same time new codes are added
321 -|c) Maintenance agency changes from A to B. Since B has different coding rules, the code list itself changes as well.
322 -|(% rowspan="3" %)(((
323 -**CS_TRADE: Concept Scheme: References**
324 -
325 -**CL_XYZ (Agency A) **
326 -)))|(% rowspan="3" %)(((
327 -Replacement of a child artefact having a different Agency.
328 -
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.
329 329  CL_XYZ (Agency A) changes to CL_XYZ (Agency B).
330 -)))|(((
312 +)))|(% style="width:555px" %)(((
331 331  **Case a): Patch: N.M.+**
332 -
333 333  There is no impact on data exchange
334 -)))|**2.0**|**2.0.1**
335 -|(((
315 +)))|(% style="width:146px" %)**2.0**|(% style="width:146px" %)**2.0.1**
316 +|(% style="width:555px" %)(((
336 336  **Case b): Minor: N. +**
337 -
338 338  The impact is the same as a new minor version of the code list
339 -)))|**2.0**|**2.1**
340 -|(((
319 +)))|(% style="width:146px" %)**2.0**|(% style="width:146px" %)**2.1**
320 +|(% style="width:555px" %)(((
341 341  **Case c) Major: +.0**
342 -
343 343  The impact is the same as a new major version of the code list.
344 -)))|**2.0**|**3.0**
323 +)))|(% style="width:146px" %)**2.0**|(% style="width:146px" %)**3.0**
345 345  
346 346  **Example 7.4 – Dependencies between artefacts: Concept Scheme and DSD. Variable impact (see below)**
347 347  
... ... @@ -348,44 +348,36 @@
348 348  |**Id:Artefact Type:Details**|**Change type**|**Version Impact**|**Old version**|**New version**
349 349  |**CS_TRADE: Concept Scheme containing Concepts C1, C2, C3**|Addition of new Concept C4|**Minor: N.+**|**1.4**|**1.5**
350 350  |(((
351 -**TRADE: Data Structure Definition:**
352 -
353 -**references Concepts C1 and C2**
330 +**TRADE: Data Structure Definition:
331 +references Concepts C1 and C2**
354 354  )))|(((
355 355  None
356 -
357 357  Concept C3 is not used
358 358  )))|**None**|**1.0**|**1.0**
359 359  |** **| |** **|** **|** **
360 360  |**CS_TRADE: Concept Scheme containing Concepts C1, C2, C3**|Change of description in Concept C3 (typo)|**Patch: N.M.+**|**1.4**|**1.4.1**
361 361  |(((
362 -**TRADE: Data Structure Definition:**
363 -
364 -**references Concepts C1 and C2**
339 +**TRADE: Data Structure Definition:
340 +references Concepts C1 and C2**
365 365  )))|(((
366 366  None
367 -
368 368  Concept C3 is not used
369 369  )))|**None**|**1.0**|**1.0**
370 370  |(% colspan="5" %)
371 371  |**CS_TRADE: Concept Scheme containing Concepts C1, C2, C3**|Removal of Concept C3|**Major: +.0**|**1.4**|**2.0**
372 372  |(((
373 -**TRADE: Data Structure Definition:**
374 -
375 -**references Concepts C1 and C2**
348 +**TRADE: Data Structure Definition:
349 +references Concepts C1 and C2**
376 376  )))|None concept C3 is not used|**None**|**1.0**|**1.0**
377 377  |(% 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.
378 378  |(% colspan="5" %)
379 379  |**CS_TRADE: Concept Scheme containing Concepts C1, C2, C3**|Change of description in Concept C2 (typo)|**Patch: N.M.+**|**1.4**|**1.4.1**
380 380  |(((
381 -**TRADE: Data Structure Definition:**
382 -
383 -**references Concepts C1 and C2**
355 +**TRADE: Data Structure Definition:
356 +references Concepts C1 and C2**
384 384  )))|Correction should be taken into account, concept C2 is used|(((
385 -**Patch: N.M.+**
386 -
387 -**//or//**
388 -
358 +**Patch: N.M.+
359 +//or //**
389 389  **None**
390 390  )))|**1.0**|(((
391 391  **1.0.1 //or//**
... ... @@ -394,8 +394,6 @@
394 394  )))
395 395  |(% 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.
396 396  
397 -**~ **
398 -
399 399  ----
400 400  
401 401  {{putFootnotes/}}
© Semantic R&D Group, 2026