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

From version 3.1
edited by Helena
on 2025/06/07 00:56
Change comment: There is no comment for this version
To version 5.6
edited by Helena
on 2025/06/08 11:30
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,5 +1,9 @@
1 -=== 5.1 Introduction ===
1 +{{box title="**Contents**"}}
2 +{{toc/}}
3 +{{/box}}
2 2  
5 +== 5.1 Introduction ==
6 +
3 3  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.
4 4  
5 5  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,51 +9,41 @@
9 9  The actual SDMX Base construct from which the concrete classes inherit depends upon the requirements of the class for:
10 10  
11 11  Annotation – //AnnotableArtefact//
12 -
13 13  Identification – //IdentifiableArtefact//
14 -
15 15  Naming – //NameableArtefact//
16 -
17 17  Versioning – //VersionableArtefact//
18 -
19 19  Maintenance – //MaintainableArtefact//
20 20  
21 -=== 5.2 Inheritance View ===
21 +== 5.2 Inheritance View ==
22 22  
23 -==== 5.2.1 Class Diagram ====
23 +=== 5.2.1 Class Diagram ===
24 24  
25 25  [[image:1749246368774-202.jpeg]]
26 26  
27 27  **Figure 27 Class inheritance in the Data Structure Definition and Data Set Packages**
28 28  
29 -===== 5.2.2 Explanation of the Diagram =====
29 +=== 5.2.2 Explanation of the Diagram ===
30 30  
31 -====== 5.2.2.1 Narrative ======
31 +==== 5.2.2.1 Narrative ====
32 32  
33 33  Those classes in the SDMX metamodel which require annotations 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
37 +Key// (and therefore //SeriesKey// and //GroupKey//)
41 41  //Observation//
42 42  
43 43  Those classes in the SDMX metamodel which require annotations and global identity are derived from //IdentifiableArtefact//. These are:
44 44  
45 -//NameableArtefact//
42 +//NameableArtefact
43 +ComponentList
44 +Component//
46 46  
47 -//ComponentList//
48 -
49 -//Component//
50 -
51 51  Those classes in the SDMX metamodel which require annotations, global identity, multilingual name and multilingual description are derived from //NameableArtefact//. These are:
52 52  
53 -//VersionableArtefact//
48 +//VersionableArtefact
49 +Item//
54 54  
55 -//Item//
56 -
57 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 58  
59 59  //MaintainableArtefact//
... ... @@ -60,22 +60,17 @@
60 60  
61 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:
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 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:
72 72  
73 73  Dataflow
74 -
75 75  DataStructureDefinition
76 -
77 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:
78 -
79 79  DataStructureDefinition
80 80  
81 81  A DataStructureDefinition contains a list of dimensions, a list of measures and a list of attributes.
... ... @@ -83,34 +83,29 @@
83 83  The concrete classes which inherit from //ComponentList// and are subcomponents of the DataStructureDefinition are:
84 84  
85 85  DimensionDescriptor – content is Dimension and TimeDimension
86 -
87 87  DimensionGroupDescriptor – content is an association to Dimension, TimeDimension
88 -
89 89  MeasureDescriptor – content is Measure
90 -
91 91  AttributeDescriptor – content is DataAttribute and an association to MetadataAttribute
92 92  
93 93  The classes that inherit from //Component// are:
94 94  
95 95  Measure
96 -
97 97  //DimensionComponent// and thereby its sub classes of Dimension and TimeDimension
98 -
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.
102 102  
103 -==== //5.3 Data Structure Definition – Relationship View// ====
87 +== 5.3 Data Structure Definition – Relationship View ==
104 104  
105 -===== 5.3.1 Class Diagram =====
89 +=== 5.3.1 Class Diagram ===
106 106  
107 107  [[image:1749246368782-690.jpeg]]
108 108  
109 109  **Figure 28 Relationship class diagram of the Data Structure Definition excluding representation**
110 110  
111 -===== 5.3.2 Explanation of the Diagrams =====
95 +=== 5.3.2 Explanation of the Diagrams ===
112 112  
113 -====== 5.3.2.1 Narrative ======
97 +==== 5.3.2.1 Narrative ====
114 114  
115 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.
116 116  
... ... @@ -155,11 +155,12 @@
155 155  
156 156  The following table details the possible relationships a DataAttribute may specify. Note that these relationships are mutually exclusive, and therefore only one of the following is possible.
157 157  
158 -|**Relationship**|**Meaning**|**Location in Data Set at which the Attribute is reported**
159 -|DataflowRelationship|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.|The attribute is reported at the Dataset level.
160 -|Dimension (1..n)|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.|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.
161 -|Group|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.|The attribute is reported at the level of Group.
162 -|Observation|The value of the Attribute varies with the observed value.|The attribute is reported at the level of Observation.
142 +(% style="width:1142.83px" %)
143 +|**Relationship**|(% style="width:537px" %)**Meaning**|(% style="width:434px" %)**Location in Data Set at which the Attribute is reported**
144 +|DataflowRelationship|(% style="width:537px" %)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:434px" %)The attribute is reported at the Dataset level.
145 +|Dimension (1..n)|(% style="width:537px" %)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:434px" %)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.
146 +|Group|(% style="width:537px" %)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:434px" %)The attribute is reported at the level of Group.
147 +|Observation|(% style="width:537px" %)The value of the Attribute varies with the observed value.|(% style="width:434px" %)The attribute is reported at the level of Observation.
163 163  
164 164  [[image:1749246368790-555.jpeg]]
165 165  
... ... @@ -169,7 +169,7 @@
169 169  
170 170  A DataStructureDefinition can be extended to form a derived DataStructureDefinition. This is supported in the StructureMap.
171 171  
172 -**5.3.2.2 Definitions**
157 +==== 5.3.2.2 Definitions ====
173 173  
174 174  |**Class**|**Feature**|**Description**
175 175  |StructureUsage| |See “SDMX Base”.
... ... @@ -179,7 +179,7 @@
179 179  //StructureUsage//
180 180  )))|Abstract concept (i.e., the structure without any data) of a flow of data that providers will provide for different reference periods.
181 181  | |/structure|Associates a Dataflow to the Data Structure Definition.
182 -| |dimensionConstraint|A list of Dimensions which the Dataflow uses. This is only required when the referenced DataStructureDefinition has the evolvingStructure property set to true and when the association to the DataStructureDefinition in on the latest minor version[[^^~[1~]^^>>path:#_ftn1]].
167 +| |dimensionConstraint|A list of Dimensions which the Dataflow uses. This is only required when the referenced DataStructureDefinition has the evolvingStructure property set to true and when the association to the DataStructureDefinition in on the latest minor version{{footnote}}Referencing the latest minor version of the Data Structure is achieved by the reference including the plus operator on the minor version to indicate it links to the latest stable version, for example 2.0+.0 will resolve to the highest version 2.x.y.{{/footnote}}.
183 183  |DataStructureDefiniti on| |A collection of metadata concepts, their structure and usage when used to collect or disseminate data.
184 184  | |/grouping|An association to a set of metadata concepts that have an identified structural role in a Data Structure Definition.
185 185  | |evolvingStructure|An optional boolean property, defaulting to false. When true the DataStructureDefinition may have new Dimensions added without having to change its major version number.
... ... @@ -200,7 +200,7 @@
200 200  
201 201  //ComponentList//
202 202  )))|A set metadata concepts that define the Attributes of a Data Structure Definition.
203 -| |/////components|An association to a Data Attribute component.
188 +| |/components|An association to a Data Attribute component.
204 204  |MeasureDescriptor|(((
205 205  Inherits from
206 206  
... ... @@ -219,84 +219,74 @@
219 219  TimeDimension
220 220  )))|An abstract class representing any Component that can be used for identifying observations.
221 221  
222 -
223 -
224 -
225 -|**Class**|**Feature**|**Description**
226 -| |Order|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|(((
207 +(% style="width:981.835px" %)
208 +|(% style="width:202px" %)**Class**|(% style="width:240px" %)**Feature**|(% style="width:537px" %)**Description**
209 +|(% style="width:202px" %) |(% style="width:240px" %)Order|(% style="width:537px" %)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.
210 +|(% style="width:202px" %)Dimension|(% style="width:240px" %)(((
228 228  Inherits from
229 -
230 230  //DimensionComponent//
231 -)))|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 -| |/role|Association to the Concept that specifies the role that that the Dimension plays in the Data Structure Definition.
233 -| |/conceptIdentity|An association to the metadata concept which defines the semantic of the Dimension.
234 -|TimeDimension|(((
213 +)))|(% style="width:537px" %)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.
214 +|(% style="width:202px" %) |(% style="width:240px" %)/role|(% style="width:537px" %)Association to the Concept that specifies the role that that the Dimension plays in the Data Structure Definition.
215 +|(% style="width:202px" %) |(% style="width:240px" %)/conceptIdentity|(% style="width:537px" %)An association to the metadata concept which defines the semantic of the Dimension.
216 +|(% style="width:202px" %)TimeDimension|(% style="width:240px" %)(((
235 235  Inherits from
236 -
237 237  //DimensionComponent//
238 -)))|A metadata concept that identifies the component in the key structure that has the role of “time”.
239 -|DataAttribute|(((
219 +)))|(% style="width:537px" %)A metadata concept that identifies the component in the key structure that has the role of “time”.
220 +|(% style="width:202px" %)DataAttribute|(% style="width:240px" %)(((
240 240  Inherits from
241 -
242 242  //Component//
243 -)))|A characteristic of an object or entity.
244 -| |/role|Association to the Concept that specifies the role that that the Data Attribute plays in the Data Structure Definition.
245 -| |minOccurs|Defines the minimum required occurrences for the Attribute. When equals to zero, the Attribute is conditional.
246 -| |maxOccurs|Defines the maximum allowed occurrences for the Attribute.
247 -| |Usage|Defines whether a Data Attribute must be reported or not.
248 -| |+relatedTo|Association to an Attribute Relationship.
249 -| |/conceptIdentity|An association to the Concept which defines the semantic of the component.
250 -|Measure|(((
223 +)))|(% style="width:537px" %)A characteristic of an object or entity.
224 +|(% style="width:202px" %) |(% style="width:240px" %)/role|(% style="width:537px" %)Association to the Concept that specifies the role that that the Data Attribute plays in the Data Structure Definition.
225 +|(% style="width:202px" %) |(% style="width:240px" %)minOccurs|(% style="width:537px" %)Defines the minimum required occurrences for the Attribute. When equals to zero, the Attribute is conditional.
226 +|(% style="width:202px" %) |(% style="width:240px" %)maxOccurs|(% style="width:537px" %)Defines the maximum allowed occurrences for the Attribute.
227 +|(% style="width:202px" %) |(% style="width:240px" %)Usage|(% style="width:537px" %)Defines whether a Data Attribute must be reported or not.
228 +|(% style="width:202px" %) |(% style="width:240px" %)+relatedTo|(% style="width:537px" %)Association to an Attribute Relationship.
229 +|(% style="width:202px" %) |(% style="width:240px" %)/conceptIdentity|(% style="width:537px" %)An association to the Concept which defines the semantic of the component.
230 +|(% style="width:202px" %)Measure|(% style="width:240px" %)(((
251 251  Inherits from
252 252  
253 253  //Component//
254 -)))|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 -| |/conceptIdentity|An association to the Concept which carries the values of the measures.
256 -| |minOccurs|Defines the minimum required occurrences for the Measure. When equals to zero, the Measure is conditional.
257 -| |maxOccurs|Defines the maximum allowed occurrences for the Measure.
258 -| |Usage|Defines whether a Measure must be reported or not.
259 -|//AttributeRelationship//|(((
234 +)))|(% style="width:537px" %)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.
235 +|(% style="width:202px" %) |(% style="width:240px" %)/conceptIdentity|(% style="width:537px" %)An association to the Concept which carries the values of the measures.
236 +|(% style="width:202px" %) |(% style="width:240px" %)minOccurs|(% style="width:537px" %)Defines the minimum required occurrences for the Measure. When equals to zero, the Measure is conditional.
237 +|(% style="width:202px" %) |(% style="width:240px" %)maxOccurs|(% style="width:537px" %)Defines the maximum allowed occurrences for the Measure.
238 +|(% style="width:202px" %) |(% style="width:240px" %)Usage|(% style="width:537px" %)Defines whether a Measure must be reported or not.
239 +|(% style="width:202px" %)//AttributeRelationship//|(% style="width:240px" %)(((
260 260  Abstract Class
261 -
262 262  Sub classes
242 +ObservationRelationship
243 +GroupRelationship DimensionRelationship
244 +)))|(% style="width:537px" %)Specifies the type of artefact to which a Data Attribute can be attached in a Data Set.
245 +|(% style="width:202px" %)ObservationRelationship|(% style="width:240px" %) |(% style="width:537px" %)The Data Attribute is related to the observations of the Data Set.
246 +|(% style="width:202px" %)GroupRelationship|(% style="width:240px" %) |(% style="width:537px" %)The Data Attribute is related to a Group Dimension Descriptor construct.
247 +|(% style="width:202px" %) |(% style="width:240px" %)+groupKey|(% style="width:537px" %)An association to the Group Dimension Descriptor
248 +|(% style="width:202px" %)DimensionRelationship|(% style="width:240px" %) |(% style="width:537px" %)The Data Attribute is related to a set of Dimensions.
249 +|(% style="width:202px" %) |(% style="width:240px" %)+dimensions|(% style="width:537px" %)Association to the set of Dimensions to which the Data Attribute is related.
250 +|(% style="width:202px" %) |(% style="width:240px" %)+groupKey|(% style="width:537px" %)Association to the Group Dimension Descriptor which specifies the set of Dimensions to which the Data Attribute is attached.
251 +|(% style="width:202px" %)MeasureRelationship|(% style="width:240px" %) |(% style="width:537px" %)The Measures that a Data Attribute is reported for.
252 +|(% style="width:202px" %) |(% style="width:240px" %)+measures|(% style="width:537px" %)Association to the set of Measures to which a Data Attribute is related to.
253 +|(% style="width:202px" %)SentinelValuesType|(% style="width:240px" %) |(% style="width:537px" %)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.
254 +|(% style="width:202px" %)SentinelValue|(% style="width:240px" %) |(% style="width:537px" %)A value that has a special meaning within the text format representation of the Component.
255 +|(% style="width:202px" %) |(% style="width:240px" %)+name|(% style="width:537px" %)An association of a Sentinel Value to a multilingual name.
256 +|(% style="width:202px" %) |(% style="width:240px" %)+description|(% style="width:537px" %)An association of a Sentinel Value to a multilingual description.
263 263  
264 -ObservationRelations hip
265 -
266 -GroupRelationship DimensionRelationshi p
267 -)))|Specifies the type of artefact to which a Data Attribute can be attached in a Data Set.
268 -|ObservationRelationsh ip| |The Data Attribute is related to the observations of the Data Set.
269 -|GroupRelationship| |The Data Attribute is related to a Group Dimension Descriptor construct.
270 -| |+groupKey|An association to the Group Dimension Descriptor
271 -|DimensionRelationship| |The Data Attribute is related to a set of Dimensions.
272 -| |+dimensions|Association to the set of Dimensions to which the Data Attribute is related.
273 -| |+groupKey|Association to the Group Dimension Descriptor which specifies the set of Dimensions to which the Data Attribute is attached.
274 -|MeasureRelationship| |The Measures that a Data Attribute is reported for.
275 -| |+measures|Association to the set of Measures to which a Data Attribute is related to.
276 -|SentinelValuesType| |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| |A value that has a special meaning within the text format representation of the Component.
278 -| |+name|An association of a Sentinel Value to a multilingual name.
279 -| |+description|An association of a Sentinel Value to a multilingual description.
280 -
281 -
282 -
283 283  The explanation of the classes, attributes, and associations comprising the Representation is described in the section on the SDMX Base.
284 284  
285 285  ==== //5.4 Data Set – Relationship View// ====
286 286  
287 -===== 5.4.1 Context =====
262 +=== 5.4.1 Context ===
288 288  
289 289  A data set comprises the collection of data values and associated metadata that are collected or disseminated according to a known DataStructureDefinition.
290 290  
291 -===== 5.4.2 Class Diagram =====
266 +=== 5.4.2 Class Diagram ===
292 292  
293 293  [[image:1749246368794-672.jpeg]]
294 294  
295 295  **Figure 31: Class Diagram of the Data Set**
296 296  
297 -====== 5.4.3 Explanation of the Diagram ======
272 +=== 5.4.3 Explanation of the Diagram ===
298 298  
299 -5.4.3.1 Narrative – Data Set
274 +==== 5.4.3.1 Narrative – Data Set ====
300 300  
301 301  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.
302 302  
... ... @@ -314,214 +314,169 @@
314 314  
315 315  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.
316 316  
317 -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.
292 +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.
318 318  
319 319  The //AttributeValue// links to the object type (SeriesKey, GroupKey, Observation) to which it is associated.
320 320  
321 -5.4.3.2 Definitions
296 +==== 5.4.3.2 Definitions ====
322 322  
323 -|**Class**|**Feature**|**Description**
324 -|//DataSet//|(((
298 +(% style="width:964.835px" %)
299 +|(% style="width:200px" %)**Class**|(% style="width:285px" %)**Feature**|(% style="width:454px" %)**Description**
300 +|(% style="width:200px" %)//DataSet//|(% style="width:285px" %)(((
325 325  Abstract Class
326 -
327 327  Sub classes
328 -
329 329  StructureSpecificData
330 -
331 331  Set
332 -)))|An organised collection of data.
333 -| |reportingBegin|A specific time period in a known system of time periods that identifies the start period of a report.
334 -| |reportingEnd|A specific time period in a known system of time periods that identifies the end period of a report.
335 -| |dataExtractionDate|A specific time period that identifies the date and time that the data are extracted from a data source.
336 -| |validFrom|Indicates the inclusive start time indicating the validity of the information in the data set.
337 -| |validTo|Indicates the inclusive end time indicating the validity of the information in the data set.
338 -| |publicationYear|Specifies the year of publication of the data or metadata in terms of whatever provisioning agreements might be in force.
339 -| |publicationPeriod|Specifies the period of publication of the data or metadata in terms of whatever provisioning agreements might be in force.
340 -| |setId|Provides an identification of the data set.
341 -| |action|Defines the action to be taken by the recipient system (information, append, replace, delete)
342 -| |describedBy|(((
343 -Associates a Dataflow and thereby a Data Structure
344 -
345 -Definition to the data set.
305 +)))|(% style="width:454px" %)An organised collection of data.
306 +|(% style="width:200px" %) |(% style="width:285px" %)reportingBegin|(% style="width:454px" %)A specific time period in a known system of time periods that identifies the start period of a report.
307 +|(% style="width:200px" %) |(% style="width:285px" %)reportingEnd|(% style="width:454px" %)A specific time period in a known system of time periods that identifies the end period of a report.
308 +|(% style="width:200px" %) |(% style="width:285px" %)dataExtractionDate|(% style="width:454px" %)A specific time period that identifies the date and time that the data are extracted from a data source.
309 +|(% style="width:200px" %) |(% style="width:285px" %)validFrom|(% style="width:454px" %)Indicates the inclusive start time indicating the validity of the information in the data set.
310 +|(% style="width:200px" %) |(% style="width:285px" %)validTo|(% style="width:454px" %)Indicates the inclusive end time indicating the validity of the information in the data set.
311 +|(% style="width:200px" %) |(% style="width:285px" %)publicationYear|(% style="width:454px" %)Specifies the year of publication of the data or metadata in terms of whatever provisioning agreements might be in force.
312 +|(% style="width:200px" %) |(% style="width:285px" %)publicationPeriod|(% style="width:454px" %)Specifies the period of publication of the data or metadata in terms of whatever provisioning agreements might be in force.
313 +|(% style="width:200px" %) |(% style="width:285px" %)setId|(% style="width:454px" %)Provides an identification of the data set.
314 +|(% style="width:200px" %) |(% style="width:285px" %)action|(% style="width:454px" %)Defines the action to be taken by the recipient system (information, append, replace, delete)
315 +|(% style="width:200px" %) |(% style="width:285px" %)describedBy|(% style="width:454px" %)(((
316 +Associates a Dataflow and thereby a Data Structure Definition to the data set.
346 346  )))
347 -| |+structuredBy|(((
348 -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
349 -
350 -(non-mandatory) to the Dataflow.
318 +|(% style="width:200px" %) |(% style="width:285px" %)+structuredBy|(% style="width:454px" %)(((
319 +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.
351 351  )))
352 -| |+publishedBy|Associates the Data Provider that reports/publishes the data.
353 -|StructureSpecific DataSet| |An XML specific data format structure that contains data corresponding to one specific Data Structure Definition.
354 -|//Key//|(((
321 +|(% style="width:200px" %) |(% style="width:285px" %)+publishedBy|(% style="width:454px" %)Associates the Data Provider that reports/publishes the data.
322 +|(% style="width:200px" %)StructureSpecificDataSet|(% style="width:285px" %) |(% style="width:454px" %)An XML specific data format structure that contains data corresponding to one specific Data Structure Definition.
323 +|(% style="width:200px" %)//Key//|(% style="width:285px" %)(((
355 355  Abstract class
356 -
357 357  Sub classes
358 -
359 359  SeriesKey
360 -
361 361  GroupKey
362 -)))|Comprises the cross product of values of dimensions that identify uniquely an Observation.
363 -| |keyValues|Association to the individual Key Values that comprise the Key.
364 -| |+attachedAttribute|Association to the Attribute Values relating to the Series Key or Group Key.
365 -|//KeyValue//|(((
328 +)))|(% style="width:454px" %)Comprises the cross product of values of dimensions that identify uniquely an Observation.
329 +|(% style="width:200px" %) |(% style="width:285px" %)keyValues|(% style="width:454px" %)Association to the individual Key Values that comprise the Key.
330 +|(% style="width:200px" %) |(% style="width:285px" %)+attachedAttribute|(% style="width:454px" %)Association to the Attribute Values relating to the Series Key or Group Key.
331 +|(% style="width:200px" %)//KeyValue//|(% style="width:285px" %)(((
366 366  Abstract class
367 -
368 368  Sub classes
369 -
370 370  TimeKeyValue
371 -
372 372  CodedKeyValue
373 -
374 374  UncodedKeyValue
375 -)))|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.
376 -| |+valueFor|(((
337 +)))|(% style="width:454px" %)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.
338 +|(% style="width:200px" %) |(% style="width:285px" %)+valueFor|(% style="width:454px" %)(((
377 377  Association to the key component in the Data Structure Definition for which this Key Value is a valid representation.
378 -
379 379  Note that this is conceptual association as the key component is identified explicitly in the data set.
380 380  )))
381 -|TimeKeyValue|(((
342 +|(% style="width:200px" %)TimeKeyValue|(% style="width:285px" %)(((
382 382  Inherits from
383 -
384 384  //KeyValue//
385 -)))|The value of the Time Dimension component of the key.
386 -|CodedKeyValue|(((
345 +)))|(% style="width:454px" %)The value of the Time Dimension component of the key.
346 +|(% style="width:200px" %)CodedKeyValue|(% style="width:285px" %)(((
387 387  Inherits from
388 -
389 389  //KeyValue//
390 -)))|The value of a coded component of the key. The value is the Code to which this class is associated.
391 -| |+valueOf|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.
392 -|UnCodedKeyValue|(((
349 +)))|(% style="width:454px" %)The value of a coded component of the key. The value is the Code to which this class is associated.
350 +|(% style="width:200px" %) |(% style="width:285px" %)+valueOf|(% style="width:454px" %)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.
351 +|(% style="width:200px" %)UnCodedKeyValue|(% style="width:285px" %)(((
393 393  Inherits from
394 -
395 395  //KeyValue//
396 -)))|The value of an uncoded component of the key.
397 -| |value|The value of the key component.
398 -| |startTime|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).
399 -|GroupKey|(((
354 +)))|(% style="width:454px" %)The value of an uncoded component of the key.
355 +|(% style="width:200px" %) |(% style="width:285px" %)value|(% style="width:454px" %)The value of the key component.
356 +|(% style="width:200px" %) |(% style="width:285px" %)startTime|(% style="width:454px" %)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).
357 +|(% style="width:200px" %)GroupKey|(% style="width:285px" %)(((
400 400  Inherits from
401 -
402 402  //Key//
403 -)))|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.
404 -| |+describedBy|Associates the Group Dimension Descriptor defined in the Data Structure Definition.
405 -|SeriesKey|(((
360 +)))|(% style="width:454px" %)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.
361 +|(% style="width:200px" %) |(% style="width:285px" %)+describedBy|(% style="width:454px" %)Associates the Group Dimension Descriptor defined in the Data Structure Definition.
362 +|(% style="width:200px" %)SeriesKey|(% style="width:285px" %)(((
406 406  Inherits from
407 -
408 408  //Key//
409 -)))|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.
410 -| |+describedBy|Associates the Dimension Descriptor defined in the Data Structure Definition.
411 -|Observation| |The value(s) of the observed phenomenon in the context of the Key Values comprising the key.
412 -| |+valueFor|(((
365 +)))|(% style="width:454px" %)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.
366 +|(% style="width:200px" %) |(% style="width:285px" %)+describedBy|(% style="width:454px" %)Associates the Dimension Descriptor defined in the Data Structure Definition.
367 +|(% style="width:200px" %)Observation|(% style="width:285px" %) |(% style="width:454px" %)The value(s) of the observed phenomenon in the context of the Key Values comprising the key.
368 +|(% style="width:200px" %) |(% style="width:285px" %)+valueFor|(% style="width:454px" %)(((
413 413  Associates the Measure(s) defined in the Data Structure Definition.
414 414  
415 415  The source multiplicity (1..*) indicates that more than one values may be provided for a Measure, if the latter allows it.
416 416  )))
417 -| |+attachedAttribute|Association to the Attribute Values relating to the Observation.
418 -| |+observationDimension|Association to the Key Value that holds the value of the “Dimension at the Observation Level”.
419 -|//ObservationValue//|(((
373 +|(% style="width:200px" %) |(% style="width:285px" %)+attachedAttribute|(% style="width:454px" %)Association to the Attribute Values relating to the Observation.
374 +|(% style="width:200px" %) |(% style="width:285px" %)+observationDimension|(% style="width:454px" %)Association to the Key Value that holds the value of the “Dimension at the Observation Level”.
375 +|(% style="width:200px" %)//ObservationValue//|(% style="width:285px" %)(((
420 420  Abstract class
421 421  
422 422  Sub classes
423 423  
424 -//UncodedObservationVal ue//
380 +//UncodedObservationValue//
425 425  
426 426  CodedObservation
427 -)))|
428 -|//UncodedObservatio nValue//|(((
383 +)))|(% style="width:454px" %)
384 +|(% style="width:200px" %)//UncodedObservationValue//|(% style="width:285px" %)(((
429 429  Abstract class
430 -
431 431  Inherits from
432 -
433 433  //ObservationValue//
434 -
435 435  Sub classes
436 -
437 -OtherUncodedMeasureVa lue
438 -
389 +OtherUncodedMeasureValue
439 439  TextMeasureValue
440 -)))|
441 -|OtherUncodedMeasu reValue|(((
391 +)))|(% style="width:454px" %)
392 +|(% style="width:200px" %)OtherUncodedMeasureValue|(% style="width:285px" %)(((
442 442  Inherits from
443 -
444 -//UncodedObservationVal ue//
445 -)))|An observation that has a text value.
446 -| |value|The value of the Uncoded Observation.
447 -| |startTime|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).
448 -|TextMeasureValue|(((
394 +//UncodedObservationValue//
395 +)))|(% style="width:454px" %)An observation that has a text value.
396 +|(% style="width:200px" %) |(% style="width:285px" %)value|(% style="width:454px" %)The value of the Uncoded Observation.
397 +|(% style="width:200px" %) |(% style="width:285px" %)startTime|(% style="width:454px" %)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).
398 +|(% style="width:200px" %)TextMeasureValue|(% style="width:285px" %)(((
449 449  Inherits from
450 -
451 -//UncodedObservationVal ue//
452 -)))|An observation that has a localised text value
453 -| |text|The localised text values.
454 -|CodedObservation|(((
400 +//UncodedObservationValue//
401 +)))|(% style="width:454px" %)An observation that has a localised text value
402 +|(% style="width:200px" %) |(% style="width:285px" %)text|(% style="width:454px" %)The localised text values.
403 +|(% style="width:200px" %)CodedObservation|(% style="width:285px" %)(((
455 455  Inherits from
456 -
457 457  //ObservationValue//
458 -)))|An Observation that takes its value from a code in a Code list.
459 -| |+valueOf|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.
460 -|//AttributeValue//|(((
406 +)))|(% style="width:454px" %)An Observation that takes its value from a code in a Code list.
407 +|(% style="width:200px" %) |(% style="width:285px" %)+valueOf|(% style="width:454px" %)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.
408 +|(% style="width:200px" %)//AttributeValue//|(% style="width:285px" %)(((
461 461  Abstract class
462 -
463 463  Sub classes
464 -
465 -//DataAttributeValue// //MetadataAttributeValu e//
466 -)))|Represents the value for any Attribute reported in the Dataset, i.e., Data or Metadata Attribute.
467 -|//DataAttributeValu e//|(((
411 +//DataAttributeValue// //MetadataAttributeValue//
412 +)))|(% style="width:454px" %)Represents the value for any Attribute reported in the Dataset, i.e., Data or Metadata Attribute.
413 +|(% style="width:200px" %)//DataAttributeValue//|(% style="width:285px" %)(((
468 468  Abstract class
469 -
470 470  Inherits from
471 -
472 472  //AttributeValue//
473 -
474 474  Sub classes
475 -
476 -//UncodedAttributeValue//
477 -
478 -//CodedAttributeValue//
479 -)))|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.
480 -| |+valueFor|(((
418 +//UncodedAttributeValue
419 +CodedAttributeValue//
420 +)))|(% style="width:454px" %)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.
421 +|(% style="width:200px" %) |(% style="width:285px" %)+valueFor|(% style="width:454px" %)(((
481 481  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.
482 -
483 483  The source multiplicity (1..*) indicates the possibility to provide more than one values for a Data Attribute, if the latter allows it.
484 484  )))
485 -|//MetadataAttribute Value//|(((
425 +|(% style="width:200px" %)//MetadataAttributeValue//|(% style="width:285px" %)(((
486 486  (explained further in section
487 487  
488 488  “Metadata Set”)
489 -)))|The value of a Metadata Attribute, as specified in the Metadata Structure Definition, which is linked in the Data Structure Definition
490 -|//UncodedAttributeV alue//|(((
429 +)))|(% style="width:454px" %)The value of a Metadata Attribute, as specified in the Metadata Structure Definition, which is linked in the Data Structure Definition
430 +|(% style="width:200px" %)//UncodedAttributeValue//|(% style="width:285px" %)(((
491 491  Inherits from
492 -
493 493  //AttributeValue//
494 -
495 495  Sub classes
496 -
497 497  OtherUncodedAttribute
498 -
499 499  Value
500 -
501 501  TextAttributeValue
502 -)))|
503 -|OtherUncodedAttri buteValue|(((
437 +)))|(% style="width:454px" %)
438 +|(% style="width:200px" %)OtherUncodedAttributeValue|(% style="width:285px" %)(((
504 504  Inherits from
505 -
506 -//UncodedObservationVal ue//
507 -)))|An attribute value that has a text value
508 -| |value|The value of the Uncoded attribute.
509 -| |startTime|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).
510 -|TextAttributeValu e|(((
440 +//UncodedObservationValue//
441 +)))|(% style="width:454px" %)An attribute value that has a text value
442 +|(% style="width:200px" %) |(% style="width:285px" %)value|(% style="width:454px" %)The value of the Uncoded attribute.
443 +|(% style="width:200px" %) |(% style="width:285px" %)startTime|(% style="width:454px" %)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).
444 +|(% style="width:200px" %)TextAttributeValue|(% style="width:285px" %)(((
511 511  Inherits from
512 -
513 513  //UncodedAttributeValue//
514 -)))|An attribute that has a localised text value
515 -| |text|The localised text values.
516 -|CodedAttributeVal ue|(((
447 +)))|(% style="width:454px" %)An attribute that has a localised text value
448 +|(% style="width:200px" %) |(% style="width:285px" %)text|(% style="width:454px" %)The localised text values.
449 +|(% style="width:200px" %)CodedAttributeValue|(% style="width:285px" %)(((
517 517  Inherits from
518 -
519 519  //AttributeValue//
520 -)))|An attribute that takes it value from a Code in Code list.
521 -| |+valueOf|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.
452 +)))|(% style="width:454px" %)An attribute that takes it value from a Code in Code list.
453 +|(% style="width:200px" %) |(% style="width:285px" %)+valueOf|(% style="width:454px" %)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.
522 522  
523 -
524 -
525 525  ----
526 526  
527 -[[~[1~]>>path:#_ftnref1]] Referencing the latest minor version of the Data Structure is achieved by the reference including the plus operator on the minor version to indicate it links to the latest stable version, for example 2.0+.0 will resolve to the highest version 2.x.y.
457 +{{putFootnotes/}}