Interoperability Basis Platform

== 5.1 Introduction ==

The DataStructureDefiniton is the class [[name>>doc:IMElements.name.WebHome]] for a [[structure>>doc:IMElements.structure.WebHome]] definition for data. Some organisations know this [[type>>doc:IMElements.type.WebHome]] of definition as a “[[Key>>doc:IMElements.AnnotableArtefact.Key.WebHome]] Family” and so the two names are synonymous. The term [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] (also referred to as [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]) is used in this specification.

8

9

Many of the constructs in this layer of the model inherit from the [[SDMX>>doc:sdmx:Glossary 2\.1.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>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]].

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>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Base gives most of the [[structure>>doc:IMElements.structure.WebHome]] of this sub model both in terms of associations and in terms of [[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]. The relationship diagrams shown in this section show clearly when these associations are inherited from the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Base (see the Appendix “A Short Guide to UML in the [[SDMX Information Model>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]” to see the diagrammatic notation used to depict this).

12

13

The actual [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Base construct from which the concrete classes inherit depends upon the requirements of the class for:

14

15

[[Annotation>>doc:IMElements.Annotation.WebHome]] – //[[AnnotableArtefact>>doc:IMElements.AnnotableArtefact.WebHome]]//

16

Identification – //[[IdentifiableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.WebHome]]//

17

Naming – //[[NameableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.WebHome]]//

18

Versioning – //[[VersionableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.WebHome]]//

19

Maintenance – //[[MaintainableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.WebHome]]//

20

21

== 5.2 Inheritance View ==

22

23

=== 5.2.1 Class Diagram ===

24

25

[[image:image53.png]]

26

27

**Figure 27 Class inheritance in the Data Structure Definition and Data Set Packages**

28

29

=== 5.2.2 Explanation of the Diagram ===

30

31

==== 5.2.2.1 Narrative ====

32

33

Those classes in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] metamodel which require annotations inherit from //[[AnnotableArtefact>>doc:IMElements.AnnotableArtefact.WebHome]]//. These are:

34

35

//[[IdentifiableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.WebHome]]

36

[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]

37

[[Key>>doc:IMElements.AnnotableArtefact.Key.WebHome]]// (and therefore //[[SeriesKey>>doc:IMElements.AnnotableArtefact.Key.SeriesKey.WebHome]]// and //[[GroupKey>>doc:IMElements.AnnotableArtefact.Key.GroupKey.WebHome]]//)

38

//[[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]]//

39

40

Those classes in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] metamodel which require annotations and global identity are derived from //[[IdentifiableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.WebHome]]//. These are:

41

42

//[[NameableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.WebHome]]

43

[[ComponentList>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.WebHome]]

44

[[Component>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.WebHome]]//

45

46

Those classes in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] metamodel which require annotations, global identity, multilingual [[name>>doc:IMElements.name.WebHome]] and multilingual [[description>>doc:IMElements.description.WebHome]] are derived from //[[NameableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.WebHome]]//. These are:

47

48

//[[VersionableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.WebHome]]

49

[[Item>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.WebHome]]//

50

51

The classes in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] metamodel which require annotations, global identity, multilingual [[name>>doc:IMElements.name.WebHome]] and multilingual [[description>>doc:IMElements.description.WebHome]], and versioning are derived from //[[VersionableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.WebHome]]//. These are:

52

53

//[[MaintainableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.WebHome]]//

54

55

Abstract classes which represent information that is maintained by [[Maintenance Agencies>>doc:sdmx:Glossary 2\.1.Maintenance agency.WebHome]] all inherit from //[[MaintainableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.WebHome]]//, they also inherit all the features of a //[[VersionableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.WebHome]]//, and are:

56

57

//[[StructureUsage>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.WebHome]]

58

[[Structure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.WebHome]]

59

[[ItemScheme>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.ItemScheme.WebHome]]//

60

61

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.

62

63

Those concrete classes in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] and [[Dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] packages of the metamodel which require to be maintained by Agencies all inherit (via other abstract classes) from //[[MaintainableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.WebHome]]//, these are:

64

65

[[Dataflow>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.Dataflow.WebHome]]

66

[[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]]

67

The component structures that are lists of lists, inherit directly from //[[Structure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.WebHome]]//. A //[[Structure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.WebHome]]// contains several lists of [[components>>doc:IMElements.components.WebHome]]. The concrete class that inherits from //[[Structure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.WebHome]]// is:

68

[[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]]

69

70

A [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] contains a list of [[dimensions>>doc:IMElements.dimensions.WebHome]], a list of [[measures>>doc:IMElements.measures.WebHome]] and a list of [[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]].

71

72

The concrete classes which inherit from //[[ComponentList>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.WebHome]]// and are subcomponents of the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] are:

73

74

[[DimensionDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.DimensionDescriptor.WebHome]] – content is [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] and [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]]

75

DimensionGroupDescriptor – content is an association to [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]], [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]]

76

[[MeasureDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.MeasureDescriptor.WebHome]] – content is [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]]

77

[[AttributeDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.AttributeDescriptor.WebHome]] – content is [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] and an association to [[MetadataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.MetadataAttribute.WebHome]]

78

79

The classes that inherit from //[[Component>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.WebHome]]// are:

80

81

[[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]]

82

//[[DimensionComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.WebHome]]// and thereby its sub classes of [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] and [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]]

83

//[[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]// and thereby its sub classes of [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] and [[MetadataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.MetadataAttribute.WebHome]]

84

85

The concrete classes identified above are the majority of the classes required to define the metamodel for the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]]. The diagrams and explanations in the rest of this section show how these concrete classes are related in order to support the functionality required.

86

87

== 5.3 Data Structure Definition – Relationship View ==

88

89

=== 5.3.1 Class Diagram ===

90

91

[[image:image54.png]]

92

93

**Figure 28 Relationship class diagram of the Data Structure Definition excluding representation**

94

95

=== 5.3.2 Explanation of the Diagrams ===

96

97

==== 5.3.2.1 Narrative ====

98

99

