Changes for page 5 Data Structure Definition and Dataset

Last modified by Artur on 2025/09/10 11:19

From 9.3 to 9.2 From 10.1 to 9.5

From version 9.5

edited by Helena
on 2025/05/16 23:04

Change comment: There is no comment for this version

To version 9.3

edited by Helena
on 2025/05/16 23:02

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -153,108 +153,111 @@
  **Figure 30: Representation of DSD Components**
--Each of [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]], TimeDimension, [[Measure>>doc:xwiki:Glossary.Measure.WebHome]], DataAttribute and MetadataAttribute can have a [[Representation>>doc:xwiki:Glossary.Representation.WebHome]] specified (using the localRepresentation association). If this is not specified in the DataStructureDefinition then the [[representation>>doc:xwiki:Glossary.Representation.WebHome]] specified for (% style="color:#2ecc71" %)Concept(%%) (coreRepresentation) is used. [[Measure>>doc:xwiki:Glossary.Measure.WebHome]], and DataAttribute may be also represented by multilingual text (as seen in the [[DataSet>>doc:xwiki:Glossary.Data set.WebHome]] diagram further down). An exception is the MetadataAttribute, where its [[Representation>>doc:xwiki:Glossary.Representation.WebHome]] is specified in the MetadataStructureDefinition.
++Each of Dimension, TimeDimension, Measure, DataAttribute and MetadataAttribute can have a Representation specified (using the localRepresentation association). If this is not specified in the DataStructureDefinition then the representation specified for Concept (coreRepresentation) is used. Measure, and DataAttribute may be also represented by multilingual text (as seen in the DataSet diagram further down). An exception is the MetadataAttribute, where its Representation is specified in the MetadataStructureDefinition.
  A DataStructureDefinition can be extended to form a derived DataStructureDefinition. This is supported in the StructureMap.
  ==== 5.3.2.2 Definitions ====
