Changes for page 5 Data Structure Definition and Dataset

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

From 23.9 to 23.8 From 24.1 to 23.11

From version 23.11

edited by Helena K.
on 2026/06/04 21:27

Change comment: There is no comment for this version

To version 23.9

edited by Helena K.
on 2026/06/04 21:25

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -250,7 +250,7 @@
  === 5.4.1 Context ===
--A [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] comprises the collection of data values and associated [[metadata>>doc:IMElements.metadata.WebHome]] that are collected or disseminated according to a known DataStructureDefinition.
++A [[data set>>doc:Glossary.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,25 +262,25 @@
  ==== 5.4.3.1 Narrative – Data Set ====
--Note that the //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]// must conform to the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] associated to the [[Dataflow>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.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>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]], this is for conceptual purposes to show the link to the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]]. In the actual //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]// as exchanged there must, of course, be a reference to the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] and optionally a [[Dataflow>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.Dataflow.WebHome]] or a ProvisionAgreement, but the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] is not necessarily exchanged with the data. Therefore, the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] 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>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] 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>>doc:IMElements.KeyValue.WebHome]]// as defined by the [[Representation>>doc:IMElements.Representation.WebHome]] in the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]].
++Note that the //[[DataSet>>doc:Glossary.Data set.WebHome]]// must conform to the DataStructureDefinition associated to the [[Dataflow>>doc:Glossary.Dataflow.WebHome]] for which this [[DataSet>>doc:Glossary.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:Glossary.Data set.WebHome]]// as exchanged there must, of course, be a reference to the DataStructureDefinition and optionally a [[Dataflow>>doc:Glossary.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:Glossary.Data set.WebHome]]// when the //[[DataSet>>doc:Glossary.Data set.WebHome]]// is exchanged. However, the [[structural metadata>>doc:Glossary.Structural metadata.WebHome]] in the DataStructureDefinition can be used by an application to validate the contents of the //[[DataSet>>doc:Glossary.Data set.WebHome]]// in terms of the valid content of a //KeyValue// as defined by the [[Representation>>doc:Glossary.Representation.WebHome]] in the DataStructureDefinition.
--An organisation playing the [[role>>doc:IMElements.role.WebHome]] of [[DataProvider>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.Organisation.DataProvider.WebHome]] can be responsible for one or more //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]//.
++An organisation playing the role of DataProvider can be responsible for one or more //[[DataSet>>doc:Glossary.Data set.WebHome]]//.
--A //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]// is formatted as a [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] specific [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] ([[StructureSpecificDataSet>>doc:IMElements.AnnotableArtefact.DataSet.StructureSpecificDataSet.WebHome]]). The structured [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] is structured according to one specific [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]]; hence the latter is required for validation at the syntax level.
++A //[[DataSet>>doc:Glossary.Data set.WebHome]]// is formatted as a DataStructureDefinition specific [[data set>>doc:Glossary.Data set.WebHome]] (StructureSpecificDataSet). The structured [[data set>>doc:Glossary.Data set.WebHome]] 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 a collection of a set of //Observation//s that share the same dimensionality, which is specified by a set of unique [[components>>doc:IMElements.components.WebHome]] ([[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]], [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]]) defined in the [[DimensionDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.DimensionDescriptor.WebHome]] of the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]], 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. It can be structured in terms of a [[SeriesKey>>doc:IMElements.AnnotableArtefact.Key.SeriesKey.WebHome]] to which //Observation//s are reported.
++A //[[DataSet>>doc:Glossary.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:Glossary.Component.WebHome]] ([[Dimension>>doc:Glossary.Dimension.WebHome]], TimeDimension) defined in the DimensionDescriptor of the DataStructureDefinition, together with associated //AttributeValue//s that define specific characteristics about the [[artefact>>doc:Glossary.Artefact.WebHome]] to which it is attached – //Observation//s, set of [[Dimensions>>doc:Glossary.Dimension.WebHome]]. It can be structured in terms of a SeriesKey to which //Observation//s are reported.
--The //[[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]]// can be the [[value>>doc:IMElements.value.WebHome]](s) of the variable(s) being measured for the [[Concept>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.Concept.WebHome]] associated to the Measure(s) in the [[MeasureDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.MeasureDescriptor.WebHome]] of the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]]. Each //[[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]]// associates one or more //[[ObservationValue>>doc:IMElements.AnnotableArtefact.ObservationValue.WebHome]]//s with a [[KeyValue>>doc:IMElements.KeyValue.WebHome]] (+[[observationDimension>>doc:IMElements.observationDimension.WebHome]]) which is the [[value>>doc:IMElements.value.WebHome]] for the “[[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] at the [[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]] Level”. Any [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] can be specified as being the “[[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] at the [[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]] 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:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] for the entire //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]//).
++The //Observation// can be the value(s) of the variable(s) being measured for the (% style="color:#e74c3c" %)[[Concept>>doc:Glossary.Concept.WebHome]](%%) associated to the [[Measure>>doc:Glossary.Measure.WebHome]](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:Glossary.Dimension.WebHome]] at the Observation Level”. Any [[Dimension>>doc:Glossary.Dimension.WebHome]] can be specified as being the “[[Dimension>>doc:Glossary.Dimension.WebHome]] at the Observation Level”, and this specification is made at the level of the //[[DataSet>>doc:Glossary.Data set.WebHome]]// (i.e., it must be the same [[Dimension>>doc:Glossary.Dimension.WebHome]] for the entire //[[DataSet>>doc:Glossary.Data set.WebHome]]//).
--The //[[KeyValue>>doc:IMElements.KeyValue.WebHome]]// is a [[value>>doc:IMElements.value.WebHome]] for one of [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]] or [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] specified in the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]]. If it is a [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]], it can be coded ([[CodedKeyValue>>doc:IMElements.KeyValue.CodedKeyValue.WebHome]]) or uncoded ([[UncodedKeyValue>>doc:IMElements.KeyValue.UncodedKeyValue.WebHome]]). If it is the [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]] then it is a [[TimeKeyValue>>doc:IMElements.KeyValue.TimeKeyValue.WebHome]]. The actual [[value>>doc:IMElements.value.WebHome]] that the CodedDimensionValue can take must be one of the Codes in the [[Codelist>>doc:sdmx:Glossary 2\.1.Code list.WebHome]] specified as the [[Representation>>doc:IMElements.Representation.WebHome]] of the [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] in the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]].
++The //KeyValue// is a value for one of TimeDimension or [[Dimension>>doc:Glossary.Dimension.WebHome]] specified in the DataStructureDefinition. If it is a [[Dimension>>doc:Glossary.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:Glossary.Code.WebHome]] in the Codelist specified as the [[Representation>>doc:Glossary.Representation.WebHome]] of the [[Dimension>>doc:Glossary.Dimension.WebHome]] in the DataStructureDefinition.
--An [[ObservationValue>>doc:IMElements.AnnotableArtefact.ObservationValue.WebHome]] can be coded – this is the [[CodedObservation>>doc:IMElements.AnnotableArtefact.ObservationValue.CodedObservation.WebHome]] – or it can be uncoded – this is the UncodedObservation. In the case of uncoded observations, the values may be multilingual – expressed via the [[TextMeasureValue>>doc:IMElements.AnnotableArtefact.ObservationValue.UncodedObservationValue.TextMeasureValue.WebHome]] – or not ([[OtherUncodedMeasureValue>>doc:IMElements.AnnotableArtefact.ObservationValue.UncodedObservationValue.OtherUncodedMeasureValue.WebHome]]).
++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>>doc:IMElements.AnnotableArtefact.Key.GroupKey.WebHome]] is a subunit of the //[[Key>>doc:IMElements.AnnotableArtefact.Key.WebHome]]// that has the same dimensionality as the [[SeriesKey>>doc:IMElements.AnnotableArtefact.Key.SeriesKey.WebHome]] but defines a subset of the KeyValues of the [[SeriesKey>>doc:IMElements.AnnotableArtefact.Key.SeriesKey.WebHome]]. Its sub dimension [[structure>>doc:IMElements.structure.WebHome]] is defined in the [[GroupDimensionDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.GroupDimensionDescriptor.WebHome]] of the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] identified by the same [[id>>doc:IMElements.id.WebHome]] as the [[GroupKey>>doc:IMElements.AnnotableArtefact.Key.GroupKey.WebHome]]. The [[id>>doc:IMElements.id.WebHome]] identifies a “[[type>>doc:IMElements.type.WebHome]]” of group and the purpose of the [[GroupKey>>doc:IMElements.AnnotableArtefact.Key.GroupKey.WebHome]] is to report one or more //[[AttributeValue>>doc:IMElements.AnnotableArtefact.AttributeValue.WebHome]]// that are contained at this group level. The [[GroupKey>>doc:IMElements.AnnotableArtefact.Key.GroupKey.WebHome]] is present when the [[GroupDimensionDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.GroupDimensionDescriptor.WebHome]] is related to the [[GroupRelationship>>doc:IMElements.AttributeRelationship.GroupRelationship.WebHome]] in the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]]. 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>>doc:IMElements.AttributeRelationship.DimensionRelationship.WebHome]] in the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] then the //[[AttributeValue>>doc:IMElements.AnnotableArtefact.AttributeValue.WebHome]]// will be reported with the appropriate dimension in the [[SeriesKey>>doc:IMElements.AnnotableArtefact.Key.SeriesKey.WebHome]] or [[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]].
++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:Glossary.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:Glossary.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:Glossary.Dimension.WebHome]] in the SeriesKey or Observation.
--In this way each of [[SeriesKey>>doc:IMElements.AnnotableArtefact.Key.SeriesKey.WebHome]], [[GroupKey>>doc:IMElements.AnnotableArtefact.Key.GroupKey.WebHome]], and [[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]] can have zero or more //[[AttributeValue>>doc:IMElements.AnnotableArtefact.AttributeValue.WebHome]]//s that define some [[metadata>>doc:IMElements.metadata.WebHome]] about the object to which it is associated. The //[[AttributeValue>>doc:IMElements.AnnotableArtefact.AttributeValue.WebHome]]// may be either a //[[DataAttributeValue>>doc:IMElements.AnnotableArtefact.AttributeValue.DataAttributeValue.WebHome]]// or a //[[MetadataAttributeValue>>doc:IMElements.AnnotableArtefact.AttributeValue.MetadataAttributeValue.WebHome]]//, 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 and the objects to which these [[metadata>>doc:IMElements.metadata.WebHome]] can be associated (attached) are defined in the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] and the linked [[MetadataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.MetadataStructureDefinition.WebHome]].
++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:Glossary.Data structure definition.WebHome]] or MetadataAttributes of the linked [[MSD>>doc:Glossary.Metadata structure definition.WebHome]], respectively. The allowable (% style="color:#e74c3c" %)[[Concepts>>doc:Glossary.Concept.WebHome]](%%) and the objects to which these metadata can be associated (attached) are defined in the DataStructureDefinition and the linked MetadataStructureDefinition.
--The //[[AttributeValue>>doc:IMElements.AnnotableArtefact.AttributeValue.WebHome]]// links to the object [[type>>doc:IMElements.type.WebHome]] ([[SeriesKey>>doc:IMElements.AnnotableArtefact.Key.SeriesKey.WebHome]], [[GroupKey>>doc:IMElements.AnnotableArtefact.Key.GroupKey.WebHome]], [[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]]) to which it is associated.
++The //AttributeValue// links to the object type (SeriesKey, GroupKey, Observation) to which it is associated.
  ==== 5.4.3.2 Definitions ====