Changes for page 5 Data Structure Definition and Dataset

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

From 28.7 to 28.8 From 28.12 to 29.1

From version 28.8

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

Change comment: There is no comment for this version

To version 28.12

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

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -173,22 +173,22 @@
  Inherits from
  //ComponentList//
  )))|(% style="width:538px" %)A set of metadata concepts that define a partial key derived from the [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] Descriptor in a [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]].
--|(% style="width:204px" %) |(% style="width:236px" %)/[[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]]|(% style="width:538px" %)An association to the [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] [[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]] that comprise the group.
++|(% style="width:204px" %) |(% style="width:236px" %)/components|(% style="width:538px" %)An association to the [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] [[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]] that comprise the group.
  |(% style="width:204px" %)DimensionDescriptor|(% style="width:236px" %)(((
  Inherits from
  //ComponentList//
  )))|(% style="width:538px" %)An ordered set of metadata concepts that, combined, classify a statistical [[series>>doc:sdmx:Glossary 2\.1.Series.WebHome]], and whose values, when combined (the key) in an instance such as a [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]], uniquely identify a specific observation.
--|(% style="width:204px" %) |(% style="width:236px" %)/[[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]]|(% style="width:538px" %)An association to the [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] and Time [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] comprising the Key Descriptor.
++|(% style="width:204px" %) |(% style="width:236px" %)/components|(% style="width:538px" %)An association to the [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] and Time [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] comprising the Key Descriptor.
  |(% style="width:204px" %)AttributeDescriptor|(% style="width:236px" %)(((
  Inherits from
  //ComponentList//
  )))|(% style="width:538px" %)A set metadata concepts that define the [[Attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] of a [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]].
--|(% style="width:204px" %) |(% style="width:236px" %)/[[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]]|(% style="width:538px" %)An association to a Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] [[component>>doc:sdmx:Glossary 2\.1.Component.WebHome]].
++|(% style="width:204px" %) |(% style="width:236px" %)/components|(% style="width:538px" %)An association to a Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] [[component>>doc:sdmx:Glossary 2\.1.Component.WebHome]].
  |(% style="width:204px" %)MeasureDescriptor|(% style="width:236px" %)(((
  Inherits from
  //ComponentList//
  )))|(% style="width:538px" %)A metadata concept that defines the [[Measures>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] of a [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]].
--|(% style="width:204px" %) |(% style="width:236px" %)/[[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]]|(% style="width:538px" %)An association to a [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] [[component>>doc:sdmx:Glossary 2\.1.Component.WebHome]].
++|(% style="width:204px" %) |(% style="width:236px" %)/components|(% style="width:538px" %)An association to a [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] [[component>>doc:sdmx:Glossary 2\.1.Component.WebHome]].
  |(% style="width:204px" %)//DimensionComponent//|(% style="width:236px" %)(((
  Inherits from
  //[[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]]//
@@ -235,10 +235,10 @@
  |(% style="width:211px" %)GroupRelationship|(% style="width:235px" %) |(% style="width:534px" %)The Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is related to a Group [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] Descriptor construct.
  |(% style="width:211px" %) |(% style="width:235px" %)+groupKey|(% style="width:534px" %)An association to the Group [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] Descriptor
  |(% style="width:211px" %)DimensionRelationship|(% style="width:235px" %) |(% style="width:534px" %)The Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is related to a set of [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]].