A [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] defines the Dimensions, [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]], DataAttributes, and Measures, and associated Representations, that comprise the valid [[structure>>doc:IMElements.structure.WebHome]] of data and related [[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] that are contained in a [[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]], which is defined by a [[Dataflow>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.Dataflow.WebHome]]. In addition, a [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] may be related to one [[MetadataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.MetadataStructureDefinition.WebHome]], in order to use the latter’s MetadataAttributes, by relating them to other //Components// within the [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]], as explained below.

100

101

The [[Dataflow>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.Dataflow.WebHome]] may also have additional [[metadata>>doc:IMElements.metadata.WebHome]] attached that define qualitative information and [[Constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] on the use of the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] such as the subset of Codes used in a [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] (this is covered later in this document – see sections “[[Constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]]” and “Data Provisioning”). Each [[Dataflow>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.Dataflow.WebHome]] has a maximum of one [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] specified which defines the [[structure>>doc:IMElements.structure.WebHome]] of any [[DataSets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] to be reported/disseminated. A [[Dataflow>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.Dataflow.WebHome]] may optionally define which Dimensions it uses, by defining a [[DimensionConstraint>>doc:IMElements.DimensionConstraint.WebHome]] (this is a mandatory requirement if the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] sets its’ [[evolvingStructure>>doc:IMElements.evolvingStructure.WebHome]] property to ‘true’ and is sematically referenced by the [[Dataflow>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.Dataflow.WebHome]]).

102

103

There are two types of [[dimensions>>doc:IMElements.dimensions.WebHome]] each having a common association to [[Concept>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.Concept.WebHome]]:

104

105

* [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]]

106

* [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]]

107

108

Note that [[DimensionComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.WebHome]] can be any or all its sub classes i.e., [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]], [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]].

109

110

The //[[DimensionComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.WebHome]]//, [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]], [[MetadataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.MetadataAttribute.WebHome]] and [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]] link to the [[Concept>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.Concept.WebHome]] that defines its [[name>>doc:IMElements.name.WebHome]] and semantic (/conceptIdentity association to [[Concept>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.Concept.WebHome]]). The [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]], [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] (but not [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]]) and [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]] can optionally have a +conceptRole association with a [[Concept>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.Concept.WebHome]] that identifies its [[role>>doc:IMElements.role.WebHome]] in the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]], or one of the standard pre-defined roles, i.e., those published in "GUIDELINES FOR SDMX CONCEPT ROLES" by the [[SDMX>>doc:sdmx:Glossary 2\.1.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 [[value>>doc:IMElements.value.WebHome]] 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.

111

112

The valid values for a //[[DimensionComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.WebHome]]//, [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]], [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] or [[MetadataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.MetadataAttribute.WebHome]], when used in this [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]], are defined by the [[Representation>>doc:IMElements.Representation.WebHome]]. This [[Representation>>doc:IMElements.Representation.WebHome]] is taken from the [[Concept>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.Concept.WebHome]] definition ([[coreRepresentation>>doc:IMElements.coreRepresentation.WebHome]]) unless it is overridden in this [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] ([[localRepresentation>>doc:IMElements.localRepresentation.WebHome]]) – see Figure 28. Note also that [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]] is constrained to specific FacetValueTypes. Moreover, the Representations of MetadataAttributes are specified in the corresponding [[MetadataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.MetadataStructureDefinition.WebHome]], linked by the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]].

113

114

There will always be a [[DimensionDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.DimensionDescriptor.WebHome]] [[grouping>>doc:IMElements.grouping.WebHome]] that identifies all of the [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] comprising the full key. Together the Dimensions specify the key of an [[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]].

115

116

The //[[DimensionComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.WebHome]]// can optionally be grouped by multiple GroupDimensionDescriptors each of which identifies the group of Dimensions that can form a partial key. The [[GroupDimensionDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.GroupDimensionDescriptor.WebHome]] must be identified ([[GroupDimensionDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.GroupDimensionDescriptor.WebHome]].id) and this is used in the [[GroupKey>>doc:IMElements.AnnotableArtefact.Key.GroupKey.WebHome]] of the [[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] to declare which DataAttributes or MetadataAttributes are reported at this group level in the [[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]].

117

118

There can be a maximum of one [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]] specified in the [[DimensionDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.DimensionDescriptor.WebHome]]. The [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]] is used to specify the [[Concept>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.Concept.WebHome]] used to convey the [[time period>>doc:sdmx:Glossary 2\.1.Time period.WebHome]] of the observation in a [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]. The [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]] must contain a valid representation of time and cannot be coded.

119

120

There can be one or more Measures under the [[MeasureDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.MeasureDescriptor.WebHome]]. Measures represent the observable phenomena. Each [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]] may have a valid representation, a [[maxOccurs>>doc:IMElements.maxOccurs.WebHome]] [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] limiting the maximum number of values per [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]] (which may be set to 'unbounded' for unlimited occurrences), as well as a [[minOccurs>>doc:IMElements.minOccurs.WebHome]] [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]], indicating the minimum required number of values, when the [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]] is reported. If [[minOccurs>>doc:IMElements.minOccurs.WebHome]] or [[maxOccurs>>doc:IMElements.maxOccurs.WebHome]] are omitted (they both default to ‘1’), the [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]] is considered to take a single [[value>>doc:IMElements.value.WebHome]]; otherwise, it is an array. Moreover, the usage [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] indicates whether a [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]] must be reported or not, by the corresponding values: mandatory or optional.

121

122

The [[AttributeDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.AttributeDescriptor.WebHome]] may contain one or more //[[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]//s, i.e., at least one [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] definition or one [[MetadataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.MetadataAttribute.WebHome]] reference.

123

124

The [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] defines a characteristic of data that are collected or disseminated and is grouped in the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] by a single [[AttributeDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.AttributeDescriptor.WebHome]]. The [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] can be indicated if it must be reported or not, by the corresponding [[value>>doc:IMElements.value.WebHome]] of the usage [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]: i.e., mandatory or optional. The property [[minOccurs>>doc:IMElements.minOccurs.WebHome]] specifies the minimum number of array values to be included when the [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] is reported. Moreover, a [[maxOccurs>>doc:IMElements.maxOccurs.WebHome]] [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] indicates whether the [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] may need to report more than one values, i.e., an array of values. The [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] may play a specific [[role>>doc:IMElements.role.WebHome]] in the [[structure>>doc:IMElements.structure.WebHome]] and this is specified by the +[[role>>doc:IMElements.role.WebHome]] association to the [[Concept>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.Concept.WebHome]] that identifies its [[role>>doc:IMElements.role.WebHome]].

125

126

The [[MetadataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.MetadataAttribute.WebHome]] defines [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] that may be collected or disseminated and is grouped together with [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] under the [[AttributeDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.AttributeDescriptor.WebHome]].

127

128

