Skip to Content
Last modified by Helena K. on 2026/06/08 15:16
From version 25.6
edited by Helena K.
on 2026/06/03 13:19
Change comment: There is no comment for this version
To version 25.3
edited by Helena K.
on 2026/06/03 13:18
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -98,7 +98,7 @@
98 98  * Improvements to constraints
99 99  
100 100  (% class="wikigeneratedid" id="HVersioningofStructuralMetadataArtefacts" %)
101 -**Versioning of Structural Metadata Artefacts**
101 +**Versioning of [[Structural Metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]]**
102 102  
103 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]])
104 104  
... ... @@ -113,20 +113,20 @@
113 113  (% class="wikigeneratedid" id="HSOAPWebServicesAPI" %)
114 114  **SOAP Web Services API**
115 115  
116 -* The SOAP web services API has been deprecated with version 3.0 standardising on REST
116 +* The SOAP web services API has been deprecated with (% style="color:#e74c3c" %)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 Version has been deprecated with URN now exclusively used for all non-local referencing purpose
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
122 122  
123 -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.
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.
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 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 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.
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 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 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 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.
© Semantic R&D Group, 2026