Skip to Content
Last modified by Helena on 2025/09/10 11:19
From version 7.2
edited by Helena
on 2025/05/14 13:28
Change comment: There is no comment for this version
To version 7.6
edited by Helena
on 2025/05/14 13:37
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -4,9 +4,10 @@
4 4  
5 5  **Revision History**
6 6  
7 -|Revision|Date|Contents
8 -|DRAFT 1.0|May 2021|Draft release updated for SDMX 3.0 for public consultation
9 -|1.0|October 2021|Public Release for SDMX 3.0
7 +(% style="width:738.039px" %)
8 +|(% style="width:187px" %)Revision|(% style="width:157px" %)Date|(% style="width:390px" %)Contents
9 +|(% style="width:187px" %)DRAFT 1.0|(% style="width:157px" %)May 2021|(% style="width:390px" %)Draft release updated for SDMX 3.0 for public consultation
10 +|(% style="width:187px" %)1.0|(% style="width:157px" %)October 2021|(% style="width:390px" %)Public Release for SDMX 3.0
10 10  
11 11  = 1 Overview =
12 12  
... ... @@ -24,7 +24,7 @@
24 24  
25 25  **Versioning of Structural Metadata Artefacts**
26 26  
27 -• Adoption of the three-number semantic versioning standard for structural metadata artefacts [[(>>url:https://semver.org/]][[__https:~~/~~/semver.org__>>url:https://semver.org/]][[)>>url:https://semver.org/]]
28 +* Adoption of the three-number semantic versioning standard for structural metadata artefacts ([[https:~~/~~/semver.org/>>https://semver.org/||rel="noopener noreferrer" target="_blank"]])
28 28  
29 29  **REST Web Services Application Programming Interface (API)**
30 30  
... ... @@ -35,7 +35,7 @@
35 35  
36 36  **SOAP Web Services API**
37 37  
38 -• The SOAP web services API has been deprecated with version 3.0 standardising on REST** **
39 +* The SOAP web services API has been deprecated with version 3.0 standardising on REST**;**
39 39  
40 40  **XML, JSON, CSV and EDI Transmission formats**
41 41  
... ... @@ -66,7 +66,8 @@
66 66  
67 67  == //2.1 Web Services API// ==
68 68  
69 -|**REST API**|(((
70 +(% style="width:948.039px" %)
71 +|**REST API**|(% style="width:818px" %)(((
70 70  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:
71 71  
72 72  * Structure queries
... ... @@ -82,7 +82,7 @@
82 82  
83 83  Implementors are also recommended to version their API services providing users with an explicit choice of which version to use.
84 84  )))
85 -|**SOAP API**|The SOAP API has been deprecated.
87 +|**SOAP API**|(% style="width:818px" %)The SOAP API has been deprecated.
86 86  
87 87  == //2.2 Transmission Formats// ==
88 88  
... ... @@ -89,7 +89,8 @@
89 89  :
90 90  
91 91  (((
92 -|**SDMX-ML**|(((
94 +(% style="width:952.039px" %)
95 +|(% style="width:130px" %)**SDMX-ML**|(% style="width:820px" %)(((
93 93  The following legacy XML data messages have been deprecated:
94 94  
95 95  SDMX-ML 1.0/2.0 Generic (time-series) data message
... ... @@ -105,34 +105,27 @@
105 105  The SDMX-ML structure message is not backwardly compatible primarily due to:
106 106  
107 107  * Changes to the information model
108 -* Changes to the way the structures are organised into
109 -
110 -‘collections’ within the message
111 -
111 +* Changes to the way the structures are organised into ‘collections’ within the message
112 112  * Deprecation of the Agency, ID, Version option for referencing of structures in messages
113 113  )))
114 -|**SDMX-JSON**|(((
114 +|(% style="width:130px" %)**SDMX-JSON**|(% style="width:820px" %)(((
115 115  The JSON data message is not backwardly compatible with version 2.1 primarily due to changes needed to support the improved REST API data queries, in particular the ability to retrieve in one operation data from multiple datasets with potentially different Data Structure Definitions.
116 116  
117 117  The JSON structure message is not backwardly compatible primarily due to:
118 118  
119 119  * Changes to the information model
120 -* Changes to the way the structures are organised into
121 -
122 -‘collections’ within the message
123 -
120 +* Changes to the way the structures are organised into ‘collections’ within the message
124 124  * Deprecation of the Agency, ID, Version option for referencing of structures in messages
125 125  )))
126 -|**SDMX-EDI**|The EDI format for both structures and data has been deprecated.
127 -|**SDMX-CSV**|The CSV data and reference metadata 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.**     **
123 +|(% style="width:130px" %)**SDMX-EDI**|(% style="width:820px" %)The EDI format for both structures and data has been deprecated.
124 +|(% style="width:130px" %)**SDMX-CSV**|(% style="width:820px" %)The CSV data and reference metadata 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.**     **
128 128  )))
129 129  
130 130  == //2.3 Information Model// ==
131 131  
132 -:
133 -
134 134  (((
135 -|**Data Structure Definition**|(((
130 +(% style="width:955.039px" %)
131 +|(% style="width:132px" %)**Data Structure Definition**|(% style="width:819px" %)(((
136 136  The version 3.0 Data Structure Definition (DSD) model is not directly backwardly compatible with 2.1 primarily due to the deprecation of the special MeasureDimension.
137 137  
138 138  //Conversion guidance for implementors//
... ... @@ -141,7 +141,7 @@
141 141  
142 142  Version 3.0 DSDs cannot be reliably converted to the 2.1 model due to the introduction of new features such as multiple measures and value arrays for measures and attributes.
143 143  )))
144 -|**Structure mapping model**|(((
140 +|(% style="width:132px" %)**Structure mapping model**|(% style="width:819px" %)(((
145 145  The structure mapping model has changed significantly in version 3.0 with deprecation of the Structure Set maintainable artefact and introduction of five new ones: Representation Map and four variants of item scheme map.
146 146  
147 147  //Conversion guidance for implementors//
... ... @@ -150,7 +150,7 @@
150 150  
151 151  Conversion from the version 3.0 structure mapping model to 2.1 is generally possible. However, when attempting to convert mapping rules from 2.1 to 3.0 and back to 2.1, the resulting Structure Set will not be precisely the same as the original. In converting to version 3.0, the system must generate IDs for each of the new maintainable artefacts, but details of the original Structure Set artefacts are lost.
152 152  )))
153 -|**Reference metadata model**|(((
149 +|(% style="width:132px" %)**Reference metadata model**|(% style="width:819px" %)(((
154 154  The reference metadata model has changed in version 3.0 with modifications to the role of the Data Structure Definition, Metadata Structure Definition and Metadataflow artefacts. Metadata Provision Agreement and Metadata Provider Scheme have been added. Metadatasets are now identifiable.
155 155  
156 156  Version 2.1 reference metadata models are not valid in version 3.0.
... ... @@ -159,12 +159,12 @@
159 159  
160 160  A version 2.1 Metadata Structure Definition can be converted to the version 3.0 model under some circumstances, but target information is either lost or has to be translated into a metadataflow. Further, conversion of a Data Structure Definition for collecting reference metadata against a dataset would need to make changes to the dataset’s Data Structure Definition. As the Data Structure Definition may not actually be specified, judgement would need to be taken, perhaps determining the most likely candidate by examining which
161 161  )))
162 -| |(((
158 +|(% style="width:132px" %) |(% style="width:819px" %)(((
163 163  already have metadata reported against their datasets. A 2.1 metadata report could be converted to a version 3.0 Metadataset if it is attached to a structure, but requires a Metadata Provision Agreement which would need to be created if not already in existence.
164 164  
165 165  Conversion from the version 3.0 model to version 2.1 cannot be performed reliably. The process would need target information to be derived from analysis of the Metadataflows and Metadata Provision Agreements. Depending on the complexity it may not be possible to express that information in a version 2.1 Data Structure Definition.
166 166  )))
167 -|**Constraint model**|(((
163 +|(% style="width:132px" %)**Constraint model**|(% style="width:819px" %)(((
168 168  The version 2.1 Content Constraint artefact has been deprecated in version 3.0 and replaced by the Data Constraint for data, and the Metadata Constraint for reference metadata.
169 169  
170 170  //Conversion guidance for implementors//
... ... @@ -173,7 +173,7 @@
173 173  
174 174  Conversion from 3.0 to 2.1 presents challenges where wildcards have been used, in those cases requiring expansion of the wildcard into explicit values.
175 175  )))
176 -|**Hierarchical codelist structures**|(((
172 +|(% style="width:132px" %)**Hierarchical codelist structures**|(% style="width:819px" %)(((
177 177  The version 2.1 Hierarchical Codelist artefact has been deprecated in version 3.0 and replaced by two new artefacts, Hierarchy and Hierarchy Association.
178 178  
179 179  //Conversion guidance for implementors//
... ... @@ -507,7 +507,7 @@
507 507  
508 508  = 4 Versioning of Structural Metadata Artefacts =
509 509  
510 -Version 3.0 adopts semantic versioning principles for versioning of metadata artefacts following the rules set out at [[__https:~~/~~/semver.org__>>url:https://semver.org/]][[.>>url:https://semver.org/]] However, this is not mandatory, and organisations may continue to use the pre-existing two-digit versioning strategy, or not to version artefacts by omitting the //version// property. The version number no longer defaults to 1.0 if not explicitly set.
506 +Version 3.0 adopts semantic versioning principles for versioning of metadata artefacts following the rules set out at __[[https:~~/~~/semver.org>>https://semver.org]] __However, this is not mandatory, and organisations may continue to use the pre-existing two-digit versioning strategy, or not to version artefacts by omitting the //version// property. The version number no longer defaults to 1.0 if not explicitly set.
511 511  
512 512  Semantic version numbers are three digits:
513 513  
... ... @@ -589,11 +589,12 @@
589 589  
590 590  /data/dataflow/ESTAT/ICP?c[REF_AREA]=DE&c[ICP_ITEM]=sw:01&c[TIME_PERIOD]=ge:2015 Operators include:
591 591  
592 -|eq|Equals
593 -|ne|Not equal to
594 -|le|Less than
595 -|ge|Greater than or equal to
596 -|sw|Starts with
588 +(% style="width:531.039px" %)
589 +|(% style="width:151px" %)eq|(% style="width:378px" %)Equals
590 +|(% style="width:151px" %)ne|(% style="width:378px" %)Not equal to
591 +|(% style="width:151px" %)le|(% style="width:378px" %)Less than
592 +|(% style="width:151px" %)ge|(% style="width:378px" %)Greater than or equal to
593 +|(% style="width:151px" %)sw|(% style="width:378px" %)Starts with
597 597  
598 598  === Support for multiple keys ===
599 599  
... ... @@ -635,47 +635,49 @@
635 635  
636 636  Additionally, the way the individual artefacts are organised into ‘collections’ within the message has been significantly revised with a simpler flat structure adopted as set out in the following table:
637 637  
638 -|**Artefact type**|**Version 2.1 Collection**|**Version 3.0 Collection**
639 -|AgencyScheme|OrganisationSchemes|AgencySchemes
640 -|DataConsumerScheme|OrganisationSchemes|DataConsumerSchemes
641 -|DataProviderScheme|OrganisationSchemes|DataProviderSchemes
642 -|MetadataProviderScheme|OrganisationSchemes|MetadataProviderSchemes
643 -|OrganisationUnitScheme|OrganisationSchemes|OrganisationUnitSchemes
644 -|GeographicCodelist|Codelists|GeographicCodelists
645 -|GeoGridCodelist|Codelists|GeoGridCodelists
646 -|ConceptScheme|Concepts|ConceptSchemes
647 -|ValueList|Codelists|ValueLists
648 -|StructureMap|StructureMappings|StructureMaps
649 -|RepresentationMap|StructureMappings|RepresentationMaps
650 -|ConceptSchemeMap|StructureMappings|ConceptSchemeMaps
651 -|CategorySchemeMap|StructureMappings|CategorySchemeMaps
652 -|OrganisationSchemeMap|StructureMappings|OrganisationSchemeMaps
653 -|ReportingTaxonomyMap|StructureMappings|ReportingTaxonomyMaps
654 -|DataConstraint|Constraints|DataConstraints
655 -|MetadataConstraint|Constraints|MetadataConstraints
656 -|MetadataProvisionAgreement|ProvisionAgreement|MetadataProvisionAgreements
657 -|CustomTypeScheme|CustomTypes|CustomTypeSchemes
658 -|VtlMappingScheme|VtlMappings|VtlMappingSchemes
659 -|NamePersonalisationScheme|NamePersonalisations|NamePersonalisationSchemes
660 -|RulesetScheme|Rulesets|RulesetSchemes
661 -|TransformationScheme|Transformations|TransformationSchemes
662 -|UserDefinedOperatorScheme|UserDefinedOperators|UserDefinedOperatorSchemes
635 +(% style="width:1102.04px" %)
636 +|(% style="width:321px" %)**Artefact type**|(% style="width:351px" %)**Version 2.1 Collection**|(% style="width:426px" %)**Version 3.0 Collection**
637 +|(% style="width:321px" %)AgencyScheme|(% style="width:351px" %)OrganisationSchemes|(% style="width:426px" %)AgencySchemes
638 +|(% style="width:321px" %)DataConsumerScheme|(% style="width:351px" %)OrganisationSchemes|(% style="width:426px" %)DataConsumerSchemes
639 +|(% style="width:321px" %)DataProviderScheme|(% style="width:351px" %)OrganisationSchemes|(% style="width:426px" %)DataProviderSchemes
640 +|(% style="width:321px" %)MetadataProviderScheme|(% style="width:351px" %)OrganisationSchemes|(% style="width:426px" %)MetadataProviderSchemes
641 +|(% style="width:321px" %)OrganisationUnitScheme|(% style="width:351px" %)OrganisationSchemes|(% style="width:426px" %)OrganisationUnitSchemes
642 +|(% style="width:321px" %)GeographicCodelist|(% style="width:351px" %)Codelists|(% style="width:426px" %)GeographicCodelists
643 +|(% style="width:321px" %)GeoGridCodelist|(% style="width:351px" %)Codelists|(% style="width:426px" %)GeoGridCodelists
644 +|(% style="width:321px" %)ConceptScheme|(% style="width:351px" %)Concepts|(% style="width:426px" %)ConceptSchemes
645 +|(% style="width:321px" %)ValueList|(% style="width:351px" %)Codelists|(% style="width:426px" %)ValueLists
646 +|(% style="width:321px" %)StructureMap|(% style="width:351px" %)StructureMappings|(% style="width:426px" %)StructureMaps
647 +|(% style="width:321px" %)RepresentationMap|(% style="width:351px" %)StructureMappings|(% style="width:426px" %)RepresentationMaps
648 +|(% style="width:321px" %)ConceptSchemeMap|(% style="width:351px" %)StructureMappings|(% style="width:426px" %)ConceptSchemeMaps
649 +|(% style="width:321px" %)CategorySchemeMap|(% style="width:351px" %)StructureMappings|(% style="width:426px" %)CategorySchemeMaps
650 +|(% style="width:321px" %)OrganisationSchemeMap|(% style="width:351px" %)StructureMappings|(% style="width:426px" %)OrganisationSchemeMaps
651 +|(% style="width:321px" %)ReportingTaxonomyMap|(% style="width:351px" %)StructureMappings|(% style="width:426px" %)ReportingTaxonomyMaps
652 +|(% style="width:321px" %)DataConstraint|(% style="width:351px" %)Constraints|(% style="width:426px" %)DataConstraints
653 +|(% style="width:321px" %)MetadataConstraint|(% style="width:351px" %)Constraints|(% style="width:426px" %)MetadataConstraints
654 +|(% style="width:321px" %)MetadataProvisionAgreement|(% style="width:351px" %)ProvisionAgreement|(% style="width:426px" %)MetadataProvisionAgreements
655 +|(% style="width:321px" %)CustomTypeScheme|(% style="width:351px" %)CustomTypes|(% style="width:426px" %)CustomTypeSchemes
656 +|(% style="width:321px" %)VtlMappingScheme|(% style="width:351px" %)VtlMappings|(% style="width:426px" %)VtlMappingSchemes
657 +|(% style="width:321px" %)NamePersonalisationScheme|(% style="width:351px" %)NamePersonalisations|(% style="width:426px" %)NamePersonalisationSchemes
658 +|(% style="width:321px" %)RulesetScheme|(% style="width:351px" %)Rulesets|(% style="width:426px" %)RulesetSchemes
659 +|(% style="width:321px" %)TransformationScheme|(% style="width:351px" %)Transformations|(% style="width:426px" %)TransformationSchemes
660 +|(% style="width:321px" %)UserDefinedOperatorScheme|(% style="width:351px" %)UserDefinedOperators|(% style="width:426px" %)UserDefinedOperatorSchemes
663 663  
664 664  No changes have been made to the way the following artefacts are organised in the structure message:
665 665  
666 -|**Artefact type**|**Collection**
667 -|Dataflow|Dataflows
668 -|Metadataflow|Metadataflows
669 -|CategoryScheme|CategorySchemes
670 -|Categorisation|Categorisations
671 -|Codelist|Codelists
672 -|Hierarchy|Hierarchies
673 -|HierarchyAssociation|HierarchyAssociations
674 -|MetadataStructure|MetadataStructures
675 -|DataStructure|DataStructures
676 -|ReportingTaxonomy|ReportingTaxonomies
677 -|Process|Processes
678 -|ProvisionAgreement|ProvisionAgreements
664 +(% style="width:1106.04px" %)
665 +|(% style="width:326px" %)**Artefact type**|(% style="width:776px" %)**Collection**
666 +|(% style="width:326px" %)Dataflow|(% style="width:776px" %)Dataflows
667 +|(% style="width:326px" %)Metadataflow|(% style="width:776px" %)Metadataflows
668 +|(% style="width:326px" %)CategoryScheme|(% style="width:776px" %)CategorySchemes
669 +|(% style="width:326px" %)Categorisation|(% style="width:776px" %)Categorisations
670 +|(% style="width:326px" %)Codelist|(% style="width:776px" %)Codelists
671 +|(% style="width:326px" %)Hierarchy|(% style="width:776px" %)Hierarchies
672 +|(% style="width:326px" %)HierarchyAssociation|(% style="width:776px" %)HierarchyAssociations
673 +|(% style="width:326px" %)MetadataStructure|(% style="width:776px" %)MetadataStructures
674 +|(% style="width:326px" %)DataStructure|(% style="width:776px" %)DataStructures
675 +|(% style="width:326px" %)ReportingTaxonomy|(% style="width:776px" %)ReportingTaxonomies
676 +|(% style="width:326px" %)Process|(% style="width:776px" %)Processes
677 +|(% style="width:326px" %)ProvisionAgreement|(% style="width:776px" %)ProvisionAgreements
679 679  
680 680  From version 3.0, collections can appear in any order within a structure message.
681 681