A [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] or a [[MetadataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.MetadataAttribute.WebHome]] (i.e., an //[[AttributeComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.WebHome]]//) is specified as being +[[relatedTo>>doc:IMElements.relatedTo.WebHome]] an [[AttributeRelationship>>doc:IMElements.AttributeRelationship.WebHome]], which defines the constructs to which the //[[AttributeComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.WebHome]]// is to be reported within a //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]//. An //[[AttributeComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.WebHome]]// can be specified as being related to one of the following [[artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]]:

129

130

* All data within the [[dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] (DataflowRelationship) – this is equivalent to attaching an [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] to all data within the [[Dataflow>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.Dataflow.WebHome]].

131

* [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] or set of Dimensions ([[DimensionRelationship>>doc:IMElements.AttributeRelationship.DimensionRelationship.WebHome]])

132

* Set of Dimensions specified by a [[GroupKey>>doc:IMElements.AnnotableArtefact.Key.GroupKey.WebHome]] ([[GroupRelationship>>doc:IMElements.AttributeRelationship.GroupRelationship.WebHome]] – this is retained for compatibility reasons – or +[[groupKey>>doc:IMElements.groupKey.WebHome]] of the [[DimensionRelationship>>doc:IMElements.AttributeRelationship.DimensionRelationship.WebHome]])

133

* [[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]] ([[ObservationRelationship>>doc:IMElements.AttributeRelationship.ObservationRelationship.WebHome]])

134

* In addition to the positioning of an //[[AttributeComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.WebHome]]// within a //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]//, another relationship indicates the [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]](s) for which the //[[AttributeComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.WebHome]]// is reported. Regardless of the position of the //[[AttributeComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.WebHome]]// within the //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]//, the //[[AttributeComponent>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.WebHome]]// may concern one, more than one, or all Measures included in the [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]. This is expressed using the [[MeasureRelationship>>doc:IMElements.AttributeRelationship.MeasureRelationship.WebHome]] class, which relates a [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] to one or more Measures. Lack of the [[MeasureRelationship>>doc:IMElements.AttributeRelationship.MeasureRelationship.WebHome]] defaults to a relationship to all Measures.

135

136

[[image:image55.png]]

137

138

**Figure 29: Attribute Attachment Defined in the Data Structure Definition**

139

140

The following table details the possible relationships a [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] may specify. Note that these relationships are mutually exclusive, and therefore only one of the following is possible.

141

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>>doc:IMElements.value.WebHome]] of the [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is fixed for all data contained in the [[dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]. The [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] [[value>>doc:IMElements.value.WebHome]] applies to all data defined by the underlying [[Dataflow>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.Dataflow.WebHome]].|(% style="width:434px" %)The [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is reported at the [[Dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] level.

145

|[[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] (1..n)|(% style="width:537px" %)The [[value>>doc:IMElements.value.WebHome]] of the [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] will vary with the [[value>>doc:IMElements.value.WebHome]](s) of the referenced [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]](s). In this case, Group(s) to which the [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] should be attached may optionally be specified.|(% style="width:434px" %)The [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is reported at the lowest level of the [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] to which the [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is related, otherwise at the level of the Group if Attachment Group(s) is specified.

146

|Group|(% style="width:537px" %)The [[value>>doc:IMElements.value.WebHome]] of the [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] 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>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] [[value>>doc:IMElements.value.WebHome]] varies based on all Group [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] values.|(% style="width:434px" %)The [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is reported at the level of Group.

147

|[[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]]|(% style="width:537px" %)The [[value>>doc:IMElements.value.WebHome]] of the [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] varies with the observed [[value>>doc:IMElements.value.WebHome]].|(% style="width:434px" %)The [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is reported at the level of [[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]].

148

149

[[image:image56.png]]

150

151

**Figure 30: Representation of DSD Components**

152

153

Each of [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]], [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]], [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]], [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] and [[MetadataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.MetadataAttribute.WebHome]] can have a [[Representation>>doc:IMElements.Representation.WebHome]] specified (using the [[localRepresentation>>doc:IMElements.localRepresentation.WebHome]] association). If this is not specified in the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] then the representation specified for (% style="color:#e74c3c" %)[[Concept>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.Concept.WebHome]](%%) ([[coreRepresentation>>doc:IMElements.coreRepresentation.WebHome]]) is used. [[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]], and [[DataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.DataAttribute.WebHome]] may be also represented by multilingual [[text>>doc:IMElements.text.WebHome]] (as seen in the [[DataSet>>doc:Glossary.Data set.WebHome]] diagram further down). An exception is the [[MetadataAttribute>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.AttributeComponent.MetadataAttribute.WebHome]], where its [[Representation>>doc:IMElements.Representation.WebHome]] is specified in the [[MetadataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.MetadataStructureDefinition.WebHome]].

154

155

A [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] can be extended to form a derived [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]]. This is supported in the StructureMap.

156

157

==== 5.3.2.2 Definitions ====

158

159

(% style="width:981.835px" %)

160

|(% style="width:204px" %)**Class**|(% style="width:236px" %)**Feature**|(% style="width:538px" %)**Description**

161

|(% style="width:204px" %)StructureUsage|(% style="width:236px" %) |(% style="width:538px" %)See “[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Base”.

162

|(% style="width:204px" %)[[Dataflow>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.Dataflow.WebHome]]|(% style="width:236px" %)(((

Inherits from

//StructureUsage//

)))|(% style="width:538px" %)Abstract concept (i.e., the structure without any data) of a flow of data that providers will provide for different [[reference periods>>doc:sdmx:Glossary 2\.1.Reference period.WebHome]].

167

|(% style="width:204px" %) |(% style="width:236px" %)/structure|(% style="width:538px" %)Associates a Dataflow to the [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]].

168

|(% style="width:204px" %) |(% style="width:236px" %)dimensionConstraint|(% style="width:538px" %)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}}.

169

|(% style="width:204px" %)DataStructureDefinition|(% style="width:236px" %) |(% style="width:538px" %)A collection of metadata concepts, their structure and usage when used to collect or disseminate data.

170

|(% style="width:204px" %) |(% style="width:236px" %)/grouping|(% style="width:538px" %)An association to a set of metadata concepts that have an identified structural role in a [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]].

171

|(% style="width:204px" %) |(% style="width:236px" %)evolvingStructure|(% style="width:538px" %)An optional boolean property, defaulting to false. When true the DataStructureDefinition may have new Dimensions added without having to change its major version number.

172

|(% style="width:204px" %)GroupDimensionDescriptor|(% style="width:236px" %)(((

173

Inherits from

174

//ComponentList//

175

)))|(% style="width:538px" %)A set of metadata concepts that define a partial key derived from the Dimension Descriptor in a [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]].

176

|(% style="width:204px" %) |(% style="width:236px" %)/components|(% style="width:538px" %)An association to the Dimension components that comprise the group.

