Skip to Content
Last modified by Helena K. on 2026/06/08 16:58
From version 15.4
edited by Helena K.
on 2026/04/16 14:26
Change comment: There is no comment for this version
To version 23.2
edited by Helena K.
on 2026/06/04 21:17
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -4,26 +4,24 @@
4 4  
5 5  == 5.1 Introduction ==
6 6  
7 -The DataStructureDefiniton is the class name for a structure definition for data. Some organisations know this type of definition as a “Key Family” and so the two names are synonymous. The term [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]] (also referred to as [[DSD>>doc:Glossary.Data structure definition.WebHome]]) is used in this specification.
7 +The DataStructureDefiniton is the class [[name>>doc:IMElements.name.WebHome]] for a [[structure>>doc:IMElements.structure.WebHome]] definition for data. Some organisations know this [[type>>doc:IMElements.type.WebHome]] of definition as a “[[Key>>doc:IMElements.AnnotableArtefact.Key.WebHome]] Family” and so the two names are synonymous. The term [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] (also referred to as [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]) is used in this specification.
8 8  
9 -Many of the constructs in this layer of the model inherit from the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] Base Layer. Therefore, it is necessary to study both the inheritance and the relationship diagrams to understand the functionality of individual packages. In simple sub models these are shown in the same diagram but are omitted from the more complex sub models for the sake of clarity. In these cases, the inheritance diagram below shows the full inheritance tree for the classes concerned with data structure definitions.
9 +Many of the constructs in this layer of the model inherit from the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Base Layer. Therefore, it is necessary to study both the inheritance and the relationship diagrams to understand the functionality of individual packages. In simple sub models these are shown in the same diagram but are omitted from the more complex sub models for the sake of clarity. In these cases, the inheritance diagram below shows the full inheritance tree for the classes concerned with [[data structure definitions>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]].
10 10  
11 -There are very few additional classes in this sub model other than those shown in the inheritance diagram below. In other words, the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] Base gives most of the structure of this sub model both in terms of associations and in terms of [[attributes>>doc:Glossary.Attribute.WebHome]]. The relationship diagrams shown in this section show clearly when these associations are inherited from the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] Base (see the Appendix “A Short Guide to UML in the [[SDMX Information Model>>doc:Glossary.SDMX Information Model.WebHome]]” to see the diagrammatic notation used to depict this).
11 +There are very few additional classes in this sub model other than those shown in the inheritance diagram below. In other words, the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Base gives most of the [[structure>>doc:IMElements.structure.WebHome]] of this sub model both in terms of associations and in terms of [[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]. The relationship diagrams shown in this section show clearly when these associations are inherited from the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Base (see the Appendix “A Short Guide to UML in the [[SDMX Information Model>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]” to see the diagrammatic notation used to depict this).
12 12  
13 -The actual [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] Base construct from which the concrete classes inherit depends upon the requirements of the class for:
13 +The actual [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Base construct from which the concrete classes inherit depends upon the requirements of the class for:
14 14  
15 -[[Annotation>>doc:Glossary.Annotation.WebHome]] – //AnnotableArtefact//
16 -Identification – //IdentifiableArtefact//
17 -Naming – //NameableArtefact//
18 -Versioning – //VersionableArtefact//
19 -Maintenance – //MaintainableArtefact//
15 +[[Annotation>>doc:IMElements.Annotation.WebHome]] – //[[AnnotableArtefact>>doc:IMElements.AnnotableArtefact.WebHome]]//
16 +Identification – //[[IdentifiableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.WebHome]]//
17 +Naming – //[[NameableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.WebHome]]//
18 +Versioning – //[[VersionableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.WebHome]]//
19 +Maintenance – //[[MaintainableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.WebHome]]//
20 20  
21 21  == 5.2 Inheritance View ==
22 22  
23 23  === 5.2.1 Class Diagram ===
24 24  
25 -[[image:1749246368774-202.jpeg]]
26 -
27 27  [[image:image53.png]]
28 28  
29 29  **Figure 27 Class inheritance in the Data Structure Definition and Data Set Packages**
... ... @@ -32,66 +32,64 @@
32 32  
33 33  ==== 5.2.2.1 Narrative ====
34 34  
35 -Those classes in the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] metamodel which require [[annotations>>doc:Glossary.Annotation.WebHome]] inherit from //AnnotableArtefact//. These are:
33 +Those classes in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] metamodel which require annotations inherit from //[[AnnotableArtefact>>doc:IMElements.AnnotableArtefact.WebHome]]//. These are:
36 36  
37 -//IdentifiableArtefact
38 -[[DataSet>>doc:Glossary.Data set.WebHome]]
39 -Key// (and therefore //SeriesKey// and //GroupKey//)
40 -//Observation//
35 +//[[IdentifiableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.WebHome]]
36 +[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]
37 +[[Key>>doc:IMElements.AnnotableArtefact.Key.WebHome]]// (and therefore //[[SeriesKey>>doc:IMElements.AnnotableArtefact.Key.SeriesKey.WebHome]]// and //[[GroupKey>>doc:IMElements.AnnotableArtefact.Key.GroupKey.WebHome]]//)
38 +//[[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]]//
41 41  
42 -Those classes in the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] metamodel which require [[annotations>>doc:Glossary.Annotation.WebHome]] and global identity are derived from //IdentifiableArtefact//. These are:
40 +Those classes in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] metamodel which require annotations and global identity are derived from //[[IdentifiableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.WebHome]]//. These are:
43 43  
44 -//NameableArtefact
45 -ComponentList
46 -[[Component>>doc:Glossary.Component.WebHome]]//
42 +//[[NameableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.WebHome]]
43 +[[ComponentList>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.WebHome]]
44 +[[Component>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.WebHome]]//
47 47  
48 -Those classes in the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] metamodel which require [[annotations>>doc:Glossary.Annotation.WebHome]], global identity, multilingual name and multilingual description are derived from //NameableArtefact//. These are:
46 +Those classes in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] metamodel which require annotations, global identity, multilingual [[name>>doc:IMElements.name.WebHome]] and multilingual [[description>>doc:IMElements.description.WebHome]] are derived from //[[NameableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.WebHome]]//. These are:
49 49  
50 -//VersionableArtefact
51 -Item//
48 +//[[VersionableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.WebHome]]
49 +[[Item>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.WebHome]]//
52 52  
53 -The classes in the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] metamodel which require [[annotations>>doc:Glossary.Annotation.WebHome]], global identity, multilingual name and multilingual description, and versioning are derived from //VersionableArtefact//. These are:
51 +The classes in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] metamodel which require annotations, global identity, multilingual [[name>>doc:IMElements.name.WebHome]] and multilingual [[description>>doc:IMElements.description.WebHome]], and versioning are derived from //[[VersionableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.WebHome]]//. These are:
54 54  
55 -//MaintainableArtefact//
53 +//[[MaintainableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.WebHome]]//
56 56  
57 -Abstract classes which represent information that is maintained by [[Maintenance Agencies>>doc:Glossary.Maintenance agency.WebHome]] all inherit from //MaintainableArtefact//, they also inherit all the features of a //VersionableArtefact//, and are:
55 +Abstract classes which represent information that is maintained by [[Maintenance Agencies>>doc:sdmx:Glossary 2\.1.Maintenance agency.WebHome]] all inherit from //[[MaintainableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.WebHome]]//, they also inherit all the features of a //[[VersionableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.WebHome]]//, and are:
58 58  
59 -//StructureUsage
60 -Structure
61 -ItemScheme//
57 +//[[StructureUsage>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.WebHome]]
58 +[[Structure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.WebHome]]
59 +[[ItemScheme>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.ItemScheme.WebHome]]//
62 62  
63 63  All the above classes are abstract. The key to understanding the class diagrams presented in this section are the concrete classes that inherit from these abstract classes.
64 64  
65 -Those concrete classes in the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]] and [[Dataset>>doc:Glossary.Data set.WebHome]] packages of the metamodel which require to be maintained by Agencies all inherit (via other abstract classes) from //MaintainableArtefact//, these are:
63 +Those concrete classes in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] and [[Dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] packages of the metamodel which require to be maintained by Agencies all inherit (via other abstract classes) from //[[MaintainableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.WebHome]]//, these are:
66 66  
67 -[[Dataflow>>doc:Glossary.Dataflow.WebHome]]
68 -DataStructureDefinition
69 -The [[component>>doc:Glossary.Component.WebHome]] structures that are lists of lists, inherit directly from //Structure//. A //Structure// contains several lists of [[components>>doc:Glossary.Component.WebHome]]. The concrete class that inherits from //Structure// is:
70 -DataStructureDefinition
65 +[[Dataflow>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.Dataflow.WebHome]]
66 +[[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]]
67 +The component structures that are lists of lists, inherit directly from //[[Structure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.WebHome]]//. A //[[Structure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.WebHome]]// contains several lists of [[components>>doc:IMElements.components.WebHome]]. The concrete class that inherits from //[[Structure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.WebHome]]// is:
68 +[[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]]
71 71  
72 -A DataStructureDefinition contains a list of [[dimensions>>doc:Glossary.Dimension.WebHome]], a list of [[measures>>doc:Glossary.Measure.WebHome]] and a list of [[attributes>>doc:Glossary.Attribute.WebHome]].
70 +A [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] contains a list of [[dimensions>>doc:IMElements.dimensions.WebHome]], a list of [[measures>>doc:IMElements.measures.WebHome]] and a list of [[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]].
73 73  
74 -The concrete classes which inherit from //ComponentList// and are subcomponents of the DataStructureDefinition are:
72 +The concrete classes which inherit from //[[ComponentList>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.WebHome]]// and are subcomponents of the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] are:
75 75  
76 -DimensionDescriptor – content is [[Dimension>>doc:Glossary.Dimension.WebHome]] and TimeDimension
77 -DimensionGroupDescriptor – content is an association to [[Dimension>>doc:Glossary.Dimension.WebHome]], TimeDimension
78 -MeasureDescriptor – content is [[Measure>>doc:Glossary.Measure.WebHome]]
79 -AttributeDescriptor – content is DataAttribute and an association to MetadataAttribute
74 +[[DimensionDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.DimensionDescriptor.WebHome]] – content is [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] and [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]]
75 +DimensionGroupDescriptor – content is an association to [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]], [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]]
76 +[[MeasureDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.MeasureDescriptor.WebHome]] – content is [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]]
77 +[[AttributeDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.AttributeDescriptor.WebHome]] – content is [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] and an association to [[MetadataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.MetadataAttribute.WebHome]]
80 80  
81 -The classes that inherit from //[[Component>>doc:Glossary.Component.WebHome]]// are:
79 +The classes that inherit from //[[Component>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.WebHome]]// are:
82 82  
83 -[[Measure>>doc:Glossary.Measure.WebHome]]
84 -//DimensionComponent// and thereby its sub classes of [[Dimension>>doc:Glossary.Dimension.WebHome]] and TimeDimension
85 -//[[Attribute>>doc:Glossary.Attribute.WebHome]]// and thereby its sub classes of DataAttribute and MetadataAttribute
81 +[[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]]
82 +//[[DimensionComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.WebHome]]// and thereby its sub classes of [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] and [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]]
83 +//[[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]// and thereby its sub classes of [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] and [[MetadataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.MetadataAttribute.WebHome]]
86 86  
87 -The concrete classes identified above are the majority of the classes required to define the metamodel for the DataStructureDefinition. The diagrams and explanations in the rest of this section show how these concrete classes are related in order to support the functionality required.
85 +The concrete classes identified above are the majority of the classes required to define the metamodel for the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]]. The diagrams and explanations in the rest of this section show how these concrete classes are related in order to support the functionality required.
88 88  
89 89  == 5.3 Data Structure Definition – Relationship View ==
90 90  
91 91  === 5.3.1 Class Diagram ===
92 92  
93 -[[image:1749246368782-690.jpeg]]
94 -
95 95  [[image:image54.png]]
96 96  
97 97  **Figure 28 Relationship class diagram of the Data Structure Definition excluding representation**
... ... @@ -100,45 +100,43 @@
100 100  
101 101  ==== 5.3.2.1 Narrative ====
102 102  
103 -A DataStructureDefinition defines the [[Dimensions>>doc:Glossary.Dimension.WebHome]], TimeDimension, DataAttributes, and [[Measures>>doc:Glossary.Measure.WebHome]], and associated [[Representations>>doc:Glossary.Representation.WebHome]], that comprise the valid structure of data and related [[attributes>>doc:Glossary.Attribute.WebHome]] that are contained in a [[DataSet>>doc:Glossary.Data set.WebHome]], which is defined by a [[Dataflow>>doc:Glossary.Dataflow.WebHome]]. In addition, a DataStructureDefinition may be related to one MetadataStructureDefinition, in order to use the latter’s MetadataAttributes, by relating them to other //[[Components>>doc:Glossary.Component.WebHome]]// within the [[DSD>>doc:Glossary.Data structure definition.WebHome]], as explained below.
99 +A [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] defines the Dimensions, [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]], DataAttributes, and Measures, and associated Representations, that comprise the valid [[structure>>doc:IMElements.structure.WebHome]] of data and related [[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] that are contained in a [[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]], which is defined by a [[Dataflow>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.Dataflow.WebHome]]. In addition, a [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] may be related to one [[MetadataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.MetadataStructureDefinition.WebHome]], in order to use the latter’s MetadataAttributes, by relating them to other //Components// within the [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]], as explained below.
104 104  
105 -The [[Dataflow>>doc:Glossary.Dataflow.WebHome]] may also have additional metadata attached that define qualitative information and (% style="color:#e74c3c" %)[[Constraints>>doc:Glossary.Constraint.WebHome]](%%) on the use of the DataStructureDefinition such as the subset of [[Codes>>doc:Glossary.Code.WebHome]] used in a [[Dimension>>doc:Glossary.Dimension.WebHome]] (this is covered later in this document – see sections “(% style="color:#e74c3c" %)[[Constraints>>doc:Glossary.Constraint.WebHome]](%%)” and “Data Provisioning”). Each [[Dataflow>>doc:Glossary.Dataflow.WebHome]] has a maximum of one DataStructureDefinition specified which defines the structure of any [[DataSets>>doc:Glossary.Data set.WebHome]] to be reported/disseminated. A [[Dataflow>>doc:Glossary.Dataflow.WebHome]] may optionally define which [[Dimensions>>doc:Glossary.Dimension.WebHome]] it uses, by defining a DimensionConstraint (this is a mandatory requirement if the DataStructureDefinition sets its’ evolvingStructure property to ‘true’ and is sematically referenced by the [[Dataflow>>doc:Glossary.Dataflow.WebHome]]).
101 +The [[Dataflow>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.Dataflow.WebHome]] may also have additional [[metadata>>doc:IMElements.metadata.WebHome]] attached that define qualitative information and [[Constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] on the use of the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] such as the subset of Codes used in a [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] (this is covered later in this document – see sections “[[Constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]]” and “Data Provisioning”). Each [[Dataflow>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.Dataflow.WebHome]] has a maximum of one [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] specified which defines the [[structure>>doc:IMElements.structure.WebHome]] of any [[DataSets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] to be reported/disseminated. A [[Dataflow>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.Dataflow.WebHome]] may optionally define which Dimensions it uses, by defining a [[DimensionConstraint>>doc:IMElements.DimensionConstraint.WebHome]] (this is a mandatory requirement if the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] sets its’ [[evolvingStructure>>doc:IMElements.evolvingStructure.WebHome]] property to ‘true’ and is sematically referenced by the [[Dataflow>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.Dataflow.WebHome]]).
106 106  
107 -There are two types of [[dimensions>>doc:Glossary.Dimension.WebHome]] each having a common association to (% style="color:#e74c3c" %)[[Concept>>doc:Glossary.Concept.WebHome]](%%):
103 +There are two types of [[dimensions>>doc:IMElements.dimensions.WebHome]] each having a common association to [[Concept>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.Concept.WebHome]]:
108 108  
109 -* [[Dimension>>doc:Glossary.Dimension.WebHome]]
110 -* TimeDimension
105 +* [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]]
106 +* [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]]
111 111  
112 -Note that DimensionComponent can be any or all its sub classes i.e., [[Dimension>>doc:Glossary.Dimension.WebHome]], TimeDimension.
108 +Note that [[DimensionComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.WebHome]] can be any or all its sub classes i.e., [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]], [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]].
113 113  
114 -The //DimensionComponent//, DataAttribute, MetadataAttribute and [[Measure>>doc:Glossary.Measure.WebHome]] link to the (% style="color:#e74c3c" %)[[Concept>>doc:Glossary.Concept.WebHome]](%%) that defines its name and semantic (/conceptIdentity association to (% style="color:#e74c3c" %)[[Concept>>doc:Glossary.Concept.WebHome]](%%)). The DataAttribute, [[Dimension>>doc:Glossary.Dimension.WebHome]] (but not TimeDimension) and [[Measure>>doc:Glossary.Measure.WebHome]] can optionally have a +conceptRole association with a (% style="color:#e74c3c" %)[[Concept>>doc:Glossary.Concept.WebHome]](%%) that identifies its role in the DataStructureDefinition, or one of the standard pre-defined roles, i.e., those published in "GUIDELINES FOR [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] (% style="color:#e74c3c" %)[[CONCEPT>>doc:Glossary.Concept.WebHome]](%%) ROLES" by the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] SWG. The use of these roles is to enable applications to process the data in a meaningful way (e.g., relating a [[dimension>>doc:Glossary.Dimension.WebHome]] value to a mapping vector). It is expected, beyond the standard roles published by the SWG, that communities (such as the official statistics community) will harmonise such roles within their community so that data can be exchanged and shared in a meaningful way within that community.
110 +The //DimensionComponent//, DataAttribute, MetadataAttribute and [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] link to the (% style="color:#e74c3c" %)Concept(%%) that defines its name and semantic (/conceptIdentity association to (% style="color:#e74c3c" %)Concept(%%)). The DataAttribute, [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] (but not TimeDimension) and [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] can optionally have a +conceptRole association with a (% style="color:#e74c3c" %)Concept(%%) that identifies its role in the DataStructureDefinition, or one of the standard pre-defined roles, i.e., those published in "GUIDELINES FOR [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] (% style="color:#e74c3c" %)CONCEPT(%%) ROLES" by the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] SWG. The use of these roles is to enable applications to process the data in a meaningful way (e.g., relating a [[dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] value to a mapping vector). It is expected, beyond the standard roles published by the SWG, that communities (such as the official statistics community) will harmonise such roles within their community so that data can be exchanged and shared in a meaningful way within that community.
115 115  
116 -The valid values for a //DimensionComponent//, [[Measure>>doc:Glossary.Measure.WebHome]], DataAttribute or MetadataAttribute, when used in this DataStructureDefinition, are defined by the [[Representation>>doc:Glossary.Representation.WebHome]]. This [[Representation>>doc:Glossary.Representation.WebHome]] is taken from the (% style="color:#e74c3c" %)[[Concept>>doc:Glossary.Concept.WebHome]](%%) definition (coreRepresentation) unless it is overridden in this DataStructureDefinition (localRepresentation) – see Figure 28. Note also that TimeDimension is constrained to specific FacetValueTypes. Moreover, the [[Representations>>doc:Glossary.Representation.WebHome]] of MetadataAttributes are specified in the corresponding MetadataStructureDefinition, linked by the DataStructureDefinition.
112 +The valid values for a //DimensionComponent//, [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]], DataAttribute or MetadataAttribute, when used in this DataStructureDefinition, are defined by the [[Representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]]. This [[Representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] is taken from the (% style="color:#e74c3c" %)Concept(%%) definition (coreRepresentation) unless it is overridden in this DataStructureDefinition (localRepresentation) – see Figure 28. Note also that TimeDimension is constrained to specific FacetValueTypes. Moreover, the [[Representations>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] of MetadataAttributes are specified in the corresponding MetadataStructureDefinition, linked by the DataStructureDefinition.
117 117  
118 -There will always be a DimensionDescriptor grouping that identifies all of the [[Dimension>>doc:Glossary.Dimension.WebHome]] comprising the full key. Together the [[Dimensions>>doc:Glossary.Dimension.WebHome]] specify the key of an Observation.
114 +There will always be a DimensionDescriptor grouping that identifies all of the [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] comprising the full key. Together the [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] specify the key of an Observation.
119 119  
120 -The //DimensionComponent// can optionally be grouped by multiple GroupDimensionDescriptors each of which identifies the group of [[Dimensions>>doc:Glossary.Dimension.WebHome]] that can form a partial key. The GroupDimensionDescriptor must be identified (GroupDimensionDescriptor.id) and this is used in the GroupKey of the [[DataSet>>doc:Glossary.Data set.WebHome]] to declare which DataAttributes or MetadataAttributes are reported at this group level in the [[DataSet>>doc:Glossary.Data set.WebHome]].
116 +The //DimensionComponent// can optionally be grouped by multiple GroupDimensionDescriptors each of which identifies the group of [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] that can form a partial key. The GroupDimensionDescriptor must be identified (GroupDimensionDescriptor.id) and this is used in the GroupKey of the [[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] to declare which DataAttributes or MetadataAttributes are reported at this group (% style="color:#e74c3c" %)level(%%) in the [[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]].
121 121  
122 -There can be a maximum of one TimeDimension specified in the DimensionDescriptor. The TimeDimension is used to specify the (% style="color:#e74c3c" %)[[Concept>>doc:Glossary.Concept.WebHome]](%%) used to convey the [[time period>>doc:Glossary.Time period.WebHome]] of the observation in a [[data set>>doc:Glossary.Data set.WebHome]]. The TimeDimension must contain a valid [[representation>>doc:Glossary.Representation.WebHome]] of time and cannot be coded.
118 +There can be a maximum of one TimeDimension specified in the DimensionDescriptor. The TimeDimension is used to specify the (% style="color:#e74c3c" %)Concept(%%) used to convey the [[time period>>doc:sdmx:Glossary 2\.1.Time period.WebHome]] of the observation in a [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]. The TimeDimension must contain a valid [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] of time and cannot be coded.
123 123  
124 -There can be one or more [[Measures>>doc:Glossary.Measure.WebHome]] under the MeasureDescriptor. [[Measures>>doc:Glossary.Measure.WebHome]] represent the observable phenomena. Each [[Measure>>doc:Glossary.Measure.WebHome]] may have a valid [[representation>>doc:Glossary.Representation.WebHome]], a maxOccurs [[attribute>>doc:Glossary.Attribute.WebHome]] limiting the maximum number of values per [[Measure>>doc:Glossary.Measure.WebHome]] (which may be set to 'unbounded' for unlimited occurrences), as well as a minOccurs [[attribute>>doc:Glossary.Attribute.WebHome]], indicating the minimum required number of values, when the [[Measure>>doc:Glossary.Measure.WebHome]] is reported. If minOccurs or maxOccurs are omitted (they both default to ‘1’), the [[Measure>>doc:Glossary.Measure.WebHome]] is considered to take a single value; otherwise, it is an array. Moreover, the usage [[attribute>>doc:Glossary.Attribute.WebHome]] indicates whether a [[Measure>>doc:Glossary.Measure.WebHome]] must be reported or not, by the corresponding values: mandatory or optional.
120 +There can be one or more [[Measures>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] under the MeasureDescriptor. [[Measures>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] represent the observable phenomena. Each [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] may have a valid [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]], a maxOccurs [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] limiting the maximum number of values per [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] (which may be set to 'unbounded' for unlimited occurrences), as well as a minOccurs [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]], indicating the minimum required number of values, when the [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] is reported. If minOccurs or maxOccurs are omitted (they both default to ‘1’), the [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] is considered to take a single value; otherwise, it is an array. Moreover, the usage [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] indicates whether a [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] must be reported or not, by the corresponding values: mandatory or optional.
125 125  
126 -The AttributeDescriptor may contain one or more //[[Attribute>>doc:Glossary.Attribute.WebHome]]//s, i.e., at least one DataAttribute definition or one MetadataAttribute reference.
122 +The AttributeDescriptor may contain one or more //[[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]//s, i.e., at least one DataAttribute definition or one MetadataAttribute reference.
127 127  
128 -The DataAttribute defines a characteristic of data that are collected or disseminated and is grouped in the DataStructureDefinition by a single AttributeDescriptor. The DataAttribute can be indicated if it must be reported or not, by the corresponding value of the usage [[attribute>>doc:Glossary.Attribute.WebHome]]: i.e., mandatory or optional. The property minOccurs specifies the minimum number of array values to be included when the DataAttribute is reported. Moreover, a maxOccurs [[attribute>>doc:Glossary.Attribute.WebHome]] indicates whether the DataAttribute may need to report more than one values, i.e., an array of values. The DataAttribute may play a specific role in the structure and this is specified by the +role association to the [[Concept>>doc:Glossary.Concept.WebHome]] that identifies its role.
124 +The DataAttribute defines a characteristic of data that are collected or disseminated and is grouped in the DataStructureDefinition by a single AttributeDescriptor. The DataAttribute can be indicated if it must be reported or not, by the corresponding value of the usage [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]: i.e., mandatory or optional. The property minOccurs specifies the minimum number of array values to be included when the DataAttribute is reported. Moreover, a maxOccurs [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] indicates whether the DataAttribute may need to report more than one values, i.e., an array of values. The DataAttribute may play a specific role in the structure and this is specified by the +role association to the (% style="color:#e74c3c" %)Concept(%%) that identifies its role.
129 129  
130 -The MetadataAttribute defines [[reference metadata>>doc:Glossary.Reference metadata.WebHome]] that may be collected or disseminated and is grouped together with DataAttribute under the AttributeDescriptor.
126 +The MetadataAttribute defines [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] that may be collected or disseminated and is grouped together with DataAttribute under the AttributeDescriptor.
131 131  
132 -A DataAttribute or a MetadataAttribute (i.e., an //AttributeComponent//) is specified as being +relatedTo an AttributeRelationship, which defines the constructs to which the //AttributeComponent// is to be reported within a //[[DataSet>>doc:Glossary.Data set.WebHome]]//. An //AttributeComponent// can be specified as being related to one of the following [[artefacts>>doc:Glossary.Artefact.WebHome]]:
128 +A DataAttribute or a MetadataAttribute (i.e., an //AttributeComponent//) is specified as being +relatedTo an AttributeRelationship, which defines the constructs to which the //AttributeComponent// is to be reported within a //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]//. An //AttributeComponent// can be specified as being related to one of the following [[artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]]:
133 133  
134 -* All data within the [[dataset>>doc:Glossary.Data set.WebHome]] (DataflowRelationship) – this is equivalent to attaching an [[Attribute>>doc:Glossary.Attribute.WebHome]] to all data within the [[Dataflow>>doc:Glossary.Dataflow.WebHome]].
135 -* [[Dimension>>doc:Glossary.Dimension.WebHome]] or set of [[Dimensions>>doc:Glossary.Dimension.WebHome]] (DimensionRelationship)
136 -* Set of [[Dimensions>>doc:Glossary.Dimension.WebHome]] specified by a GroupKey (GroupRelationship – this is retained for compatibility reasons – or +groupKey of the DimensionRelationship)
130 +* All data within the [[dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] (DataflowRelationship) – this is equivalent to attaching an [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] to all data within the [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]].
131 +* [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] or set of [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] (DimensionRelationship)
132 +* Set of [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] specified by a GroupKey (GroupRelationship – this is retained for compatibility reasons – or +groupKey of the DimensionRelationship)
137 137  * Observation (ObservationRelationship)
138 -* In addition to the positioning of an //AttributeComponent// within a //[[DataSet>>doc:Glossary.Data set.WebHome]]//, another relationship indicates the [[Measure>>doc:Glossary.Measure.WebHome]](s) for which the //AttributeComponent// is reported. Regardless of the position of the //AttributeComponent// within the //[[DataSet>>doc:Glossary.Data set.WebHome]]//, the //AttributeComponent// may concern one, more than one, or all [[Measures>>doc:Glossary.Measure.WebHome]] included in the [[DSD>>doc:Glossary.Data structure definition.WebHome]]. This is expressed using the MeasureRelationship class, which relates a DataAttribute to one or more [[Measures>>doc:Glossary.Measure.WebHome]]. Lack of the MeasureRelationship defaults to a relationship to all [[Measures>>doc:Glossary.Measure.WebHome]].
134 +* In addition to the positioning of an //AttributeComponent// within a //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]//, another relationship indicates the [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]](s) for which the //AttributeComponent// is reported. Regardless of the position of the //AttributeComponent// within the //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]//, the //AttributeComponent// may concern one, more than one, or all [[Measures>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] included in the [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]. This is expressed using the MeasureRelationship class, which relates a DataAttribute to one or more [[Measures>>doc:sdmx:Glossary 2\.1.Measure.WebHome]]. Lack of the MeasureRelationship defaults to a relationship to all [[Measures>>doc:sdmx:Glossary 2\.1.Measure.WebHome]].
139 139  
140 -[[image:1749246368785-499.jpeg]]
141 -
142 142  [[image:image55.png]]
143 143  
144 144  **Figure 29: Attribute Attachment Defined in the Data Structure Definition**
... ... @@ -152,8 +152,6 @@
152 152  |Group|(% style="width:537px" %)The value of the [[Attribute>>doc:Glossary.Attribute.WebHome]] varies with combination of values for all of the [[Dimensions>>doc:Glossary.Dimension.WebHome]] contained in the Group. This is added as a convenience to listing all [[Dimensions>>doc:Glossary.Dimension.WebHome]] and the attachment Group, but should only be used when the [[Attribute>>doc:Glossary.Attribute.WebHome]] value varies based on all Group [[Dimension>>doc:Glossary.Dimension.WebHome]] values.|(% style="width:434px" %)The [[attribute>>doc:Glossary.Attribute.WebHome]] is reported at the level of Group.
153 153  |Observation|(% style="width:537px" %)The value of the [[Attribute>>doc:Glossary.Attribute.WebHome]] varies with the observed value.|(% style="width:434px" %)The [[attribute>>doc:Glossary.Attribute.WebHome]] is reported at the level of Observation.
154 154  
155 -[[image:1749246368790-555.jpeg]]
156 -
157 157  [[image:image56.png]]
158 158  
159 159  **Figure 30: Representation of DSD Components**
... ... @@ -254,7 +254,7 @@
254 254  
255 255  The explanation of the classes, [[attributes>>doc:Glossary.Attribute.WebHome]], and associations comprising the [[Representation>>doc:Glossary.Representation.WebHome]] is described in the section on the [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] Base.
256 256  
257 -==== //5.4 Data Set – Relationship View// ====
249 +== 5.4 Data Set – Relationship View ==
258 258  
259 259  === 5.4.1 Context ===
260 260  
... ... @@ -262,7 +262,7 @@
262 262  
263 263  === 5.4.2 Class Diagram ===
264 264  
265 -[[image:1749246368794-672.jpeg]]
257 +[[image:image57.png]]
266 266  
267 267  **Figure 31: Class Diagram of the Data Set**
268 268  
1749246368774-202.jpeg
Author
... ... @@ -1,1 +1,0 @@
1 -xwiki:XWiki.arturkryazhev
Size
... ... @@ -1,1 +1,0 @@
1 -57.3 KB
Content
1749246368782-690.jpeg
Author
... ... @@ -1,1 +1,0 @@
1 -xwiki:XWiki.arturkryazhev
Size
... ... @@ -1,1 +1,0 @@
1 -25.2 KB
Content
1749246368785-499.jpeg
Author
... ... @@ -1,1 +1,0 @@
1 -xwiki:XWiki.arturkryazhev
Size
... ... @@ -1,1 +1,0 @@
1 -42.8 KB
Content
1749246368790-555.jpeg
Author
... ... @@ -1,1 +1,0 @@
1 -xwiki:XWiki.arturkryazhev
Size
... ... @@ -1,1 +1,0 @@
1 -40.9 KB
Content
1749246368794-672.jpeg
Author
... ... @@ -1,1 +1,0 @@
1 -xwiki:XWiki.arturkryazhev
Size
... ... @@ -1,1 +1,0 @@
1 -77.8 KB
Content
image57.png
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.helena
Size
... ... @@ -1,0 +1,1 @@
1 +146.6 KB
Content
© Semantic R&D Group, 2026