--|(% style="width:211px" %) |(% style="width:235px" %)+[[dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]|(% style="width:534px" %)Association to the set of [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] to which the Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is related.
++|(% style="width:211px" %) |(% style="width:235px" %)+dimensions|(% style="width:534px" %)Association to the set of [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] to which the Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is related.
  |(% style="width:211px" %) |(% style="width:235px" %)+groupKey|(% style="width:534px" %)Association to the Group [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] Descriptor which specifies the set of [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] to which the Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is attached.
  |(% style="width:211px" %)MeasureRelationship|(% style="width:235px" %) |(% style="width:534px" %)The [[Measures>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] that a Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is reported for.
--|(% style="width:211px" %) |(% style="width:235px" %)+[[measures>>doc:sdmx:Glossary 2\.1.Measure.WebHome]]|(% style="width:534px" %)Association to the set of [[Measures>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] to which a Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is related to.
++|(% style="width:211px" %) |(% style="width:235px" %)+measures|(% style="width:534px" %)Association to the set of [[Measures>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] to which a Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is related to.
  |(% style="width:211px" %)SentinelValuesType|(% style="width:235px" %) |(% style="width:534px" %)This [[facet>>doc:sdmx:Glossary 2\.1.Facet.WebHome]] indicates that an [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] or a [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] has sentinel values with special meaning within their data type. This is realised by providing such values within the TextFormat, in addition to any textType or other [[Facet>>doc:sdmx:Glossary 2\.1.Facet.WebHome]].
  |(% style="width:211px" %)SentinelValue|(% style="width:235px" %) |(% style="width:534px" %)A value that has a special meaning within the text format [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] of the [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]].
  |(% style="width:211px" %) |(% style="width:235px" %)+name|(% style="width:534px" %)An association of a Sentinel Value to a multilingual name.
@@ -250,7 +250,7 @@
  === 5.4.1 Context ===
--A data set comprises the collection of data values and associated metadata that are collected or disseminated according to a known DataStructureDefinition.
++A [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] comprises the collection of data values and associated metadata that are collected or disseminated according to a known DataStructureDefinition.
  === 5.4.2 Class Diagram ===
@@ -262,23 +262,23 @@
  ==== 5.4.3.1 Narrative – Data Set ====
--Note that the //DataSet// must conform to the DataStructureDefinition associated to the Dataflow for which this DataSet is an “instance of data”. Whilst the model shows the association to the classes of the DataStructureDefinition, this is for conceptual purposes to show the link to the DataStructureDefinition. In the actual //DataSet// as exchanged there must, of course, be a reference to the DataStructureDefinition and optionally a Dataflow or a ProvisionAgreement, but the DataStructureDefinition is not necessarily exchanged with the data. Therefore, the DataStructureDefinition classes are shown in the grey areas, as these are not a part of the //DataSet// when the //DataSet// is exchanged. However, the structural metadata in the DataStructureDefinition can be used by an application to validate the contents of the //DataSet// in terms of the valid content of a //KeyValue// as defined by the Representation in the DataStructureDefinition.
++Note that the //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]// must conform to the DataStructureDefinition associated to the [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] for which this [[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] is an “instance of data”. Whilst the model shows the association to the classes of the DataStructureDefinition, this is for conceptual purposes to show the link to the DataStructureDefinition. In the actual //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]// as exchanged there must, of course, be a reference to the DataStructureDefinition and optionally a [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] or a ProvisionAgreement, but the DataStructureDefinition is not necessarily exchanged with the data. Therefore, the DataStructureDefinition classes are shown in the grey areas, as these are not a part of the //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]// when the //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]// is exchanged. However, the [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] in the DataStructureDefinition can be used by an application to validate the contents of the //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]// in terms of the valid content of a //KeyValue// as defined by the [[Representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] in the DataStructureDefinition.
--An organisation playing the role of DataProvider can be responsible for one or more //DataSet//.
++An organisation playing the role of DataProvider can be responsible for one or more //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]//.
--A //DataSet// is formatted as a DataStructureDefinition specific data set (StructureSpecificDataSet). The structured data set is structured according to one specific DataStructureDefinition; hence the latter is required for validation at the syntax level.
++A //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]// is formatted as a DataStructureDefinition specific [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] (StructureSpecificDataSet). The structured [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] is structured according to one specific DataStructureDefinition; hence the latter is required for validation at the syntax level.
--A //DataSet// is a collection of a set of //Observation//s that share the same dimensionality, which is specified by a set of unique components (Dimension, TimeDimension) defined in the DimensionDescriptor of the DataStructureDefinition, together with associated //AttributeValue//s that define specific characteristics about the artefact to which it is attached – //Observation//s, set of Dimensions. It can be structured in terms of a SeriesKey to which //Observation//s are reported.
++A //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]// is a collection of a set of //Observation//s that share the same dimensionality, which is specified by a set of unique [[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]] ([[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]], TimeDimension) defined in the DimensionDescriptor of the DataStructureDefinition, together with associated //AttributeValue//s that define specific characteristics about the [[artefact>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] to which it is attached – //Observation//s, set of [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]. It can be structured in terms of a SeriesKey to which //Observation//s are reported.
--The //Observation// can be the value(s) of the variable(s) being measured for the Concept associated to the Measure(s) in the MeasureDescriptor of the DataStructureDefinition. Each //Observation// associates one or more //ObservationValue//s with a KeyValue (+observationDimension) which is the value for the “Dimension at the Observation Level”. Any Dimension can be specified as being the “Dimension at the Observation Level”, and this specification is made at the level of the //DataSet// (i.e., it must be the same Dimension for the entire //DataSet//).
++The //Observation// can be the value(s) of the variable(s) being measured for the [[Concept>>doc:sdmx:Glossary 2\.1.Concept.WebHome]] associated to the Measure(s) in the MeasureDescriptor of the DataStructureDefinition. Each //Observation// associates one or more //ObservationValue//s with a KeyValue (+observationDimension) which is the value for the “[[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] at the Observation Level”. Any [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] can be specified as being the “[[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] at the Observation Level”, and this specification is made at the level of the //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]// (i.e., it must be the same [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] for the entire //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]//).
--The //KeyValue// is a value for one of TimeDimension or Dimension specified in the DataStructureDefinition. If it is a Dimension, it can be coded (CodedKeyValue) or uncoded (UncodedKeyValue). If it is the TimeDimension then it is a TimeKeyValue. The actual value that the CodedDimensionValue can take must be one of the Codes in the Codelist specified as the Representation of the Dimension in the DataStructureDefinition.
++The //KeyValue// is a value for one of TimeDimension or [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] specified in the DataStructureDefinition. If it is a [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]], it can be coded (CodedKeyValue) or uncoded (UncodedKeyValue). If it is the TimeDimension then it is a TimeKeyValue. The actual value that the CodedDimensionValue can take must be one of the [[Codes>>doc:sdmx:Glossary 2\.1.Code.WebHome]] in the [[Codelist>>doc:sdmx:Glossary 2\.1.Code list.WebHome]] specified as the [[Representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] of the [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] in the DataStructureDefinition.
  An ObservationValue can be coded – this is the CodedObservation – or it can be uncoded – this is the UncodedObservation. In the case of uncoded observations, the values may be multilingual – expressed via the TextMeasureValue – or not (OtherUncodedMeasureValue).
--The GroupKey is a subunit of the //Key// that has the same dimensionality as the SeriesKey but defines a subset of the KeyValues of the SeriesKey. Its sub dimension structure is defined in the GroupDimensionDescriptor of the DataStructureDefinition identified by the same id as the GroupKey. The id identifies a “type” of group and the purpose of the GroupKey is to report one or more //AttributeValue// that are contained at this group level. The GroupKey is present when the GroupDimensionDescriptor is related to the GroupRelationship in the DataStructureDefinition. There can be many types of groups in a //DataSet//. If the Group is related to the DimensionRelationship in the DataStructureDefinition then the //AttributeValue// will be reported with the appropriate dimension in the SeriesKey or Observation.
++The GroupKey is a subunit of the //Key// that has the same dimensionality as the SeriesKey but defines a subset of the KeyValues of the SeriesKey. Its sub [[dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] structure is defined in the GroupDimensionDescriptor of the DataStructureDefinition identified by the same id as the GroupKey. The id identifies a “type” of group and the purpose of the GroupKey is to report one or more //AttributeValue// that are contained at this group level. The GroupKey is present when the GroupDimensionDescriptor is related to the GroupRelationship in the DataStructureDefinition. There can be many types of groups in a //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]//. If the Group is related to the DimensionRelationship in the DataStructureDefinition then the //AttributeValue// will be reported with the appropriate [[dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] in the SeriesKey or Observation.
--In this way each of SeriesKey, GroupKey, and Observation can have zero or more //AttributeValue//s that define some metadata about the object to which it is associated. The //AttributeValue// may be either a //DataAttributeValue// or a //MetadataAttributeValue//, representing values of DataAttributes defined in the DSD or MetadataAttributes of the linked MSD, respectively. The allowable Concepts and the objects to which these metadata can be associated (attached) are defined in the DataStructureDefinition and the linked MetadataStructureDefinition.
++In this way each of SeriesKey, GroupKey, and Observation can have zero or more //AttributeValue//s that define some metadata about the object to which it is associated. The //AttributeValue// may be either a //DataAttributeValue// or a //MetadataAttributeValue//, representing values of DataAttributes defined in the [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] or MetadataAttributes of the linked [[MSD>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]], respectively. The allowable [[Concepts>>doc:sdmx:Glossary 2\.1.Concept.WebHome]] and the objects to which these metadata can be associated (attached) are defined in the DataStructureDefinition and the linked MetadataStructureDefinition.
  The //AttributeValue// links to the object type (SeriesKey, GroupKey, Observation) to which it is associated.