Wiki source code of 9 Transforming between versions of SDMX

Last modified by Artur K. on 2026/05/29 14:28

version	line-number	content
2.1	1	{{box title="Contents"}}
	2	{{toc/}}
	3	{{/box}}
1.1	4
	5	== 9.1 Scope ==
	6
17.1	7	The scope of this section is to define both best practices and mandatory behaviour for specific aspects of transformation between different formats of [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]].
1.1	8
	9	== 9.2 Groups and Dimension Groups ==
	10
	11	=== 9.2.1 Issue ===
	12
17.1	13	Version 2.1 introduces a more granular mechanism for specifying the relationship between a Data [[Attribute>>doc:Glossary.Attribute.WebHome]] and the [[Dimensions>>doc:Glossary.Dimension.WebHome]] to which the [[attribute>>doc:Glossary.Attribute.WebHome]] applies. The technical construct for this is the [[Dimension>>doc:Glossary.Dimension.WebHome]] Group. This [[Dimension>>doc:Glossary.Dimension.WebHome]] Group has no direct equivalent in versions 2.0 and 1.0 and so the application transforming data from a version 2.1 [[data set>>doc:Glossary.Data set.WebHome]] to a version 2.0 or version 1.0 [[data set>>doc:Glossary.Data set.WebHome]] must decide to which construct the [[attribute>>doc:Glossary.Attribute.WebHome]] value, whose [[Attribute>>doc:Glossary.Attribute.WebHome]] is declared in a [[Dimension>>doc:Glossary.Dimension.WebHome]] Group, should be attached. The closest construct is the “Series” [[attachment level>>doc:Glossary.Attachment level.WebHome]] and in many cases this is the correct construct to use.
1.1	14
17.1	15	However, there is one case where the [[attribute>>doc:Glossary.Attribute.WebHome]] MUST be attached to a Group in the version 2.0 and 1.0 message. The conditions of this case are:
1.1	16
17.1	17	1. A Group is defined in the [[DSD>>doc:Glossary.Data structure definition.WebHome]] with exactly the same [[Dimensions>>doc:Glossary.Dimension.WebHome]] as a [[Dimension>>doc:Glossary.Dimension.WebHome]] Group in the same [[DSD>>doc:Glossary.Data structure definition.WebHome]].
	18	1. The [[Attribute>>doc:Glossary.Attribute.WebHome]] is defined in the [[DSD>>doc:Glossary.Data structure definition.WebHome]] with an [[Attribute Relationship>>doc:Glossary.Attribute relationship.WebHome]] to the [[Dimension>>doc:Glossary.Dimension.WebHome]] Group. This [[attribute>>doc:Glossary.Attribute.WebHome]] is NOT defined as having an [[Attribute Relationship>>doc:Glossary.Attribute relationship.WebHome]] to the Group.
1.1	19
	20	=== 9.2.2 Structural Metadata ===
	21
17.1	22	If the conditions defined in 9.2.1are true then on conversion to a version 2.0 or 1.0 [[DSD>>doc:Glossary.Data structure definition.WebHome]] (Key Family) the [[Component>>doc:Glossary.Component.WebHome]]/[[Attribute>>doc:Glossary.Attribute.WebHome]].attachmentLevel must be set to “Group” and the [[Component>>doc:Glossary.Component.WebHome]]/[[Attribute>>doc:Glossary.Attribute.WebHome]]/AttachmentGroup” is used to identify the Group. Note that under rule(1) in 1.2.1 this group will have been defined in the V 2.1 [[DSD>>doc:Glossary.Data structure definition.WebHome]] and so will be present in the V 2.0 transformation.
1.1	23
	24	=== 9.2.3 Data ===
	25
17.1	26	If the conditions defined in 9.2.1are true then, on conversion from a 2.1 [[data set>>doc:Glossary.Data set.WebHome]] to a 2.0 or 1.0 [[dataset>>doc:Glossary.Data set.WebHome]] the [[attribute>>doc:Glossary.Attribute.WebHome]] value will be placed in the relevant . If these conditions are not true then the [[attribute>>doc:Glossary.Attribute.WebHome]] value will be placed in the .
1.1	27
	28	=== 9.2.4 Compact Schema ===
	29
17.1	30	If the conditions defined in 9.2.1are true then the Compact Schema must be generated with the Group present and the [[Attribute>>doc:Glossary.Attribute.WebHome]](s) present in that group definition.