Changes for page 5 Data Structure Definition and Dataset

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

From 28.2 to 28.1 From 28.7 to 28.6

From version 28.6

edited by Helena K.
on 2026/06/08 16:51

Change comment: There is no comment for this version

To version 28.2

edited by Helena K.
on 2026/06/08 16:45

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -4,20 +4,21 @@
  == 5.1 Introduction ==
--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: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.
++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 (also referred to as DSD) is used in this specification.
--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]].
++Many of the constructs in this layer of the model inherit from the SDMX 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.
--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 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).
++There are very few additional classes in this sub model other than those shown in the inheritance diagram below. In other words, the SDMX Base gives most of the structure of this sub model both in terms of associations and in terms of attributes. The relationship diagrams shown in this section show clearly when these associations are inherited from the SDMX Base (see the Appendix “A Short Guide to UML in the SDMX Information Model” to see the diagrammatic notation used to depict this).
--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:
++The actual SDMX Base construct from which the concrete classes inherit depends upon the requirements of the class for:
--[[Annotation>>doc:sdmx:Glossary 2\.1.Annotation.WebHome]] – //AnnotableArtefact//
++Annotation – //AnnotableArtefact//
  Identification – //IdentifiableArtefact//
  Naming – //NameableArtefact//
  Versioning – //VersionableArtefact//
  Maintenance – //MaintainableArtefact//
++
  == 5.2 Inheritance View ==
  === 5.2.1 Class Diagram ===
@@ -30,29 +30,29 @@
  ==== 5.2.2.1 Narrative ====
--Those classes in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] metamodel which require [[annotations>>doc:sdmx:Glossary 2\.1.Annotation.WebHome]] inherit from //AnnotableArtefact//. These are:
++Those classes in the SDMX metamodel which require annotations inherit from //AnnotableArtefact//. These are:
  //IdentifiableArtefact
--[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]
++DataSet
  Key// (and therefore //SeriesKey// and //GroupKey//)
  //Observation//
--Those classes in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] metamodel which require [[annotations>>doc:sdmx:Glossary 2\.1.Annotation.WebHome]] and global identity are derived from //IdentifiableArtefact//. These are:
++Those classes in the SDMX metamodel which require annotations and global identity are derived from //IdentifiableArtefact//. These are:
  //NameableArtefact
  ComponentList
--[[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]]//
++Component//
--Those classes in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] metamodel which require [[annotations>>doc:sdmx:Glossary 2\.1.Annotation.WebHome]], global identity, multilingual name and multilingual description are derived from //NameableArtefact//. These are:
++Those classes in the SDMX metamodel which require annotations, global identity, multilingual name and multilingual description are derived from //NameableArtefact//. These are:
  //VersionableArtefact
  Item//
--The classes in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] metamodel which require [[annotations>>doc:sdmx:Glossary 2\.1.Annotation.WebHome]], global identity, multilingual name and multilingual description, and versioning are derived from //VersionableArtefact//. These are:
++The classes in the SDMX metamodel which require annotations, global identity, multilingual name and multilingual description, and versioning are derived from //VersionableArtefact//. These are:
  //MaintainableArtefact//
--Abstract classes which represent information that is maintained by [[Maintenance Agencies>>doc:sdmx:Glossary 2\.1.Maintenance agency.WebHome]] all inherit from //MaintainableArtefact//, they also inherit all the features of a //VersionableArtefact//, and are:
++Abstract classes which represent information that is maintained by Maintenance Agencies all inherit from //MaintainableArtefact//, they also inherit all the features of a //VersionableArtefact//, and are:
  //StructureUsage
  Structure
@@ -60,27 +60,27 @@
  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.
