Skip to Content
Last modified by Helena K. on 2026/06/08 15:19
From version 9.2
edited by Helena K.
on 2026/06/03 14:29
Change comment: There is no comment for this version
To version 13.3
edited by Helena K.
on 2026/06/04 13:40
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -11,14 +11,13 @@
11 11  
12 12  = 1. Overview =
13 13  
14 -
15 15  [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] 3.1 is a minor revision to the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] 3.0 Standard which introduces a limited set of changes, which cover the following:
16 16  
17 17  **Information Model**
18 18  
19 19  * Support for [[Dataflows>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] to reference a subset of [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] from a [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]
20 -* Simplification to Data [[Constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]]
21 -* Addition of Availability [[Constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]]
19 +* Simplification to Data Constraints
20 +* Addition of Availability Constraints
22 22  
23 23  **Documentation**
24 24  
... ... @@ -29,11 +29,9 @@
29 29  * Remove [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] property on [[Categorisation>>doc:sdmx:Glossary 2\.1.Categorisation.WebHome]]
30 30  * Removal of Advanced [[Release Calendar>>doc:sdmx:Glossary 2\.1.Release policy - release calendar.WebHome]]
31 31  
32 -*
33 -
34 34  **Content of the Document**
35 35  
36 -The remainder of this document contains a summary of the changes. More detailed information can be found in the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] 3.1 Technical Specifications, in particular:
33 +The remainder of this document contains a summary of the changes. More detailed information can be found in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] 3.1 Technical Specifications, in particular:
37 37  
38 38  Section 2 – Information Model
39 39  
... ... @@ -41,7 +41,7 @@
41 41  
42 42  Section 6 – Technical Notes
43 43  
44 -[[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] TWG GitHub for the REST API and the XML and JSON formats
41 +[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] TWG GitHub for the REST API and the XML and JSON formats
45 45  
46 46  = 2. Summary of Breaking Changes in 3.1 =
47 47  
... ... @@ -49,55 +49,55 @@
49 49  
50 50  == 2.1 Removal of Advanced Release Calendar ==
51 51  
52 -The Data (% style="color:#e74c3c" %)[[Constraint>>doc:Glossary.Constraint.WebHome]](%%) was simplified to become a cohesive structural [[artefact>>doc:Glossary.Artefact.WebHome]] focussed solely on the restriction of values that can be reported. As part of this remodelling the Advanced [[Release Calendar>>doc:Glossary.Release policy - release calendar.WebHome]] was removed as it does not play a restrictive role.
49 +The Data Constraint was simplified to become a cohesive structural [[artefact>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] focussed solely on the restriction of values that can be reported. As part of this remodelling the Advanced [[Release Calendar>>doc:sdmx:Glossary 2\.1.Release policy - release calendar.WebHome]] was removed as it does not play a restrictive role.
53 53  
54 54  //Guidance for Implementors//
55 -[[Reference Metadata>>doc:Glossary.Reference metadata.WebHome]] reported against a [[Dataflow>>doc:Glossary.Dataflow.WebHome]] and / or [[Provision Agreement>>doc:Glossary.Provision agreement.WebHome]] can be used as an alternative to the Advanced [[Release Calendar>>doc:Glossary.Release policy - release calendar.WebHome]].
52 +[[Reference Metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] reported against a [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] and / or [[Provision Agreement>>doc:sdmx:Glossary 2\.1.Provision agreement.WebHome]] can be used as an alternative to the Advanced [[Release Calendar>>doc:sdmx:Glossary 2\.1.Release policy - release calendar.WebHome]].
56 56  
57 57  == 2.2 Removal of Version on Categorisation ==
58 58  
59 -The Categorisation structural [[artefact>>doc:Glossary.Artefact.WebHome]] has no use case for undergoing (% style="color:#e74c3c" %)[[version>>doc:Glossary.Version.WebHome]](%%) changes, the (% style="color:#e74c3c" %)[[version>>doc:Glossary.Version.WebHome]](%%) was therefore removed.
56 +The [[Categorisation>>doc:sdmx:Glossary 2\.1.Categorisation.WebHome]] structural [[artefact>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] has no use case for undergoing [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] changes, the [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] was therefore removed.
60 60  
61 61  //Guidance for Implementors//
62 -If multiple (% style="color:#e74c3c" %)[[versions>>doc:Glossary.Version.WebHome]](%%) of a Categorisation exist where the source or target differs, these Categorisations should be given a unique ID.
59 +If multiple [[versions>>doc:sdmx:Glossary 2\.1.Version.WebHome]] of a [[Categorisation>>doc:sdmx:Glossary 2\.1.Categorisation.WebHome]] exist where the source or target differs, these [[Categorisations>>doc:sdmx:Glossary 2\.1.Categorisation.WebHome]] should be given a unique ID.
63 63  
64 64  = 3. Information Model =
65 65  
66 66  The changes to the information model support two distinct use cases:
67 67  
68 -1. Horizontally complex [[Data Structure Definitions>>doc:Glossary.Data structure definition.WebHome]] (DSDs)
69 -1. Additional cohesion to the Data (% style="color:#e74c3c" %)[[Constraints>>doc:Glossary.Constraint.WebHome]](%%) model
65 +1. Horizontally complex [[Data Structure Definitions>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] (DSDs)
66 +1. Additional cohesion to the Data Constraints model
70 70  
71 71  These changes are described in below.
72 72  
73 73  == 3.1 Horizontally Complex Data Structure Definitions ==
74 74  
75 -An explanation of this use case, with additional details can be found under Section 6 - Technical Notes, under heading ‘10.3 [[Dimension>>doc:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)[[Constraint>>doc:Glossary.Constraint.WebHome]](%%)’.
72 +An explanation of this use case, with additional details can be found under Section 6 - Technical Notes, under heading ‘10.3 Dimension Constraint’.
76 76  
77 77  The following changes to the model have been made to satisfy this use case.
78 78  
79 79  **Data Structure Definition**
80 80  
81 -The [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]] has a new ‘evolving structure’ property, this is a Boolean property, when set to ‘true’ it indicates to the users of the [[DSD>>doc:Glossary.Data structure definition.WebHome]] that new [[Dimensions>>doc:Glossary.Dimension.WebHome]] may be added without the [[DSD>>doc:Glossary.Data structure definition.WebHome]] undergoing a change to its major (% style="color:#e74c3c" %)[[version>>doc:Glossary.Version.WebHome]](%%) number.
78 +The [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] has a new ‘evolving structure’ property, this is a Boolean property, when set to ‘true’ it indicates to the users of the [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] that new [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] may be added without the [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] undergoing a change to its major [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] number.
82 82  
83 83  **Dataflow**
84 84  
85 -The [[Dataflow>>doc:Glossary.Dataflow.WebHome]] has a new [[Dimension>>doc:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)[[Constraint>>doc:Glossary.Constraint.WebHome]](%%) property, which is used to reference a subset of [[Dimensions>>doc:Glossary.Dimension.WebHome]] which it uses from the referenced [[DSD>>doc:Glossary.Data structure definition.WebHome]].
82 +The [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] has a new Dimension Constraint property, which is used to reference a subset of [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] which it uses from the referenced [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]].
86 86  
87 -The [[Dimension>>doc:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)[[Constraint>>doc:Glossary.Constraint.WebHome]](%%) fixes the [[Dimensions>>doc:Glossary.Dimension.WebHome]] of the [[Dataflow>>doc:Glossary.Dataflow.WebHome]] enabling the referenced [[DSD>>doc:Glossary.Data structure definition.WebHome]] to have new [[Dimensions>>doc:Glossary.Dimension.WebHome]] added without the need to change the major (% style="color:#e74c3c" %)[[version>>doc:Glossary.Version.WebHome]](%%) number.
84 +The Dimension Constraint fixes the [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] of the [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] enabling the referenced [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] to have new [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] added without the need to change the major [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] number.
88 88  
89 -The [[Dimension>>doc:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)[[Constraint>>doc:Glossary.Constraint.WebHome]](%%) property is only required if the [[DSD>>doc:Glossary.Data structure definition.WebHome]] sets the evolving structure property to true.
86 +The Dimension Constraint property is only required if the [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] sets the evolving structure property to true.
90 90  
91 91  == 3.2 Constraint Cohesion ==
92 92  
93 -The (% style="color:#e74c3c" %)[[Constraint>>doc:Glossary.Constraint.WebHome]](%%) model in [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] 3.1 has been made more cohesive by separating the Data (% style="color:#e74c3c" %)[[Constraint>>doc:Glossary.Constraint.WebHome]](%%) into two distinct structures; the Data (% style="color:#e74c3c" %)[[Constraint>>doc:Glossary.Constraint.WebHome]](%%) which describes reporting restrictions, and the Availability (% style="color:#e74c3c" %)[[Constraint>>doc:Glossary.Constraint.WebHome]](%%), which describes data content from a [[data source>>doc:Glossary.Data source.WebHome]]. In [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] 3.0 these distinctions were made using the ‘type’ property on a Data (% style="color:#e74c3c" %)[[Constraint>>doc:Glossary.Constraint.WebHome]](%%).
90 +The Constraint model in [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] 3.1 has been made more cohesive by separating the Data [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] into two distinct structures; the Data [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] which describes reporting restrictions, and the Availability [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]], which describes data content from a [[data source>>doc:sdmx:Glossary 2\.1.Data source.WebHome]]. In [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] 3.0 these distinctions were made using the ‘type’ property on a Data [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]].
94 94  
95 -**Data [[Constraint>>doc:Glossary.Constraint.WebHome]]**
92 +**Data Constraint**
96 96  
97 -The Data (% style="color:#e74c3c" %)[[Constraint>>doc:Glossary.Constraint.WebHome]](%%) has had the ‘type’ property removed; the Data (% style="color:#e74c3c" %)[[Constraint>>doc:Glossary.Constraint.WebHome]](%%) in [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] 3.1 is always used to describe restrictions on content for data reporting purposes.
94 +The Data [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] has had the ‘type’ property removed; the Data [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] in [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] 3.1 is always used to describe restrictions on content for data reporting purposes.
98 98  
99 -The attachment of the Data (% style="color:#e74c3c" %)[[Constraint>>doc:Glossary.Constraint.WebHome]](%%) in [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] 3.0 included [[Data Sources>>doc:Glossary.Data source.WebHome]], in [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] 3.1 these attachments have been removed as these are not relevant for restricting reported data.
96 +The attachment of the Data [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] in [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] 3.0 included [[Data Sources>>doc:sdmx:Glossary 2\.1.Data source.WebHome]], in [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] 3.1 these attachments have been removed as these are not relevant for restricting reported data.
100 100  
101 -**Availability [[Constraint>>doc:Glossary.Constraint.WebHome]]**
98 +**Availability Constraint**
102 102  
103 -The Availability (% style="color:#e74c3c" %)[[Constraint>>doc:Glossary.Constraint.WebHome]](%%) is a new Structure introduced to describe data that exists, it is generated in the response to the Availability REST API. It is not a maintained structure, and as such has no [[maintenance agency>>doc:Glossary.Maintenance agency.WebHome]], identity or (% style="color:#e74c3c" %)[[version>>doc:Glossary.Version.WebHome]]
100 +The Availability [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] is a new Structure introduced to describe data that exists, it is generated in the response to the Availability REST API. It is not a maintained structure, and as such has no [[maintenance agency>>doc:sdmx:Glossary 2\.1.Maintenance agency.WebHome]], identity or [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]].
© Semantic R&D Group, 2026