Changes for page Guidelines for SDMX Data Structure Definitions
Last modified by Artur K. on 2026/05/29 14:28
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 7 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -389,19 +389,19 @@ 389 389 390 390 **Table 9. Minimum requirements for DSDs~*~*** 391 391 392 -|**Question**|**Concept**|**COG**|**Code list**|**Time series Cross-section** 393 -|Where?|reference area|X|revision|mand. attribute or dimension 394 -|What?|“indicator”|-|domain|one or multiple dimensions 395 -|How?|unit of measure|X|development|mand. attribute or dimension 396 -|How?|unit multiplier|X|available|mandatory attribute 397 -|How?|decimals|X|available|mandatory attribute 398 -|How?|//adjustment//|X|development|mand. att. not relevant 399 -|When?|time period|X|format|dimension mand. att. 400 -|When?|time format|X|available|mandatory attribute 401 -|When?|time period – collection|X|development|mand. att. cond. att. 402 -|When?|data update – last update|X|time stamp|mandatory attribute 403 -|How often?|//frequency//|X|available|mand. att. or not relevant 404 -|(% colspan="2" %)How much? observation value|-|numeric|dimension measure 392 +|(% style="width:205px" %)**Question**|(% style="width:272px" %)**Concept**|(% style="width:178px" %)**COG**|(% style="width:270px" %)**Code list**|(% style="width:690px" %)**Time series Cross-section** 393 +|(% style="width:205px" %)Where?|(% style="width:272px" %)reference area|(% style="width:178px" %)X|(% style="width:270px" %)revision|(% style="width:690px" %)mand. attribute or dimension 394 +|(% style="width:205px" %)What?|(% style="width:272px" %)“indicator”|(% style="width:178px" %)-|(% style="width:270px" %)domain|(% style="width:690px" %)one or multiple dimensions 395 +|(% style="width:205px" %)How?|(% style="width:272px" %)unit of measure|(% style="width:178px" %)X|(% style="width:270px" %)development|(% style="width:690px" %)mand. attribute or dimension 396 +|(% style="width:205px" %)How?|(% style="width:272px" %)unit multiplier|(% style="width:178px" %)X|(% style="width:270px" %)available|(% style="width:690px" %)mandatory attribute 397 +|(% style="width:205px" %)How?|(% style="width:272px" %)decimals|(% style="width:178px" %)X|(% style="width:270px" %)available|(% style="width:690px" %)mandatory attribute 398 +|(% style="width:205px" %)How?|(% style="width:272px" %)//adjustment//|(% style="width:178px" %)X|(% style="width:270px" %)development|(% style="width:690px" %)mand. att. not relevant 399 +|(% style="width:205px" %)When?|(% style="width:272px" %)time period|(% style="width:178px" %)X|(% style="width:270px" %)format|(% style="width:690px" %)dimension mand. att. 400 +|(% style="width:205px" %)When?|(% style="width:272px" %)time format|(% style="width:178px" %)X|(% style="width:270px" %)available|(% style="width:690px" %)mandatory attribute 401 +|(% style="width:205px" %)When?|(% style="width:272px" %)time period – collection|(% style="width:178px" %)X|(% style="width:270px" %)development|(% style="width:690px" %)mand. att. cond. att. 402 +|(% style="width:205px" %)When?|(% style="width:272px" %)data update – last update|(% style="width:178px" %)X|(% style="width:270px" %)time stamp|(% style="width:690px" %)mandatory attribute 403 +|(% style="width:205px" %)How often?|(% style="width:272px" %)//frequency//|(% style="width:178px" %)X|(% style="width:270px" %)available|(% style="width:690px" %)mand. att. or not relevant 404 +|(% colspan="2" style="width:477px" %)How much? observation value|(% style="width:178px" %)-|(% style="width:270px" %)numeric|(% style="width:690px" %)dimension measure 405 405 406 406 ~*~*Concepts in //italics// are only relevant for time series DSDs. An “X” in the COG column means the concept is defined in the COG. Code list “development” means that the SWG will develop a code list to be recommended in the COG; “revision” means that the code list is recommended by the COG and under revision by the SWG; “format” means that a format is defined by another concept; “text”, “time stamp”, and “numeric” provide data types used for uncoded concepts. 407 407 ... ... @@ -409,25 +409,19 @@ 409 409 410 410 **Table 10. Suggested additional concepts for certain scenarios~*~*** 411 411 412 -|**Question**|**Concept**|**COG**|**Code list**|**TS CS**|**Scenario**412 +|**Question**|**Concept**|**COG**|**Code list**|**TS**|**CS**|**Scenario** 413 413 |Who?|compiling agency|X|development|((( 414 -conditional conditional 415 - 416 - (sibling) (obs. level) 417 -)))|data provider different from data compiler 414 +conditional (sibling) 415 +)))|conditional (obs. level)|data provider different from data compiler 418 418 |Who?|((( 419 -confidentiality 420 - 421 -status – observation 422 -)))|X|available|mandatory (obs. level)|except dissemination 423 -|How?|observation status|X|available|conditional (obs. level)|except orig. collection 417 +confidentiality status – observation 418 +)))|X|available|(% colspan="2" rowspan="1" %)mandatory (obs. level)|except dissemination 419 +|How?|observation status|X|available|(% colspan="2" rowspan="1" %)conditional (obs. level)|except orig. collection 424 424 |How much?|((( 425 -//observation pre-// 421 +//observation pre-break value// 422 +)))|-|numeric|cond. (obs.)|not relevant|except orig. collection 423 +|What and how?|//time series title//|X|text|cond. (TS)|not relevant|dissemination 426 426 427 -//break value// 428 -)))|-|numeric|cond. (obs.) not relevant|except orig. collection 429 -|What and how?|//time series title//|X|text|cond. (TS) not relevant|dissemination 430 - 431 431 ~** The legend of Table 9 applies to Table 10 as well. The suggested attachment level of attributes (if any) is provided in parentheses in the TS (time series) or CS (cross-section) columns. In case an attribute does not vary at that level in a certain use case, it should be attached at the highest possible level. 432 432 433 433 == 5.2 Attribute attachment levels and definition of groups == ... ... @@ -449,10 +449,8 @@ 449 449 * //ID//: a unique identifier of the message 450 450 * //Test//: a Boolean attribute that indicates whether the message is for test purposes or not 451 451 * //Prepared//: the date the message was prepared 452 -* //Sender//: the identification of the organization that is transmitting the message 446 +* //Sender//: the identification of the organization that is transmitting the message (recommended: code from the agency code list in the SDMX COG) 453 453 454 -(recommended: code from the agency code list in the SDMX COG) 455 - 456 456 From a business perspective, the inclusion of the //Name// element is highly recommended, as it can help to understand the purpose of the exchange message. Other header elements such as //Receiver// are optional. 457 457 458 458 = 6 STEP-BY-STEP GUIDE = ... ... @@ -463,13 +463,15 @@ 463 463 464 464 Figure 1 provides an overview of the overall process. As a first step, the context of the data exchange(s) that should be covered by the DSD(s) is defined in terms of purpose, domains, level of exchange, type of data, type of recipient, role of in data exchange, process pattern, and GSBPM phase (see Figure 2). Since reusing existing artefacts is one of the guiding principles, the second step identifies existing DSDs that may be reused (see Figure 3). In case relevant DSDs are available, their suitability in the present context is evaluated in step 3. Aspects to be taken into account are concept coverage, concept roles, attribute attachment levels, and code lists (see Figure 4). Step 4 is subject to the outcome of step 3. In case of a favorable assessment, the DSDs are simply reused. If the DSDs are partly suitable, modified versions can be derived. See section 2. for a summary of possible DSD modification scenarios. If the DSDs are not suitable or if no relevant DSDs are available at all, new DSDs will be defined as described in section 3. Finally, supporting artefacts such as data flow definitions and data provision agreements are defined (see Figure 5). 465 465 458 +(% class="wikigeneratedid" %) 459 +[[image:1768470533088-795.png]] 466 466 467 467 (% class="wikigeneratedid" id="HFigure1.OverviewoftheDSDdesignprocess" %) 468 468 Figure 1. Overview of the DSD design process 469 469 470 - 471 471 Figure 2 summarizes the characteristics of the data exchange context that is defined in step 1. These characteristics affect the decision on the data structuring approach that is part of the process of defining the concepts of a new DSD (step 4.3. in Figure 1; see Figure 7 in section 2.). 472 472 466 +[[image:1768470575978-226.png]] 473 473 474 474 (% class="wikigeneratedid" id="HFigure2.Characteristicsofdataexchangecontext" %) 475 475 Figure 2. Characteristics of data exchange context ... ... @@ -476,20 +476,23 @@ 476 476 477 477 Figure 3 recaps the priorities given to different types of existing DSDs when searching for candidates for reuse in step 2. Global DSDs maintained by the SDMX consortium are ranked the highest. They can be found via the Global SDMX Registry. 478 478 473 +(% class="wikigeneratedid" %) 474 +[[image:1768470596130-305.png]] 479 479 480 480 (% class="wikigeneratedid" id="HFigure3.PriorityrankingofexistingDSDsforreuse" %) 481 481 Figure 3. Priority ranking of existing DSDs for reuse 482 482 483 - 484 484 Figure 4 summarizes the aspects to be considered in the assessment of the suitability of existing DSDs in step 3. For a detailed description of the cases of partial unsuitability see section 2.1. above. 485 485 481 +(% class="wikigeneratedid" %) 482 +[[image:1768470626558-321.png]] 486 486 487 487 (% class="wikigeneratedid" id="HFigure4.AspectsofDSDsuitability" %) 488 488 Figure 4. Aspects of DSD suitability 489 489 490 - 491 491 Figure 5 lists the most relevant artefacts required in addition to a DSD, its concept scheme, and code lists. 492 492 489 +[[image:1768470646456-652.png]] 493 493 494 494 Figure 5. Supporting artefacts 495 495 ... ... @@ -497,8 +497,10 @@ 497 497 498 498 Figure 6 briefly recapitulates the actions that can be taken to overcome partial unsuitability of DSDs. As far as possible, existing artefacts should be reused in this case. This means that even if a DSD cannot be reused as a whole, concepts and code lists from that DSD can be included in the new DSD by reference. 499 499 500 - **Figure6.DSD modificationscenarios**497 +[[image:1768470678965-391.png]] 501 501 499 +Figure 6. DSD modification scenarios 500 + 502 502 == 6.3 Defining new DSDs == 503 503 504 504 In case no (suitable) DSD is available, the actual process of specifying a new DSD is started. Figure 7 depicts this process (step 4.3. in Figure 1). It encompasses the specification of concepts, code lists, and data formats. All three specification steps include the identification of already existing artefacts that could be reused or modified to satisfy the requirements at hand and the definition of new artefacts in case no suitable artefacts are detected. Several iterations of steps 1 (specification of concepts; see Figure 8) and 2 (specification of code lists; see Figure°13) may be necessary, including revisions of the decision concerning the data structuring approach. Finally all artefacts defined in the previous steps are put together into a DSD.
- 1768470533088-795.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +48.6 KB - Content
- 1768470575978-226.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +95.8 KB - Content
- 1768470596130-305.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +44.4 KB - Content
- 1768470611326-907.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +51.5 KB - Content
- 1768470626558-321.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +51.5 KB - Content
- 1768470646456-652.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +32.7 KB - Content
- 1768470678965-391.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +117.9 KB - Content