177

|(% style="width:204px" %)DimensionDescriptor|(% style="width:236px" %)(((

178

Inherits from

179

//ComponentList//

180

)))|(% style="width:538px" %)An ordered set of metadata concepts that, combined, classify a statistical [[series>>doc:sdmx:Glossary 2\.1.Series.WebHome]], and whose values, when combined (the key) in an instance such as a [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]], uniquely identify a specific observation.

181

|(% style="width:204px" %) |(% style="width:236px" %)/components|(% style="width:538px" %)An association to the Dimension and Time Dimension comprising the Key Descriptor.

182

|(% style="width:204px" %)AttributeDescriptor|(% style="width:236px" %)(((

183

Inherits from

184

//ComponentList//

185

)))|(% style="width:538px" %)A set metadata concepts that define the [[Attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] of a [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]].

186

|(% style="width:204px" %) |(% style="width:236px" %)/components|(% style="width:538px" %)An association to a Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] component.

187

|(% style="width:204px" %)[[MeasureDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.MeasureDescriptor.WebHome]]|(% style="width:236px" %)(((

188

Inherits from

189

//ComponentList//

190

)))|(% style="width:538px" %)A metadata concept that defines the Measures of a [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]].

191

|(% style="width:204px" %) |(% style="width:236px" %)/components|(% style="width:538px" %)An association to a Measure component.

192

|(% style="width:204px" %)//DimensionComponent//|(% style="width:236px" %)(((

193

Inherits from

194

//[[Component>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.WebHome]]//

195

Sub class

196

[[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]]

197

TimeDimension

198

)))|(% style="width:538px" %)An abstract class representing any Component that can be used for identifying observations.

199

|(% style="width:211px" %) |(% style="width:235px" %)[[Order>>doc:IMElements.Order.WebHome]]|(% style="width:534px" %)Specifies the order of the Dimension Components within the [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]. The property is used to indicate the position of the Dimension Component and determines the Key for identifying observations, or [[series>>doc:sdmx:Glossary 2\.1.Series.WebHome]]. The Time Dimension, when specified, must be the last within the Dimension Descriptor.

200

|(% style="width:211px" %)[[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]]|(% style="width:235px" %)(((

201

Inherits from

202

//DimensionComponent//

203

)))|(% style="width:534px" %)A metadata concept used (most probably together with other metadata concepts) to classify a statistical [[series>>doc:sdmx:Glossary 2\.1.Series.WebHome]], e.g., a statistical concept indicating a certain [[economic activity>>doc:sdmx:Glossary 2\.1.Economic activity.WebHome]] or a geographical [[reference area>>doc:sdmx:Glossary 2\.1.Reference area.WebHome]].

204

|(% style="width:211px" %) |(% style="width:235px" %)/role|(% style="width:534px" %)Association to the Concept that specifies the role that that the Dimension plays in the [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]].

205

|(% style="width:211px" %) |(% style="width:235px" %)/conceptIdentity|(% style="width:534px" %)An association to the metadata concept which defines the semantic of the Dimension.

206

|(% style="width:211px" %)TimeDimension|(% style="width:235px" %)(((

207

Inherits from

208

//DimensionComponent//

209

)))|(% style="width:534px" %)A metadata concept that identifies the component in the key structure that has the role of “time”.

210

|(% style="width:211px" %)DataAttribute|(% style="width:235px" %)(((

211

Inherits from

212

//[[Component>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.WebHome]]//

213

)))|(% style="width:534px" %)A characteristic of an object or entity.

214

|(% style="width:211px" %) |(% style="width:235px" %)/role|(% style="width:534px" %)Association to the Concept that specifies the role that that the Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] plays in the [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]].

215

|(% style="width:211px" %) |(% style="width:235px" %)minOccurs|(% style="width:534px" %)Defines the minimum required occurrences for the [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]. When equals to zero, the [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is conditional.

216

|(% style="width:211px" %) |(% style="width:235px" %)maxOccurs|(% style="width:534px" %)Defines the maximum allowed occurrences for the [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]].

217

|(% style="width:211px" %) |(% style="width:235px" %)[[Usage>>doc:IMElements.Usage.WebHome]]|(% style="width:534px" %)Defines whether a Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] must be reported or not.

218

|(% style="width:211px" %) |(% style="width:235px" %)+relatedTo|(% style="width:534px" %)Association to an [[Attribute Relationship>>doc:sdmx:Glossary 2\.1.Attribute relationship.WebHome]].

219

|(% style="width:211px" %) |(% style="width:235px" %)/conceptIdentity|(% style="width:534px" %)An association to the Concept which defines the semantic of the component.

220

|(% style="width:211px" %)[[Measure>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.Measure.WebHome]]|(% style="width:235px" %)(((

221

Inherits from

222

//[[Component>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.WebHome]]//

223

)))|(% style="width:534px" %)The metadata concept that is the phenomenon to be measured in a [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]. In a [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] the instance of the measure is often called the observation.

224

|(% style="width:211px" %) |(% style="width:235px" %)/conceptIdentity|(% style="width:534px" %)An association to the Concept which carries the values of the measures.

225

|(% style="width:211px" %) |(% style="width:235px" %)minOccurs|(% style="width:534px" %)Defines the minimum required occurrences for the Measure. When equals to zero, the Measure is conditional.

226

|(% style="width:211px" %) |(% style="width:235px" %)maxOccurs|(% style="width:534px" %)Defines the maximum allowed occurrences for the Measure.

227

|(% style="width:211px" %) |(% style="width:235px" %)[[Usage>>doc:IMElements.Usage.WebHome]]|(% style="width:534px" %)Defines whether a Measure must be reported or not.

228

|(% style="width:211px" %)//AttributeRelationship//|(% style="width:235px" %)(((

229

Abstract Class

230

Sub classes

231

ObservationRelationship

232

GroupRelationship DimensionRelationship

233

)))|(% style="width:534px" %)Specifies the type of [[artefact>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] to which a Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] can be attached in a [[Data Set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]].

234

|(% style="width:211px" %)ObservationRelationship|(% style="width:235px" %) |(% style="width:534px" %)The Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is related to the observations of the [[Data Set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]].

235

|(% style="width:211px" %)GroupRelationship|(% style="width:235px" %) |(% style="width:534px" %)The Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is related to a Group Dimension Descriptor construct.

236

|(% style="width:211px" %) |(% style="width:235px" %)+groupKey|(% style="width:534px" %)An association to the Group Dimension Descriptor

237

|(% style="width:211px" %)DimensionRelationship|(% style="width:235px" %) |(% style="width:534px" %)The Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is related to a set of Dimensions.

