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

From version 8.2
edited by Helena
on 2025/05/16 13:49
Change comment: There is no comment for this version
To version 10.1
edited by Helena
on 2025/05/16 23:08
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -4,15 +4,15 @@
4 4  
5 5  == 5.1 Introduction ==
6 6  
7 -The DataStructureDefiniton is the class name for a structure definition for data. Some organisations know this type of definition as a “Key Family” and so the two names are synonymous. The term Data Structure Definition (also referred to as DSD) is used in this specification.
7 +The DataStructureDefiniton is the class name for a structure definition for data. Some organisations know this type of definition as a “Key Family” and so the two names are synonymous. The term [[Data Structure Definition>>doc:xwiki:Glossary.Data structure definition.WebHome]] (also referred to as [[DSD>>doc:xwiki:Glossary.Data structure definition.WebHome]]) is used in this specification.
8 8  
9 -Many of the constructs in this layer of the model inherit from the SDMX Base Layer. Therefore, it is necessary to study both the inheritance and the relationship diagrams to understand the functionality of individual packages. In simple sub models these are shown in the same diagram but are omitted from the more complex sub models for the sake of clarity. In these cases, the inheritance diagram below shows the full inheritance tree for the classes concerned with data structure definitions.
9 +Many of the constructs in this layer of the model inherit from the [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] Base Layer. Therefore, it is necessary to study both the inheritance and the relationship diagrams to understand the functionality of individual packages. In simple sub models these are shown in the same diagram but are omitted from the more complex sub models for the sake of clarity. In these cases, the inheritance diagram below shows the full inheritance tree for the classes concerned with data structure definitions.
10 10  
11 -There are very few additional classes in this sub model other than those shown in the inheritance diagram below. In other words, the SDMX Base gives most of the structure of this sub model both in terms of associations and in terms of attributes. The relationship diagrams shown in this section show clearly when these associations are inherited from the SDMX Base (see the Appendix “A Short Guide to UML in the SDMX Information Model” to see the diagrammatic notation used to depict this).
11 +There are very few additional classes in this sub model other than those shown in the inheritance diagram below. In other words, the [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] Base gives most of the structure of this sub model both in terms of associations and in terms of [[attributes>>doc:xwiki:Glossary.Attribute.WebHome]]. The relationship diagrams shown in this section show clearly when these associations are inherited from the [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] Base (see the Appendix “A Short Guide to UML in the [[SDMX Information Model>>doc:xwiki:Glossary.SDMX Information Model.WebHome]]” to see the diagrammatic notation used to depict this).
12 12  
13 -The actual SDMX Base construct from which the concrete classes inherit depends upon the requirements of the class for:
13 +The actual [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] Base construct from which the concrete classes inherit depends upon the requirements of the class for:
14 14  
15 -Annotation – //AnnotableArtefact//
15 +[[Annotation>>doc:xwiki:Glossary.Annotation.WebHome]] – //AnnotableArtefact//
16 16  Identification – //IdentifiableArtefact//
17 17  Naming – //NameableArtefact//
18 18  Versioning – //VersionableArtefact//
... ... @@ -30,72 +30,59 @@
30 30  
31 31  ==== 5.2.2.1 Narrative ====
32 32  
33 -Those classes in the SDMX metamodel which require annotations inherit from //AnnotableArtefact//. These are:
33 +Those classes in the [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] metamodel which require [[annotations>>doc:xwiki:Glossary.Annotation.WebHome]] inherit from //AnnotableArtefact//. These are:
34 34  
35 -//IdentifiableArtefact//
36 -
37 -//DataSet//
38 -
39 -//Key// (and therefore //SeriesKey// and //GroupKey//)
40 -
35 +//IdentifiableArtefact
36 +[[DataSet>>doc:xwiki:Glossary.Data set.WebHome]]
37 +Key// (and therefore //SeriesKey// and //GroupKey//)
41 41  //Observation//
42 42  
43 -Those classes in the SDMX metamodel which require annotations and global identity are derived from //IdentifiableArtefact//. These are:
40 +Those classes in the [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] metamodel which require [[annotations>>doc:xwiki:Glossary.Annotation.WebHome]] and global identity are derived from //IdentifiableArtefact//. These are:
44 44  
45 -//NameableArtefact//
42 +//NameableArtefact
43 +ComponentList
44 +[[Component>>doc:xwiki:Glossary.Component.WebHome]]//
46 46  
47 -//ComponentList//
46 +Those classes in the [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] metamodel which require [[annotations>>doc:xwiki:Glossary.Annotation.WebHome]], global identity, multilingual name and multilingual description are derived from //NameableArtefact//. These are:
48 48  
49 -//Component//
48 +//VersionableArtefact
49 +Item//
50 50  
51 -Those classes in the SDMX metamodel which require annotations, global identity, multilingual name and multilingual description are derived from //NameableArtefact//. These are:
51 +The classes in the [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] metamodel which require [[annotations>>doc:xwiki:Glossary.Annotation.WebHome]], global identity, multilingual name and multilingual description, and versioning are derived from //VersionableArtefact//. These are:
52 52  
53 -//VersionableArtefact//
54 -
55 -//Item//
56 -
57 -The classes in the SDMX metamodel which require annotations, global identity, multilingual name and multilingual description, and versioning are derived from //VersionableArtefact//. These are:
58 -
59 59  //MaintainableArtefact//
60 60  
61 -Abstract classes which represent information that is maintained by Maintenance Agencies all inherit from //MaintainableArtefact//, they also inherit all the features of a //VersionableArtefact//, and are:
55 +Abstract classes which represent information that is maintained by [[Maintenance Agencies>>doc:xwiki:Glossary.Maintenance agency.WebHome]] all inherit from //MaintainableArtefact//, they also inherit all the features of a //VersionableArtefact//, and are:
62 62  
63 -//StructureUsage//
57 +//StructureUsage
58 +Structure
59 +ItemScheme//
64 64  
65 -//Structure//
66 -
67 -//ItemScheme//
68 -
69 69  All the above classes are abstract. The key to understanding the class diagrams presented in this section are the concrete classes that inherit from these abstract classes.
70 70  
71 -Those concrete classes in the SDMX Data Structure Definition and Dataset packages of the metamodel which require to be maintained by Agencies all inherit (via other abstract classes) from //MaintainableArtefact//, these are:
63 +Those concrete classes in the [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] [[Data Structure Definition>>doc:xwiki:Glossary.Data structure definition.WebHome]] and [[Dataset>>doc:xwiki:Glossary.Data set.WebHome]] packages of the metamodel which require to be maintained by Agencies all inherit (via other abstract classes) from //MaintainableArtefact//, these are:
72 72  
73 73  Dataflow
74 -
75 75  DataStructureDefinition
76 76  
77 -The component structures that are lists of lists, inherit directly from //Structure//. A //Structure// contains several lists of components. The concrete class that inherits from //Structure// is:
68 +The [[component>>doc:xwiki:Glossary.Component.WebHome]] structures that are lists of lists, inherit directly from //Structure//. A //Structure// contains several lists of [[components>>doc:xwiki:Glossary.Component.WebHome]]. The concrete class that inherits from //Structure// is:
78 78  
79 79  DataStructureDefinition
80 80  
81 -A DataStructureDefinition contains a list of dimensions, a list of measures and a list of attributes.
72 +A DataStructureDefinition contains a list of [[dimensions>>doc:xwiki:Glossary.Dimension.WebHome]], a list of [[measures>>doc:xwiki:Glossary.Measure.WebHome]] and a list of attributes.
82 82  
83 83  The concrete classes which inherit from //ComponentList// and are subcomponents of the DataStructureDefinition are:
84 84  
85 -DimensionDescriptor – content is Dimension and TimeDimension
86 -
87 -DimensionGroupDescriptor – content is an association to Dimension, TimeDimension
88 -
76 +DimensionDescriptor – content is [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] and TimeDimension
77 +DimensionGroupDescriptor – content is an association to [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]], TimeDimension
89 89  MeasureDescriptor – content is Measure
90 -
91 91  AttributeDescriptor – content is DataAttribute and an association to MetadataAttribute
92 92  
93 -The classes that inherit from //Component// are:
81 +The classes that inherit from //[[Component>>doc:xwiki:Glossary.Component.WebHome]]// are:
94 94  
95 95  Measure
96 96  
97 -//DimensionComponent// and thereby its sub classes of Dimension and TimeDimension
98 -
85 +//DimensionComponent// and thereby its sub classes of [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] and TimeDimension
99 99  //Attribute// and thereby its sub classes of DataAttribute and MetadataAttribute
100 100  
101 101  The concrete classes identified above are the majority of the classes required to define the metamodel for the DataStructureDefinition. The diagrams and explanations in the rest of this section show how these concrete classes are related in order to support the functionality required.
... ... @@ -112,42 +112,42 @@
112 112  
113 113  ==== 5.3.2.1 Narrative ====
114 114  
115 -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.
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.
116 116  
117 -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.
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.Data set.WebHome]] to be reported/disseminated.
118 118  
119 -There are two types of dimensions each having a common association to Concept:
106 +There are two types of [[dimensions>>doc:xwiki:Glossary.Dimension.WebHome]] each having a common association to (% style="color:#2ecc71" %)Concept(%%):
120 120  
121 -* Dimension
108 +* [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]]
122 122  * TimeDimension
123 123  
124 -Note that DimensionComponent can be any or all its sub classes i.e., Dimension, TimeDimension.
111 +Note that DimensionComponent can be any or all its sub classes i.e., [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]], TimeDimension.
125 125  
126 -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.
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.Statistical data and metadata exchange.WebHome]] (% style="color:#2ecc71" %)CONCEPT(%%) ROLES" by the [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] SWG. The use of these roles is to enable applications to process the data in a meaningful way (e.g., relating a [[dimension>>doc: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.
127 127  
128 -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.
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.
129 129  
130 -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.
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.
131 131  
132 -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.
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.Data set.WebHome]] to declare which DataAttributes or MetadataAttributes are reported at this group (% style="color:#2ecc71" %)level(%%) in the [[DataSet>>doc:xwiki:Glossary.Data set.WebHome]].
133 133  
134 -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.
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.Time period.WebHome]] of the observation in a [[data set>>doc:xwiki:Glossary.Data set.WebHome]]. The TimeDimension must contain a valid [[representation>>doc:xwiki:Glossary.Representation.WebHome]] of time and cannot be coded.
135 135  
136 -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.
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.
137 137  
138 -The AttributeDescriptor may contain one or more //Attribute//s, i.e., at least one DataAttribute definition or one MetadataAttribute reference.
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.
139 139  
140 -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.
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.
141 141  
142 -The MetadataAttribute defines reference metadata that may be collected or disseminated and is grouped together with DataAttribute under the AttributeDescriptor.
129 +The MetadataAttribute defines [[reference metadata>>doc:xwiki:Glossary.Reference metadata.WebHome]] that may be collected or disseminated and is grouped together with DataAttribute under the AttributeDescriptor.
143 143  
144 -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:
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]]:
145 145  
146 -* All data within the dataset (DataflowRelationship) – this is equivalent to attaching an Attribute to all data within the Dataflow.
147 -* Dimension or set of Dimensions (DimensionRelationship)
148 -* Set of Dimensions specified by a GroupKey (GroupRelationship – this is retained for compatibility reasons – or +groupKey of the DimensionRelationship)
133 +* All data within the [[dataset>>doc:xwiki:Glossary.Data set.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)
149 149  * Observation (ObservationRelationship)
150 -* 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.
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.Data structure 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]].
151 151  
152 152  [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_f235bfd4.jpg||height="542" width="604"]]
153 153  
... ... @@ -157,135 +157,117 @@
157 157  
158 158  (% style="width:839.039px" %)
159 159  |**Relationship**|(% style="width:384px" %)**Meaning**|(% style="width:303px" %)**Location in Data Set at which the Attribute is reported**
160 -|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.
161 -|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.
162 -|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.
163 -|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.
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.Data set.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.Data set.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.
164 164  
165 165  [[image:SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_42ff01fb.jpg||height="380" width="590"]]
166 166  
167 167  **Figure 30: Representation of DSD Components**
168 168  
169 -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
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.Data set.WebHome]] diagram further down). An exception is the MetadataAttribute, where its [[Representation>>doc:xwiki:Glossary.Representation.WebHome]] is specified in the MetadataStructureDefinition.
170 170  
171 -(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.
172 -
173 173  A DataStructureDefinition can be extended to form a derived DataStructureDefinition. This is supported in the StructureMap.
174 174  
175 175  ==== 5.3.2.2 Definitions ====
176 176  
177 -:
178 -
179 179  (((
180 180  (% style="width:834.039px" %)
181 -|**Class**|(% style="width:194px" %)**Feature**|(% style="width:454px" %)**Description**
182 -|StructureUsage|(% style="width:194px" %) |(% style="width:454px" %)See “SDMX Base”.
183 -|Dataflow|(% style="width:194px" %)(((
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.Statistical data and metadata exchange.WebHome]] Base”.
166 +|(% style="width:209px" %)[[Dataflow>>doc:xwiki:Glossary.Dataflow.WebHome]]|(% style="width:175px" %)(((
184 184  Inherits from
185 -
186 186  //StructureUsage//
187 -)))|(% 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.
188 -| |(% style="width:194px" %)/structure|(% style="width:454px" %)Associates a Dataflow to the Data Structure Definition.
189 -|DataStructureDefiniti on|(% style="width:194px" %) |(% style="width:454px" %)A collection of metadata concepts, their structure and usage when used to collect or disseminate data.
190 -| |(% 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.
191 -|GroupDimensionDescrip tor|(% style="width:194px" %)(((
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" %)(((
192 192  Inherits from
193 -
194 194  //ComponentList//
195 -)))|(% style="width:454px" %)A set of metadata concepts that define a partial key derived from the Dimension Descriptor in a Data Structure Definition.
196 -| |(% style="width:194px" %)/components|(% style="width:454px" %)An association to the Dimension components that comprise the group.
197 -|DimensionDescriptor|(% style="width:194px" %)(((
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" %)(((
198 198  Inherits from
199 -
200 200  //ComponentList//
201 -)))|(% 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.
202 -| |(% style="width:194px" %)/components|(% style="width:454px" %)(((
203 -An association to the Dimension and Time Dimension comprising the Key Descriptor.
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.
204 204  )))
205 -|AttributeDescriptor|(% style="width:194px" %)(((
185 +|(% style="width:209px" %)AttributeDescriptor|(% style="width:175px" %)(((
206 206  Inherits from
207 -
208 208  //ComponentList//
209 -)))|(% style="width:454px" %)A set metadata concepts that define the Attributes of a Data Structure Definition.
210 -| |(% style="width:194px" %)/components|(% style="width:454px" %)An association to a Data Attribute component.
211 -|MeasureDescriptor|(% style="width:194px" %)(((
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" %)(((
212 212  Inherits from
213 -
214 214  //ComponentList//
215 -)))|(% style="width:454px" %)A metadata concept that defines the Measures of a Data Structure Definition.
216 -| |(% style="width:194px" %)/components|(% style="width:454px" %)An association to a Measure component.
217 -|//DimensionComponent//|(% style="width:194px" %)(((
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" %)(((
218 218  Inherits from
197 +//[[Component>>doc:xwiki:Glossary.Component.WebHome]]//
219 219  
220 -//Component//
221 -
222 -Sub class Dimension
223 -
199 +Sub class [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]]
224 224  TimeDimension
225 -)))|(% style="width:454px" %)An abstract class representing any Component that can be used for identifying observations.
226 -| |(% 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.
227 -|Dimension|(% style="width:194px" %)(((
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.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.
203 +|(% style="width:209px" %)[[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]]|(% style="width:175px" %)(((
228 228  Inherits from
229 -
230 230  //DimensionComponent//
231 -)))|(% 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.
232 -| |(% 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.
233 -| |(% style="width:194px" %)/conceptIdentity|(% style="width:454px" %)An association to the metadata concept which defines the semantic of the Dimension.
234 -|TimeDimension|(% style="width:194px" %)(((
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.Economic activity.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" %)(((
235 235  Inherits from
236 -
237 237  //DimensionComponent//
238 -)))|(% style="width:454px" %)A metadata concept that identifies the component in the key structure that has the role of “time”.
239 -|DataAttribute|(% style="width:194px" %)(((
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" %)(((
240 240  Inherits from
241 -
242 -//Component//
215 +//[[Component>>doc:xwiki:Glossary.Component.WebHome]]//
243 243  )))|(% style="width:454px" %)A characteristic of an object or entity.
244 -| |(% 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.
245 -| |(% style="width:194px" %)minOccurs|(% style="width:454px" %)Defines the minimum required occurrences for the Attribute. When equals to zero, the Attribute is conditional.
246 -| |(% style="width:194px" %)maxOccurs|(% style="width:454px" %)Defines the maximum allowed occurrences for the Attribute.
247 -| |(% style="width:194px" %)usage|(% style="width:454px" %)Defines whether a Data Attribute must be reported or not.
248 -| |(% style="width:194px" %)+relatedTo|(% style="width:454px" %)Association to an Attribute Relationship.
249 -| |(% style="width:194px" %)/conceptIdentity|(% style="width:454px" %)An association to the Concept which defines the semantic of the component.
250 -|Measure|(% style="width:194px" %)(((
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" %)(((
251 251  Inherits from
252 -
253 -//Component//
254 -)))|(% 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.
255 -| |(% style="width:194px" %)/conceptIdentity|(% style="width:454px" %)An association to the Concept which carries the values of the measures.
256 -| |(% style="width:194px" %)minOccurs|(% style="width:454px" %)Defines the minimum required occurrences for the Measure. When equals to zero, the Measure is conditional.
257 -| |(% style="width:194px" %)maxOccurs|(% style="width:454px" %)Defines the maximum allowed occurrences for the Measure.
258 -| |(% style="width:194px" %)usage|(% style="width:454px" %)Defines whether a Measure must be reported or not.
259 -|//AttributeRelationship//|(% style="width:194px" %)(((
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.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.
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" %)(((
260 260  Abstract Class
261 -
262 262  Sub classes
263 -
264 264  ObservationRelationship
265 -
266 -GroupRelationship DimensionRelationshi p
267 -)))|(% style="width:454px" %)Specifies the type of artefact to which a Data Attribute can be attached in a Data Set.
268 -|ObservationRelationsh ip|(% style="width:194px" %) |(% style="width:454px" %)The Data Attribute is related to the observations of the Data Set.
269 -|GroupRelationship|(% style="width:194px" %) |(% style="width:454px" %)The Data Attribute is related to a Group Dimension Descriptor construct.
270 -| |(% style="width:194px" %)+groupKey|(% style="width:454px" %)An association to the Group Dimension Descriptor
271 -|DimensionRelationship|(% style="width:194px" %) |(% style="width:454px" %)The Data Attribute is related to a set of Dimensions.
272 -| |(% style="width:194px" %)+dimensions|(% style="width:454px" %)Association to the set of Dimensions to which the Data Attribute is related.
273 -| |(% 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.
274 -|MeasureRelationship|(% style="width:194px" %) |(% style="width:454px" %)The Measures that a Data Attribute is reported for.
275 -| |(% style="width:194px" %)+measures|(% style="width:454px" %)Association to the set of Measures to which a Data Attribute is related to.
276 -|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.
277 -|SentinelValue|(% style="width:194px" %) |(% style="width:454px" %)A value that has a special meaning within the text format representation of the Component.
278 -| |(% style="width:194px" %)+name|(% style="width:454px" %)An association of a Sentinel Value to a multilingual name.
279 -| |(% style="width:194px" %)+description|(% style="width:454px" %)An association of a Sentinel Value to a multilingual description.
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]] Descriptor
240 +|(% 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.
280 280  )))
281 281  
282 -The explanation of the classes, attributes, and associations comprising the Representation is described in the section on the SDMX Base.
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.Statistical data and metadata exchange.WebHome]] Base.
283 283  
284 284  == 5.4 Data Set – Relationship View ==
285 285  
286 286  === 5.4.1 Context ===
287 287  
288 -A data set comprises the collection of data values and associated metadata that are collected or disseminated according to a known DataStructureDefinition.
257 +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.
289 289  
290 290  === 5.4.2 Class Diagram ===
291 291  
... ... @@ -297,27 +297,25 @@
297 297  
298 298  ==== 5.4.3.1 Narrative – Data Set ====
299 299  
300 -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.
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.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.
301 301  
302 -An organisation playing the role of DataProvider can be responsible for one or more //DataSet//.
271 +An organisation playing the role of DataProvider can be responsible for one or more //[[DataSet>>doc:xwiki:Glossary.Data set.WebHome]]//.
303 303  
304 -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.
273 +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(%%).
305 305  
306 -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
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 associated
307 307  
308 -DimensionDescriptor of the DataStructureDefinition, together with associated
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.
309 309  
310 -//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.
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]]//).
311 311  
312 -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//).
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.
313 313  
314 -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.
315 -
316 316  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).
317 317  
318 -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.
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.
319 319  
320 -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.
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.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.
321 321  
322 322  The //AttributeValue// links to the object type (SeriesKey, GroupKey, Observation) to which it is associated.
323 323  
... ... @@ -324,194 +324,153 @@
324 324  ==== 5.4.3.2 Definitions ====
325 325  
326 326  (% style="width:812.039px" %)
327 -|(% style="width:147px" %)**Class**|(% style="width:222px" %)**Feature**|(% style="width:437px" %)**Description**
328 -|(% style="width:147px" %)//DataSet//|(% style="width:222px" %)(((
294 +|(% style="width:147px" %)**Class**|(% style="width:246px" %)**Feature**|(% style="width:395px" %)**Description**
295 +|(% style="width:147px" %)//[[DataSet>>doc:xwiki:Glossary.Data set.WebHome]]//|(% style="width:246px" %)(((
329 329  Abstract Class
330 -
331 331  Sub classes
332 -
333 333  StructureSpecificData
334 -
335 335  Set
336 -)))|(% style="width:437px" %)An organised collection of data.
337 -|(% style="width:147px" %) |(% style="width:222px" %)reportingBegin|(% style="width:437px" %)A specific time period in a known system of time periods that identifies the start period of a report.
338 -|(% style="width:147px" %) |(% style="width:222px" %)reportingEnd|(% style="width:437px" %)A specific time period in a known system of time periods that identifies the end period of a report.
339 -|(% style="width:147px" %) |(% style="width:222px" %)dataExtractionDate|(% style="width:437px" %)A specific time period that identifies the date and time that the data are extracted from a data source.
340 -|(% style="width:147px" %) |(% style="width:222px" %)validFrom|(% style="width:437px" %)Indicates the inclusive start time indicating the validity of the information in the data set.
341 -|(% style="width:147px" %) |(% style="width:222px" %)validTo|(% style="width:437px" %)Indicates the inclusive end time indicating the validity of the information in the data set.
342 -|(% style="width:147px" %) |(% style="width:222px" %)publicationYear|(% style="width:437px" %)Specifies the year of publication of the data or metadata in terms of whatever provisioning agreements might be in force.
343 -|(% style="width:147px" %) |(% style="width:222px" %)publicationPeriod|(% style="width:437px" %)Specifies the period of publication of the data or metadata in terms of whatever provisioning agreements might be in force.
344 -|(% style="width:147px" %) |(% style="width:222px" %)setId|(% style="width:437px" %)Provides an identification of the data set.
345 -|(% style="width:147px" %) |(% style="width:222px" %)action|(% style="width:437px" %)Defines the action to be taken by the recipient system (information, append, replace, delete)
346 -|(% style="width:147px" %) |(% style="width:222px" %)describedBy|(% style="width:437px" %)Associates a Dataflow and thereby a Data Structure Definition to the data set.
347 -|(% style="width:147px" %) |(% style="width:222px" %)+structuredBy|(% style="width:437px" %)Associates the Data Structure Definition that defines the structure of the Data Set. Note that the Data Structure Definition is the same as that associated (non-mandatory) to the Dataflow.
348 -|(% style="width:147px" %) |(% style="width:222px" %)+publishedBy|(% style="width:437px" %)Associates the Data Provider that reports/publishes the data.
349 -|(% style="width:147px" %)StructureSpecific DataSet|(% style="width:222px" %) |(% style="width:437px" %)An XML specific data format structure that contains data corresponding to one specific Data Structure Definition.
350 -|(% style="width:147px" %)//Key//|(% style="width:222px" %)(((
300 +)))|(% style="width:395px" %)An organised collection of data.
301 +|(% style="width:147px" %) |(% style="width:246px" %)reportingBegin|(% style="width:395px" %)A specific [[time period>>doc:xwiki:Glossary.Time period.WebHome]] in a known system of [[time periods>>doc:xwiki:Glossary.Time period.WebHome]] that identifies the start period of a report.
302 +|(% style="width:147px" %) |(% style="width:246px" %)reportingEnd|(% style="width:395px" %)A specific [[time period>>doc:xwiki:Glossary.Time period.WebHome]] in a known system of [[time periods>>doc:xwiki:Glossary.Time period.WebHome]] that identifies the end period of a report.
303 +|(% style="width:147px" %) |(% style="width:246px" %)dataExtractionDate|(% style="width:395px" %)A specific [[time period>>doc:xwiki:Glossary.Time period.WebHome]] that identifies the date and time that the data are extracted from a data source.
304 +|(% style="width:147px" %) |(% style="width:246px" %)validFrom|(% style="width:395px" %)Indicates the inclusive start time indicating the validity of the information in the [[data set>>doc:xwiki:Glossary.Data set.WebHome]].
305 +|(% style="width:147px" %) |(% style="width:246px" %)validTo|(% style="width:395px" %)Indicates the inclusive end time indicating the validity of the information in the [[data set>>doc:xwiki:Glossary.Data set.WebHome]].
306 +|(% style="width:147px" %) |(% style="width:246px" %)publicationYear|(% style="width:395px" %)Specifies the year of publication of the data or metadata in terms of whatever provisioning agreements might be in force.
307 +|(% style="width:147px" %) |(% style="width:246px" %)publicationPeriod|(% style="width:395px" %)Specifies the period of publication of the data or metadata in terms of whatever provisioning agreements might be in force.
308 +|(% style="width:147px" %) |(% style="width:246px" %)setId|(% style="width:395px" %)Provides an identification of the [[data set>>doc:xwiki:Glossary.Data set.WebHome]].
309 +|(% style="width:147px" %) |(% style="width:246px" %)action|(% style="width:395px" %)Defines the action to be taken by the recipient system (information, append, replace, delete)
310 +|(% style="width:147px" %) |(% style="width:246px" %)describedBy|(% style="width:395px" %)Associates a [[Dataflow>>doc:xwiki:Glossary.Dataflow.WebHome]] and thereby a [[Data Structure Definition>>doc:xwiki:Glossary.Data structure definition.WebHome]] to the [[data set>>doc:xwiki:Glossary.Data set.WebHome]].
311 +|(% style="width:147px" %) |(% style="width:246px" %)+structuredBy|(% style="width:395px" %)Associates the [[Data Structure Definition>>doc:xwiki:Glossary.Data structure definition.WebHome]] that defines the structure of the [[Data Set>>doc:xwiki:Glossary.Data set.WebHome]]. Note that the [[Data Structure Definition>>doc:xwiki:Glossary.Data structure definition.WebHome]] is the same as that associated (non-mandatory) to the [[Dataflow>>doc:xwiki:Glossary.Dataflow.WebHome]].
312 +|(% style="width:147px" %) |(% style="width:246px" %)+publishedBy|(% style="width:395px" %)Associates the [[Data Provider>>doc:xwiki:Glossary.Data provider.WebHome]] that reports/publishes the data.
313 +|(% style="width:147px" %)StructureSpecificDataSet|(% style="width:246px" %) |(% style="width:395px" %)An XML specific data format structure that contains data corresponding to one specific [[Data Structure Definition>>doc:xwiki:Glossary.Data structure definition.WebHome]].
314 +|(% style="width:147px" %)//Key//|(% style="width:246px" %)(((
351 351  Abstract class Sub classes
352 -
353 353  SeriesKey
354 -
355 355  GroupKey
356 -)))|(% style="width:437px" %)Comprises the cross product of values of dimensions that identify uniquely an Observation.
357 -|(% style="width:147px" %) |(% style="width:222px" %)keyValues|(% style="width:437px" %)Association to the individual Key Values that comprise the Key.
358 -|(% style="width:147px" %) |(% style="width:222px" %)+attachedAttribute|(% style="width:437px" %)Association to the Attribute Values relating to the Series Key or Group Key.
359 -|(% style="width:147px" %)//KeyValue//|(% style="width:222px" %)(((
318 +)))|(% style="width:395px" %)Comprises the cross product of values of [[dimensions>>doc:xwiki:Glossary.Dimension.WebHome]] that identify uniquely an Observation.
319 +|(% style="width:147px" %) |(% style="width:246px" %)keyValues|(% style="width:395px" %)Association to the individual Key Values that comprise the Key.
320 +|(% style="width:147px" %) |(% style="width:246px" %)+attachedAttribute|(% style="width:395px" %)Association to the [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] Values relating to the [[Series Key>>doc:xwiki:Glossary.Series key.WebHome]] or Group Key.
321 +|(% style="width:147px" %)//KeyValue//|(% style="width:246px" %)(((
360 360  Abstract class Sub classes
361 -
362 362  TimeKeyValue
363 -
364 364  CodedKeyValue
365 -
366 366  UncodedKeyValue
367 -)))|(% style="width:437px" %)The value of a component of a key such as the value of the instance a Dimension in a Dimension Descriptor of a Data Structure Definition.
368 -|(% style="width:147px" %) |(% style="width:222px" %)+valueFor|(% style="width:437px" %)(((
369 -Association to the key component in the Data Structure Definition for which this Key Value is a valid representation.
370 -Note that this is conceptual association as the key component is identified explicitly in the data set.
326 +)))|(% style="width:395px" %)The value of a [[component>>doc:xwiki:Glossary.Component.WebHome]] of a key such as the value of the instance a [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] in a [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] Descriptor of a [[Data Structure Definition>>doc:xwiki:Glossary.Data structure definition.WebHome]].
327 +|(% style="width:147px" %) |(% style="width:246px" %)+valueFor|(% style="width:395px" %)(((
328 +Association to the key [[component>>doc:xwiki:Glossary.Component.WebHome]] in the [[Data Structure Definition>>doc:xwiki:Glossary.Data structure definition.WebHome]] for which this Key Value is a valid representation.
329 +Note that this is conceptual association as the key [[component>>doc:xwiki:Glossary.Component.WebHome]] is identified explicitly in the [[data set>>doc:xwiki:Glossary.Data set.WebHome]].
371 371  )))
372 -|(% style="width:147px" %)TimeKeyValue|(% style="width:222px" %)(((
331 +|(% style="width:147px" %)TimeKeyValue|(% style="width:246px" %)(((
373 373  Inherits from
374 -
375 375  //KeyValue//
376 -)))|(% style="width:437px" %)The value of the Time Dimension component of the key.
377 -|(% style="width:147px" %)CodedKeyValue|(% style="width:222px" %)(((
334 +)))|(% style="width:395px" %)The value of the Time [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] [[component>>doc:xwiki:Glossary.Component.WebHome]] of the key.
335 +|(% style="width:147px" %)CodedKeyValue|(% style="width:246px" %)(((
378 378  Inherits from
379 -
380 380  //KeyValue//
381 -)))|(% style="width:437px" %)The value of a coded component of the key. The value is the Code to which this class is associated.
382 -|(% style="width:147px" %) |(% style="width:222px" %)+valueOf|(% style="width:437px" %)Association to the Code. Note that this is a conceptual association showing that the Code must exist in the Code list associated with the Dimension in the Data Structure Definition. In the actual Data Set the value of the Code is placed in the Key Value.
383 -|(% style="width:147px" %)UnCodedKeyValue|(% style="width:222px" %)(((
338 +)))|(% style="width:395px" %)The value of a coded [[component>>doc:xwiki:Glossary.Component.WebHome]] of the key. The value is the [[Code>>doc:xwiki:Glossary.Code.WebHome]] to which this class is associated.
339 +|(% style="width:147px" %) |(% style="width:246px" %)+valueOf|(% style="width:395px" %)Association to the [[Code>>doc:xwiki:Glossary.Code.WebHome]]. Note that this is a conceptual association showing that the [[Code>>doc:xwiki:Glossary.Code.WebHome]] must exist in the [[Code list>>doc:xwiki:Glossary.Code list.WebHome]] associated with the [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] in the [[Data Structure Definition>>doc:xwiki:Glossary.Data structure definition.WebHome]]. In the actual [[Data Set>>doc:xwiki:Glossary.Data set.WebHome]] the value of the [[Code>>doc:xwiki:Glossary.Code.WebHome]] is placed in the Key Value.
340 +|(% style="width:147px" %)UnCodedKeyValue|(% style="width:246px" %)(((
384 384  Inherits from
385 -
386 386  //KeyValue//
387 -)))|(% style="width:437px" %)The value of an uncoded component of the key.
388 -|(% style="width:147px" %) |(% style="width:222px" %)value|(% style="width:437px" %)The value of the key component.
389 -|(% style="width:147px" %) |(% style="width:222px" %)startTime|(% style="width:437px" %)This attribute is only used if the textFormat of the attribute is of the Timespan type in the Data Structure Definition (in which case the value field takes a duration).
390 -|(% style="width:147px" %)GroupKey|(% style="width:222px" %)(((
343 +)))|(% style="width:395px" %)The value of an uncoded [[component>>doc:xwiki:Glossary.Component.WebHome]] of the key.
344 +|(% style="width:147px" %) |(% style="width:246px" %)value|(% style="width:395px" %)The value of the key [[component>>doc:xwiki:Glossary.Component.WebHome]].
345 +|(% style="width:147px" %) |(% style="width:246px" %)startTime|(% style="width:395px" %)This [[attribute>>doc:xwiki:Glossary.Attribute.WebHome]] is only used if the textFormat of the [[attribute>>doc:xwiki:Glossary.Attribute.WebHome]] is of the Timespan type in the [[Data Structure Definition>>doc:xwiki:Glossary.Data structure definition.WebHome]] (in which case the value field takes a duration).
346 +|(% style="width:147px" %)GroupKey|(% style="width:246px" %)(((
391 391  Inherits from
392 -
393 393  //Key//
394 -)))|(% style="width:437px" %)A set of Key Values that comprise a partial key, of the same dimensionality as the Time Series Key for the purpose of attaching Data Attributes.
395 -|(% style="width:147px" %) |(% style="width:222px" %)+describedBy|(% style="width:437px" %)Associates the Group Dimension Descriptor defined in the Data Structure Definition.
396 -|(% style="width:147px" %)SeriesKey|(% style="width:222px" %)(((
349 +)))|(% style="width:395px" %)A set of Key Values that comprise a partial key, of the same dimensionality as the Time [[Series Key>>doc:xwiki:Glossary.Series key.WebHome]] for the purpose of attaching Data Attributes.
350 +|(% style="width:147px" %) |(% style="width:246px" %)+describedBy|(% style="width:395px" %)Associates the Group [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] Descriptor defined in the [[Data Structure Definition>>doc:xwiki:Glossary.Data structure definition.WebHome]].
351 +|(% style="width:147px" %)SeriesKey|(% style="width:246px" %)(((
397 397  Inherits from
398 -
399 399  //Key//
400 -)))|(% style="width:437px" %)Comprises the cross product of values of all the Key Values that, together with the Key Value of the +observation Dimension identify uniquely an Observation.
401 -|(% style="width:147px" %) |(% style="width:222px" %)+describedBy|(% style="width:437px" %)Associates the Dimension Descriptor defined in the Data Structure Definition.
402 -|(% style="width:147px" %)Observation|(% style="width:222px" %) |(% style="width:437px" %)The value(s) of the observed phenomenon in the context of the Key Values comprising the key.
403 -|(% style="width:147px" %) |(% style="width:222px" %)+valueFor|(% style="width:437px" %)(((
404 -Associates the Measure(s) defined in the Data Structure Definition.
354 +)))|(% style="width:395px" %)Comprises the cross product of values of all the Key Values that, together with the Key Value of the +observation [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] identify uniquely an Observation.
355 +|(% style="width:147px" %) |(% style="width:246px" %)+describedBy|(% style="width:395px" %)Associates the [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] Descriptor defined in the [[Data Structure Definition>>doc:xwiki:Glossary.Data structure definition.WebHome]].
356 +|(% style="width:147px" %)Observation|(% style="width:246px" %) |(% style="width:395px" %)The value(s) of the observed phenomenon in the context of the Key Values comprising the key.
357 +|(% style="width:147px" %) |(% style="width:246px" %)+valueFor|(% style="width:395px" %)(((
358 +Associates the [[Measure>>doc:xwiki:Glossary.Measure.WebHome]](s) defined in the [[Data Structure Definition>>doc:xwiki:Glossary.Data structure definition.WebHome]].
405 405  
406 -The source multiplicity (1..*) indicates that more than one values may be provided for a Measure, if the latter allows it.
360 +The source multiplicity (1..*) indicates that more than one values may be provided for a [[Measure>>doc:xwiki:Glossary.Measure.WebHome]], if the latter allows it.
407 407  )))
408 -|(% style="width:147px" %) |(% style="width:222px" %)+attachedAttribute|(% style="width:437px" %)Association to the Attribute Values relating to the Observation.
409 -|(% style="width:147px" %) |(% style="width:222px" %)+observationDimension|(% style="width:437px" %)Association to the Key Value that holds the value of the “Dimension at the Observation Level”.
410 -|(% style="width:147px" %)//ObservationValue//|(% style="width:222px" %)(((
362 +|(% style="width:147px" %) |(% style="width:246px" %)+attachedAttribute|(% style="width:395px" %)Association to the [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] Values relating to the Observation.
363 +|(% style="width:147px" %) |(% style="width:246px" %)+observationDimension|(% style="width:395px" %)Association to the Key Value that holds the value of the “[[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] at the Observation Level”.
364 +|(% style="width:147px" %)//ObservationValue//|(% style="width:246px" %)(((
411 411  Abstract class
412 -
413 413  Sub classes
414 -
415 -//UncodedObservationVal//
416 -
417 -//ue//
418 -
367 +//UncodedObservationValue//
419 419  CodedObservation
420 -)))|(% style="width:437px" %)
421 -|(% style="width:147px" %)//UncodedObservatio nValue//|(% style="width:222px" %)(((
369 +)))|(% style="width:395px" %)
370 +|(% style="width:147px" %)//UncodedObservationValue//|(% style="width:246px" %)(((
422 422  Abstract class
423 -
424 424  Inherits from
425 -
426 426  //ObservationValue//
427 -
428 428  Sub classes
429 -
430 -OtherUncodedMeasureVa lue
431 -
375 +OtherUncodedMeasureValue
432 432  TextMeasureValue
433 -)))|(% style="width:437px" %)
434 -|(% style="width:147px" %)OtherUncodedMeasu reValue|(% style="width:222px" %)(((
377 +)))|(% style="width:395px" %)
378 +|(% style="width:147px" %)OtherUncodedMeasureValue|(% style="width:246px" %)(((
435 435  Inherits from
436 436  
437 -//UncodedObservationVal ue//
438 -)))|(% style="width:437px" %)An observation that has a text value.
439 -|(% style="width:147px" %) |(% style="width:222px" %)value|(% style="width:437px" %)The value of the Uncoded Observation.
440 -|(% style="width:147px" %) |(% style="width:222px" %)startTime|(% style="width:437px" %)This attribute is only used if the textFormat of the Measure is of the Timespan type in the Data Structure Definition (in which case the value field takes a duration).
441 -|(% style="width:147px" %)TextMeasureValue|(% style="width:222px" %)(((
381 +//UncodedObservationValue//
382 +)))|(% style="width:395px" %)An observation that has a text value.
383 +|(% style="width:147px" %) |(% style="width:246px" %)value|(% style="width:395px" %)The value of the Uncoded Observation.
384 +|(% style="width:147px" %) |(% style="width:246px" %)startTime|(% style="width:395px" %)This [[attribute>>doc:xwiki:Glossary.Attribute.WebHome]] is only used if the textFormat of the [[Measure>>doc:xwiki:Glossary.Measure.WebHome]] is of the Timespan type in the [[Data Structure Definition>>doc:xwiki:Glossary.Data structure definition.WebHome]] (in which case the value field takes a duration).
385 +|(% style="width:147px" %)TextMeasureValue|(% style="width:246px" %)(((
442 442  Inherits from
443 -
444 -//UncodedObservationVal ue//
445 -)))|(% style="width:437px" %)An observation that has a localised text value
446 -|(% style="width:147px" %) |(% style="width:222px" %)text|(% style="width:437px" %)The localised text values.
447 -|(% style="width:147px" %)CodedObservation|(% style="width:222px" %)(((
387 +//UncodedObservationValue//
388 +)))|(% style="width:395px" %)An observation that has a localised text value
389 +|(% style="width:147px" %) |(% style="width:246px" %)text|(% style="width:395px" %)The localised text values.
390 +|(% style="width:147px" %)CodedObservation|(% style="width:246px" %)(((
448 448  Inherits from
449 -
450 450  //ObservationValue//
451 -)))|(% style="width:437px" %)An Observation that takes its value from a code in a Code list.
452 -|(% style="width:147px" %) |(% style="width:222px" %)+valueOf|(% style="width:437px" %)Association to the Code that is the value of the Observation. Note that this is a conceptual association showing that the Code must exist in the Codelist(s) associated with the Measure(s) in the Data Structure Definition. In the actual Data Set the value of the Code is placed in the Observation.
453 -|(% style="width:147px" %)//AttributeValue//|(% style="width:222px" %)(((
393 +)))|(% style="width:395px" %)An Observation that takes its value from a [[code>>doc:xwiki:Glossary.Code.WebHome]] in a [[Code list>>doc:xwiki:Glossary.Code list.WebHome]].
394 +|(% style="width:147px" %) |(% style="width:246px" %)+valueOf|(% style="width:395px" %)Association to the [[Code>>doc:xwiki:Glossary.Code.WebHome]] that is the value of the Observation. Note that this is a conceptual association showing that the [[Code>>doc:xwiki:Glossary.Code.WebHome]] must exist in the Codelist(s) associated with the [[Measure>>doc:xwiki:Glossary.Measure.WebHome]](s) in the [[Data Structure Definition>>doc:xwiki:Glossary.Data structure definition.WebHome]]. In the actual [[Data Set>>doc:xwiki:Glossary.Data set.WebHome]] the value of the [[Code>>doc:xwiki:Glossary.Code.WebHome]] is placed in the Observation.
395 +|(% style="width:147px" %)//AttributeValue//|(% style="width:246px" %)(((
454 454  Abstract class
455 -
456 456  Sub classes
457 -
458 -//DataAttributeValue// //MetadataAttributeValu e//
459 -)))|(% style="width:437px" %)Represents the value for any Attribute reported in the Dataset, i.e., Data or Metadata Attribute.
460 -|(% style="width:147px" %)//DataAttributeValu e//|(% style="width:222px" %)(((
398 +//DataAttributeValue// //MetadataAttributeValue//
399 +)))|(% style="width:395px" %)Represents the value for any [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] reported in the [[Dataset>>doc:xwiki:Glossary.Data set.WebHome]], i.e., Data or Metadata [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]].
400 +|(% style="width:147px" %)//DataAttributeValue//|(% style="width:246px" %)(((
461 461  Abstract class
462 -
463 463  Inherits from
464 -
465 465  //AttributeValue//
466 -
467 467  Sub classes
468 -
469 -//UncodedAttributeValue//
470 -
471 -//CodedAttributeValue//
472 -)))|(% style="width:437px" %)The value of a Data Attribute, such as the instance of a Coded Attribute or of an Uncoded Attribute in a structure such as a Data Structure Definition.
473 -|(% style="width:147px" %) |(% style="width:222px" %)+valueFor|(% style="width:437px" %)(((
474 -Association to the Data Attribute defined in the Data Structure Definition. Note that this is conceptual association as the Concept is identified explicitly in the data set.
475 -The source multiplicity (1..*) indicates the possibility to provide more than one values for a Data Attribute, if the latter allows it.
405 +//UncodedAttributeValue
406 +CodedAttributeValue//
407 +)))|(% style="width:395px" %)The value of a Data [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]], such as the instance of a Coded [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] or of an Uncoded [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] in a structure such as a [[Data Structure Definition>>doc:xwiki:Glossary.Data structure definition.WebHome]].
408 +|(% style="width:147px" %) |(% style="width:246px" %)+valueFor|(% style="width:395px" %)(((
409 +Association to the Data [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] defined in the [[Data Structure Definition>>doc:xwiki:Glossary.Data structure definition.WebHome]]. Note that this is conceptual association as the (% style="color:#2ecc71" %)Concept(%%) is identified explicitly in the [[data set>>doc:xwiki:Glossary.Data set.WebHome]].
410 +The source multiplicity (1..*) indicates the possibility to provide more than one values for a Data [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]], if the latter allows it.
476 476  )))
477 -|(% style="width:147px" %)//MetadataAttribute Value//|(% style="width:222px" %)(((
478 -(explained further in section
412 +|(% style="width:147px" %)//MetadataAttributeValue//|(% style="width:246px" %)(((
413 +(explained further in section “Metadata Set”)
414 +)))|(% style="width:395px" %)(((
415 +The value of a Metadata [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]], as specified in the [[Metadata Structure Definition>>doc:xwiki:Glossary.Metadata structure definition.WebHome]], which is linked in the Data Structure
479 479  
480 -“Metadata Set”)
481 -)))|(% style="width:437px" %)(((
482 -The value of a Metadata Attribute, as specified in the Metadata Structure Definition, which is linked in the Data Structure
483 -
484 484  Definition
485 485  )))
486 -|(% style="width:147px" %)//UncodedAttributeV alue//|(% style="width:222px" %)(((
419 +|(% style="width:147px" %)//UncodedAttributeValue//|(% style="width:246px" %)(((
487 487  Inherits from
488 -
489 489  //AttributeValue//
490 -
491 491  Sub classes
492 -
493 493  OtherUncodedAttribute Value
494 -
495 495  TextAttributeValue
496 -)))|(% style="width:437px" %)
497 -|(% style="width:147px" %)OtherUncodedAttri buteValue|(% style="width:222px" %)(((
425 +)))|(% style="width:395px" %)
426 +|(% style="width:147px" %)OtherUncodedAttributeValue|(% style="width:246px" %)(((
498 498  Inherits from
499 -
500 -//UncodedObservationVal ue//
501 -)))|(% style="width:437px" %)An attribute value that has a text value
502 -|(% style="width:147px" %) |(% style="width:222px" %)value|(% style="width:437px" %)The value of the Uncoded attribute.
503 -|(% style="width:147px" %) |(% style="width:222px" %)startTime|(% style="width:437px" %)This attribute is only used if the textFormat of the attribute is of the Timespan type in the Data Structure Definition (in which case the value field takes a duration).
504 -|(% style="width:147px" %)TextAttributeValu e|(% style="width:222px" %)(((
428 +//UncodedObservationValue//
429 +)))|(% style="width:395px" %)An [[attribute>>doc:xwiki:Glossary.Attribute.WebHome]] value that has a text value
430 +|(% style="width:147px" %) |(% style="width:246px" %)value|(% style="width:395px" %)The value of the Uncoded [[attribute>>doc:xwiki:Glossary.Attribute.WebHome]].
431 +|(% style="width:147px" %) |(% style="width:246px" %)startTime|(% style="width:395px" %)This [[attribute>>doc:xwiki:Glossary.Attribute.WebHome]] is only used if the textFormat of the [[attribute>>doc:xwiki:Glossary.Attribute.WebHome]] is of the Timespan type in the [[Data Structure Definition>>doc:xwiki:Glossary.Data structure definition.WebHome]] (in which case the value field takes a duration).
432 +|(% style="width:147px" %)TextAttributeValue|(% style="width:246px" %)(((
505 505  Inherits from
506 -
507 507  //UncodedAttributeValue//
508 -)))|(% style="width:437px" %)An attribute that has a localised text value
509 -|(% style="width:147px" %) |(% style="width:222px" %)text|(% style="width:437px" %)The localised text values.
510 -|(% style="width:147px" %)CodedAttributeVal ue|(% style="width:222px" %)(((
435 +)))|(% style="width:395px" %)An [[attribute>>doc:xwiki:Glossary.Attribute.WebHome]] that has a localised text value
436 +|(% style="width:147px" %) |(% style="width:246px" %)text|(% style="width:395px" %)The localised text values.
437 +|(% style="width:147px" %)CodedAttributeValue|(% style="width:246px" %)(((
511 511  Inherits from
512 -
513 513  //AttributeValue//
514 -)))|(% style="width:437px" %)An attribute that takes it value from a Code in Code list.
515 -|(% style="width:147px" %) |(% style="width:222px" %)+valueOf|(% style="width:437px" %)Association to the Code that is the value of the Attribute Value. Note that this is a conceptual association showing that the Code must exist in the Code list associated with the Data Attribute in the Data Structure Definition. In the actual Data Set the value of the Code is placed in the Attribute Value.
440 +)))|(% style="width:395px" %)An [[attribute>>doc:xwiki:Glossary.Attribute.WebHome]] that takes it value from a [[Code>>doc:xwiki:Glossary.Code.WebHome]] in [[Code list>>doc:xwiki:Glossary.Code list.WebHome]].
441 +|(% style="width:147px" %) |(% style="width:246px" %)+valueOf|(% style="width:395px" %)Association to the [[Code>>doc:xwiki:Glossary.Code.WebHome]] that is the value of the [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] Value. Note that this is a conceptual association showing that the [[Code>>doc:xwiki:Glossary.Code.WebHome]] must exist in the [[Code list>>doc:xwiki:Glossary.Code list.WebHome]] associated with the Data [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] in the [[Data Structure Definition>>doc:xwiki:Glossary.Data structure definition.WebHome]]. In the actual [[Data Set>>doc:xwiki:Glossary.Data set.WebHome]] the value of the [[Code>>doc:xwiki:Glossary.Code.WebHome]] is placed in the [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] Value.
516 516  
517 517