--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//, these are:
++Those concrete classes in the SDMX Data Structure Definition and Dataset packages of the metamodel which require to be maintained by Agencies all inherit (via other abstract classes) from //MaintainableArtefact//, these are:
--[[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]
++Dataflow
  DataStructureDefinition
--The [[component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] structures that are lists of lists, inherit directly from //Structure//. A //Structure// contains several lists of [[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]]. The concrete class that inherits from //Structure// is:
++The component structures that are lists of lists, inherit directly from //Structure//. A //Structure// contains several lists of components. The concrete class that inherits from //Structure// is:
  DataStructureDefinition
--A DataStructureDefinition contains a list of [[dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]], a list of [[measures>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] and a list of [[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]].
++A DataStructureDefinition contains a list of dimensions, a list of measures and a list of attributes.
  The concrete classes which inherit from //ComponentList// and are subcomponents of the DataStructureDefinition are:
--DimensionDescriptor – content is [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] and TimeDimension
--DimensionGroupDescriptor – content is an association to [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]], TimeDimension
--MeasureDescriptor – content is [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]]
++DimensionDescriptor – content is Dimension and TimeDimension
++DimensionGroupDescriptor – content is an association to Dimension, TimeDimension
++MeasureDescriptor – content is Measure
  AttributeDescriptor – content is DataAttribute and an association to MetadataAttribute
--The classes that inherit from //[[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]]// are:
++The classes that inherit from //Component// are:
--[[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]]
--//DimensionComponent// and thereby its sub classes of [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] and TimeDimension
--//[[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]// and thereby its sub classes of DataAttribute and MetadataAttribute
++Measure
++//DimensionComponent// and thereby its sub classes of Dimension and TimeDimension
++//Attribute// and thereby its sub classes of DataAttribute and MetadataAttribute
  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.
@@ -96,42 +96,42 @@
  ==== 5.3.2.1 Narrative ====
--A DataStructureDefinition defines the [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]], TimeDimension, DataAttributes, and [[Measures>>doc:sdmx:Glossary 2\.1.Measure.WebHome]], and associated [[Representations>>doc:sdmx:Glossary 2\.1.Representation.WebHome]], that comprise the valid structure 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:sdmx:Glossary 2\.1.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:sdmx:Glossary 2\.1.Component.WebHome]]// within the [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]], as explained below.
++A DataStructureDefinition defines the Dimensions, TimeDimension, DataAttributes, and Measures, and associated Representations, that comprise the valid structure of data and related attributes that are contained in a DataSet, which is defined by a Dataflow. In addition, a DataStructureDefinition may be related to one MetadataStructureDefinition, in order to use the latter’s MetadataAttributes, by relating them to other //Components// within the DSD, as explained below.
--The [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] may also have additional metadata attached that define qualitative information and [[Constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] on the use of the DataStructureDefinition such as the subset of [[Codes>>doc:sdmx:Glossary 2\.1.Code.WebHome]] used in a [[Dimension>>doc:sdmx:Glossary 2\.1.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:sdmx:Glossary 2\.1.Dataflow.WebHome]] has a maximum of one DataStructureDefinition specified which defines the structure of any [[DataSets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] to be reported/disseminated. A [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] may optionally define which [[Dimensions>>doc:sdmx:Glossary 2\.1.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:sdmx:Glossary 2\.1.Dataflow.WebHome]]).
++The Dataflow may also have additional metadata attached that define qualitative information and Constraints on the use of the DataStructureDefinition such as the subset of Codes used in a Dimension (this is covered later in this document – see sections “Constraints” and “Data Provisioning”). Each Dataflow has a maximum of one DataStructureDefinition specified which defines the structure of any DataSets to be reported/disseminated. A Dataflow may optionally define which Dimensions 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).
--There are two types of [[dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] each having a common association to [[Concept>>doc:sdmx:Glossary 2\.1.Concept.WebHome]]:
++There are two types of dimensions each having a common association to Concept:
--* [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]
++* Dimension
  * TimeDimension
--Note that DimensionComponent can be any or all its sub classes i.e., [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]], TimeDimension.
++Note that DimensionComponent can be any or all its sub classes i.e., Dimension, TimeDimension.
--The //DimensionComponent//, DataAttribute, MetadataAttribute and [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] link to the [[Concept>>doc:sdmx:Glossary 2\.1.Concept.WebHome]] that defines its name and semantic (/conceptIdentity association to [[Concept>>doc:sdmx:Glossary 2\.1.Concept.WebHome]]). 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 [[Concept>>doc:sdmx:Glossary 2\.1.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:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] [[CONCEPT>>doc:sdmx:Glossary 2\.1.Concept.WebHome]] 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.
++The //DimensionComponent//, DataAttribute, MetadataAttribute and Measure link to the Concept that defines its name and semantic (/conceptIdentity association to Concept). The DataAttribute, Dimension (but not TimeDimension) and Measure can optionally have a +conceptRole association with a Concept that identifies its role in the DataStructureDefinition, or one of the standard pre-defined roles, i.e., those published in "GUIDELINES FOR SDMX CONCEPT ROLES" by the SDMX SWG. The use of these roles is to enable applications to process the data in a meaningful way (e.g., relating a dimension 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.
--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 [[Concept>>doc:sdmx:Glossary 2\.1.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:sdmx:Glossary 2\.1.Representation.WebHome]] of MetadataAttributes are specified in the corresponding MetadataStructureDefinition, linked by the DataStructureDefinition.
++The valid values for a //DimensionComponent//, Measure, DataAttribute or MetadataAttribute, when used in this DataStructureDefinition, are defined by the Representation. This Representation is taken from the 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 of MetadataAttributes are specified in the corresponding MetadataStructureDefinition, linked by the DataStructureDefinition.
--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.
++There will always be a DimensionDescriptor grouping that identifies all of the Dimension comprising the full key. Together the Dimensions specify the key of an Observation.
--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 level in the [[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]].
++The //DimensionComponent// can optionally be grouped by multiple GroupDimensionDescriptors each of which identifies the group of Dimensions that can form a partial key. The GroupDimensionDescriptor must be identified (GroupDimensionDescriptor.id) and this is used in the GroupKey of the DataSet to declare which DataAttributes or MetadataAttributes are reported at this group level in the DataSet.
--There can be a maximum of one TimeDimension specified in the DimensionDescriptor. The TimeDimension is used to specify the [[Concept>>doc:sdmx:Glossary 2\.1.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 must contain a valid [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] of time and cannot be coded.
++There can be a maximum of one TimeDimension specified in the DimensionDescriptor. The TimeDimension is used to specify the Concept used to convey the time period of the observation in a data set. The TimeDimension must contain a valid representation of time and cannot be coded.
--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.
++There can be one or more Measures under the MeasureDescriptor. Measures represent the observable phenomena. Each Measure may have a valid representation, a maxOccurs attribute limiting the maximum number of values per Measure (which may be set to 'unbounded' for unlimited occurrences), as well as a minOccurs attribute, indicating the minimum required number of values, when the Measure is reported. If minOccurs or maxOccurs are omitted (they both default to ‘1’), the Measure is considered to take a single value; otherwise, it is an array. Moreover, the usage attribute indicates whether a Measure must be reported or not, by the corresponding values: mandatory or optional.
--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.
++The AttributeDescriptor may contain one or more //Attribute//s, i.e., at least one DataAttribute definition or one MetadataAttribute reference.
--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 [[Concept>>doc:sdmx:Glossary 2\.1.Concept.WebHome]] that identifies its role.
++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: 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 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 that identifies its role.
--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.
++The MetadataAttribute defines reference metadata that may be collected or disseminated and is grouped together with DataAttribute under the AttributeDescriptor.
--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]]:
++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//. An //AttributeComponent// can be specified as being related to one of the following artefacts:
--* 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]].
--* [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] or set of [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] (DimensionRelationship)
--* 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)
++* All data within the dataset (DataflowRelationship) – this is equivalent to attaching an Attribute to all data within the Dataflow.
++* Dimension or set of Dimensions (DimensionRelationship)
++* Set of Dimensions specified by a GroupKey (GroupRelationship – this is retained for compatibility reasons – or +groupKey of the DimensionRelationship)
  * Observation (ObservationRelationship)