238

|(% style="width:211px" %) |(% style="width:235px" %)+dimensions|(% style="width:534px" %)Association to the set of Dimensions to which the Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is related.

239

|(% style="width:211px" %) |(% style="width:235px" %)+groupKey|(% style="width:534px" %)Association to the Group Dimension Descriptor which specifies the set of Dimensions to which the Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is attached.

240

|(% style="width:211px" %)MeasureRelationship|(% style="width:235px" %) |(% style="width:534px" %)The Measures that a Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is reported for.

241

|(% style="width:211px" %) |(% style="width:235px" %)+measures|(% style="width:534px" %)Association to the set of Measures to which a Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is related to.

242

|(% style="width:211px" %)SentinelValuesType|(% style="width:235px" %) |(% style="width:534px" %)This facet indicates that an [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] 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.

243

|(% style="width:211px" %)SentinelValue|(% style="width:235px" %) |(% style="width:534px" %)A value that has a special meaning within the text format representation of the Component.

244

|(% style="width:211px" %) |(% style="width:235px" %)+name|(% style="width:534px" %)An association of a Sentinel Value to a multilingual name.

245

|(% style="width:211px" %) |(% style="width:235px" %)+description|(% style="width:534px" %)An association of a Sentinel Value to a multilingual description.

246

247

The explanation of the classes, [[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]], and associations comprising the [[Representation>>doc:IMElements.Representation.WebHome]] is described in the section on the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Base..

248

249

== 5.4 Data Set – Relationship View ==

250

251

=== 5.4.1 Context ===

252

253

A [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] comprises the collection of data values and associated [[metadata>>doc:IMElements.metadata.WebHome]] that are collected or disseminated according to a known DataStructureDefinition.

254

255

=== 5.4.2 Class Diagram ===

256

257

[[image:image57.png]]

258

259

**Figure 31: Class Diagram of the Data Set**

260

261

=== 5.4.3 Explanation of the Diagram ===

262

263

==== 5.4.3.1 Narrative – Data Set ====

264

265

Note that the //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]// must conform to the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] associated to the [[Dataflow>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.Dataflow.WebHome]] for which this [[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] is an “instance of data”. Whilst the model shows the association to the classes of the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]], this is for conceptual purposes to show the link to the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]]. In the actual //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]// as exchanged there must, of course, be a reference to the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] and optionally a [[Dataflow>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.StructureUsage.Dataflow.WebHome]] or a ProvisionAgreement, but the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] is not necessarily exchanged with the data. Therefore, the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] classes are shown in the grey areas, as these are not a part of the //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]// when the //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]// is exchanged. However, the [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] in the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] can be used by an application to validate the contents of the //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]// in terms of the valid content of a //[[KeyValue>>doc:IMElements.KeyValue.WebHome]]// as defined by the [[Representation>>doc:IMElements.Representation.WebHome]] in the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]].

266

267

An organisation playing the [[role>>doc:IMElements.role.WebHome]] of [[DataProvider>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.Organisation.DataProvider.WebHome]] can be responsible for one or more //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]//.

268

269

A //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]// is formatted as a [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] specific [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] ([[StructureSpecificDataSet>>doc:IMElements.AnnotableArtefact.DataSet.StructureSpecificDataSet.WebHome]]). The structured [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] is structured according to one specific [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]]; hence the latter is required for validation at the syntax level.

270

271

A //[[DataSet>>doc:sdmx:Glossary 2\.1.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:IMElements.components.WebHome]] ([[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]], [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]]) defined in the [[DimensionDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.DimensionDescriptor.WebHome]] of the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]], together with associated //AttributeValue//s that define specific characteristics about the [[artefact>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] to which it is attached – //Observation//s, set of Dimensions. It can be structured in terms of a [[SeriesKey>>doc:IMElements.AnnotableArtefact.Key.SeriesKey.WebHome]] to which //Observation//s are reported.

272

273

The //[[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]]// can be the [[value>>doc:IMElements.value.WebHome]](s) of the variable(s) being measured for the [[Concept>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.Item.Concept.WebHome]] associated to the Measure(s) in the [[MeasureDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.MeasureDescriptor.WebHome]] of the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]]. Each //[[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]]// associates one or more //[[ObservationValue>>doc:IMElements.AnnotableArtefact.ObservationValue.WebHome]]//s with a [[KeyValue>>doc:IMElements.KeyValue.WebHome]] (+[[observationDimension>>doc:IMElements.observationDimension.WebHome]]) which is the [[value>>doc:IMElements.value.WebHome]] for the “[[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] at the [[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]] Level”. Any [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] can be specified as being the “[[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] at the [[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]] Level”, and this specification is made at the level of the //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]// (i.e., it must be the same [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] for the entire //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]//).

274

275

The //[[KeyValue>>doc:IMElements.KeyValue.WebHome]]// is a [[value>>doc:IMElements.value.WebHome]] for one of [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]] or [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] specified in the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]]. If it is a [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]], it can be coded ([[CodedKeyValue>>doc:IMElements.KeyValue.CodedKeyValue.WebHome]]) or uncoded ([[UncodedKeyValue>>doc:IMElements.KeyValue.UncodedKeyValue.WebHome]]). If it is the [[TimeDimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.TimeDimension.WebHome]] then it is a [[TimeKeyValue>>doc:IMElements.KeyValue.TimeKeyValue.WebHome]]. The actual [[value>>doc:IMElements.value.WebHome]] that the CodedDimensionValue can take must be one of the Codes in the [[Codelist>>doc:sdmx:Glossary 2\.1.Code list.WebHome]] specified as the [[Representation>>doc:IMElements.Representation.WebHome]] of the [[Dimension>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.Component.DimensionComponent.Dimension.WebHome]] in the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]].

276

277

An [[ObservationValue>>doc:IMElements.AnnotableArtefact.ObservationValue.WebHome]] can be coded – this is the [[CodedObservation>>doc:IMElements.AnnotableArtefact.ObservationValue.CodedObservation.WebHome]] – or it can be uncoded – this is the UncodedObservation. In the case of uncoded observations, the values may be multilingual – expressed via the [[TextMeasureValue>>doc:IMElements.AnnotableArtefact.ObservationValue.UncodedObservationValue.TextMeasureValue.WebHome]] – or not ([[OtherUncodedMeasureValue>>doc:IMElements.AnnotableArtefact.ObservationValue.UncodedObservationValue.OtherUncodedMeasureValue.WebHome]]).

278

279