++:
++
  (((
  (% style="width:834.039px" %)
--|(% style="width:209px" %)**Class**|(% style="width:175px" %)**Feature**|(% style="width:454px" %)**Description**
--|(% style="width:209px" %)StructureUsage|(% style="width:175px" %) |(% style="width:454px" %)See “[[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] Base”.
--|(% style="width:209px" %)[[Dataflow>>doc:xwiki:Glossary.Dataflow.WebHome]]|(% style="width:175px" %)(((
++|**Class**|(% style="width:194px" %)**Feature**|(% style="width:454px" %)**Description**
++|StructureUsage|(% style="width:194px" %) |(% style="width:454px" %)See “SDMX Base”.
++|Dataflow|(% style="width:194px" %)(((
  Inherits from
  //StructureUsage//
--)))|(% style="width:454px" %)Abstract (% style="color:#2ecc71" %)concept(%%) (i.e., the structure without any data) of a flow of data that providers will provide for different reference periods.
--|(% style="width:209px" %) |(% style="width:175px" %)/structure|(% style="width:454px" %)Associates a [[Dataflow>>doc:xwiki:Glossary.Dataflow.WebHome]] to the Data Structure Definition.
--|(% style="width:209px" %)DataStructureDefiniti on|(% style="width:175px" %) |(% style="width:454px" %)A collection of metadata (% style="color:#2ecc71" %)concepts(%%), their structure and usage when used to collect or disseminate data.
--|(% style="width:209px" %) |(% style="width:175px" %)/grouping|(% style="width:454px" %)An association to a set of metadata (% style="color:#2ecc71" %)concepts(%%) that have an identified structural role in a Data Structure Definition.
--|(% style="width:209px" %)GroupDimensionDescriptor|(% style="width:175px" %)(((
++)))|(% style="width:454px" %)Abstract concept (i.e., the structure without any data) of a flow of data that providers will provide for different reference periods.
++| |(% style="width:194px" %)/structure|(% style="width:454px" %)Associates a Dataflow to the Data Structure Definition.
++|DataStructureDefiniti on|(% style="width:194px" %) |(% style="width:454px" %)A collection of metadata concepts, their structure and usage when used to collect or disseminate data.
++| |(% style="width:194px" %)/grouping|(% style="width:454px" %)An association to a set of metadata concepts that have an identified structural role in a Data Structure Definition.
++|GroupDimensionDescrip tor|(% style="width:194px" %)(((
  Inherits from
  //ComponentList//
--)))|(% style="width:454px" %)A set of metadata (% style="color:#2ecc71" %)concepts(%%) that define a partial key derived from the [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] Descriptor in a Data Structure Definition.
--|(% style="width:209px" %) |(% style="width:175px" %)/components|(% style="width:454px" %)An association to the [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] [[components>>doc:xwiki:Glossary.Component.WebHome]] that comprise the group.
--|(% style="width:209px" %)DimensionDescriptor|(% style="width:175px" %)(((
++)))|(% style="width:454px" %)A set of metadata concepts that define a partial key derived from the Dimension Descriptor in a Data Structure Definition.
++| |(% style="width:194px" %)/components|(% style="width:454px" %)An association to the Dimension components that comprise the group.
++|DimensionDescriptor|(% style="width:194px" %)(((
  Inherits from
  //ComponentList//
--)))|(% style="width:454px" %)An ordered set of metadata (% style="color:#2ecc71" %)concepts(%%) that, combined, classify a statistical series, and whose values, when combined (the key) in an instance such as a [[data set>>doc:xwiki:Glossary.Data set.WebHome]], uniquely identify a specific observation.
--|(% style="width:209px" %) |(% style="width:175px" %)/components|(% style="width:454px" %)(((
--An association to the [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] and Time [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] comprising the Key Descriptor.
++)))|(% style="width:454px" %)An ordered set of metadata concepts that, combined, classify a statistical series, and whose values, when combined (the key) in an instance such as a data set, uniquely identify a specific observation.
++| |(% style="width:194px" %)/components|(% style="width:454px" %)(((
++An association to the Dimension and Time Dimension comprising the Key Descriptor.
  )))
--|(% style="width:209px" %)AttributeDescriptor|(% style="width:175px" %)(((
++|AttributeDescriptor|(% style="width:194px" %)(((
  Inherits from
  //ComponentList//
--)))|(% style="width:454px" %)A set metadata (% style="color:#2ecc71" %)concepts(%%) that define the [[Attributes>>doc:xwiki:Glossary.Attribute.WebHome]] of a Data Structure Definition.
--|(% style="width:209px" %) |(% style="width:175px" %)/[[components>>doc:xwiki:Glossary.Component.WebHome]]|(% style="width:454px" %)An association to a Data [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] [[component>>doc:xwiki:Glossary.Component.WebHome]].
--|(% style="width:209px" %)MeasureDescriptor|(% style="width:175px" %)(((
++)))|(% style="width:454px" %)A set metadata concepts that define the Attributes of a Data Structure Definition.
++| |(% style="width:194px" %)/components|(% style="width:454px" %)An association to a Data Attribute component.
++|MeasureDescriptor|(% style="width:194px" %)(((
  Inherits from
  //ComponentList//
--)))|(% style="width:454px" %)A metadata (% style="color:#2ecc71" %)concept(%%) that defines the [[Measures>>doc:xwiki:Glossary.Measure.WebHome]] of a Data Structure Definition.
--|(% style="width:209px" %) |(% style="width:175px" %)/components|(% style="width:454px" %)An association to a [[Measure>>doc:xwiki:Glossary.Measure.WebHome]] [[component>>doc:xwiki:Glossary.Component.WebHome]].
--|(% style="width:209px" %)//DimensionComponent//|(% style="width:175px" %)(((
++)))|(% style="width:454px" %)A metadata concept that defines the Measures of a Data Structure Definition.
++| |(% style="width:194px" %)/components|(% style="width:454px" %)An association to a Measure component.
++|//DimensionComponent//|(% style="width:194px" %)(((
  Inherits from
--//[[Component>>doc:xwiki:Glossary.Component.WebHome]]//
++//Component//
--Sub class [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]]
++Sub class Dimension
  TimeDimension
--)))|(% style="width:454px" %)An abstract class representing any [[Component>>doc:xwiki:Glossary.Component.WebHome]] that can be used for identifying observations.
--|(% style="width:209px" %) |(% style="width:175px" %)order|(% style="width:454px" %)Specifies the order of the [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] [[Components>>doc:xwiki:Glossary.Component.WebHome]] within the [[DSD>>doc:xwiki:Glossary.Data structure definition.WebHome]]. The property is used to indicate the position of the [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] [[Component>>doc:xwiki:Glossary.Component.WebHome]] and determines the Key for identifying observations, or series. The Time [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]], when specified, must be the last within the [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] Descriptor.
--|(% style="width:209px" %)[[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]]|(% style="width:175px" %)(((
++)))|(% style="width:454px" %)An abstract class representing any Component that can be used for identifying observations.
++| |(% style="width:194px" %)order|(% style="width:454px" %)Specifies the order of the Dimension Components within the DSD. The property is used to indicate the position of the Dimension Component and determines the Key for identifying observations, or series. The Time Dimension, when specified, must be the last within the Dimension Descriptor.
++|Dimension|(% style="width:194px" %)(((
  Inherits from
  //DimensionComponent//
--)))|(% style="width:454px" %)A metadata (% style="color:#2ecc71" %)concept(%%) used (most probably together with other metadata (% style="color:#2ecc71" %)concepts(%%)) to classify a statistical series, e.g., a statistical (% style="color:#2ecc71" %)concept(%%) indicating a certain [[economic activity>>doc:xwiki:Glossary.Economic activity.WebHome]] or a geographical reference area.
--|(% style="width:209px" %) |(% style="width:175px" %)/role|(% style="width:454px" %)Association to the (% style="color:#2ecc71" %)Concept(%%) that specifies the role that that the [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] plays in the Data Structure Definition.
--|(% style="width:209px" %) |(% style="width:175px" %)/conceptIdentity|(% style="width:454px" %)An association to the metadata (% style="color:#2ecc71" %)concept(%%) which defines the semantic of the [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]].
--|(% style="width:209px" %)TimeDimension|(% style="width:175px" %)(((
++)))|(% style="width:454px" %)A metadata concept used (most probably together with other metadata concepts) to classify a statistical series, e.g., a statistical concept indicating a certain economic activity or a geographical reference area.
++| |(% style="width:194px" %)/role|(% style="width:454px" %)Association to the Concept that specifies the role that that the Dimension plays in the Data Structure Definition.
++| |(% style="width:194px" %)/conceptIdentity|(% style="width:454px" %)An association to the metadata concept which defines the semantic of the Dimension.
++|TimeDimension|(% style="width:194px" %)(((
  Inherits from
  //DimensionComponent//
--)))|(% style="width:454px" %)A metadata (% style="color:#2ecc71" %)concept(%%) that identifies the [[component>>doc:xwiki:Glossary.Component.WebHome]] in the key structure that has the role of “time”.
--|(% style="width:209px" %)DataAttribute|(% style="width:175px" %)(((
++)))|(% style="width:454px" %)A metadata concept that identifies the component in the key structure that has the role of “time”.
++|DataAttribute|(% style="width:194px" %)(((
  Inherits from
--//[[Component>>doc:xwiki:Glossary.Component.WebHome]]//
++
++//Component//
  )))|(% style="width:454px" %)A characteristic of an object or entity.
--|(% style="width:209px" %) |(% style="width:175px" %)/role|(% style="width:454px" %)Association to the (% style="color:#2ecc71" %)Concept(%%) that specifies the role that that the Data [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] plays in the Data Structure Definition.
--|(% style="width:209px" %) |(% style="width:175px" %)minOccurs|(% style="width:454px" %)Defines the minimum required occurrences for the [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]]. When equals to zero, the [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] is conditional.
--|(% style="width:209px" %) |(% style="width:175px" %)maxOccurs|(% style="width:454px" %)Defines the maximum allowed occurrences for the [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]].
--|(% style="width:209px" %) |(% style="width:175px" %)usage|(% style="width:454px" %)Defines whether a Data [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] must be reported or not.
--|(% style="width:209px" %) |(% style="width:175px" %)+relatedTo|(% style="width:454px" %)Association to an [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] Relationship.
--|(% style="width:209px" %) |(% style="width:175px" %)/conceptIdentity|(% style="width:454px" %)An association to the (% style="color:#2ecc71" %)Concept(%%) which defines the semantic of the [[component>>doc:xwiki:Glossary.Component.WebHome]].
--|(% style="width:209px" %)[[Measure>>doc:xwiki:Glossary.Measure.WebHome]]|(% style="width:175px" %)(((
++| |(% style="width:194px" %)/role|(% style="width:454px" %)Association to the Concept that specifies the role that that the Data Attribute plays in the Data Structure Definition.
++| |(% style="width:194px" %)minOccurs|(% style="width:454px" %)Defines the minimum required occurrences for the Attribute. When equals to zero, the Attribute is conditional.
++| |(% style="width:194px" %)maxOccurs|(% style="width:454px" %)Defines the maximum allowed occurrences for the Attribute.
++| |(% style="width:194px" %)usage|(% style="width:454px" %)Defines whether a Data Attribute must be reported or not.
++| |(% style="width:194px" %)+relatedTo|(% style="width:454px" %)Association to an Attribute Relationship.
++| |(% style="width:194px" %)/conceptIdentity|(% style="width:454px" %)An association to the Concept which defines the semantic of the component.
++|Measure|(% style="width:194px" %)(((
  Inherits from
--//[[Component>>doc:xwiki:Glossary.Component.WebHome]]//
--)))|(% style="width:454px" %)The metadata (% style="color:#2ecc71" %)concept(%%) that is the phenomenon to be measured in a [[data set>>doc:xwiki:Glossary.Data set.WebHome]]. In a [[data set>>doc:xwiki:Glossary.Data set.WebHome]] the instance of the [[measure>>doc:xwiki:Glossary.Measure.WebHome]] is often called the observation.
--|(% style="width:209px" %) |(% style="width:175px" %)/conceptIdentity|(% style="width:454px" %)An association to the (% style="color:#2ecc71" %)Concept(%%) which carries the values of the [[measures>>doc:xwiki:Glossary.Measure.WebHome]].
--|(% style="width:209px" %) |(% style="width:175px" %)minOccurs|(% style="width:454px" %)Defines the minimum required occurrences for the [[Measure>>doc:xwiki:Glossary.Measure.WebHome]]. When equals to zero, the [[Measure>>doc:xwiki:Glossary.Measure.WebHome]] is conditional.
--|(% style="width:209px" %) |(% style="width:175px" %)maxOccurs|(% style="width:454px" %)Defines the maximum allowed occurrences for the [[Measure>>doc:xwiki:Glossary.Measure.WebHome]].
--|(% style="width:209px" %) |(% style="width:175px" %)usage|(% style="width:454px" %)Defines whether a [[Measure>>doc:xwiki:Glossary.Measure.WebHome]] must be reported or not.
--|(% style="width:209px" %)//AttributeRelationship//|(% style="width:175px" %)(((
++//Component//
++)))|(% style="width:454px" %)The metadata concept that is the phenomenon to be measured in a data set. In a data set the instance of the measure is often called the observation.
++| |(% style="width:194px" %)/conceptIdentity|(% style="width:454px" %)An association to the Concept which carries the values of the measures.
++| |(% style="width:194px" %)minOccurs|(% style="width:454px" %)Defines the minimum required occurrences for the Measure. When equals to zero, the Measure is conditional.
++| |(% style="width:194px" %)maxOccurs|(% style="width:454px" %)Defines the maximum allowed occurrences for the Measure.
++| |(% style="width:194px" %)usage|(% style="width:454px" %)Defines whether a Measure must be reported or not.
++|//AttributeRelationship//|(% style="width:194px" %)(((
  Abstract Class
  Sub classes
  ObservationRelationship
