Changes for page 5 Data Structure Definition and Dataset
Last modified by Artur on 2025/09/10 11:19
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -99,42 +99,42 @@ 99 99 100 100 ==== 5.3.2.1 Narrative ==== 101 101 102 -A DataStructureDefinition defines the [[Dimensions>>doc:xwiki:Glossary.Dimension.WebHome]], TimeDimension, DataAttributes, and[[Measures>>doc:xwiki:Glossary.Measure.WebHome]], and associated[[Representations>>doc:xwiki:Glossary.Representation.WebHome]], that comprise the valid structure of data and related[[attributes>>doc:xwiki:Glossary.Attribute.WebHome]]that are contained in a[[DataSet>>doc:xwiki:Glossary.Data set.WebHome]], which is defined by a[[Dataflow>>doc:xwiki:Glossary.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:xwiki:Glossary.Component.WebHome]]// within the[[DSD>>doc:xwiki:Glossary.Data structure definition.WebHome]], as explained below.102 +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. 103 103 104 -The [[Dataflow>>doc:xwiki:Glossary.Dataflow.WebHome]]may also have additional metadata attached that define qualitative information and(% style="color:#2ecc71" %)Constraints(%%)on the use of the DataStructureDefinition such as the subset of[[Codes>>doc:xwiki:Glossary.Code.WebHome]]used in a[[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]](this is covered later in this document – see sections “(% style="color:#2ecc71" %)Constraints(%%)” and “Data Provisioning”). Each[[Dataflow>>doc:xwiki:Glossary.Dataflow.WebHome]]has a maximum of one DataStructureDefinition specified which defines the structure of any[[DataSets>>doc:xwiki:Glossary.Dataset.WebHome]]tobe reported/disseminated.104 +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. 105 105 106 -There are two types of [[dimensions>>doc:xwiki:Glossary.Dimension.WebHome]]each having a common association to(% style="color:#2ecc71" %)Concept(%%):106 +There are two types of dimensions each having a common association to Concept: 107 107 108 -* [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]]108 +* Dimension 109 109 * TimeDimension 110 110 111 -Note that DimensionComponent can be any or all its sub classes i.e., [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]], TimeDimension.111 +Note that DimensionComponent can be any or all its sub classes i.e., Dimension, TimeDimension. 112 112 113 -The //DimensionComponent//, DataAttribute, MetadataAttribute and [[Measure>>doc:xwiki:Glossary.Measure.WebHome]]link to the(% style="color:#2ecc71" %)Concept(%%)that defines its name and semantic (/conceptIdentity association to(% style="color:#2ecc71" %)Concept(%%)). The DataAttribute,[[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]](but not TimeDimension) and[[Measure>>doc:xwiki:Glossary.Measure.WebHome]]can optionally have a +conceptRole association with a(% style="color:#2ecc71" %)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:xwiki:Glossary.Statisticaldata and metadata exchange.WebHome]] (% style="color:#2ecc71" %)CONCEPT(%%)ROLES" by the[[SDMX>>doc:xwiki:Glossary.Statisticaldata 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:xwiki:Glossary.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.113 +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. 114 114 115 -The valid values for a //DimensionComponent//, [[Measure>>doc:xwiki:Glossary.Measure.WebHome]], DataAttribute or MetadataAttribute, when used in this DataStructureDefinition, are defined by the[[Representation>>doc:xwiki:Glossary.Representation.WebHome]].This[[Representation>>doc:xwiki:Glossary.Representation.WebHome]]is taken from the(% style="color:#2ecc71" %)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:xwiki:Glossary.Representation.WebHome]]of MetadataAttributes are specified in the corresponding MetadataStructureDefinition, linked by the DataStructureDefinition.115 +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. 116 116 117 -There will always be a DimensionDescriptor grouping that identifies all of the [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]]comprising the full key. Together the[[Dimensions>>doc:xwiki:Glossary.Dimension.WebHome]]specify the key of an Observation.117 +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. 118 118 119 -The //DimensionComponent// can optionally be grouped by multiple GroupDimensionDescriptors each of which identifies the group of [[Dimensions>>doc:xwiki:Glossary.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:xwiki:Glossary.Dataset.WebHome]]todeclare which DataAttributes or MetadataAttributes are reported at this group(% style="color:#2ecc71" %)level(%%)in the[[DataSet>>doc:xwiki:Glossary.Data set.WebHome]].119 +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. 120 120 121 -There can be a maximum of one TimeDimension specified in the DimensionDescriptor. The TimeDimension is used to specify the (% style="color:#2ecc71" %)Concept(%%)used to convey the[[time period>>doc:xwiki:Glossary.Timeperiod.WebHome]] of the observation in a[[data set>>doc:xwiki:Glossary.Dataset.WebHome]].The TimeDimension must contain a valid[[representation>>doc:xwiki:Glossary.Representation.WebHome]]of time and cannot be coded.121 +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. 122 122 123 -here can be one or more [[Measures>>doc:xwiki:Glossary.Measure.WebHome]]under the MeasureDescriptor.[[Measures>>doc:xwiki:Glossary.Measure.WebHome]]represent the observable phenomena. Each[[Measure>>doc:xwiki:Glossary.Measure.WebHome]]may have a valid[[representation>>doc:xwiki:Glossary.Representation.WebHome]], a maxOccurs[[attribute>>doc:xwiki:Glossary.Attribute.WebHome]]limiting the maximum number of values per[[Measure>>doc:xwiki:Glossary.Measure.WebHome]](which may be set to 'unbounded' for unlimited occurrences), as well as a minOccurs[[attribute>>doc:xwiki:Glossary.Attribute.WebHome]], indicating the minimum required number of values, when the[[Measure>>doc:xwiki:Glossary.Measure.WebHome]]is reported. If minOccurs or maxOccurs are omitted (they both default to ‘1’), the[[Measure>>doc:xwiki:Glossary.Measure.WebHome]]is considered to take a single value; otherwise, it is an array. Moreover, the usage[[attribute>>doc:xwiki:Glossary.Attribute.WebHome]]indicates whether a[[Measure>>doc:xwiki:Glossary.Measure.WebHome]]must be reported or not, by the corresponding values: mandatory or optional.123 +here 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. 124 124 125 -The AttributeDescriptor may contain one or more // [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]]//s, i.e., at least one DataAttribute definition or one MetadataAttribute reference.125 +The AttributeDescriptor may contain one or more //Attribute//s, i.e., at least one DataAttribute definition or one MetadataAttribute reference. 126 126 127 -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:xwiki:Glossary.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:xwiki:Glossary.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:#2ecc71" %)Concept(%%)that identifies its role.127 +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. 128 128 129 -The MetadataAttribute defines [[reference metadata>>doc:xwiki:Glossary.Referencemetadata.WebHome]] that may be collected or disseminated and is grouped together with DataAttribute under the AttributeDescriptor.129 +The MetadataAttribute defines reference metadata that may be collected or disseminated and is grouped together with DataAttribute under the AttributeDescriptor. 130 130 131 -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:xwiki:Glossary.Data set.WebHome]]//. An //AttributeComponent// can be specified as being related to one of the following[[artefacts>>doc:xwiki:Glossary.Artefact.WebHome]]:131 +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: 132 132 133 -* All data within the [[dataset>>doc:xwiki:Glossary.Dataset.WebHome]](DataflowRelationship) – this is equivalent to attaching an[[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]]to all data within the[[Dataflow>>doc:xwiki:Glossary.Dataflow.WebHome]].134 -* [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]]or set of[[Dimensions>>doc:xwiki:Glossary.Dimension.WebHome]](DimensionRelationship)135 -* Set of [[Dimensions>>doc:xwiki:Glossary.Dimension.WebHome]]specified by a GroupKey (GroupRelationship – this is retained for compatibility reasons – or +groupKey of the DimensionRelationship)133 +* All data within the dataset (DataflowRelationship) – this is equivalent to attaching an Attribute to all data within the Dataflow. 134 +* Dimension or set of Dimensions (DimensionRelationship) 135 +* Set of Dimensions specified by a GroupKey (GroupRelationship – this is retained for compatibility reasons – or +groupKey of the DimensionRelationship) 136 136 * Observation (ObservationRelationship) 137 -* In addition to the positioning of an //AttributeComponent// within a // [[DataSet>>doc:xwiki:Glossary.Data set.WebHome]]//, another relationship indicates the[[Measure>>doc:xwiki:Glossary.Measure.WebHome]](s) for which the //AttributeComponent// is reported. Regardless of the position of the //AttributeComponent// within the //[[DataSet>>doc:xwiki:Glossary.Data set.WebHome]]//, the //AttributeComponent// may concern one, more than one, or all[[Measures>>doc:xwiki:Glossary.Measure.WebHome]]included in the[[DSD>>doc:xwiki:Glossary.Datastructure definition.WebHome]].This is expressed using the MeasureRelationship class, which relates a DataAttribute to one or more[[Measures>>doc:xwiki:Glossary.Measure.WebHome]].Lack of the MeasureRelationship defaults to a relationship to all[[Measures>>doc:xwiki:Glossary.Measure.WebHome]].137 +* 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. 138 138 139 139 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_f235bfd4.jpg||height="542" width="604"]] 140 140 ... ... @@ -144,117 +144,120 @@ 144 144 145 145 (% style="width:839.039px" %) 146 146 |**Relationship**|(% style="width:384px" %)**Meaning**|(% style="width:303px" %)**Location in Data Set at which the Attribute is reported** 147 -|DataflowRelationship|(% style="width:384px" %)The value of the [[attribute>>doc:xwiki:Glossary.Attribute.WebHome]]is fixed for all data contained in the[[dataset>>doc:xwiki:Glossary.Dataset.WebHome]].The[[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]]value applies to all data defined by the underlying[[Dataflow>>doc:xwiki:Glossary.Dataflow.WebHome]].|(% style="width:303px" %)The[[attribute>>doc:xwiki:Glossary.Attribute.WebHome]]is reported at the[[Dataset>>doc:xwiki:Glossary.Dataset.WebHome]] (% style="color:#2ecc71" %)level(%%).148 -| [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]](1..n)|(% style="width:384px" %)The value of the[[attribute>>doc:xwiki:Glossary.Attribute.WebHome]]will vary with the value(s) of the referenced[[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]](s). In this case, Group(s) to which the[[attribute>>doc:xwiki:Glossary.Attribute.WebHome]]should be attached may optionally be specified.|(% style="width:303px" %)The[[attribute>>doc:xwiki:Glossary.Attribute.WebHome]]is reported at the lowest(% style="color:#2ecc71" %)level(%%)of the[[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]]to which the[[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]]is related, otherwise at the(% style="color:#2ecc71" %)level(%%)of the Group if Attachment Group(s) is specified.149 -|Group|(% style="width:384px" %)The value of the [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]]varies with combination of values for all of the[[Dimensions>>doc:xwiki:Glossary.Dimension.WebHome]]contained in the Group. This is added as a convenience to listing all[[Dimensions>>doc:xwiki:Glossary.Dimension.WebHome]]and the attachment Group, but should only be used when the[[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]]value varies based on __all__ Group[[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]]values.|(% style="width:303px" %)The[[attribute>>doc:xwiki:Glossary.Attribute.WebHome]]is reported at the(% style="color:#2ecc71" %)level(%%)of Group.150 -|Observation|(% style="width:384px" %)The value of the [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]]varies with the observed value.|(% style="width:303px" %)The[[attribute>>doc:xwiki:Glossary.Attribute.WebHome]]is reported at the(% style="color:#2ecc71" %)level(%%)of Observation.147 +|DataflowRelationship|(% style="width:384px" %)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:303px" %)The attribute is reported at the Dataset level. 148 +|Dimension (1..n)|(% style="width:384px" %)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:303px" %)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. 149 +|Group|(% style="width:384px" %)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:303px" %)The attribute is reported at the level of Group. 150 +|Observation|(% style="width:384px" %)The value of the Attribute varies with the observed value.|(% style="width:303px" %)The attribute is reported at the level of Observation. 151 151 152 152 [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_42ff01fb.jpg||height="380" width="590"]] 153 153 154 154 **Figure 30: Representation of DSD Components** 155 155 156 -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.Dataset.WebHome]]diagram further down). An exception is the MetadataAttribute, where its[[Representation>>doc:xwiki:Glossary.Representation.WebHome]]is specified in the MetadataStructureDefinition.156 +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. 157 157 158 158 A DataStructureDefinition can be extended to form a derived DataStructureDefinition. This is supported in the StructureMap. 159 159 160 160 ==== 5.3.2.2 Definitions ==== 161 161 162 +: 163 + 162 162 ((( 163 163 (% style="width:834.039px" %) 164 -| (% style="width:209px" %)**Class**|(% style="width:175px" %)**Feature**|(% style="width:454px" %)**Description**165 -| (% style="width:209px" %)StructureUsage|(% style="width:175px" %) |(% style="width:454px" %)See “[[SDMX>>doc:xwiki:Glossary.Statisticaldata and metadata exchange.WebHome]]Base”.166 -| (% style="width:209px" %)[[Dataflow>>doc:xwiki:Glossary.Dataflow.WebHome]]|(% style="width:175px" %)(((166 +|**Class**|(% style="width:194px" %)**Feature**|(% style="width:454px" %)**Description** 167 +|StructureUsage|(% style="width:194px" %) |(% style="width:454px" %)See “SDMX Base”. 168 +|Dataflow|(% style="width:194px" %)((( 167 167 Inherits from 168 168 //StructureUsage// 169 -)))|(% 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.170 -| (%style="width:209px" %)|(% style="width:175px" %)/structure|(% style="width:454px" %)Associates a[[Dataflow>>doc:xwiki:Glossary.Dataflow.WebHome]]to the Data Structure Definition.171 -| (% 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.172 -| (%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.173 -| (% style="width:209px" %)GroupDimensionDescriptor|(% style="width:175px" %)(((171 +)))|(% 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. 172 +| |(% style="width:194px" %)/structure|(% style="width:454px" %)Associates a Dataflow to the Data Structure Definition. 173 +|DataStructureDefiniti on|(% style="width:194px" %) |(% style="width:454px" %)A collection of metadata concepts, their structure and usage when used to collect or disseminate data. 174 +| |(% 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. 175 +|GroupDimensionDescrip tor|(% style="width:194px" %)((( 174 174 Inherits from 175 175 //ComponentList// 176 -)))|(% 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.177 -| (%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.178 -| (% style="width:209px" %)DimensionDescriptor|(% style="width:175px" %)(((178 +)))|(% style="width:454px" %)A set of metadata concepts that define a partial key derived from the Dimension Descriptor in a Data Structure Definition. 179 +| |(% style="width:194px" %)/components|(% style="width:454px" %)An association to the Dimension components that comprise the group. 180 +|DimensionDescriptor|(% style="width:194px" %)((( 179 179 Inherits from 180 180 //ComponentList// 181 -)))|(% 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.182 -| (%style="width:209px" %)|(% style="width:175px" %)/components|(% style="width:454px" %)(((183 -An association to the [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]]and Time[[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]]comprising the Key Descriptor.183 +)))|(% 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. 184 +| |(% style="width:194px" %)/components|(% style="width:454px" %)((( 185 +An association to the Dimension and Time Dimension comprising the Key Descriptor. 184 184 ))) 185 -| (% style="width:209px" %)AttributeDescriptor|(% style="width:175px" %)(((187 +|AttributeDescriptor|(% style="width:194px" %)((( 186 186 Inherits from 187 187 //ComponentList// 188 -)))|(% style="width:454px" %)A set metadata (% style="color:#2ecc71" %)concepts(%%)that define the[[Attributes>>doc:xwiki:Glossary.Attribute.WebHome]]of a Data Structure Definition.189 -| (%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]].190 -| (% style="width:209px" %)MeasureDescriptor|(% style="width:175px" %)(((190 +)))|(% style="width:454px" %)A set metadata concepts that define the Attributes of a Data Structure Definition. 191 +| |(% style="width:194px" %)/components|(% style="width:454px" %)An association to a Data Attribute component. 192 +|MeasureDescriptor|(% style="width:194px" %)((( 191 191 Inherits from 192 192 //ComponentList// 193 -)))|(% style="width:454px" %)A metadata (% style="color:#2ecc71" %)concept(%%)that defines the[[Measures>>doc:xwiki:Glossary.Measure.WebHome]]of a Data Structure Definition.194 -| (%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]].195 -| (% style="width:209px" %)//DimensionComponent//|(% style="width:175px" %)(((195 +)))|(% style="width:454px" %)A metadata concept that defines the Measures of a Data Structure Definition. 196 +| |(% style="width:194px" %)/components|(% style="width:454px" %)An association to a Measure component. 197 +|//DimensionComponent//|(% style="width:194px" %)((( 196 196 Inherits from 197 -// [[Component>>doc:xwiki:Glossary.Component.WebHome]]//199 +//Component// 198 198 199 -Sub class [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]]201 +Sub class Dimension 200 200 TimeDimension 201 -)))|(% style="width:454px" %)An abstract class representing any [[Component>>doc:xwiki:Glossary.Component.WebHome]]that can be used for identifying observations.202 -| (%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.Datastructure 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.203 -| (% style="width:209px" %)[[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]]|(% style="width:175px" %)(((203 +)))|(% style="width:454px" %)An abstract class representing any Component that can be used for identifying observations. 204 +| |(% 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. 205 +|Dimension|(% style="width:194px" %)((( 204 204 Inherits from 205 205 //DimensionComponent// 206 -)))|(% 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.Economicactivity.WebHome]] or a geographical reference area.207 -| (%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.208 -| (%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]].209 -| (% style="width:209px" %)TimeDimension|(% style="width:175px" %)(((208 +)))|(% 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. 209 +| |(% 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. 210 +| |(% style="width:194px" %)/conceptIdentity|(% style="width:454px" %)An association to the metadata concept which defines the semantic of the Dimension. 211 +|TimeDimension|(% style="width:194px" %)((( 210 210 Inherits from 211 211 //DimensionComponent// 212 -)))|(% 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”.213 -| (% style="width:209px" %)DataAttribute|(% style="width:175px" %)(((214 +)))|(% style="width:454px" %)A metadata concept that identifies the component in the key structure that has the role of “time”. 215 +|DataAttribute|(% style="width:194px" %)((( 214 214 Inherits from 215 -//[[Component>>doc:xwiki:Glossary.Component.WebHome]]// 217 + 218 +//Component// 216 216 )))|(% style="width:454px" %)A characteristic of an object or entity. 217 -| (%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.218 -| (%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.219 -| (%style="width:209px" %)|(% style="width:175px" %)maxOccurs|(% style="width:454px" %)Defines the maximum allowed occurrences for the[[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]].220 -| (%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.221 -| (%style="width:209px" %)|(% style="width:175px" %)+relatedTo|(% style="width:454px" %)Association to an[[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]]Relationship.222 -| (%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]].223 -| (% style="width:209px" %)[[Measure>>doc:xwiki:Glossary.Measure.WebHome]]|(% style="width:175px" %)(((220 +| |(% 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. 221 +| |(% style="width:194px" %)minOccurs|(% style="width:454px" %)Defines the minimum required occurrences for the Attribute. When equals to zero, the Attribute is conditional. 222 +| |(% style="width:194px" %)maxOccurs|(% style="width:454px" %)Defines the maximum allowed occurrences for the Attribute. 223 +| |(% style="width:194px" %)usage|(% style="width:454px" %)Defines whether a Data Attribute must be reported or not. 224 +| |(% style="width:194px" %)+relatedTo|(% style="width:454px" %)Association to an Attribute Relationship. 225 +| |(% style="width:194px" %)/conceptIdentity|(% style="width:454px" %)An association to the Concept which defines the semantic of the component. 226 +|Measure|(% style="width:194px" %)((( 224 224 Inherits from 225 -// [[Component>>doc:xwiki:Glossary.Component.WebHome]]//226 -)))|(% style="width:454px" %)The metadata (% style="color:#2ecc71" %)concept(%%)that is the phenomenon to be measured in a[[data set>>doc:xwiki:Glossary.Dataset.WebHome]].In a[[data set>>doc:xwiki:Glossary.Dataset.WebHome]] the instance of the[[measure>>doc:xwiki:Glossary.Measure.WebHome]]is often called the observation.227 -| (%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]].228 -| (%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.229 -| (%style="width:209px" %)|(% style="width:175px" %)maxOccurs|(% style="width:454px" %)Defines the maximum allowed occurrences for the[[Measure>>doc:xwiki:Glossary.Measure.WebHome]].230 -| (%style="width:209px" %)|(% style="width:175px" %)usage|(% style="width:454px" %)Defines whether a[[Measure>>doc:xwiki:Glossary.Measure.WebHome]]must be reported or not.231 -| (% style="width:209px" %)//AttributeRelationship//|(% style="width:175px" %)(((228 +//Component// 229 +)))|(% 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. 230 +| |(% style="width:194px" %)/conceptIdentity|(% style="width:454px" %)An association to the Concept which carries the values of the measures. 231 +| |(% style="width:194px" %)minOccurs|(% style="width:454px" %)Defines the minimum required occurrences for the Measure. When equals to zero, the Measure is conditional. 232 +| |(% style="width:194px" %)maxOccurs|(% style="width:454px" %)Defines the maximum allowed occurrences for the Measure. 233 +| |(% style="width:194px" %)usage|(% style="width:454px" %)Defines whether a Measure must be reported or not. 234 +|//AttributeRelationship//|(% style="width:194px" %)((( 232 232 Abstract Class 233 233 Sub classes 234 234 ObservationRelationship 235 -GroupRelationship DimensionRelationship 236 -)))|(% 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]].237 -| (% 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]].238 -| (% 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.239 -| (%style="width:209px" %)|(% style="width:175px" %)+groupKey|(% style="width:454px" %)An association to the Group[[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]]Descriptor240 -| (% 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]].241 -| (%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.242 -| (%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.243 -| (% 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.244 -| (%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.245 -| (% 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]].246 -| (% 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]].247 -| (%style="width:209px" %)|(% style="width:175px" %)+name|(% style="width:454px" %)An association of a Sentinel Value to a multilingual name.248 -| (%style="width:209px" %)|(% style="width:175px" %)+description|(% style="width:454px" %)An association of a Sentinel Value to a multilingual description.238 +GroupRelationship DimensionRelationshi p 239 +)))|(% style="width:454px" %)Specifies the type of artefact to which a Data Attribute can be attached in a Data Set. 240 +|ObservationRelationsh ip|(% style="width:194px" %) |(% style="width:454px" %)The Data Attribute is related to the observations of the Data Set. 241 +|GroupRelationship|(% style="width:194px" %) |(% style="width:454px" %)The Data Attribute is related to a Group Dimension Descriptor construct. 242 +| |(% style="width:194px" %)+groupKey|(% style="width:454px" %)An association to the Group Dimension Descriptor 243 +|DimensionRelationship|(% style="width:194px" %) |(% style="width:454px" %)The Data Attribute is related to a set of Dimensions. 244 +| |(% style="width:194px" %)+dimensions|(% style="width:454px" %)Association to the set of Dimensions to which the Data Attribute is related. 245 +| |(% 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. 246 +|MeasureRelationship|(% style="width:194px" %) |(% style="width:454px" %)The Measures that a Data Attribute is reported for. 247 +| |(% style="width:194px" %)+measures|(% style="width:454px" %)Association to the set of Measures to which a Data Attribute is related to. 248 +|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. 249 +|SentinelValue|(% style="width:194px" %) |(% style="width:454px" %)A value that has a special meaning within the text format representation of the Component. 250 +| |(% style="width:194px" %)+name|(% style="width:454px" %)An association of a Sentinel Value to a multilingual name. 251 +| |(% style="width:194px" %)+description|(% style="width:454px" %)An association of a Sentinel Value to a multilingual description. 249 249 ))) 250 250 251 -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.Statisticaldata and metadata exchange.WebHome]]Base.254 +The explanation of the classes, attributes, and associations comprising the Representation is described in the section on the SDMX Base. 252 252 253 253 == 5.4 Data Set – Relationship View == 254 254 255 255 === 5.4.1 Context === 256 256 257 -A [[data set>>doc:xwiki:Glossary.Dataset.WebHome]]comprises the collection of data values and associated metadata that are collected or disseminated according to a known DataStructureDefinition.260 +A data set comprises the collection of data values and associated metadata that are collected or disseminated according to a known DataStructureDefinition. 258 258 259 259 === 5.4.2 Class Diagram === 260 260 ... ... @@ -266,25 +266,25 @@ 266 266 267 267 ==== 5.4.3.1 Narrative – Data Set ==== 268 268 269 -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.Dataset.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.Structuralmetadata.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.272 +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. 270 270 271 -An organisation playing the role of DataProvider can be responsible for one or more // [[DataSet>>doc:xwiki:Glossary.Data set.WebHome]]//.274 +An organisation playing the role of DataProvider can be responsible for one or more //DataSet//. 272 272 273 -A // [[DataSet>>doc:xwiki:Glossary.Data set.WebHome]]// is formatted as a DataStructureDefinition specific[[data set>>doc:xwiki:Glossary.Dataset.WebHome]](StructureSpecificDataSet). The structured[[data set>>doc:xwiki:Glossary.Dataset.WebHome]]is structured according to one specific DataStructureDefinition; hence the latter is required for validation at the syntax(% style="color:#2ecc71" %)level(%%).276 +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. 274 274 275 -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 associated278 +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 276 276 277 -//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.280 +//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. 278 278 279 -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]]//).282 +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//). 280 280 281 -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.284 +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. 282 282 283 283 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). 284 284 285 -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.288 +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. 286 286 287 -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.Datastructure 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.290 +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. 288 288 289 289 The //AttributeValue// links to the object type (SeriesKey, GroupKey, Observation) to which it is associated. 290 290