Skip to Content
Last modified by Helena K. on 2026/06/08 15:16
From version 24.4
edited by Helena K.
on 2026/06/03 12:14
Change comment: There is no comment for this version
To version 24.1
edited by Artur K.
on 2025/11/05 14:26
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -xwiki:XWiki.helena
1 +xwiki:XWiki.arturkryazhev
Content
... ... @@ -10,97 +10,95 @@
10 10  
11 11  = 1 Introduction =
12 12  
13 -The [[Statistical Data and Metadata Exchange>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] ([[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]) initiative (https:~/~/www.sdmx.org) sets standards that can facilitate the exchange of statistical data and metadata using modern information technology.
13 +The [[Statistical Data and Metadata Exchange>>doc:Glossary.Statistical data and metadata exchange.WebHome]] ([[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]]) initiative (https:~/~/www.sdmx.org) sets standards that can facilitate the exchange of statistical data and metadata using modern information technology.
14 14  
15 -The [[SDMX Technical Specifications>>doc:sdmx:Glossary 2\.1.SDMX Technical Specification.WebHome]] are organised into several discrete sections.
15 +The [[SDMX Technical Specifications>>doc:Glossary.SDMX Technical Specification.WebHome]] are organised into several discrete sections.
16 16  
17 -The following are published on the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] website ([[__https:~~/~~/www.sdmx.org__>>https://https:www.sdmx.org]]):
17 +The following are published on the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] website ([[__https:~~/~~/www.sdmx.org__>>https://https:www.sdmx.org]]):
18 18  
19 -**Section 1** **Framework for [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Technical Standards** – this document providing an introduction to the technical standards.
19 +**Section 1** **Framework for SDMX Technical Standards** – this document providing an introduction to the technical standards.
20 20  
21 -**Section 2** **[[SDMX Information Model>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]** - the [[SDMX information model>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]] is a standardised object model for modelling [[statistical domains>>doc:sdmx:Glossary 2\.1.Statistical subject-matter domain.WebHome]] centring on the structure of their data and [[metadata sets>>doc:sdmx:Glossary 2\.1.Metadata set.WebHome]], the coding schemes used for [[classification>>doc:sdmx:Glossary 2\.1.Statistical Classification.WebHome]], and the rules for controlling the exchange of data and metadata between organisations. This document provides a UML specification with supporting narrative.
21 +**Section 2** **SDMX Information Model** - the [[SDMX information model>>doc:Glossary.SDMX Information Model.WebHome]] is a standardised object model for modelling [[statistical domains>>doc:Glossary.Statistical subject-matter domain.WebHome]] centring on the structure of their data and [[metadata sets>>doc: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.
22 22  
23 -**Section 5** **[[SDMX Registry>>doc:sdmx:Glossary 2\.1.SDMX Registry.WebHome]] Specification** – an [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] ‘registry’ acts as a repository for [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] and provisioning information, and a registry of data and metadata sources. This document sets out the specification.
23 +**Section 5** **SDMX Registry Specification** – an [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] ‘registry’ acts as a repository for [[structural metadata>>doc:Glossary.Structural metadata.WebHome]] and provisioning information, and a registry of data and metadata sources. This document sets out the specification.
24 24  
25 -**Section 6** **[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Technical Notes** – detailed technical guidance for implementors of the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] standard.
25 +**Section 6** **SDMX Technical Notes** – detailed technical guidance for implementors of the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] standard.
26 26  
27 -The following are published on the GitHub repository of the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Standards Technical Working Group ([[__https:~~/~~/github.com/sdmx-twg__>>https://https:github.comsdmx-twg]]): [[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]-twg/[[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]-rest – REST API
27 +The following are published on the GitHub repository of the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] Standards Technical Working Group ([[__https:~~/~~/github.com/sdmx-twg__>>https://https:github.comsdmx-twg]]): sdmx-twg/sdmx-rest – REST API
28 28  
29 -Technical specifications for the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] RESTful web services application programming interfaces (API).
29 +Technical specifications for the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] RESTful web services application programming interfaces (API).
30 30  
31 31  (% class="wikigeneratedid" id="Hsdmx-twg2Fsdmx-ml2013SDMX-ML" %)
32 -**[[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]-twg/[[sdmx-ml>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]] – [[SDMX-ML>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]]**
33 -Technical specifications for the XML transmission format including XSD schemas, documentation and samples for data, structure and [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] messages.
32 +**sdmx-twg/sdmx-ml – SDMX-ML**
33 +Technical specifications for the XML transmission format including XSD schemas, documentation and samples for data, structure and [[reference metadata>>doc:Glossary.Reference metadata.WebHome]] messages.
34 34  
35 35  (% class="wikigeneratedid" id="Hsdmx-twg2Fsdmx-json2013SDMX-JSON" %)
36 -**[[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]-twg/[[sdmx-json>>doc:sdmx:Glossary 2\.1.SDMX-JSON.WebHome]] – [[SDMX-JSON>>doc:sdmx:Glossary 2\.1.SDMX-JSON.WebHome]]**
37 -Technical specifications for the JSON transmission format including documentation, schemas and samples for data, structure and [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] messages.
36 +**sdmx-twg/sdmx-json – SDMX-JSON**
37 +Technical specifications for the JSON transmission format including documentation, schemas and samples for data, structure and [[reference metadata>>doc:Glossary.Reference metadata.WebHome]] messages.
38 38  
39 39  (% class="wikigeneratedid" id="Hsdmx-twg2Fsdmx-csv2013SDMX-CSV" %)
40 -**[[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]-twg/[[sdmx-csv>>doc:sdmx:Glossary 2\.1.SDMX-CSV.WebHome]] – [[SDMX-CSV>>doc:sdmx:Glossary 2\.1.SDMX-CSV.WebHome]]**
41 -Technical specifications for the [[SDMX-CSV>>doc:sdmx:Glossary 2\.1.SDMX-CSV.WebHome]] transmission format for ‘comma-separated values’ (CSV) data and [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]].
40 +**sdmx-twg/sdmx-csv – SDMX-CSV**
41 +Technical specifications for the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]]-CSV transmission format for ‘comma-separated values’ (CSV) data and [[reference metadata>>doc:Glossary.Reference metadata.WebHome]].
42 42  
43 43  The following sections are obsolete:
44 44  
45 -Section 3 - [[SDMX-ML>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]] - replaced by the [[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]-twg/[[sdmx-ml>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]] GitHub repository
45 +Section 3 - [[SDMX-ML>>doc:Glossary.SDMX-ML.WebHome]] - replaced by the sdmx-twg/sdmx-ml GitHub repository
46 46  
47 -Section 4 - [[SDMX-EDI>>doc:sdmx:Glossary 2\.1.SDMX-EDI.WebHome]]
47 +Section 4 - [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]]-EDI
48 48  
49 -Section 7 - API - replaced by the [[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]-twg/[[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]-rest GitHub repository [[VTL>>doc:sdmx:Glossary 2\.1.Validation and transformation language.WebHome]]
49 +Section 7 - API - replaced by the sdmx-twg/sdmx-rest GitHub repository [[VTL>>doc:Glossary.Validation and transformation language.WebHome]]
50 50  
51 -In July 2020 the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] 2.1 specifications were revised to add support for the [[Validation and Transformation Language>>doc:sdmx:Glossary 2\.1.Validation and transformation language.WebHome]] ([[VTL>>doc:sdmx:Glossary 2\.1.Validation and transformation language.WebHome]]). For 3.0, the [[VTL>>doc:sdmx:Glossary 2\.1.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:sdmx:Glossary 2\.1.Structural metadata.WebHome]] [[artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]]. Section 2 (Information Model) sets out details of the ‘Transformation and Expressions’ package for defining and managing [[VTL>>doc:sdmx:Glossary 2\.1.Validation and transformation language.WebHome]] 2.0 programs and Section 6 (Technical Notes) provides detailed guidance on implementing and using [[VTL>>doc:sdmx:Glossary 2\.1.Validation and transformation language.WebHome]] with [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]].
51 +In July 2020 the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] 2.1 specifications were revised to add support for the [[Validation and Transformation Language>>doc:Glossary.Validation and transformation language.WebHome]] ([[VTL>>doc:Glossary.Validation and transformation language.WebHome]]). For 3.0, the [[VTL>>doc: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:Glossary.Structural metadata.WebHome]] [[artefacts>>doc:Glossary.Artefact.WebHome]]. Section 2 (Information Model) sets out details of the ‘Transformation and Expressions’ package for defining and managing [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] 2.0 programs and Section 6 (Technical Notes) provides detailed guidance on implementing and using [[VTL>>doc:Glossary.Validation and transformation language.WebHome]] with [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]].
52 52  
53 53  = 2 Change History =
54 54  
55 -The 2.0 (% style="color:#e74c3c" %)version(%%) of this standard represented a significant increase in scope, and also provided more complete support in those areas covered in the (% style="color:#e74c3c" %)version(%%) 1.0 specification. (% style="color:#e74c3c" %)Version(%%) 2.0 of this standard is backward-compatible with (% style="color:#e74c3c" %)version(%%) 1.0, so that existing implementations can be easily migrated to conformance with (% style="color:#e74c3c" %)version(%%) 2.0.
55 +The 2.0 version of this standard represented a significant increase in scope, and also provided more complete support in those areas covered in the version 1.0 specification. Version 2.0 of this standard is backward-compatible with version 1.0, so that existing implementations can be easily migrated to conformance with version 2.0.
56 56  
57 -The 2.1 (% style="color:#e74c3c" %)version(%%) of this standard represents a set of changes resulting from several years of implementation experience with the 2.0 standard. The changes do not represent a major increase in scope or functionality, but do correct some bugs, and add functionalities in some cases. Major changes in [[SDMX-ML>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]] include a much stronger alignment of the XML Schemas with the Information Model, to emphasize inheritance and object-oriented features, and increased precision and flexibility in the attachment of metadata reports to specific objects in the [[SDMX Information Model>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]].
57 +The 2.1 version of this standard represents a set of changes resulting from several years of implementation experience with the 2.0 standard. The changes do not represent a major increase in scope or functionality, but do correct some bugs, and add functionalities in some cases. Major changes in [[SDMX-ML>>doc:Glossary.SDMX-ML.WebHome]] include a much stronger alignment of the XML Schemas with the Information Model, to emphasize inheritance and object-oriented features, and increased precision and flexibility in the attachment of metadata reports to specific objects in the [[SDMX Information Model>>doc:Glossary.SDMX Information Model.WebHome]].
58 58  
59 -The 3.0 (% style="color:#e74c3c" %)version(%%) incorporates new features, improvements and changes arising from the collective knowledge gained from a decade of operating experience with the 2.1 standard. In pursuit of modernisation and simplification, features considered obsolete have been deprecated – in particular the EDI transmission format, the lesser-used XML data messages and the SOAP web services API. Many areas remain backwardly compatible with 2.1, but there are some breaking changes where the information model has been redesigned to better support practical use case. Structure mapping and [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] are examples. The opportunity has been taken to revise the RESTful web services API which is also not backwardly compatible, but benefits from a rationalisation and better organisations of resources, and a much richer data query URL syntax.
59 +The 3.0 version incorporates new features, improvements and changes arising from the collective knowledge gained from a decade of operating experience with the 2.1 standard. In pursuit of modernisation and simplification, features considered obsolete have been deprecated – in particular the EDI transmission format, the lesser-used XML data messages and the SOAP web services API. Many areas remain backwardly compatible with 2.1, but there are some breaking changes where the information model has been redesigned to better support practical use case. Structure mapping and [[reference metadata>>doc:Glossary.Reference metadata.WebHome]] are examples. The opportunity has been taken to revise the RESTful web services API which is also not backwardly compatible, but benefits from a rationalisation and better organisations of resources, and a much richer data query URL syntax.
60 60  
61 -The 3.1 (% style="color:#e74c3c" %)version(%%) provides supports for data models to increase dimensionality over time without impacting existing data collections. The Data (% style="color:#e74c3c" %)Constraint(%%) model was adjusted to separate concerns of data reporting and data dissemination.
61 +The 3.1 version provides supports for data models to increase dimensionality over time without impacting existing data collections. The Data Constraint model was adjusted to separate concerns of data reporting and data dissemination.
62 62  
63 63  == 2.1 Major Changes from 1.0 to 2.0 ==
64 64  
65 -*
66 -* **[[Reference Metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]]**: In addition to describing and specifying data structures and formats (along with related [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]]), the (% style="color:#e74c3c" %)version(%%) 2.0 specification also provides for the exchange of metadata which is distinct from the [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] in the 1.0 (% style="color:#e74c3c" %)version(%%). This [[category>>doc:sdmx:Glossary 2\.1.Category.WebHome]] includes “reference” metadata (regarding data quality, methodology, and similar types – it can be configured by the user to include whatever (% style="color:#e74c3c" %)concepts(%%) require reporting); metadata related to data provisioning ([[release calendar>>doc:sdmx:Glossary 2\.1.Release policy - release calendar.WebHome]] information, description of the data and metadata provided, etc.); and metadata relevant to the exchange of categorization schemes.
67 -* **[[SDMX Registry>>doc:sdmx:Glossary 2\.1.SDMX Registry.WebHome]]**: Provision is made in the 2.0 standard for standard communication with registry services, to support a data-sharing model of statistical exchange. These services include registration of data and metadata, querying of registered data and metadata, and [[subscription>>doc:sdmx:Glossary 2\.1.Subscription.WebHome]]/[[notification>>doc:sdmx:Glossary 2\.1.Notification.WebHome]].
68 -* **[[Structural Metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]]**: The support for exchange of statistical data and related [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] has been expanded. Some support is provided for qualitative data; data cube structures are described; [[hierarchical code>>doc:sdmx:Glossary 2\.1.Hierarchical code.WebHome]] lists are supported; relationships between data structures can be expressed, providing support for extensibility of data structures; and the description of functional dependencies within cubes are supported.
65 +* **[[Reference Metadata>>doc:Glossary.Reference metadata.WebHome]]**: In addition to describing and specifying data structures and formats (along with related [[structural metadata>>doc:Glossary.Structural metadata.WebHome]]), the version 2.0 specification also provides for the exchange of metadata which is distinct from the [[structural metadata>>doc:Glossary.Structural metadata.WebHome]] in the 1.0 version. This [[category>>doc:Glossary.Category.WebHome]] includes “reference” metadata (regarding data quality, methodology, and similar types – it can be configured by the user to include whatever concepts require reporting); metadata related to data provisioning ([[release calendar>>doc:Glossary.Release policy - release calendar.WebHome]] information, description of the data and metadata provided, etc.); and metadata relevant to the exchange of categorization schemes.
66 +* **[[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] Registry**: Provision is made in the 2.0 standard for standard communication with registry services, to support a data-sharing model of statistical exchange. These services include registration of data and metadata, querying of registered data and metadata, and [[subscription>>doc:Glossary.Subscription.WebHome]]/notification.
67 +* **[[Structural Metadata>>doc:Glossary.Structural metadata.WebHome]]**: The support for exchange of statistical data and related [[structural metadata>>doc:Glossary.Structural metadata.WebHome]] has been expanded. Some support is provided for qualitative data; data cube structures are described; [[hierarchical code lists>>doc:Glossary.Hierarchical code list.WebHome]] are supported; relationships between data structures can be expressed, providing support for extensibility of data structures; and the description of functional dependencies within cubes are supported.
69 69  
70 70  == 2.2 Major Changes from 2.0 to 2.1 ==
71 71  
72 -* **Web-Services-Oriented Changes:** Several organizations have been implementing web services applications using [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]], and these implementations have resulted in several changes to the specifications. Because the nature of [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] web services could not be anticipated at the time of the original drafting of the specifications, the web services guidelines have been completely re-developed.
73 -* **Presentational Changes: **Much work has gone into using various technologies for the visualization of [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] data and metadata, and some changes have been proposed as a result, to better leverage this graphical visualization. These changes are largely to leverage the [[Cross-domain Concepts>>doc:sdmx:Glossary 2\.1.Cross-domain concept.WebHome]] of the Content Oriented Guidelines.
71 +* **Web-Services-Oriented Changes:** Several organizations have been implementing web services applications using [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]], and these implementations have resulted in several changes to the specifications. Because the nature of [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] web services could not be anticipated at the time of the original drafting of the specifications, the web services guidelines have been completely re-developed.
72 +* **Presentational Changes: **Much work has gone into using various technologies for the visualization of [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] data and metadata, and some changes have been proposed as a result, to better leverage this graphical visualization. These changes are largely to leverage the [[Cross-domain Concepts>>doc:Glossary.Cross-domain concept.WebHome]] of the Content Oriented Guidelines.
74 74  * **Consistency Issues:** There have been some areas where the draft specifications were inconsistent in minor ways, and these have been addressed.
75 75  * **Clarifications in Documentation:** In some cases, it has been identified that the documentation of specific fields within the standard needed clarification and elaboration, and these issues have been addressed.
76 -* **Optimization for XML Technologies:** Implementation has shown that it is possible to better organize the XML schemas for use within common technology development tools which work with XML. These changes are primarily focused on leveraging the objectoriented features of W3C XML Schema to allow for easier processing of [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] data and metadata.
77 -* **Consistency between the [[SDMX-ML>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]] and the [[SDMX Information Model>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]: **Certain aspects of the XML schemas and UML model have been more closely aligned, to allow for easier comprehension of the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] model.
75 +* **Optimization for XML Technologies:** Implementation has shown that it is possible to better organize the XML schemas for use within common technology development tools which work with XML. These changes are primarily focused on leveraging the objectoriented features of W3C XML Schema to allow for easier processing of [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] data and metadata.
76 +* **Consistency between the [[SDMX-ML>>doc:Glossary.SDMX-ML.WebHome]] and the [[SDMX Information Model>>doc:Glossary.SDMX Information Model.WebHome]]: **Certain aspects of the XML schemas and UML model have been more closely aligned, to allow for easier comprehension of the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] model.
78 78  * **Technical Bugs:** Some minor technical bugs have been identified in the registry interfaces and elsewhere. These bugs have been addressed.
79 -* **Support for Non-Time-[[Series>>doc:sdmx:Glossary 2\.1.Series.WebHome]] Data in the Generic Format: **One area which has been extended is the ability to express non-time-[[series>>doc:sdmx:Glossary 2\.1.Series.WebHome]] data as part of the generic data message.
80 -* **Simplification of the [[data structure definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] - specific message types: **Both [[time series>>doc:sdmx:Glossary 2\.1.Series.WebHome]] ((% style="color:#e74c3c" %)version(%%) 2.0 Compact) and non-[[time series>>doc:sdmx:Glossary 2\.1.Series.WebHome]] [[data sets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] ((% style="color:#e74c3c" %)version(%%) 2.0 Cross Sectional) use the same underlying structure for a structure-specific formatted message, which is specific to the [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] of the [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]].
81 -* **Simplification and better support for the metadata structure: **New use cases have been reported and these are now supported by a re-modelled [[metadata structure definition>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]].
82 -* **Support for partial [[item schemes>>doc:sdmx:Glossary 2\.1.Item scheme.WebHome]] such as a [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] list: **The (% style="color:#e74c3c" %)concept(%%) of a partial (subset) [[item scheme>>doc:sdmx:Glossary 2\.1.Item scheme.WebHome]] such as a partial [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] list for use in exchange scenarios has been introduced**.**
78 +* **Support for Non-Time-Series Data in the Generic Format: **One area which has been extended is the ability to express non-time-series data as part of the generic data message.
79 +* **Simplification of the [[data structure definition>>doc:Glossary.Data structure definition.WebHome]] - specific message types: **Both time series (version 2.0 Compact) and non-time series [[data sets>>doc:Glossary.Data set.WebHome]] (version 2.0 Cross Sectional) use the same underlying structure for a structure-specific formatted message, which is specific to the [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]] of the data set.
80 +* **Simplification and better support for the metadata structure: **New use cases have been reported and these are now supported by a re-modelled metadata structure definition.
81 +* **Support for partial [[item schemes>>doc:Glossary.Item scheme.WebHome]] such as a [[code list>>doc:Glossary.Code list.WebHome]]: **The concept of a partial (subset) [[item scheme>>doc:Glossary.Item scheme.WebHome]] such as a partial [[code list>>doc:Glossary.Code list.WebHome]] for use in exchange scenarios has been introduced**.**
83 83  
84 84  == 2.3 Major Changes from 2.1 to 3.0 ==
85 85  
85 +[[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] version 3.0 introduces new features, improvements and changes to the Standard in the following key areas:
86 86  
87 -[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] (% style="color:#e74c3c" %)version(%%) 3.0 introduces new features, improvements and changes to the Standard in the following key areas:
88 -
89 89  (% class="wikigeneratedid" id="HInformationModel" %)
90 90  **Information Model**
91 91  
92 -* Simplification and improvement of the [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] model
90 +* Simplification and improvement of the [[reference metadata>>doc:Glossary.Reference metadata.WebHome]] model
93 93  * Support for microdata
94 94  * Support for geospatial data
95 -* Support for [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] list extension and discriminated union of [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] lists
93 +* Support for [[code list>>doc:Glossary.Code list.WebHome]] extension and discriminated union of [[code lists>>doc:Glossary.Code list.WebHome]]
96 96  * Improvements to structure mapping
97 -* Improvements to [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] [[hierarchies>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]] for data discovery
98 -* Improvements to (% style="color:#e74c3c" %)constraints
95 +* Improvements to [[code>>doc:Glossary.Code.WebHome]] [[hierarchies>>doc:Glossary.Hierarchy.WebHome]] for data discovery
96 +* Improvements to (% style="color:#e74c3c" %)[[constraints>>doc:Glossary.Constraint.WebHome]]
99 99  
100 100  (% class="wikigeneratedid" id="HVersioningofStructuralMetadataArtefacts" %)
101 -**Versioning of [[Structural Metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]]**
99 +**Versioning of Structural Metadata Artefacts**
102 102  
103 -Adoption of the three-number semantic versioning standard for [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] [[artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] ([[__https:~~/~~/semver.org__>>https://https:semver.org]])
101 +Adoption of the three-number semantic versioning standard for [[structural metadata>>doc:Glossary.Structural metadata.WebHome]] [[artefacts>>doc:Glossary.Artefact.WebHome]] ([[__https:~~/~~/semver.org__>>https://https:semver.org]])
104 104  
105 105  (% class="wikigeneratedid" id="HRESTWebServicesApplicationProgrammingInterface28API29" %)
106 106  **REST Web Services Application Programming Interface (API)**
... ... @@ -107,32 +107,32 @@
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 -* Improvements to [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] queries
111 -* Support for [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] maintenance using HTTP PUT, POST and DELETE verbs
108 +* Improvements to [[reference metadata>>doc:Glossary.Reference metadata.WebHome]] queries
109 +* Support for [[structural metadata>>doc:Glossary.Structural metadata.WebHome]] maintenance using HTTP PUT, POST and DELETE verbs
112 112  
113 113  (% class="wikigeneratedid" id="HSOAPWebServicesAPI" %)
114 114  **SOAP Web Services API**
115 115  
116 -* The SOAP web services API has been deprecated with (% style="color:#e74c3c" %)version(%%) 3.0 standardising on REST
114 +* The SOAP web services API has been deprecated with version 3.0 standardising on REST
117 117  
118 118  (% class="wikigeneratedid" id="HXML2CJSON2CCSVandEDITransmissionformats" %)
119 119  **XML, JSON, CSV and EDI Transmission formats**
120 120  
121 -The [[SDMX-ML>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]], [[SDMX-JSON>>doc:sdmx:Glossary 2\.1.SDMX-JSON.WebHome]] and [[SDMX-CSV>>doc:sdmx:Glossary 2\.1.SDMX-CSV.WebHome]] specifications have been extended and modified where needed to support the new features and changes such as [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] and microdata Obsolete [[SDMX-ML>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]] 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>>doc:sdmx:Glossary 2\.1.Data exchange.WebHome]] The [[SDMX-EDI>>doc:sdmx:Glossary 2\.1.SDMX-EDI.WebHome]] transmission format for structures and data has been deprecated The organisation of structures into ‘collections’ in [[SDMX-ML>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]] and [[SDMX-JSON>>doc:sdmx:Glossary 2\.1.SDMX-JSON.WebHome]] structure messages has been flattened and simplified The option to reference structures in [[SDMX-ML>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]] and [[SDMX-JSON>>doc:sdmx:Glossary 2\.1.SDMX-JSON.WebHome]] messages using Agency, ID and (% style="color:#e74c3c" %)Version(%%) has been deprecated with URN now exclusively used for all non-local referencing purpose
119 +The [[SDMX-ML>>doc:Glossary.SDMX-ML.WebHome]], [[SDMX-JSON>>doc:Glossary.SDMX-JSON.WebHome]] and [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]]-CSV specifications have been extended and modified where needed to support the new features and changes such as [[reference metadata>>doc:Glossary.Reference metadata.WebHome]] and microdata Obsolete [[SDMX-ML>>doc:Glossary.SDMX-ML.WebHome]] 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 The [[SDMX-EDI>>doc:Glossary.SDMX-EDI.WebHome]] transmission format for structures and data has been deprecated The organisation of structures into ‘collections’ in [[SDMX-ML>>doc:Glossary.SDMX-ML.WebHome]] and [[SDMX-JSON>>doc:Glossary.SDMX-JSON.WebHome]] structure messages has been flattened and simplified The option to reference structures in [[SDMX-ML>>doc:Glossary.SDMX-ML.WebHome]] and [[SDMX-JSON>>doc:Glossary.SDMX-JSON.WebHome]] messages using Agency, ID and Version has been deprecated with URN now exclusively used for all non-local referencing purpose
122 122  
123 -Several of the changes are ‘breaking’ meaning that, in specific cases, the (% style="color:#e74c3c" %)version(%%) 3.0 specification is not backwardly compatible with earlier (% style="color:#e74c3c" %)versions(%%) of the Standard.
121 +Several of the changes are ‘breaking’ meaning that, in specific cases, the version 3.0 specification is not backwardly compatible with earlier versions of the Standard.
124 124  
125 125  The principle breaking changes are:
126 126  
127 127  * REST API – The REST API is not backwardly compatible due to modifications to the URLs and query parameters resulting in breaking changes in four of the five main resources.
128 -* SOAP API – Deprecation of the SOAP API means that existing systems designed to use SOAP will not work with (% style="color:#e74c3c" %)version(%%) 3.0 registries.
129 -* [[SDMX-ML>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]] – [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] 2.1 and earlier structure, data and metadata XML messages are not valid in (% style="color:#e74c3c" %)version(%%) 3.0. Specifically: legacy data messages including Generic, Compact and Utility are no longer supported. The remaining Structure Specific data message has been changed to support new features such as reporting of [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] as part of the [[dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]], Structure messages have a number of breaking changes, principally modification to the information model, removal of the agency-(% style="color:#e74c3c" %)version(%%)-id option for referencing [[artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] and changes to the way the structures are organised into ‘collections’ within the message.
130 -* [[SDMX-JSON>>doc:sdmx:Glossary 2\.1.SDMX-JSON.WebHome]] – [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] 2.1 structure, data and metadata JSON messages are not valid in (% style="color:#e74c3c" %)version(%%) 3.0. The data message has been changed to support the improved REST data queries, in particular the ability to retrieve in one operation data from multiple [[datasets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] with potentially different [[Data Structure Definitions>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]. Breaking changes similar to those for the [[SDMX-ML>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]] transmission format have been made to the structure message.
131 -* [[SDMX-CSV>>doc:sdmx:Glossary 2\.1.SDMX-CSV.WebHome]] - The CSV data and [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] messages are not backwardly compatible with those under (% style="color:#e74c3c" %)version(%%) 2.1 due to changes to the structure of the messages needed to support new features such as the improved REST API data queries.
132 -* [[SDMX-EDI>>doc:sdmx:Glossary 2\.1.SDMX-EDI.WebHome]] – Deprecation of the EDI transmission format means that existing systems designed to send or receive structures or data in EDI will not work with (% style="color:#e74c3c" %)version(%%) 3.0 registries.
133 -* Information Model – Several structures have been changed in the (% style="color:#e74c3c" %)version(%%) 3.0 model and three removed. For these reasons the (% style="color:#e74c3c" %)version(%%) 3.0 model is not directly compatible with (% style="color:#e74c3c" %)version(%%) 2.1 or earlier, although conversion of specific [[artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] is possible under some circumstances. Loss of information during the conversion process however means that in cases like structure mapping, the conversion is not reversible i.e. it is not possible to recreate the 2.1 structure once it has been converted to the 3.0 model.
126 +* SOAP API – Deprecation of the SOAP API means that existing systems designed to use SOAP will not work with version 3.0 registries.
127 +* [[SDMX-ML>>doc:Glossary.SDMX-ML.WebHome]] – [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] 2.1 and earlier structure, data and metadata XML messages are not valid in version 3.0. Specifically: legacy data messages including Generic, Compact and Utility are no longer supported. The remaining Structure Specific data message has been changed to support new features such as reporting of [[reference metadata>>doc:Glossary.Reference metadata.WebHome]] as part of the [[dataset>>doc:Glossary.Data set.WebHome]], Structure messages have a number of breaking changes, principally modification to the information model, removal of the agency-version-id option for referencing [[artefacts>>doc:Glossary.Artefact.WebHome]] and changes to the way the structures are organised into ‘collections’ within the message.
128 +* [[SDMX-JSON>>doc:Glossary.SDMX-JSON.WebHome]] – [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] 2.1 structure, data and metadata JSON messages are not valid in version 3.0. The data message has been changed to support the improved REST data queries, in particular the ability to retrieve in one operation data from multiple [[datasets>>doc:Glossary.Data set.WebHome]] with potentially different [[Data Structure Definitions>>doc:Glossary.Data structure definition.WebHome]]. Breaking changes similar to those for the [[SDMX-ML>>doc:Glossary.SDMX-ML.WebHome]] transmission format have been made to the structure message.
129 +* [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]]-CSV - The CSV data and [[reference metadata>>doc:Glossary.Reference metadata.WebHome]] messages are not backwardly compatible with those under version 2.1 due to changes to the structure of the messages needed to support new features such as the improved REST API data queries.
130 +* [[SDMX-EDI>>doc:Glossary.SDMX-EDI.WebHome]] – Deprecation of the EDI transmission format means that existing systems designed to send or receive structures or data in EDI will not work with version 3.0 registries.
131 +* Information Model – Several structures have been changed in the version 3.0 model and three removed. For these reasons the version 3.0 model is not directly compatible with version 2.1 or earlier, although conversion of specific [[artefacts>>doc:Glossary.Artefact.WebHome]] is possible under some circumstances. Loss of information during the conversion process however means that in cases like structure mapping, the conversion is not reversible i.e. it is not possible to recreate the 2.1 structure once it has been converted to the 3.0 model.
134 134  
135 -The [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] 3.0 Major Changes document provides more information including an analysis of the breaking changes.
133 +The [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] 3.0 Major Changes document provides more information including an analysis of the breaking changes.
136 136  
137 137  == 2.4 Major Changes from 3.0 to 3.1 ==
138 138  
... ... @@ -139,36 +139,35 @@
139 139  (% class="wikigeneratedid" id="HInformationModel-1" %)
140 140  **Information Model**
141 141  
142 -* Addition of [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] (% style="color:#e74c3c" %)Constraint(%%) property to a [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]
143 -* Addition of evolving structure property to a [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]
144 -* Remove (% style="color:#e74c3c" %)version(%%) property on [[Categorisation>>doc:sdmx:Glossary 2\.1.Categorisation.WebHome]]
145 -* Simplification of (% style="color:#e74c3c" %)Constraints
146 -** Removal of Advanced [[Release Calendar>>doc:sdmx:Glossary 2\.1.Release policy - release calendar.WebHome]]
147 -** Removal of Role, Data (% style="color:#e74c3c" %)Constraints(%%) only restrict data that can be reported
148 -** Restrict (% style="color:#e74c3c" %)constraint(%%) targets to Identifiable structures (not URLs)
149 -** Addition of Availability (% style="color:#e74c3c" %)Constraint(%%) to define actual data
140 +* Addition of [[Dimension>>doc:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)[[Constraint>>doc:Glossary.Constraint.WebHome]](%%) property to a Dataflow
141 +* Addition of evolving structure property to a Data Structure Definition
142 +* Remove (% style="color:#e74c3c" %)[[version>>doc:Glossary.Version.WebHome]](%%) property on Categorisation
143 +* Simplification of (% style="color:#e74c3c" %)[[Constraints>>doc:Glossary.Constraint.WebHome]]
144 +** Removal of Advanced Release Calendar
145 +** Removal of Role, Data (% style="color:#e74c3c" %)[[Constraints>>doc:Glossary.Constraint.WebHome]](%%) only restrict data that can be reported
146 +** Restrict (% style="color:#e74c3c" %)[[constraint>>doc:Glossary.Constraint.WebHome]](%%) targets to Identifiable structures (not URLs)
147 +** Addition of Availability (% style="color:#e74c3c" %)[[Constraint>>doc:Glossary.Constraint.WebHome]](%%) to define actual data
150 150  
151 151  (% class="wikigeneratedid" id="HDocumentation" %)
152 152  **Documentation**
153 153  
154 -* Registering [[Reference Metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] removed from documentation, to align with XML Registration object which is unable to reference a Metadata Provision, and REST API which is unable to query for registered [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] sources.
152 +* Registering [[Reference Metadata>>doc:Glossary.Reference metadata.WebHome]] removed from documentation, to align with XML Registration object which is unable to reference a Metadata Provision, and REST API which is unable to query for registered [[reference metadata>>doc:Glossary.Reference metadata.WebHome]] sources.
155 155  
156 -The [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] standards specified here are designed to support the requirements of all of these automation processes and technologies.
154 +The [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] standards specified here are designed to support the requirements of all of these automation processes and technologies.
157 157  
158 158  = 3 Processes and Business Scope =
159 159  
160 160  == 3.1 Process Patterns ==
161 161  
160 +[[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] identifies three basic process patterns regarding the exchange of statistical data and metadata. These can be described as follows:
162 162  
163 -[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] identifies three basic process patterns regarding the exchange of statistical data and metadata. These can be described as follows:
164 -
165 -1. //**[[Bilateral exchange>>doc:sdmx:Glossary 2\.1.Bilateral exchange.WebHome]]**~:// All aspects of the exchange process are agreed between counterparties, including the mechanism for exchange of data and metadata, the formats, the frequency or schedule, and the mode used for communications regarding the exchange. This is perhaps the most common process pattern.
166 -1. //**Gateway exchange**~:// Gateway exchanges are an organized set of [[bilateral exchanges>>doc:sdmx:Glossary 2\.1.Bilateral exchange.WebHome]], in which several data and metadata collecting organizations or individuals agree to exchange the collected information with each other in a single, known format, and according to a single, known process. This pattern has the effect of reducing the burden of managing multiple [[bilateral exchanges>>doc:sdmx:Glossary 2\.1.Bilateral exchange.WebHome]] (in data and metadata collection) across the sharing organizations/individuals. This is also a very common process pattern in the statistical area, where communities of institutions agree on ways to gain efficiencies within the scope of their collective responsibilities.
162 +1. //**Bilateral exchange**~:// All aspects of the exchange process are agreed between counterparties, including the mechanism for exchange of data and metadata, the formats, the frequency or schedule, and the mode used for communications regarding the exchange. This is perhaps the most common process pattern.
163 +1. //**Gateway exchange**~:// Gateway exchanges are an organized set of bilateral exchanges, in which several data and metadata collecting organizations or individuals agree to exchange the collected information with each other in a single, known format, and according to a single, known process. This pattern has the effect of reducing the burden of managing multiple bilateral exchanges (in data and metadata collection) across the sharing organizations/individuals. This is also a very common process pattern in the statistical area, where communities of institutions agree on ways to gain efficiencies within the scope of their collective responsibilities.
167 167  1. //**Data-sharing exchange**~:// Open, freely available data formats and process patterns are known and standard. Thus, any organization or individual can use any counterparty’s data and metadata (assuming they are permitted access to it). This model requires no bilateral agreement, but only requires that data and metadata providers and consumers adhere to the standards.
168 168  
169 169  == 3.2 SDMX and Process Automation ==
170 170  
171 -[[Statistical data and metadata exchanges>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] employ many different automated processes, but some are of more general interest than others. There are some common information technologies that are nearly ubiquitous within information systems today. [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] aims to provide standards that are most useful for these automated processes and technologies.
168 +Statistical data and metadata exchanges employ many different automated processes, but some are of more general interest than others. There are some common information technologies that are nearly ubiquitous within information systems today. [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] aims to provide standards that are most useful for these automated processes and technologies.
172 172  
173 173  Briefly, these can be described as:
174 174  
© Semantic R&D Group, 2026