--GroupRelationship DimensionRelationship
--)))|(% style="width:454px" %)Specifies the type of [[artefact>>doc:xwiki:Glossary.Artefact.WebHome]] to which a Data [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] can be attached in a [[Data Set>>doc:xwiki:Glossary.Data set.WebHome]].
--|(% style="width:209px" %)ObservationRelationship|(% style="width:175px" %) |(% style="width:454px" %)The Data [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] is related to the observations of the [[Data Set>>doc:xwiki:Glossary.Data set.WebHome]].
--|(% style="width:209px" %)GroupRelationship|(% style="width:175px" %) |(% style="width:454px" %)The Data [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] is related to a Group [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] Descriptor construct.
--|(% style="width:209px" %) |(% style="width:175px" %)+groupKey|(% style="width:454px" %)An association to the Group [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] Descriptor
--|(% style="width:209px" %)DimensionRelationship|(% style="width:175px" %) |(% style="width:454px" %)The Data [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] is related to a set of [[Dimensions>>doc:xwiki:Glossary.Dimension.WebHome]].
--|(% style="width:209px" %) |(% style="width:175px" %)+dimensions|(% style="width:454px" %)Association to the set of [[Dimensions>>doc:xwiki:Glossary.Dimension.WebHome]] to which the Data [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] is related.
--|(% style="width:209px" %) |(% style="width:175px" %)+groupKey|(% style="width:454px" %)Association to the Group [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] Descriptor which specifies the set of [[Dimensions>>doc:xwiki:Glossary.Dimension.WebHome]] to which the Data [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] is attached.
--|(% style="width:209px" %)MeasureRelationship|(% style="width:175px" %) |(% style="width:454px" %)The [[Measures>>doc:xwiki:Glossary.Measure.WebHome]] that a Data [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] is reported for.
--|(% style="width:209px" %) |(% style="width:175px" %)+measures|(% style="width:454px" %)Association to the set of [[Measures>>doc:xwiki:Glossary.Measure.WebHome]] to which a Data [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] is related to.
--|(% style="width:209px" %)SentinelValuesType|(% style="width:175px" %) |(% style="width:454px" %)This [[facet>>doc:xwiki:Glossary.Facet.WebHome]] indicates that an [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] or a [[Measure>>doc:xwiki:Glossary.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:xwiki:Glossary.Facet.WebHome]].
--|(% style="width:209px" %)SentinelValue|(% style="width:175px" %) |(% style="width:454px" %)A value that has a special meaning within the text format [[representation>>doc:xwiki:Glossary.Representation.WebHome]] of the [[Component>>doc:xwiki:Glossary.Component.WebHome]].
--|(% style="width:209px" %) |(% style="width:175px" %)+name|(% style="width:454px" %)An association of a Sentinel Value to a multilingual name.
--|(% style="width:209px" %) |(% style="width:175px" %)+description|(% style="width:454px" %)An association of a Sentinel Value to a multilingual description.
++GroupRelationship DimensionRelationshi p
++)))|(% style="width:454px" %)Specifies the type of artefact to which a Data Attribute can be attached in a Data Set.
++|ObservationRelationsh ip|(% style="width:194px" %) |(% style="width:454px" %)The Data Attribute is related to the observations of the Data Set.
++|GroupRelationship|(% style="width:194px" %) |(% style="width:454px" %)The Data Attribute is related to a Group Dimension Descriptor construct.
++| |(% style="width:194px" %)+groupKey|(% style="width:454px" %)An association to the Group Dimension Descriptor
++|DimensionRelationship|(% style="width:194px" %) |(% style="width:454px" %)The Data Attribute is related to a set of Dimensions.
++| |(% style="width:194px" %)+dimensions|(% style="width:454px" %)Association to the set of Dimensions to which the Data Attribute is related.
++| |(% style="width:194px" %)+groupKey|(% style="width:454px" %)Association to the Group Dimension Descriptor which specifies the set of Dimensions to which the Data Attribute is attached.
++|MeasureRelationship|(% style="width:194px" %) |(% style="width:454px" %)The Measures that a Data Attribute is reported for.
++| |(% style="width:194px" %)+measures|(% style="width:454px" %)Association to the set of Measures to which a Data Attribute is related to.
++|SentinelValuesType|(% style="width:194px" %) |(% style="width:454px" %)This facet indicates that an Attribute or a Measure 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.
++|SentinelValue|(% style="width:194px" %) |(% style="width:454px" %)A value that has a special meaning within the text format representation of the Component.
++| |(% style="width:194px" %)+name|(% style="width:454px" %)An association of a Sentinel Value to a multilingual name.
++| |(% style="width:194px" %)+description|(% style="width:454px" %)An association of a Sentinel Value to a multilingual description.
  )))