The [[GroupKey>>doc:IMElements.AnnotableArtefact.Key.GroupKey.WebHome]] is a subunit of the //[[Key>>doc:IMElements.AnnotableArtefact.Key.WebHome]]// that has the same dimensionality as the [[SeriesKey>>doc:IMElements.AnnotableArtefact.Key.SeriesKey.WebHome]] but defines a subset of the KeyValues of the [[SeriesKey>>doc:IMElements.AnnotableArtefact.Key.SeriesKey.WebHome]]. Its sub dimension [[structure>>doc:IMElements.structure.WebHome]] is defined in the [[GroupDimensionDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.GroupDimensionDescriptor.WebHome]] of the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] identified by the same [[id>>doc:IMElements.id.WebHome]] as the [[GroupKey>>doc:IMElements.AnnotableArtefact.Key.GroupKey.WebHome]]. The [[id>>doc:IMElements.id.WebHome]] identifies a “[[type>>doc:IMElements.type.WebHome]]” of group and the purpose of the [[GroupKey>>doc:IMElements.AnnotableArtefact.Key.GroupKey.WebHome]] is to report one or more //[[AttributeValue>>doc:IMElements.AnnotableArtefact.AttributeValue.WebHome]]// that are contained at this group level. The [[GroupKey>>doc:IMElements.AnnotableArtefact.Key.GroupKey.WebHome]] is present when the [[GroupDimensionDescriptor>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.ComponentList.GroupDimensionDescriptor.WebHome]] is related to the [[GroupRelationship>>doc:IMElements.AttributeRelationship.GroupRelationship.WebHome]] in the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]]. There can be many types of groups in a //[[DataSet>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]//. If the Group is related to the [[DimensionRelationship>>doc:IMElements.AttributeRelationship.DimensionRelationship.WebHome]] in the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] then the //[[AttributeValue>>doc:IMElements.AnnotableArtefact.AttributeValue.WebHome]]// will be reported with the appropriate dimension in the [[SeriesKey>>doc:IMElements.AnnotableArtefact.Key.SeriesKey.WebHome]] or [[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]].

280

281

In this way each of [[SeriesKey>>doc:IMElements.AnnotableArtefact.Key.SeriesKey.WebHome]], [[GroupKey>>doc:IMElements.AnnotableArtefact.Key.GroupKey.WebHome]], and [[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]] can have zero or more //[[AttributeValue>>doc:IMElements.AnnotableArtefact.AttributeValue.WebHome]]//s that define some [[metadata>>doc:IMElements.metadata.WebHome]] about the object to which it is associated. The //[[AttributeValue>>doc:IMElements.AnnotableArtefact.AttributeValue.WebHome]]// may be either a //[[DataAttributeValue>>doc:IMElements.AnnotableArtefact.AttributeValue.DataAttributeValue.WebHome]]// or a //[[MetadataAttributeValue>>doc:IMElements.AnnotableArtefact.AttributeValue.MetadataAttributeValue.WebHome]]//, representing values of DataAttributes defined in the [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] or MetadataAttributes of the linked [[MSD>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]], respectively. The allowable Concepts and the objects to which these [[metadata>>doc:IMElements.metadata.WebHome]] can be associated (attached) are defined in the [[DataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.DataStructureDefinition.WebHome]] and the linked [[MetadataStructureDefinition>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.NameableArtefact.VersionableArtefact.MaintainableArtefact.Structure.MetadataStructureDefinition.WebHome]].

282

283

The //[[AttributeValue>>doc:IMElements.AnnotableArtefact.AttributeValue.WebHome]]// links to the object [[type>>doc:IMElements.type.WebHome]] ([[SeriesKey>>doc:IMElements.AnnotableArtefact.Key.SeriesKey.WebHome]], [[GroupKey>>doc:IMElements.AnnotableArtefact.Key.GroupKey.WebHome]], [[Observation>>doc:IMElements.AnnotableArtefact.Observation.WebHome]]) to which it is associated.

284

285

==== 5.4.3.2 Definitions ====

286

287

(% style="width:964.835px" %)

288

|(% style="width:200px" %)**Class**|(% style="width:285px" %)**Feature**|(% style="width:454px" %)**Description**

289

|(% style="width:200px" %)//[[DataSet>>doc:Glossary.Data set.WebHome]]//|(% style="width:285px" %)(((

290

Abstract Class

291

Sub classes

292

StructureSpecificDataSet

293

)))|(% style="width:454px" %)An organised collection of data.

294

|(% style="width:200px" %) |(% style="width:285px" %)reportingBegin|(% style="width:454px" %)A specific [[time period>>doc:Glossary.Time period.WebHome]] in a known system of [[time periods>>doc:Glossary.Time period.WebHome]] that identifies the start period of a report.

295

|(% style="width:200px" %) |(% style="width:285px" %)reportingEnd|(% style="width:454px" %)A specific [[time period>>doc:Glossary.Time period.WebHome]] in a known system of [[time periods>>doc:Glossary.Time period.WebHome]] that identifies the end period of a report.

296

|(% style="width:200px" %) |(% style="width:285px" %)dataExtractionDate|(% style="width:454px" %)A specific [[time period>>doc:Glossary.Time period.WebHome]] that identifies the date and time that the data are extracted from a data source.

297

|(% 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>>doc:Glossary.Data set.WebHome]].

298

|(% 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>>doc:Glossary.Data set.WebHome]].

299

|(% 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.

300

|(% 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.

301

|(% style="width:200px" %) |(% style="width:285px" %)setId|(% style="width:454px" %)Provides an identification of the [[data set>>doc:Glossary.Data set.WebHome]].

302

|(% style="width:200px" %) |(% style="width:285px" %)action|(% style="width:454px" %)Defines the action to be taken by the recipient system (information, append, replace, delete)

303

|(% style="width:200px" %) |(% style="width:285px" %)describedBy|(% style="width:454px" %)(((

304

Associates a [[Dataflow>>doc:Glossary.Dataflow.WebHome]] and thereby a [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]] to the [[data set>>doc:Glossary.Data set.WebHome]].

305

)))

306

|(% style="width:200px" %) |(% style="width:285px" %)+structuredBy|(% style="width:454px" %)(((

307

Associates the [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]] that defines the structure of the [[Data Set>>doc:Glossary.Data set.WebHome]]. Note that the [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]] is the same as that associated (non-mandatory) to the [[Dataflow>>doc:Glossary.Dataflow.WebHome]].

308

)))

309

|(% style="width:200px" %) |(% style="width:285px" %)+publishedBy|(% style="width:454px" %)Associates the [[Data Provider>>doc:Glossary.Data provider.WebHome]] that reports/publishes the data.