--* 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]].
++* In addition to the positioning of an //AttributeComponent// within a //DataSet//, another relationship indicates the Measure(s) for which the //AttributeComponent// is reported. Regardless of the position of the //AttributeComponent// within the //DataSet//, the //AttributeComponent// may concern one, more than one, or all Measures included in the DSD. This is expressed using the MeasureRelationship class, which relates a DataAttribute to one or more Measures. Lack of the MeasureRelationship defaults to a relationship to all Measures.
  [[image:image55.png]]
@@ -141,10 +141,10 @@
  (% style="width:1142.83px" %)
  |**Relationship**|(% style="width:537px" %)**Meaning**|(% style="width:434px" %)**Location in Data Set at which the Attribute is reported**
--|DataflowRelationship|(% style="width:537px" %)The value 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 applies to all data defined by the underlying [[Dataflow>>doc:sdmx:Glossary 2\.1.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.
--|[[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] (1..n)|(% style="width:537px" %)The value of the [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] will vary with the value(s) of the referenced [[Dimension>>doc:sdmx:Glossary 2\.1.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 (% style="color:#e74c3c" %)l(%%)evel of the [[Dimension>>doc:sdmx:Glossary 2\.1.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.
--|Group|(% style="width:537px" %)The value of the [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] varies with combination of values for all of the [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] contained in the Group. This is added as a convenience to listing all [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] and the attachment Group, but should only be used when the [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] value varies based on all Group [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] values.|(% style="width:434px" %)The [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is reported at the level of Group.
--|Observation|(% style="width:537px" %)The value of the [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] varies with the observed value.|(% style="width:434px" %)The [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is reported at the level of Observation.
++|DataflowRelationship|(% style="width:537px" %)The value of the attribute is fixed for all data contained in the dataset. The Attribute value applies to all data defined by the underlying Dataflow.|(% style="width:434px" %)The attribute is reported at the Dataset level.
++|Dimension (1..n)|(% style="width:537px" %)The value of the attribute will vary with the value(s) of the referenced Dimension(s). In this case, Group(s) to which the attribute should be attached may optionally be specified.|(% style="width:434px" %)The attribute is reported at the lowest level of the Dimension to which the Attribute is related, otherwise at the level of the Group if Attachment Group(s) is specified.
++|Group|(% style="width:537px" %)The value of the Attribute 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 value varies based on all Group Dimension values.|(% style="width:434px" %)The attribute is reported at the level of Group.
++|Observation|(% style="width:537px" %)The value of the Attribute varies with the observed value.|(% style="width:434px" %)The attribute is reported at the level of Observation.
  [[image:image56.png]]