Skip to Content
Last modified by Artur on 2025/09/10 11:19
From version 3.5
edited by Helena
on 2025/05/22 00:47
Change comment: There is no comment for this version
To version 3.4
edited by Helena
on 2025/05/22 00:44
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -254,6 +254,8 @@
254 254  | |+dimensions|Association to the set of Dimensions to which the Data Attribute is related.
255 255  | |+groupKey|Association to the Group Dimension Descriptor which specifies the set of Dimensions to which the Data Attribute is attached.
256 256  
257 +
258 +
257 257  The explanation of the classes, attributes, and associations comprising the Representation is described in the section on the SDMX Base.
258 258  
259 259  == {{id name="_Toc371016"/}}5.4 Data Set – Relationship View ==
... ... @@ -274,8 +274,10 @@
274 274  
275 275  An organisation playing the role of DataProvider can be responsible for one or more //DataSet//.
276 276  
277 -A //DataSet// can be formatted either as a generic data set (GenericDataSet, GenericTimeseriesDataSet) or a DataStructureDefinition specific data set (StructureSpecificDataSet, StructureSpecificTimeseriesDataSet). The generic data set is structured in exactly the same way no matter which DataStructureDefinition the DataSet expresses. The structured data set is structured according to one specific DataStructureDefinition. Depending on the syntax chosen for the implementation the structured data set should support better validation at the syntax level.
279 +A //DataSet// can be formatted either as a generic data set (GenericDataSet,
278 278  
281 +GenericTimeseriesDataSet) or a DataStructureDefinition specific data set (StructureSpecificDataSet, StructureSpecificTimeseriesDataSet). The generic data set is structured in exactly the same way no matter which DataStructureDefinition the DataSet expresses. The structured data set is structured according to one specific DataStructureDefinition. Depending on the syntax chosen for the implementation the structured data set should support better validation at the syntax level.
282 +
279 279  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, MeasureDimension, TimeDimension) defined in the DimensionDescriptor of the DataStructureDefinition, together with associated //AttributeValue//s that define specific characteristics about the artefact to which it is attached. - DataSet, Observation, set of Dimensions. It is structured in terms of a SeriesKey to which //Observation//s are reported.
280 280  
281 281  The Observation can be the value of the variable being measured for the Concept associated to the PrimaryMeasure in the MeasureDescriptor of the DataStructureDefinition. This is true when there is no MeasureDimension that specifies the precise meaning of each Observation. Each Observation associates an ObservationValue 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//).
... ... @@ -298,145 +298,185 @@
298 298  
299 299  ==== 5.4.3.2 Definitions ====
300 300  
301 -(% style="width:1012.83px" %)
302 -|(% style="width:182px" %)**Class**|(% style="width:210px" %)**Feature**|(% style="width:617px" %)**Description**
303 -|(% style="width:182px" %)//DataSet//|(% style="width:210px" %)(((
305 +|**Class**|**Feature**|**Description**
306 +|//DataSet//|(((
304 304  Abstract Class
308 +
305 305  Sub classes
310 +
306 306  GenericDataSet
312 +
307 307  StructureSpecificDataSet
314 +
308 308  GenericTime
316 +
309 309  SeriesDataSet
318 +
310 310  StructureSpecificTime
320 +
311 311  SeriesDataSet
312 -)))|(% style="width:617px" %)An organised collection of data.
313 -|(% style="width:182px" %) |(% style="width:210px" %)reportingBegin|(% style="width:617px" %)A specific time period in a known system of time periods that identifies the start period of a report.
314 -|(% style="width:182px" %) |(% style="width:210px" %)reportingEnd|(% style="width:617px" %)A specific time period in a known system of time periods that identifies the end period of a report.
315 -|(% style="width:182px" %) |(% style="width:210px" %)dataExtractionDate|(% style="width:617px" %)A specific time period that identifies the date and time that the data are extracted from a data source.
316 -|(% style="width:182px" %) |(% style="width:210px" %)validFrom|(% style="width:617px" %)Indicates the inclusive start time indicating the validity of the information in the data set.
317 -|(% style="width:182px" %) |(% style="width:210px" %)validTo|(% style="width:617px" %)Indicates the inclusive end time indicating the validity of the information in the data set.
318 -|(% style="width:182px" %) |(% style="width:210px" %)publicationYear|(% style="width:617px" %)Specifies the year of publication of the data or metadata in terms of whatever provisioning agreements might be in force.
319 -|(% style="width:182px" %) |(% style="width:210px" %)publicationPeriod|(% style="width:617px" %)Specifies the period of publication of the data or metadata in terms of whatever provisioning agreements might be in force.
320 -|(% style="width:182px" %) |(% style="width:210px" %)setId|(% style="width:617px" %)Provides an identification of the data set.
321 -|(% style="width:182px" %) |(% style="width:210px" %)action|(% style="width:617px" %)Defines the action to be taken by the recipient system (update, append, delete)
322 -|(% style="width:182px" %) |(% style="width:210px" %)describedBy|(% style="width:617px" %)Associates a data flow definition and thereby a Data Structure Definition to the data set.
323 -|(% style="width:182px" %) |(% style="width:210px" %)+structuredBy|(% style="width:617px" %)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 (nonmandatory) to the Dataflow Definition.
324 -|(% style="width:182px" %) |(% style="width:210px" %)+publishedBy|(% style="width:617px" %)Associates the Data Provider that reports/publishes the data.
325 -|(% style="width:182px" %) |(% style="width:210px" %)+attachedAttribute|(% style="width:617px" %)Association to the Attribute Values relating to the Data Set
326 -|(% style="width:182px" %)GenericDataSet|(% style="width:210px" %) |(% style="width:617px" %)A data format structure that is able to contain data corresponding to any Data Structure Definition.
327 -|(% style="width:182px" %)StructureSpecific DataSet|(% style="width:210px" %) |(% style="width:617px" %)A data format structure that contains data corresponding to one specific Data Structure Definition.
328 -|(% style="width:182px" %)GenericTimeseries DataSet|(% style="width:210px" %) |(% style="width:617px" %)A data format structure that is able to contain timeseries data corresponding to any Data Structure Definition.
329 -|(% style="width:182px" %)(((
322 +)))|An organised collection of data.
323 +| |reportingBegin|A specific time period in a known system of time periods that identifies the start period of a report.
324 +| |reportingEnd|A specific time period in a known system of time periods that identifies the end period of a report.
325 +| |dataExtractionDate|A specific time period that identifies the date and time that the data are extracted from a data source.
326 +| |validFrom|Indicates the inclusive start time indicating the validity of the information in the data set.
327 +| |validTo|Indicates the inclusive end time indicating the validity of the information in the data set.
328 +| |publicationYear|Specifies the year of publication of the data or metadata in terms of whatever provisioning agreements might be in force.
329 +| |publicationPeriod|Specifies the period of publication of the data or metadata in terms of whatever provisioning agreements might be in force.
330 +| |setId|Provides an identification of the data set.
331 +| |action|Defines the action to be taken by the recipient system (update, append, delete)
332 +| |describedBy|Associates a data flow definition and thereby a Data Structure Definition to the data set.
333 +| |+structuredBy|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 (nonmandatory) to the Dataflow Definition.
334 +| |+publishedBy|Associates the Data Provider that reports/publishes the data.
335 +| |+attachedAttribute|Association to the Attribute Values relating to the Data Set
336 +|GenericDataSet| |A data format structure that is able to contain data corresponding to any Data Structure Definition.
337 +|StructureSpecific DataSet| |A data format structure that contains data corresponding to one specific Data Structure Definition.
338 +|GenericTimeseries DataSet| |A data format structure that is able to contain timeseries data corresponding to any Data Structure Definition.
339 +|(((
330 330  StructureSpecific
331 331  
332 332  TimeseriesDataSet
333 -)))|(% style="width:210px" %) |(% style="width:617px" %)A data format structure that contains timeseries data corresponding to one specific Data Structure Definition.
334 -|(% style="width:182px" %)Key|(% style="width:210px" %)(((
343 +)))| |A data format structure that contains timeseries data corresponding to one specific Data Structure Definition.
344 +|Key|(((
335 335  Abstract class Sub classes
346 +
336 336  SeriesKey
348 +
337 337  GroupKey
338 -)))|(% style="width:617px" %)Comprises the cross product of values of dimensions that identify uniquely an Observation.
339 -|(% style="width:182px" %) |(% style="width:210px" %)keyValues|(% style="width:617px" %)Association to the individual Key Values that comprise the Key.
340 -|(% style="width:182px" %) |(% style="width:210px" %)+attachedAttribute|(% style="width:617px" %)Association to the Attribute Values relating to the Series Key or Group Key.
341 -|(% style="width:182px" %)//KeyValue//|(% style="width:210px" %)(((
350 +)))|Comprises the cross product of values of dimensions that identify uniquely an Observation.
351 +| |keyValues|Association to the individual Key Values that comprise the Key.
352 +| |+attachedAttribute|Association to the Attribute Values relating to the Series Key or Group Key.
353 +|//KeyValue//|(((
342 342  Abstract class
355 +
343 343  Sub classes
357 +
344 344  MeasureKeyValue
359 +
345 345  TimeKeyValue
361 +
346 346  CodedKeyValue
363 +
347 347  UncodedKeyValue
348 -)))|(% style="width:617px" %)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.
349 -|(% style="width:182px" %) |(% style="width:210px" %)+valueFor|(% style="width:617px" %)(((
365 +)))|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.
366 +| |+valueFor|(((
350 350  Association to the key component in the Data Structure Definition for which this Key Value is a valid representation.
368 +
351 351  Note that this is conceptual association as the key component is identified explicitly in the data set.
352 352  )))
353 -|(% style="width:182px" %)MeasureKeyValue|(% style="width:210px" %)(((
371 +|MeasureKeyValue|(((
354 354  Inherits from
373 +
355 355  //KeyValue//
356 -)))|(% style="width:617px" %)The value of the Measure Dimension component of the key. The value is the Concept to which this class is associated.
357 -|(% style="width:182px" %) |(% style="width:210px" %)+value|(% style="width:617px" %)(((
375 +)))|The value of the Measure Dimension component of the key. The value is the Concept to which this class is associated.
376 +| |+value|(((
358 358  Association to the Concept.
359 -Note that this is a conceptual association showing that the Concept must exist in the Concept Scheme associated with the Measure Dimension in the Data Structure Definition. In the actual Data Set the value of the Concept is placed in the Key Value.
378 +
379 +Note that this is a conceptual association showing that the Concept must exist in the Concept Scheme associated with the Measure Dimension in the Data Structure
380 +
381 +Definition. In the actual Data Set the value of the Concept is placed in the Key Value.
360 360  )))
361 -|(% style="width:182px" %)TimeKeyValue|(% style="width:210px" %)(((
383 +|TimeKeyValue|(((
362 362  Inherits from
385 +
363 363  //KeyValue//
364 -)))|(% style="width:617px" %)The value of the Time Dimension component of the key.
365 -|(% style="width:182px" %)CodedKeyValue|(% style="width:210px" %)(((
387 +)))|The value of the Time Dimension component of the key.
388 +|CodedKeyValue|(((
366 366  Inherits from
390 +
367 367  //KeyValue//
368 -)))|(% style="width:617px" %)The value of a coded component of the key. The value is the Code to which this class is associated.
369 -|(% style="width:182px" %) |(% style="width:210px" %)+value|(% style="width:617px" %)(((
392 +)))|The value of a coded component of the key. The value is the Code to which this class is associated.
393 +| |+value|(((
370 370  Association to the Code.
371 -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.
395 +
396 +Note that this is a conceptual association showing that the Code must exist in the Code list associated with the Dimension in the Data
397 +
398 +Structure Definition. In the actual Data Set the value of the Code is placed in the Key Value.
372 372  )))
373 -|(% style="width:182px" %)UnCodedKeyValue|(% style="width:210px" %)(((
400 +|UnCodedKeyValue|(((
374 374  Inherits from
402 +
375 375  //KeyValue//
376 -)))|(% style="width:617px" %)The value of an uncoded component of the key.
377 -|(% style="width:182px" %) |(% style="width:210px" %)value|(% style="width:617px" %)The value of the key component.
378 -|(% style="width:182px" %) |(% style="width:210px" %)startTime|(% style="width:617px" %)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).
379 -|(% style="width:182px" %) |(% style="width:210px" %)+valueFor|(% style="width:617px" %)Associates Dimension, Measure Dimension, or Time Dimension to the Key Value, and thereby to the Concept that is the semantic of the Dimension, or Time Dimension.
380 -|(% style="width:182px" %)GroupKey|(% style="width:210px" %)(((
404 +)))|The value of an uncoded component of the key.
405 +| |value|The value of the key component.
406 +| |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).
407 +| |+valueFor|Associates Dimension, Measure Dimension, or Time Dimension to the Key Value, and thereby to the Concept that is the semantic of the Dimension, or Time Dimension.
408 +|GroupKey|(((
381 381  Inherits from
382 382  
383 383  Key
384 -)))|(% style="width:617px" %)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.
385 -|(% style="width:182px" %) |(% style="width:210px" %)+describedBy|(% style="width:617px" %)Associates the Group Dimension Descriptor defined in the Data Structure Definition.
386 -|(% style="width:182px" %)SeriesKey|(% style="width:210px" %)(((
412 +)))|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.
413 +| |+describedBy|Associates the Group Dimension Descriptor defined in the Data Structure Definition.
414 +|SeriesKey|(((
387 387  Inherits from
416 +
388 388  Key
389 -)))|(% style="width:617px" %)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.
390 -|(% style="width:182px" %) |(% style="width:210px" %)+describedBy|(% style="width:617px" %)Associates the Dimension Descriptor defined in the Data Structure Definition.
391 -|(% style="width:182px" %)Observation|(% style="width:210px" %) |(% style="width:617px" %)The value of the observed phenomenon in the context of the Key Values comprising the key.
392 -|(% style="width:182px" %) |(% style="width:210px" %)+valueFor|(% style="width:617px" %)Associates the Primary Measure defined in the Data Structure Definition.
393 -|(% style="width:182px" %) |(% style="width:210px" %)+attachedAttribute|(% style="width:617px" %)Association to the Attribute Values relating to the Observation.
394 -|(% style="width:182px" %) |(% style="width:210px" %)+observationDimension|(% style="width:617px" %)Association to the Key Value that holds the value of the “Dimension at the Observation Level”.
395 -|(% style="width:182px" %)//ObservationValue//|(% style="width:210px" %)(((
418 +)))|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.
419 +| |+describedBy|Associates the Dimension Descriptor defined in the Data Structure Definition.
420 +|Observation| |The value of the observed phenomenon in the context of the Key Values comprising the key.
421 +| |+valueFor|Associates the Primary Measure defined in the Data Structure Definition.
422 +| |+attachedAttribute|Association to the Attribute Values relating to the Observation.
423 +| |+observationDimension|Association to the Key Value that holds the value of the “Dimension at the Observation Level”.
424 +|//ObservationValue//|(((
396 396  Abstract class
426 +
397 397  Sub classes
428 +
398 398  UncodedObservation
430 +
399 399  CodedObservation
400 -)))|(% style="width:617px" %)
401 -|(% style="width:182px" %)UncodedObservation|(% style="width:210px" %)(((
432 +)))|
433 +|UncodedObservation|(((
402 402  Inherits from
435 +
403 403  ObservationValue
404 -)))|(% style="width:617px" %)An observation that has a text value.
405 -|(% style="width:182px" %) |(% style="width:210px" %)value|(% style="width:617px" %)The value of the Uncoded Observation.
406 -|(% style="width:182px" %)CodedObservation|(% style="width:210px" %)(((
437 +)))|An observation that has a text value.
438 +| |value|The value of the Uncoded Observation.
439 +|CodedObservation|(((
407 407  Inherits from
441 +
408 408  ObservationValue
409 -)))|(% style="width:617px" %)An Observation that takes its value from a code in a Code list.
410 -|(% style="width:182px" %) |(% style="width:210px" %)+value|(% style="width:617px" %)(((
443 +)))|An Observation that takes its value from a code in a Code list.
444 +| |+value|(((
411 411  Association to the Code that is the value of the Observation.
412 -Note that this is a conceptual association showing that the Code must exist in the Code list associated with the Primary Measure or the Concept of the Measure Dimension in the Data Structure Definition. In the actual Data Set the value of the Code is placed in the Observation.
446 +
447 +Note that this is a conceptual association showing that the Code must exist in the Code list associated with the Primary Measure or the Concept of the Measure Dimension in the Data
448 +
449 +Structure Definition. In the actual Data Set the value of the Code is placed in the Observation.
413 413  )))
414 -|(% style="width:182px" %)//AttributeValue//|(% style="width:210px" %)(((
451 +|//AttributeValue//|(((
415 415  Abstract class
453 +
416 416  Sub classes
417 -//UncodedAttributeValue
418 -CodedAttributeValue//
419 -)))|(% style="width:617px" %)The value of an attribute, such as the instance of a Coded Attribute or of an Uncoded Attribute in a structure such as a Data Structure Definition.
420 -|(% style="width:182px" %) |(% style="width:210px" %)value|(% style="width:617px" %)The value of the attribute.
421 -|(% style="width:182px" %) |(% style="width:210px" %)+valueFor|(% style="width:617px" %)(((
455 +
456 +//UncodedAttributeValue//
457 +
458 +//CodedAttributeValue//
459 +)))|The value of an attribute, such as the instance of a Coded Attribute or of an Uncoded Attribute in a structure such as a Data Structure Definition.
460 +| |value|The value of the attribute.
461 +| |+valueFor|(((
422 422  Association to the Data Attribute defined in the Data Structure Definition.
463 +
423 423  Note that this is conceptual association as the Concept is identified explicitly in the data set.
424 424  )))
425 -|(% style="width:182px" %)//UncodedAttribute Value//|(% style="width:210px" %)(((
466 +|//UncodedAttribute Value//|(((
426 426  Inherits from
468 +
427 427  //AttributeValue//
428 -)))|(% style="width:617px" %)An attribute value that has a text value.
429 -|(% style="width:182px" %) |(% style="width:210px" %)startTime|(% style="width:617px" %)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).
430 -|(% style="width:182px" %)(((
470 +)))|An attribute value that has a text value.
471 +| |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).
472 +|(((
431 431  CodedAttribute
432 432  
433 433  Value
434 -)))|(% style="width:210px" %)(((
476 +)))|(((
435 435  Inherits from
478 +
436 436  //AttributeValue//
437 -)))|(% style="width:617px" %)An attribute that takes it value from a Code in Code list.
438 -|(% style="width:182px" %) |(% style="width:210px" %)+value|(% style="width:617px" %)(((
480 +)))|An attribute that takes it value from a Code in Code list.
481 +| |+value|(((
439 439  Association to the Code that is the value of the Attribute Value.
483 +
440 440  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.
441 441  )))
442 442