310

|(% 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>>doc:Glossary.Data structure definition.WebHome]].

311

|(% style="width:200px" %)//Key//|(% style="width:285px" %)(((

Abstract class

Sub classes

SeriesKey

GroupKey

)))|(% style="width:454px" %)Comprises the cross product of values of [[dimensions>>doc:Glossary.Dimension.WebHome]] that identify uniquely an Observation.

317

|(% style="width:200px" %) |(% style="width:285px" %)keyValues|(% style="width:454px" %)Association to the individual Key Values that comprise the Key.

318

|(% style="width:200px" %) |(% style="width:285px" %)+attachedAttribute|(% style="width:454px" %)Association to the [[Attribute>>doc:Glossary.Attribute.WebHome]] Values relating to the [[Series Key>>doc:Glossary.Series key.WebHome]] or Group Key.

319

|(% style="width:200px" %)//KeyValue//|(% style="width:285px" %)(((

Abstract class

Sub classes

TimeKeyValue

CodedKeyValue

UncodedKeyValue

)))|(% style="width:454px" %)The value of a [[component>>doc:Glossary.Component.WebHome]] of a key such as the value of the instance a [[Dimension>>doc:Glossary.Dimension.WebHome]] in a [[Dimension>>doc:Glossary.Dimension.WebHome]] Descriptor of a [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]].

326

|(% style="width:200px" %) |(% style="width:285px" %)+valueFor|(% style="width:454px" %)(((

327

Association to the key [[component>>doc:Glossary.Component.WebHome]] in the [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]] for which this Key Value is a valid [[representation>>doc:Glossary.Representation.WebHome]].

328

Note that this is conceptual association as the key [[component>>doc:Glossary.Component.WebHome]] is identified explicitly in the [[data set>>doc:Glossary.Data set.WebHome]].

329

)))

330

|(% style="width:200px" %)TimeKeyValue|(% style="width:285px" %)(((

331

Inherits from

332

//KeyValue//

333

)))|(% style="width:454px" %)The value of the Time [[Dimension>>doc:Glossary.Dimension.WebHome]] [[component>>doc:Glossary.Component.WebHome]] of the key.

334

|(% style="width:200px" %)CodedKeyValue|(% style="width:285px" %)(((

335

Inherits from

336

//KeyValue//

337

)))|(% style="width:454px" %)The value of a coded [[component>>doc:Glossary.Component.WebHome]] of the key. The value is the [[Code>>doc:Glossary.Code.WebHome]] to which this class is associated.

338

|(% style="width:200px" %) |(% style="width:285px" %)+valueOf|(% style="width:454px" %)Association to the [[Code>>doc:Glossary.Code.WebHome]]. Note that this is a conceptual association showing that the [[Code>>doc:Glossary.Code.WebHome]] must exist in the [[Code list>>doc:Glossary.Code list.WebHome]] associated with the [[Dimension>>doc:Glossary.Dimension.WebHome]] in the [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]]. In the actual [[Data Set>>doc:Glossary.Data set.WebHome]] the value of the [[Code>>doc:Glossary.Code.WebHome]] is placed in the Key Value.

339

|(% style="width:200px" %)UnCodedKeyValue|(% style="width:285px" %)(((

340

Inherits from

341

//KeyValue//

342

)))|(% style="width:454px" %)The value of an uncoded [[component>>doc:Glossary.Component.WebHome]] of the key.

343

|(% style="width:200px" %) |(% style="width:285px" %)value|(% style="width:454px" %)The value of the key [[component>>doc:Glossary.Component.WebHome]].

344

|(% style="width:200px" %) |(% style="width:285px" %)startTime|(% style="width:454px" %)This [[attribute>>doc:Glossary.Attribute.WebHome]] is only used if the textFormat of the [[attribute>>doc:Glossary.Attribute.WebHome]] is of the Timespan type in the [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]] (in which case the value field takes a duration).

345

|(% style="width:200px" %)GroupKey|(% style="width:285px" %)(((

346

Inherits from

347

//Key//

348

)))|(% style="width:454px" %)A set of Key Values that comprise a partial key, of the same dimensionality as the Time [[Series Key>>doc:Glossary.Series key.WebHome]] for the purpose of attaching Data [[Attributes>>doc:Glossary.Attribute.WebHome]].

349

|(% style="width:200px" %) |(% style="width:285px" %)+describedBy|(% style="width:454px" %)Associates the Group [[Dimension>>doc:Glossary.Dimension.WebHome]] Descriptor defined in the [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]].

350

|(% style="width:200px" %)SeriesKey|(% style="width:285px" %)(((

351

Inherits from

352

//Key//

353

)))|(% style="width:454px" %)Comprises the cross product of values of all the Key Values that, together with the Key Value of the +observation [[Dimension>>doc:Glossary.Dimension.WebHome]] identify uniquely an Observation.

354

|(% style="width:200px" %) |(% style="width:285px" %)+describedBy|(% style="width:454px" %)Associates the [[Dimension>>doc:Glossary.Dimension.WebHome]] Descriptor defined in the [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]].

355

|(% 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.

356

|(% style="width:200px" %) |(% style="width:285px" %)+valueFor|(% style="width:454px" %)(((

357

Associates the [[Measure>>doc:Glossary.Measure.WebHome]](s) defined in the [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]].

358

359

The source multiplicity (1..*) indicates that more than one values may be provided for a [[Measure>>doc:Glossary.Measure.WebHome]], if the latter allows it.

360

)))

361

|(% style="width:200px" %) |(% style="width:285px" %)+attachedAttribute|(% style="width:454px" %)Association to the [[Attribute>>doc:Glossary.Attribute.WebHome]] Values relating to the Observation.

362

|(% style="width:200px" %) |(% style="width:285px" %)+observationDimension|(% style="width:454px" %)Association to the Key Value that holds the value of the “[[Dimension>>doc:Glossary.Dimension.WebHome]] at the Observation Level”.

363

|(% style="width:200px" %)//ObservationValue//|(% style="width:285px" %)(((

364

Abstract class

365

Sub classes

366

//UncodedObservationValue//

367

CodedObservation

368

)))|(% style="width:454px" %)

369

|(% style="width:200px" %)//UncodedObservationValue//|(% style="width:285px" %)(((

Abstract class

Inherits from

//ObservationValue//

Sub classes

OtherUncodedMeasureValue

375

TextMeasureValue

376

)))|(% style="width:454px" %)

377

|(% style="width:200px" %)OtherUncodedMeasureValue|(% style="width:285px" %)(((

378

Inherits from

379

//UncodedObservationValue//

380

)))|(% style="width:454px" %)An observation that has a text value.

