Skip to Content
Last modified by Helena on 2025/09/10 11:19
From version 7.1
edited by Helena
on 2025/05/14 15:31
Change comment: There is no comment for this version
To version 13.2
edited by Helena
on 2025/05/16 21:22
Change comment: There is no comment for this version

Summary

Details

Page properties
Tags
... ... @@ -1,0 +1,1 @@
1 +Artefact|Metadata set|Reference metadata|SDMX Information Model|SDMX Technical Specification|SDMX-JSON|SDMX-ML|Statistical data and metadata exchange|Statistical subject-matter domain|Structural metadata|Validation and transformation language
Content
... ... @@ -11,51 +11,55 @@
11 11  
12 12  = 1 Introduction =
13 13  
14 -The Statistical Data and Metadata Exchange (SDMX) initiative (https:~/~/www.sdmx.org) sets 3 standards that can facilitate the exchange of statistical data and metadata using modern 4 information technology.
14 +The [[Statistical Data and Metadata Exchange>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] ([[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]]) initiative (https:~/~/www.[[sdmx>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]].org) sets 3 standards that can facilitate the exchange of statistical data and metadata using modern 4 information technology.
15 15  
16 -The SDMX Technical Specifications are organised into several discrete sections.
16 +The [[SDMX Technical Specifications>>doc:xwiki:Glossary.SDMX Technical Specification.WebHome]] are organised into several discrete sections.
17 17  
18 -The following are published on the SDMX website ([[__https:~~/~~/www.sdmx.org__>>https://https:www.sdmx.org]]).
18 +The following are published on the [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] website
19 19  
20 +([[__https:~~/~~/www.sdmx.org__>>https://https:www.sdmx.org]]).
21 +
20 20  **Section 1** **Framework for SDMX Technical Standards** – this document providing an introduction to the technical standards.
21 21  
22 -**Section 2** **SDMX Information Model** - the SDMX information model is a standardised object model for modelling statistical domains centring on the structure of their data and metadata sets, the coding schemes used for classification, and the rules for controlling the exchange of data and metadata between organisations. This document provides a UML specification with supporting narrative.
24 +**Section 2** **SDMX Information Model** -
23 23  
24 -**Section 5** **SDMX Registry Specification** – an SDMX ‘registry’ acts as a repository for structural metadata and provisioning information, and a registry of data and metadata sources. This document sets out the specification.
26 +the [[SDMX information model>>doc:xwiki:Glossary.SDMX Information Model.WebHome]] is a standardised object model for modelling [[statistical domains>>doc:xwiki:Glossary.Statistical subject-matter domain.WebHome]] centring on the structure of their data and [[metadata sets>>doc:xwiki:Glossary.Metadata set.WebHome]], the coding schemes used for classification, and the rules for controlling the exchange of data and metadata between organisations. This document provides a UML specification with supporting narrative.
25 25  
26 -**Section 6** **SDMX Technical Notes** – detailed technical guidance for implementors of the SDMX standard.
28 +**Section 5** **SDMX Registry Specification** – an [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] ‘registry’ acts as a repository for [[structural metadata>>doc:xwiki:Glossary.Structural metadata.WebHome]] and provisioning information, and a registry of data and metadata sources. This document sets out the specification.
27 27  
28 -The following are published on the GitHub repository of the SDMX Standards Technical Working Group ( __[[https:~~/~~/github.com/sdmx-twg>>https://github.com/sdmx-twg]]) :__
30 +**Section 6** **SDMX Technical Notes** – detailed technical guidance for implementors of the [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] standard.
29 29  
32 +The following are published on the GitHub repository of the [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] Standards Technical Working Group ([[__https:~~/~~/github.com/sdmx-twg__>>https://https:github.comsdmx-twg]]):
33 +
30 30  (% class="wikigeneratedid" id="Hsdmx-twg2Fsdmx-rest2013RESTAPI" %)
31 31  **sdmx-twg/sdmx-rest – REST API**
32 32  
33 -Technical specifications for the SDMX RESTful web services application programming interfaces (API).
37 +Technical specifications for the [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] RESTful web services application programming interfaces (API).
34 34  
35 35  (% class="wikigeneratedid" id="Hsdmx-twg2Fsdmx-ml2013SDMX-ML" %)
36 -**sdmx-twg/sdmx-ml – SDMX-ML**
40 +**sdmx-twg/sdmx-ml – [[SDMX-ML>>doc:xwiki:Glossary.SDMX-ML.WebHome]]**
37 37  
38 -Technical specifications for the XML transmission format including XSD schemas, documentation and samples for data, structure and reference metadata messages.
42 +Technical specifications for the XML transmission format including XSD schemas, documentation and samples for data, structure and [[reference metadata>>doc:xwiki:Glossary.Reference metadata.WebHome]] messages.
39 39  
40 40  (% class="wikigeneratedid" id="Hsdmx-twg2Fsdmx-json2013SDMX-JSON" %)
41 -**sdmx-twg/sdmx-json – SDMX-JSON**
45 +**sdmx-twg/sdmx-json – [[SDMX-JSON>>doc:xwiki:Glossary.SDMX-JSON.WebHome]]**
42 42  
43 -Technical specifications for the JSON transmission format including documentation, schemas and samples for data, structure and reference metadata messages.
47 +Technical specifications for the JSON transmission format including documentation, schemas and samples for data, structure and [[reference metadata>>doc:xwiki:Glossary.Reference metadata.WebHome]] messages.
44 44  
45 45  (% class="wikigeneratedid" id="Hsdmx-twg2Fsdmx-csv2013SDMX-CSV" %)
46 -**sdmx-twg/sdmx-csv – SDMX-CSV**
50 +**sdmx-twg/sdmx-csv – [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]]-CSV**
47 47  
48 -Technical specifications for the SDMX-CSV transmission format for ‘comma-separated values’ (CSV) data and reference metadata.
52 +Technical specifications for the [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]]-CSV transmission format for ‘comma-separated values’ (CSV) data and [[reference metadata>>doc:xwiki:Glossary.Reference metadata.WebHome]].
49 49  
50 50  The following sections are obsolete:
51 51  
52 -Section 3 - SDMX-ML - replaced by the sdmx-twg/sdmx-ml GitHub repository
56 +Section 3 - [[SDMX-ML>>doc:xwiki:Glossary.SDMX-ML.WebHome]] - replaced by the [[sdmx>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]]-twg/[[sdmx-ml>>doc:xwiki:Glossary.SDMX-ML.WebHome]] GitHub repository
53 53  
54 -Section 4 - SDMX-EDI
58 +Section 4 - [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]]-EDI
55 55  
56 -Section 7 - API - replaced by the sdmx-twg/sdmx-rest GitHub repository VTL
60 +Section 7 - API - replaced by the [[sdmx>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]]-twg/[[sdmx>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]]-rest GitHub repository [[VTL>>doc:xwiki:Glossary.Validation and transformation language.WebHome]]
57 57  
58 -In July 2020 the SDMX 2.1 specifications were revised to add support for the Validation and Transformation Language (VTL). For 3.0, the VTL specification has been updated to align with changes to the information model and other modifications to the Standard such as the introduction of Semantic Versioning for the versioning of structural metadata artefacts. Section 2 (Information Model) sets out details of the ‘Transformation and Expressions’ package for defining and managing VTL 2.0 programs and Section 6 (Technical Notes) provides detailed guidance on implementing and using VTL with SDMX.
62 +In July 2020 the [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] 2.1 specifications were revised to add support for the [[Validation and Transformation Language>>doc:xwiki:Glossary.Validation and transformation language.WebHome]] ([[VTL>>doc:xwiki:Glossary.Validation and transformation language.WebHome]]). For 3.0, the [[VTL>>doc:xwiki:Glossary.Validation and transformation language.WebHome]] specification has been updated to align with changes to the information model and other modifications to the Standard such as the introduction of Semantic Versioning for the versioning of [[structural metadata>>doc:xwiki:Glossary.Structural metadata.WebHome]] [[artefacts>>doc:xwiki:Glossary.Artefact.WebHome]]. Section 2 (Information Model) sets out details of the ‘Transformation and Expressions’ package for defining and managing [[VTL>>doc:xwiki:Glossary.Validation and transformation language.WebHome]] 2.0 programs and Section 6 (Technical Notes) provides detailed guidance on implementing and using [[VTL>>doc:xwiki:Glossary.Validation and transformation language.WebHome]] with [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]].
59 59  
60 60  = 2 Change History =
61 61  
... ... @@ -89,7 +89,8 @@
89 89  
90 90  SDMX version 3.0 introduces new features, improvements and changes to the Standard in the following key areas:
91 91  
92 -=== Information Model ===
96 +(% class="wikigeneratedid" id="HInformationModel" %)
97 +**Information Model**
93 93  
94 94  * Simplification and improvement of the reference metadata model
95 95  * Support for microdata
... ... @@ -99,11 +99,13 @@
99 99  * Improvements to code hierarchies for data discovery
100 100  * Improvements to constraints
101 101  
102 -=== Versioning of Structural Metadata Artefacts ===
107 +(% class="wikigeneratedid" id="HVersioningofStructuralMetadataArtefacts" %)
108 +**Versioning of Structural Metadata Artefacts**
103 103  
104 104  * Adoption of the three-number semantic versioning standard for structural metadata artefacts (__[[https:~~/~~/semver.org>>url:https://semver.org/]])__
105 105  
106 -=== REST Web Services Application Programming Interface (API) ===
112 +(% class="wikigeneratedid" id="HRESTWebServicesApplicationProgrammingInterface28API29" %)
113 +**REST Web Services Application Programming Interface (API)**
107 107  
108 108  * Change to a single ‘structure’ resource for structure queries simplifying the REST API specification by reducing the number of resources to five
109 109  * Improvements to data queries
... ... @@ -110,11 +110,13 @@
110 110  * Improvements to reference metadata queries
111 111  * Support for structural metadata maintenance using HTTP PUT, POST and DELETE verbs
112 112  
113 -=== SOAP Web Services API ===
120 +(% class="wikigeneratedid" id="HSOAPWebServicesAPI" %)
121 +**SOAP Web Services API**
114 114  
115 115  * The SOAP web services API has been deprecated with version 3.0 standardising on REST
116 116  
117 -=== XML, JSON, CSV and EDI Transmission formats ===
125 +(% class="wikigeneratedid" id="HXML2CJSON2CCSVandEDITransmissionformats" %)
126 +**XML, JSON, CSV and EDI Transmission formats**
118 118  
119 119  * The SDMX-ML, SDMX-JSON and SDMX-CSV specifications have been extended and modified where needed to support the new features and changes such as reference metadata and microdata
120 120  * Obsolete SDMX-ML data message variants including Generic, Compact, Utility and Cross-sectional have been deprecated standardising on Structure Specific Data as the sole XML format for data exchange
... ... @@ -271,10 +271,8 @@
271 271  
272 272  SDMX provides a way of modelling statistical data, and defines the set of metadata constructs used for this purpose. Because SDMX specifies a number of transmission formats for expressing data and structural metadata, the model is used as a mechanism for guaranteeing that transformation between the different formats is lossless. In this sense, all of the formats are syntax-bound expressions of the common information model.
273 273  
274 -SDMX recognizes that statistical data is structured; in SDMX this structure is termed a Data Structure Definition. “Data sets” are made up of one or more lower-level “groups”, based on their degrees of similarity. Each group is in turn comprised of one or more “series” of data. Each series or section has a “key” - values for each of a cluster of concepts, also called
283 +SDMX recognizes that statistical data is structured; in SDMX this structure is termed a Data Structure Definition. “Data sets” are made up of one or more lower-level “groups”, based on their degrees of similarity. Each group is in turn comprised of one or more “series” of data. Each series or section has a “key” - values for each of a cluster of concepts, also called "dimensions" - which identifies it, and one or more “observations”, which typically combine the time of the observation, and the value of the observation (e.g., measurement). Additionally, metadata may be attached at any level of this structure as descriptive “attributes”. Code lists (enumerations) and other patterns for representation of data and metadata are also modelled.
275 275  
276 -"dimensions" - which identifies it, and one or more “observations”, which typically combine the time of the observation, and the value of the observation (e.g., measurement). Additionally, metadata may be attached at any level of this structure as descriptive “attributes”. Code lists (enumerations) and other patterns for representation of data and metadata are also modelled.
277 -
278 278  There is some similarity between “cube” structures commonly used to process statistical data, and the Data Structure Definition idea in the SDMX Information Model. It is important to note that the data as structured according to the SDMX Information Model is optimized for exchange, potentially with partners who may have no ability to process a “cube” of data coming from complex statistical systems. SDMX time series can be understood as “slices” of the cube. Such a slice is identified by its key. A "series" key consists of the values for all dimensions specified by the key family except time. Thus, it is possible to reconstruct and describe data cubes from SDMX-structured data, and to exchange such databases using the interfaces and formats provided for that purpose in the standard. Additional objects such as hierarchical code lists, constraints and structure maps make it possible to more fully model the structure of cubes.
279 279  
280 280  The information model also provides a view of reference metadata: a mechanism for referencing the meaningful “objects” within the SDMX view of statistical exchange processes (data providers, structures, provisioning agreements, dataflows, metadata flows, etc.) to which metadata is attached; a mechanism for describing a set of meaningful concepts, of organizing them into a presentational structure, and of indicating how their values are represented. This is based on a simple, hierarchical view of reference metadata which is common to many metadata systems and classification/categorization schemes. SDMX provides a model (and XML and JSON formats) for both describing reference metadata structures, and of reporting reference metadata according to those structures.
SUZ.Methodology.Code.MethodologyClass[0]