--The explanation of the classes, [[attributes>>doc:xwiki:Glossary.Attribute.WebHome]], and associations comprising the [[Representation>>doc:xwiki:Glossary.Representation.WebHome]] is described in the section on the [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] Base.
++The explanation of the classes, attributes, and associations comprising the Representation is described in the section on the SDMX Base.
  == 5.4 Data Set – Relationship View ==
  === 5.4.1 Context ===
--A [[data set>>doc:xwiki:Glossary.Data set.WebHome]] comprises the collection of data values and associated metadata that are collected or disseminated according to a known DataStructureDefinition.
++A data set comprises the collection of data values and associated metadata that are collected or disseminated according to a known DataStructureDefinition.
  === 5.4.2 Class Diagram ===
@@ -266,25 +266,25 @@
  ==== 5.4.3.1 Narrative – Data Set ====
--Note that the //[[DataSet>>doc:xwiki:Glossary.Data set.WebHome]]// must conform to the DataStructureDefinition associated to the [[Dataflow>>doc:xwiki:Glossary.Dataflow.WebHome]] for which this [[DataSet>>doc:xwiki: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:xwiki:Glossary.Data set.WebHome]]// as exchanged there must, of course, be a reference to the DataStructureDefinition and optionally a [[Dataflow>>doc:xwiki: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:xwiki:Glossary.Data set.WebHome]]// when the //[[DataSet>>doc:xwiki:Glossary.Data set.WebHome]]// is exchanged. However, the [[structural metadata>>doc:xwiki:Glossary.Structural metadata.WebHome]] in the DataStructureDefinition can be used by an application to validate the contents of the //[[DataSet>>doc:xwiki:Glossary.Data set.WebHome]]// in terms of the valid content of a //KeyValue// as defined by the [[Representation>>doc:xwiki:Glossary.Representation.WebHome]] in the DataStructureDefinition.
++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.
--An organisation playing the role of DataProvider can be responsible for one or more //[[DataSet>>doc:xwiki:Glossary.Data set.WebHome]]//.
++An organisation playing the role of DataProvider can be responsible for one or more //DataSet//.
--A //[[DataSet>>doc:xwiki:Glossary.Data set.WebHome]]// is formatted as a DataStructureDefinition specific [[data set>>doc:xwiki:Glossary.Data set.WebHome]] (StructureSpecificDataSet). The structured [[data set>>doc:xwiki:Glossary.Data set.WebHome]] is structured according to one specific DataStructureDefinition; hence the latter is required for validation at the syntax (% style="color:#2ecc71" %)level(%%).
++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:xwiki: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:xwiki:Glossary.Component.WebHome]] ([[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]], TimeDimension) defined in the DimensionDescriptor of the DataStructureDefinition, together with associated
++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>>doc:xwiki:Glossary.Artefact.WebHome]] to which it is attached – //Observation//s, set of [[Dimensions>>doc:xwiki:Glossary.Dimension.WebHome]]. It can be structured in terms of a SeriesKey to which //Observation//s are reported.
++//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.
--The //Observation// can be the value(s) of the variable(s) being measured for the (% style="color:#2ecc71" %)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>>doc:xwiki:Glossary.Dimension.WebHome]] at the Observation (% style="color:#2ecc71" %)Level(%%)”. Any [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] can be specified as being the “[[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] at the Observation (% style="color:#2ecc71" %)Level(%%)”, and this specification is made at the (% style="color:#2ecc71" %)level(%%) of the //[[DataSet>>doc:xwiki:Glossary.Data set.WebHome]]// (i.e., it must be the same [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] for the entire //[[DataSet>>doc:xwiki:Glossary.Data set.WebHome]]//).
++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 //KeyValue// is a value for one of TimeDimension or [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] specified in the DataStructureDefinition. If it is a [[Dimension>>doc:xwiki: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:xwiki:Glossary.Code.WebHome]] in the Codelist specified as the [[Representation>>doc:xwiki:Glossary.Representation.WebHome]] of the [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] in the DataStructureDefinition.
++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.
  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>>doc:xwiki: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 (% style="color:#2ecc71" %)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:xwiki: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:xwiki:Glossary.Dimension.WebHome]] 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 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.
--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:xwiki:Glossary.Data structure definition.WebHome]] or MetadataAttributes of the linked [[MSD>>doc:xwiki:Glossary.Metadata structure definition.WebHome]], respectively. The allowable (% style="color:#2ecc71" %)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 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.
  The //AttributeValue// links to the object type (SeriesKey, GroupKey, Observation) to which it is associated.