381

|(% style="width:200px" %) |(% style="width:285px" %)value|(% style="width:454px" %)The value of the Uncoded Observation.

382

|(% style="width:200px" %) |(% style="width:285px" %)startTime|(% style="width:454px" %)This [[attribute>>doc:Glossary.Attribute.WebHome]] is only used if the textFormat of the [[Measure>>doc:Glossary.Measure.WebHome]] is of the Timespan type in the [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]] (in which case the value field takes a duration).

383

|(% style="width:200px" %)TextMeasureValue|(% style="width:285px" %)(((

384

Inherits from

385

//UncodedObservationValue//

386

)))|(% style="width:454px" %)An observation that has a localised text value

387

|(% style="width:200px" %) |(% style="width:285px" %)text|(% style="width:454px" %)The localised text values.

388

|(% style="width:200px" %)CodedObservation|(% style="width:285px" %)(((

389

Inherits from

390

//ObservationValue//

391

)))|(% style="width:454px" %)An Observation that takes its value from a [[code>>doc:Glossary.Code.WebHome]] in a [[Code list>>doc:Glossary.Code list.WebHome]].

392

|(% style="width:200px" %) |(% style="width:285px" %)+valueOf|(% style="width:454px" %)Association to the [[Code>>doc:Glossary.Code.WebHome]] that is the value of the Observation. Note that this is a conceptual association showing that the [[Code>>doc:Glossary.Code.WebHome]] must exist in the Codelist(s) associated with the [[Measure>>doc:Glossary.Measure.WebHome]](s) in the [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]]. In the actual [[Data Set>>doc:Glossary.Data set.WebHome]] the value of the [[Code>>doc:Glossary.Code.WebHome]] is placed in the Observation.

393

|(% style="width:200px" %)//AttributeValue//|(% style="width:285px" %)(((

394

Abstract class

395

Sub classes

396

//DataAttributeValue// //MetadataAttributeValue//

397

)))|(% style="width:454px" %)Represents the value for any [[Attribute>>doc:Glossary.Attribute.WebHome]] reported in the [[Dataset>>doc:Glossary.Data set.WebHome]], i.e., Data or Metadata [[Attribute>>doc:Glossary.Attribute.WebHome]].

398

|(% style="width:200px" %)//DataAttributeValue//|(% style="width:285px" %)(((

Abstract class

Inherits from

//AttributeValue//

Sub classes

//UncodedAttributeValue

404

CodedAttributeValue//

405

)))|(% style="width:454px" %)The value of a Data [[Attribute>>doc:Glossary.Attribute.WebHome]], such as the instance of a Coded [[Attribute>>doc:Glossary.Attribute.WebHome]] or of an Uncoded [[Attribute>>doc:Glossary.Attribute.WebHome]] in a structure such as a [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]].

406

|(% style="width:200px" %) |(% style="width:285px" %)+valueFor|(% style="width:454px" %)(((

407

Association to the Data [[Attribute>>doc:Glossary.Attribute.WebHome]] defined in the [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]]. Note that this is conceptual association as the (% style="color:#e74c3c" %)Concept(%%) is identified explicitly in the [[data set>>doc:Glossary.Data set.WebHome]].

408

The source multiplicity (1..*) indicates the possibility to provide more than one values for a Data [[Attribute>>doc:Glossary.Attribute.WebHome]], if the latter allows it.

409

)))

410

|(% style="width:200px" %)//MetadataAttributeValue//|(% style="width:285px" %)(((

411

(explained further in section “Metadata Set”)

412

)))|(% style="width:454px" %)The value of a Metadata [[Attribute>>doc:Glossary.Attribute.WebHome]], as specified in the [[Metadata Structure Definition>>doc:Glossary.Metadata structure definition.WebHome]], which is linked in the [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]]

413

|(% style="width:200px" %)//UncodedAttributeValue//|(% style="width:285px" %)(((

Inherits from

//AttributeValue//

Sub classes

OtherUncodedAttributeValue

418

TextAttributeValue

419

)))|(% style="width:454px" %)

420

|(% style="width:200px" %)OtherUncodedAttributeValue|(% style="width:285px" %)(((

421

Inherits from

422

//UncodedObservationValue//

423

)))|(% style="width:454px" %)An [[attribute>>doc:Glossary.Attribute.WebHome]] value that has a text value

424

|(% style="width:200px" %) |(% style="width:285px" %)value|(% style="width:454px" %)The value of the Uncoded [[attribute>>doc:Glossary.Attribute.WebHome]].

425

|(% style="width:200px" %) |(% style="width:285px" %)startTime|(% style="width:454px" %)This [[attribute>>doc:Glossary.Attribute.WebHome]] is only used if the textFormat of the [[attribute>>doc:Glossary.Attribute.WebHome]] is of the Timespan type in the [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]] (in which case the value field takes a duration).

426

|(% style="width:200px" %)TextAttributeValue|(% style="width:285px" %)(((

427

Inherits from

428

//UncodedAttributeValue//

429

)))|(% style="width:454px" %)An [[attribute>>doc:Glossary.Attribute.WebHome]] that has a localised text value

430

|(% style="width:200px" %) |(% style="width:285px" %)text|(% style="width:454px" %)The localised text values.

431

|(% style="width:200px" %)CodedAttributeValue|(% style="width:285px" %)(((

432

Inherits from

433

//AttributeValue//

434

)))|(% style="width:454px" %)An [[attribute>>doc:Glossary.Attribute.WebHome]] that takes it value from a [[Code>>doc:Glossary.Code.WebHome]] in [[Code list>>doc:Glossary.Code list.WebHome]].

435

|(% style="width:200px" %) |(% style="width:285px" %)+valueOf|(% style="width:454px" %)Association to the [[Code>>doc:Glossary.Code.WebHome]] that is the value of the [[Attribute>>doc:Glossary.Attribute.WebHome]] Value. Note that this is a conceptual association showing that the [[Code>>doc:Glossary.Code.WebHome]] must exist in the [[Code list>>doc:Glossary.Code list.WebHome]] associated with the Data [[Attribute>>doc:Glossary.Attribute.WebHome]] in the [[Data Structure Definition>>doc:Glossary.Data structure definition.WebHome]]. In the actual [[Data Set>>doc:Glossary.Data set.WebHome]] the value of the [[Code>>doc:Glossary.Code.WebHome]] is placed in the [[Attribute>>doc:Glossary.Attribute.WebHome]] Value.

----

Wiki source code of 5 Data Structure Definition and Dataset