Changes for page 5 Data Structure Definition and Dataset

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

From 28.4 to 28.3 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.4

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

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -107,21 +107,21 @@
  Note that DimensionComponent can be any or all its sub classes i.e., [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]], 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>>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.
--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>>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.
  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.
--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>>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]].
--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 (% 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.
  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.
  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 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>>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.
  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.
@@ -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]]