Last modified by Helena K. on 2026/06/08 16:58

From version 23.4
edited by Helena K.
on 2026/06/04 21:19
Change comment: There is no comment for this version
To version 22.1
edited by Helena K.
on 2026/04/16 15:43
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -4,19 +4,19 @@
4 4  
5 5  == 5.1 Introduction ==
6 6  
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.
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.
8 8  
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]].
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.
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: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).
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).
12 12  
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:
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:
14 14  
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]]//
15 +[[Annotation>>doc:Glossary.Annotation.WebHome]] – //AnnotableArtefact//
16 +Identification – //IdentifiableArtefact//
17 +Naming – //NameableArtefact//
18 +Versioning – //VersionableArtefact//
19 +Maintenance – //MaintainableArtefact//
20 20  
21 21  == 5.2 Inheritance View ==
22 22  
... ... @@ -30,59 +30,59 @@
30 30  
31 31  ==== 5.2.2.1 Narrative ====
32 32  
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:
33 +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:
34 34  
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]]//
35 +//IdentifiableArtefact
36 +[[DataSet>>doc:Glossary.Data set.WebHome]]
37 +Key// (and therefore //SeriesKey// and //GroupKey//)
38 +//Observation//
39 39  
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:
40 +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:
41 41  
42 -//[[NameableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.WebHome]]
43 -[[ComponentList>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.WebHome]]
44 -[[Component>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.WebHome]]//
42 +//NameableArtefact
43 +ComponentList
44 +[[Component>>doc:Glossary.Component.WebHome]]//
45 45  
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:
46 +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:
47 47  
48 -//[[VersionableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.WebHome]]
49 -[[Item>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.WebHome]]//
48 +//VersionableArtefact
49 +Item//
50 50  
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:
51 +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:
52 52  
53 -//[[MaintainableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.WebHome]]//
53 +//MaintainableArtefact//
54 54  
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:
55 +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:
56 56  
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]]//
57 +//StructureUsage
58 +Structure
59 +ItemScheme//
60 60  
61 61  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.
62 62  
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:
63 +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:
64 64  
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]]
65 +[[Dataflow>>doc:Glossary.Dataflow.WebHome]]
66 +DataStructureDefinition
67 +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:
68 +DataStructureDefinition
69 69  
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]].
70 +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]].
71 71  
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:
72 +The concrete classes which inherit from //ComponentList// and are subcomponents of the DataStructureDefinition are:
73 73  
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]]
74 +DimensionDescriptor – content is [[Dimension>>doc:Glossary.Dimension.WebHome]] and TimeDimension
75 +DimensionGroupDescriptor – content is an association to [[Dimension>>doc:Glossary.Dimension.WebHome]], TimeDimension
76 +MeasureDescriptor – content is [[Measure>>doc:Glossary.Measure.WebHome]]
77 +AttributeDescriptor – content is DataAttribute and an association to MetadataAttribute
78 78  
79 -The classes that inherit from //[[Component>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.WebHome]]// are:
79 +The classes that inherit from //[[Component>>doc:Glossary.Component.WebHome]]// are:
80 80  
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]]
81 +[[Measure>>doc:Glossary.Measure.WebHome]]
82 +//DimensionComponent// and thereby its sub classes of [[Dimension>>doc:Glossary.Dimension.WebHome]] and TimeDimension
83 +//[[Attribute>>doc:Glossary.Attribute.WebHome]]// and thereby its sub classes of DataAttribute and MetadataAttribute
84 84  
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.
85 +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.
86 86  
87 87  == 5.3 Data Structure Definition – Relationship View ==
88 88  
... ... @@ -96,55 +96,55 @@
96 96  
97 97  ==== 5.3.2.1 Narrative ====
98 98  
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.
99 +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.
100 100  
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]]).
101 +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]]).
102 102  
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]]:
103 +There are two types of [[dimensions>>doc:Glossary.Dimension.WebHome]] each having a common association to (% style="color:#e74c3c" %)[[Concept>>doc:Glossary.Concept.WebHome]](%%):
104 104  
105 -* [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]]
106 -* [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]]
105 +* [[Dimension>>doc:Glossary.Dimension.WebHome]]
106 +* TimeDimension
107 107  
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]].
108 +Note that DimensionComponent can be any or all its sub classes i.e., [[Dimension>>doc:Glossary.Dimension.WebHome]], TimeDimension.
109 109  
110 -The //[[DimensionComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.WebHome]]//, [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]], [[MetadataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.MetadataAttribute.WebHome]] and [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]] link to the [[Concept>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.Concept.WebHome]] that defines its [[name>>doc:IMElements.name.WebHome]] and semantic (/conceptIdentity association to [[Concept>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.Concept.WebHome]]). The [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]], [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] (but not [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]]) and [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]] can optionally have a +conceptRole association with a [[Concept>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.Concept.WebHome]] that identifies its [[role>>doc:IMElements.role.WebHome]] in the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]], or one of the standard pre-defined roles, i.e., those published in "GUIDELINES FOR SDMX 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 [[value>>doc:IMElements.value.WebHome]] 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: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.
111 111  
112 -The valid values for a //[[DimensionComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.WebHome]]//, [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]], [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] or [[MetadataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.MetadataAttribute.WebHome]], when used in this [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]], are defined by the [[Representation>>doc:IMElements.Representation.WebHome]]. This [[Representation>>doc:IMElements.Representation.WebHome]] is taken from the [[Concept>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.Concept.WebHome]] definition ([[coreRepresentation>>doc:IMElements.coreRepresentation.WebHome]]) unless it is overridden in this [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] ([[localRepresentation>>doc:IMElements.localRepresentation.WebHome]]) – see Figure 28. Note also that [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]] is constrained to specific FacetValueTypes. Moreover, the Representations of MetadataAttributes are specified in the corresponding [[MetadataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.MetadataStructureDefinition.WebHome]], linked by the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]].
112 +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.
113 113  
114 -There will always be a [[DimensionDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.DimensionDescriptor.WebHome]] [[grouping>>doc:IMElements.grouping.WebHome]] that identifies all of the [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] comprising the full key. Together the Dimensions specify the key of an [[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]].
114 +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.
115 115  
116 -The //[[DimensionComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.WebHome]]// can optionally be grouped by multiple GroupDimensionDescriptors each of which identifies the group of Dimensions that can form a partial key. The [[GroupDimensionDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.GroupDimensionDescriptor.WebHome]] must be identified ([[GroupDimensionDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.GroupDimensionDescriptor.WebHome]].id) and this is used in the [[GroupKey>>doc:IMElements.AnnotableArtefact.Key.GroupKey.WebHome]] of the [[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] to declare which DataAttributes or MetadataAttributes are reported at this group level in the [[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]].
116 +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]].
117 117  
118 -There can be a maximum of one [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]] specified in the [[DimensionDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.DimensionDescriptor.WebHome]]. The [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]] is used to specify the [[Concept>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.Concept.WebHome]] 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>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]] must contain a valid representation 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>>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.
119 119  
120 -There can be one or more Measures under the [[MeasureDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.MeasureDescriptor.WebHome]]. Measures represent the observable phenomena. Each [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]] may have a valid representation, a [[maxOccurs>>doc:IMElements.maxOccurs.WebHome]] [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] limiting the maximum number of values per [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]] (which may be set to 'unbounded' for unlimited occurrences), as well as a [[minOccurs>>doc:IMElements.minOccurs.WebHome]] [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]], indicating the minimum required number of values, when the [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]] is reported. If [[minOccurs>>doc:IMElements.minOccurs.WebHome]] or [[maxOccurs>>doc:IMElements.maxOccurs.WebHome]] are omitted (they both default to ‘1’), the [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]] is considered to take a single [[value>>doc:IMElements.value.WebHome]]; otherwise, it is an array. Moreover, the usage [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] indicates whether a [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]] must be reported or not, by the corresponding values: mandatory or optional.
120 +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.
121 121  
122 -The [[AttributeDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.AttributeDescriptor.WebHome]] may contain one or more //[[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]//s, i.e., at least one [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] definition or one [[MetadataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.MetadataAttribute.WebHome]] reference.
122 +The AttributeDescriptor may contain one or more //[[Attribute>>doc:Glossary.Attribute.WebHome]]//s, i.e., at least one DataAttribute definition or one MetadataAttribute reference.
123 123  
124 -The [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] defines a characteristic of data that are collected or disseminated and is grouped in the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] by a single [[AttributeDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.AttributeDescriptor.WebHome]]. The [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] can be indicated if it must be reported or not, by the corresponding [[value>>doc:IMElements.value.WebHome]] of the usage [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]: i.e., mandatory or optional. The property [[minOccurs>>doc:IMElements.minOccurs.WebHome]] specifies the minimum number of array values to be included when the [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] is reported. Moreover, a [[maxOccurs>>doc:IMElements.maxOccurs.WebHome]] [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] indicates whether the [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] may need to report more than one values, i.e., an array of values. The [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] may play a specific [[role>>doc:IMElements.role.WebHome]] in the [[structure>>doc:IMElements.structure.WebHome]] and this is specified by the +[[role>>doc:IMElements.role.WebHome]] association to the [[Concept>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.Concept.WebHome]] that identifies its [[role>>doc:IMElements.role.WebHome]].
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: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.
125 125  
126 -The [[MetadataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.MetadataAttribute.WebHome]] defines [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] that may be collected or disseminated and is grouped together with [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] under the [[AttributeDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.AttributeDescriptor.WebHome]].
126 +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.
127 127  
128 -A [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] or a [[MetadataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.MetadataAttribute.WebHome]] (i.e., an //[[AttributeComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.WebHome]]//) is specified as being +[[relatedTo>>doc:IMElements.relatedTo.WebHome]] an [[AttributeRelationship>>doc:IMElements.AttributeRelationship.WebHome]], which defines the constructs to which the //[[AttributeComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.WebHome]]// is to be reported within a //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]//. An //[[AttributeComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.WebHome]]// can be specified as being related to one of the following [[artefacts>>doc:sdmx:Glossary 2\.1.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:Glossary.Data set.WebHome]]//. An //AttributeComponent// can be specified as being related to one of the following [[artefacts>>doc:Glossary.Artefact.WebHome]]:
129 129  
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:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.Dataflow.WebHome]].
131 -* [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] or set of Dimensions ([[DimensionRelationship>>doc:IMElements.AttributeRelationship.DimensionRelationship.WebHome]])
132 -* Set of Dimensions specified by a [[GroupKey>>doc:IMElements.AnnotableArtefact.Key.GroupKey.WebHome]] ([[GroupRelationship>>doc:IMElements.AttributeRelationship.GroupRelationship.WebHome]] – this is retained for compatibility reasons – or +[[groupKey>>doc:IMElements.groupKey.WebHome]] of the [[DimensionRelationship>>doc:IMElements.AttributeRelationship.DimensionRelationship.WebHome]])
133 -* [[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]] ([[ObservationRelationship>>doc:IMElements.AttributeRelationship.ObservationRelationship.WebHome]])
134 -* In addition to the positioning of an //[[AttributeComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.WebHome]]// within a //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]//, another relationship indicates the [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]](s) for which the //[[AttributeComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.WebHome]]// is reported. Regardless of the position of the //[[AttributeComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.WebHome]]// within the //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]//, the //[[AttributeComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.WebHome]]// may concern one, more than one, or all Measures included in the [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]. This is expressed using the [[MeasureRelationship>>doc:IMElements.AttributeRelationship.MeasureRelationship.WebHome]] class, which relates a [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] to one or more Measures. Lack of the [[MeasureRelationship>>doc:IMElements.AttributeRelationship.MeasureRelationship.WebHome]] defaults to a relationship to all Measures.
130 +* 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]].
131 +* [[Dimension>>doc:Glossary.Dimension.WebHome]] or set of [[Dimensions>>doc:Glossary.Dimension.WebHome]] (DimensionRelationship)
132 +* Set of [[Dimensions>>doc:Glossary.Dimension.WebHome]] specified by a GroupKey (GroupRelationship – this is retained for compatibility reasons – or +groupKey of the DimensionRelationship)
133 +* Observation (ObservationRelationship)
134 +* 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]].
135 135  
136 136  [[image:image55.png]]
137 137  
138 138  **Figure 29: Attribute Attachment Defined in the Data Structure Definition**
139 139  
140 -The following table details the possible relationships a [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] may specify. Note that these relationships are mutually exclusive, and therefore only one of the following is possible.
140 +The following table details the possible relationships a DataAttribute may specify. Note that these relationships are mutually exclusive, and therefore only one of the following is possible.
141 141  
142 142  (% style="width:1142.83px" %)
143 143  |**Relationship**|(% style="width:537px" %)**Meaning**|(% style="width:434px" %)**Location in Data Set at which the Attribute is reported**
144 -|DataflowRelationship|(% style="width:537px" %)The [[value>>doc:IMElements.value.WebHome]] of the [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is fixed for all data contained in the [[dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]. The [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] [[value>>doc:IMElements.value.WebHome]] applies to all data defined by the underlying [[Dataflow>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.Dataflow.WebHome]].|(% style="width:434px" %)The [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is reported at the [[Dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] level.
145 -|[[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] (1..n)|(% style="width:537px" %)The [[value>>doc:IMElements.value.WebHome]] of the [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] will vary with the [[value>>doc:IMElements.value.WebHome]](s) of the referenced [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]](s). In this case, Group(s) to which the [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] should be attached may optionally be specified.|(% style="width:434px" %)The [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is reported at the lowest level of the [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] to which the [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is related, otherwise at the level of the Group if Attachment Group(s) is specified.
146 -|Group|(% style="width:537px" %)The [[value>>doc:IMElements.value.WebHome]] of the [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] varies with combination of values for all of the Dimensions contained in the Group. This is added as a convenience to listing all Dimensions and the attachment Group, but should only be used when the [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] [[value>>doc:IMElements.value.WebHome]] varies based on all Group [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] values.|(% style="width:434px" %)The [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is reported at the level of Group.
147 -|[[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]]|(% style="width:537px" %)The [[value>>doc:IMElements.value.WebHome]] of the [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] varies with the observed [[value>>doc:IMElements.value.WebHome]].|(% style="width:434px" %)The [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is reported at the level of [[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]].
144 +|DataflowRelationship|(% style="width:537px" %)The value of the [[attribute>>doc:Glossary.Attribute.WebHome]] is fixed for all data contained in the [[dataset>>doc:Glossary.Data set.WebHome]]. The [[Attribute>>doc:Glossary.Attribute.WebHome]] value applies to all data defined by the underlying [[Dataflow>>doc:Glossary.Dataflow.WebHome]].|(% style="width:434px" %)The [[attribute>>doc:Glossary.Attribute.WebHome]] is reported at the [[Dataset>>doc:Glossary.Data set.WebHome]] level.
145 +|[[Dimension>>doc:Glossary.Dimension.WebHome]] (1..n)|(% style="width:537px" %)The value of the [[attribute>>doc:Glossary.Attribute.WebHome]] will vary with the value(s) of the referenced [[Dimension>>doc:Glossary.Dimension.WebHome]](s). In this case, Group(s) to which the [[attribute>>doc:Glossary.Attribute.WebHome]] should be attached may optionally be specified.|(% style="width:434px" %)The [[attribute>>doc:Glossary.Attribute.WebHome]] is reported at the lowest level of the [[Dimension>>doc:Glossary.Dimension.WebHome]] to which the [[Attribute>>doc:Glossary.Attribute.WebHome]] is related, otherwise at the level of the Group if Attachment Group(s) is specified.
146 +|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.
147 +|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.
148 148  
149 149  [[image:image56.png]]
150 150  
... ... @@ -246,7 +246,7 @@
246 246  
247 247  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.
248 248  
249 -== 5.4 Data Set – Relationship View ==
249 +==== //5.4 Data Set – Relationship View// ====
250 250  
251 251  === 5.4.1 Context ===
252 252  
© Semantic R&D Group, 2026