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