Wiki source code of SDMX 3.1 Standards. Section 1. Summary of Major Changes and New Functionality

Version 10.4 by Helena K. on 2026/06/03 14:36

version	line-number	content
1.1	1	{{box title="Contents"}}
	2	{{toc/}}
	3	{{/box}}
	4
8.1	5	Revision History
	6
	7	(% style="width:991.835px" %)
	8	\|(% style="width:154px" %)Revision \|(% style="width:249px" %)Date \|(% style="width:586px" %)Contents
	9	\|(% style="width:154px" %)DRAFT 1.0\|(% style="width:249px" %)December 2024\|(% style="width:586px" %)Draft release updated for SDMX 3.1 for public consultation
	10	\|(% style="width:154px" %)1.0\|(% style="width:249px" %)May 2025\|(% style="width:586px" %)Public release for SDMX 3.1
	11
1.2	12	= 1. Overview =
	13
	14
9.2	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
1.5	17	Information Model
1.2	18
9.2	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]]
1.2	22
1.5	23	Documentation
1.2	24
9.2	25	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.
1.2	26
1.5	27	Breaking Changes
1.2	28
9.2	29	* Remove [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] property on [[Categorisation>>doc:sdmx:Glossary 2\.1.Categorisation.WebHome]]
	30	* Removal of Advanced [[Release Calendar>>doc:sdmx:Glossary 2\.1.Release policy - release calendar.WebHome]]
1.2	31
1.5	32	Content of the Document
1.2	33
9.3	34	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:
1.2	35
	36	Section 2 – Information Model
	37
	38	Section 5 – Registry Specification
	39
	40	Section 6 – Technical Notes
	41
9.3	42	[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] TWG GitHub for the REST API and the XML and JSON formats
1.2	43
	44	= 2. Summary of Breaking Changes in 3.1 =
	45
3.2	46	Version 3.1 introduces breaking changes, in the model in the following areas:
1.2	47
	48	== 2.1 Removal of Advanced Release Calendar ==
	49
9.4	50	The Data [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] 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.
1.2	51
	52	//Guidance for Implementors//
9.4	53	[[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]].
1.2	54
1.3	55	== 2.2 Removal of Version on Categorisation ==
1.2	56
9.6	57	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.
1.2	58
1.6	59	//Guidance for Implementors//
9.6	60	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.
1.2	61
1.3	62	= 3. Information Model =
1.2	63
	64	The changes to the information model support two distinct use cases:
	65
10.2	66	1. Horizontally complex [[Data Structure Definitions>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] (DSDs)
	67	1. Additional cohesion to the Data [[Constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] model
1.2	68
	69	These changes are described in below.
	70
1.4	71	== 3.1 Horizontally Complex Data Structure Definitions ==
1.2	72
10.3	73	An explanation of this use case, with additional details can be found under Section 6 - Technical Notes, under heading ‘10.3 [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]]’.
1.2	74
	75	The following changes to the model have been made to satisfy this use case.
	76
1.9	77	Data Structure Definition
1.2	78
10.3	79	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.
1.2	80
1.9	81	Dataflow
1.2	82
10.3	83	The [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] has a new [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] 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]].
1.2	84
10.3	85	The [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] 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.
1.2	86
10.3	87	The [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] property is only required if the [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] sets the evolving structure property to true.
1.2	88
1.4	89	== 3.2 Constraint Cohesion ==
1.2	90
10.4	91	The [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] 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]].
1.2	92
10.4	93	Data Constraint
1.2	94
10.4	95	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.
1.2	96
10.4	97	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.
1.2	98
10.4	99	Availability Constraint
1.2	100
10.4	101	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]]
	102
	103