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.8
edited by Helena K.
on 2026/06/03 13:21
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -126,11 +126,11 @@
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 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.
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.
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-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 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 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 version 3.0 registries.
133 +* 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: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.
134 134  
135 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.
136 136  
... ... @@ -139,14 +139,14 @@
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]]
142 +* Addition of [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] Constraint property to a [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]
143 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
144 +* Remove version property on [[Categorisation>>doc:sdmx:Glossary 2\.1.Categorisation.WebHome]]
145 +* Simplification of Constraints
146 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
147 +** Removal of Role, Data Constraints only restrict data that can be reported
148 +** Restrict constraint targets to Identifiable structures (not URLs)
149 +** Addition of Availability Constraint to define actual data
150 150  
151 151  (% class="wikigeneratedid" id="HDocumentation" %)
152 152  **Documentation**
© Semantic R&D Group, 2026