Changes for page 3 SDMX Base Package

Last modified by Helena K. on 2026/06/08 16:18

From version 40.9
edited by Helena K.
on 2026/06/08 16:16
Change comment: There is no comment for this version
To version 40.5
edited by Helena K.
on 2026/06/08 16:10
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -214,7 +214,7 @@
214 214  
215 215  === 3.6.1 Context ===
216 216  
217 -The Structure Pattern is a basic architectural pattern which allows the specification of complex tabular structures which are often found in statistical data (such as [[Data (% id="confict-imterms-88" %)Structure(%%) Definition>>doc:Glossary 2\.1.Data structure definition.WebHome]], and [[Metadata (% id="confict-imterms-89" %)Structure(%%) Definition>>doc:Glossary 2\.1.Metadata structure definition.WebHome]]). A Structure is a set of ordered lists. A pattern to underpin this tabular structure has been developed, so that commonalities between these structure definitions can be supported by common software and common syntax structures.
217 +The Structure Pattern is a basic architectural pattern which allows the specification of complex tabular structures which are often found in statistical data (such as Data (% id="confict-imterms-88" %)Structure(%%) Definition, and Metadata (% id="confict-imterms-89" %)Structure(%%) Definition). A Structure is a set of ordered lists. A pattern to underpin this tabular structure has been developed, so that commonalities between these structure definitions can be supported by common software and common syntax structures.
218 218  
219 219  === 3.6.2 Class Diagrams ===
220 220  
... ... @@ -232,31 +232,31 @@
232 232  
233 233  The //Structure// is an abstract class which contains a set of one or more //ComponentList//(s) (this class is also abstract). An example of a concrete //Structure// is DataStructureDefinition.
234 234  
235 -The //ComponentList// is a list of one or more //[[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]]//(s//)//. The //ComponentList// has several concrete descriptor classes based on it: DimensionDescriptor, GroupDimensionDescriptor, MeasureDescriptor, and AttributeDescriptor of the DataStructureDefinition and MetadataAttributeDescriptor of the MetadataStructureDefinition.
235 +The //ComponentList// is a list of one or more //Component//(s//)//. The //ComponentList// has several concrete descriptor classes based on it: DimensionDescriptor, GroupDimensionDescriptor, MeasureDescriptor, and AttributeDescriptor of the DataStructureDefinition and MetadataAttributeDescriptor of the MetadataStructureDefinition.
236 236  
237 -The //[[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]]// is contained in a //ComponentList//. The type of //[[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]]// in a //ComponentList// is dependent on the concrete class of the ComponentList as follows:
237 +The //Component// is contained in a //ComponentList//. The type of //Component// in a //ComponentList// is dependent on the concrete class of the ComponentList as follows:
238 238  
239 -DimensionDescriptor: [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]], TimeDimension
240 -GroupDimensionDescriptor: [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]], TimeDimension
241 -MeasureDescriptor: [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]]
239 +DimensionDescriptor: Dimension, TimeDimension
240 +GroupDimensionDescriptor: Dimension, TimeDimension
241 +MeasureDescriptor: Measure
242 242  AttributeDescriptor: DataAttribute, MetadataAttributeRef
243 243  MetadataAttributeDescriptor: MetadataAttribute
244 244  
245 -Each //[[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]]// takes its semantic (and possibly also its [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]]) from a [[Concept>>doc:sdmx:Glossary 2\.1.Concept.WebHome]] in a ConceptScheme. This is represented by the conceptIdentity association to [[Concept>>doc:sdmx:Glossary 2\.1.Concept.WebHome]].
245 +Each //Component// takes its semantic (and possibly also its representation) from a Concept in a ConceptScheme. This is represented by the conceptIdentity association to Concept.
246 246  
247 -The //[[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]]// may also have a localRepresentation. This allows a concrete class, such as [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]], to specify its [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] which is local to the //Structure// in which it is contained (for [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] this will be DataStructureDefinition), and thus overrides any coreRepresentation specified for the [[Concept>>doc:sdmx:Glossary 2\.1.Concept.WebHome]].
247 +The //Component// may also have a localRepresentation. This allows a concrete class, such as Dimension, to specify its representation which is local to the //Structure// in which it is contained (for Dimension this will be DataStructureDefinition), and thus overrides any coreRepresentation specified for the Concept.
248 248  
249 -The [[Representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] can be enumerated or non-enumerated. The valid content of an enumerated [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] is specified either in an //ItemScheme// which can be one of [[Codelist>>doc:sdmx:Glossary 2\.1.Code list.WebHome]], ValueList or //GeoCodelist//. The valid content of a non-enumerated [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] is specified as one or more Facet(s) (for example, these may specify minimum and maximum values). For any [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] this is achieved by one of more
249 +The Representation can be enumerated or non-enumerated. The valid content of an enumerated representation is specified either in an //ItemScheme// which can be one of Codelist, ValueList or //GeoCodelist//. The valid content of a non-enumerated representation is specified as one or more Facet(s) (for example, these may specify minimum and maximum values). For any Attribute this is achieved by one of more
250 250  
251 -ExtendedFacet(s), which allow the additional [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] of XHTML.
251 +ExtendedFacet(s), which allow the additional representation of XHTML.
252 252  
253 -The types of [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] that are valid for specific [[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]] is expressed in the model as a [[constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] on the association:
253 +The types of representation that are valid for specific components is expressed in the model as a constraint on the association:
254 254  
255 -* The [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]], DataAttribute, [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]], MetadataAttribute may be enumerated and, if so, use an //EnumeratedList//.
256 -* The [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] and [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] may be non-enumerated and, if so, use one or more Facet(s), note that the FacetValueType applicable to the TimeDimension is restricted to those that represent time.
255 +* The Dimension, DataAttribute, Measure, MetadataAttribute may be enumerated and, if so, use an //EnumeratedList//.
256 +* The Dimension and Measure may be non-enumerated and, if so, use one or more Facet(s), note that the FacetValueType applicable to the TimeDimension is restricted to those that represent time.
257 257  * The MetadataAttribute and DataAttribute may be non-enumerated and, if so, use one or more ExtendedFacet(s).
258 258  
259 -The //Structure// may be used by one or more //StructureUsage//(s). An example of this, in terms of concrete classes, is that a [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] (sub class of //StructureUsage//) may use a particular DataStructureDefinition (sub class of //Structure//), and similar constructs apply for the [[Metadataflow>>doc:sdmx:Glossary 2\.1.Metadataflow.WebHome]] (link to MetadataStructureDefinition).
259 +The //Structure// may be used by one or more //StructureUsage//(s). An example of this, in terms of concrete classes, is that a Dataflow (sub class of //StructureUsage//) may use a particular DataStructureDefinition (sub class of //Structure//), and similar constructs apply for the Metadataflow (link to MetadataStructureDefinition).
260 260  
261 261  ==== 3.6.3.2 Definitions ====
262 262  
... ... @@ -266,17 +266,17 @@
266 266  Inherits from:
267 267  //MaintainableArtefact//
268 268  Sub classes are:
269 -[[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]
270 -[[Metadataflow>>doc:sdmx:Glossary 2\.1.Metadataflow.WebHome]]
271 -)))|(% style="width:897px" %)An [[artefact>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] whose [[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]] are described by a Structure. In concrete terms (sub-classes) an example would be a [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] which is linked to a given structure – in this case the [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]].
272 -| |structure|(% style="width:897px" %)An association to a Structure specifying the structure of the [[artefact>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]].
269 +Dataflow
270 +Metadataflow
271 +)))|(% style="width:897px" %)An artefact whose components are described by a Structure. In concrete terms (sub-classes) an example would be a Dataflow which is linked to a given structure – in this case the Data Structure Definition.
272 +| |structure|(% style="width:897px" %)An association to a Structure specifying the structure of the artefact.
273 273  |Structure|(((
274 274  Inherits from:
275 275  //MaintainableArtefact//
276 276  Sub classes are:
277 277  DataStructureDefinition MetadataStructureDefinition
278 -)))|(% style="width:897px" %)Abstract specification of a list of lists to define a complex tabular structure. A concrete example of this would be statistical [[concepts>>doc:sdmx:Glossary 2\.1.Concept.WebHome]], [[code lists>>doc:sdmx:Glossary 2\.1.Code list.WebHome]], and their organisation in a data or [[metadata structure definition>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]], defined by a centre institution, usually for the exchange of statistical information with its partners.
279 -| |grouping|(% style="width:897px" %)A composite association to one or more [[component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] lists.
278 +)))|(% style="width:897px" %)Abstract specification of a list of lists to define a complex tabular structure. A concrete example of this would be statistical concepts, code lists, and their organisation in a data or metadata structure definition, defined by a centre institution, usually for the exchange of statistical information with its partners.
279 +| |grouping|(% style="width:897px" %)A composite association to one or more component lists.
280 280  |//ComponentList//|(((
281 281  Inherits from:
282 282  //IdentifiableArtefact//
... ... @@ -285,30 +285,30 @@
285 285  GroupDimensionDescriptor
286 286  MeasureDescriptor
287 287  AttributeDescriptor MetadataAttributeDescriptor
288 -)))|(% style="width:897px" %)An abstract definition of a list of [[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]]. A concrete example is a [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] Descriptor, which defines the list of [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] in a [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]].
289 -| |[[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]]|(% style="width:897px" %)An aggregate association to one or more [[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]] which make up the list.
290 -|//[[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]]//|(((
288 +)))|(% style="width:897px" %)An abstract definition of a list of components. A concrete example is a Dimension Descriptor, which defines the list of Dimensions in a Data Structure Definition.
289 +| |components|(% style="width:897px" %)An aggregate association to one or more components which make up the list.
290 +|//Component//|(((
291 291  Inherits from:
292 292  //IdentifiableArtefact//
293 293  Sub classes are:
294 -[[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]]
294 +Measure
295 295  //AttributeComponent
296 296  DimensionComponent//
297 -)))|(% style="width:897px" %)A [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] is an abstract super class used to define qualitative and quantitative data and metadata items that belong to a [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] List and hence a Structure. [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] is refined through its sub-classes.
298 -| |conceptIdentity|(% style="width:897px" %)Association to a [[Concept>>doc:sdmx:Glossary 2\.1.Concept.WebHome]] in a [[Concept Scheme>>doc:sdmx:Glossary 2\.1.Concept scheme.WebHome]] that identifies and defines the semantic of the [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]].
297 +)))|(% style="width:897px" %)A Component is an abstract super class used to define qualitative and quantitative data and metadata items that belong to a Component List and hence a Structure. Component is refined through its sub-classes.
298 +| |conceptIdentity|(% style="width:897px" %)Association to a Concept in a Concept Scheme that identifies and defines the semantic of the Component.
299 299  | |localRepresentation|(% style="width:897px" %)(((
300 -Association to the [[Representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] of the [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] if this is different from the coreRepresentation of the [[Concept>>doc:sdmx:Glossary 2\.1.Concept.WebHome]], which the [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] uses (ConceptUsage).
300 +Association to the Representation of the Component if this is different from the coreRepresentation of the Concept, which the Component uses (ConceptUsage).
301 301  )))
302 -|[[Representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]]| |(% style="width:897px" %)The allowable value or format for [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] or (% style="color:#e74c3c" %)Concept
303 -| |+enumerated|(% style="width:897px" %)Association to an enumerated list that contains the allowable content for the [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] when reported in a data or [[metadata set>>doc:sdmx:Glossary 2\.1.Metadata set.WebHome]]. The type of enumerated list that is allowed for any concrete [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] is shown in the (% style="color:#e74c3c" %)constraints(%%) on the association.
304 -| |+nonEnumerated|(% style="width:897px" %)Association to a set of [[Facets>>doc:sdmx:Glossary 2\.1.Facet.WebHome]] that define the allowable format for the content of the [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] when reported in a data or [[metadata set>>doc:sdmx:Glossary 2\.1.Metadata set.WebHome]].
305 -|[[Facet>>doc:sdmx:Glossary 2\.1.Facet.WebHome]]| |(% style="width:897px" %)Defines the format for the content of the [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] when reported in a data or [[metadata set>>doc:sdmx:Glossary 2\.1.Metadata set.WebHome]].
306 -| |facetType|(% style="width:897px" %)A specific content type, which is constrained by the [[Facet>>doc:sdmx:Glossary 2\.1.Facet.WebHome]] Type enumeration.
307 -| |facetValueType|(% style="width:897px" %)The format of the value of a [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] when reported in a data or [[metadata set>>doc:sdmx:Glossary 2\.1.Metadata set.WebHome]]. This is constrained by the [[Facet>>doc:sdmx:Glossary 2\.1.Facet.WebHome]] Value Type enumeration.
308 -| |+itemSchemeFacet|(% style="width:897px" %)Defines the format of the identifiers in an [[Item Scheme>>doc:sdmx:Glossary 2\.1.Item scheme.WebHome]] used by a [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]]. Typically, this would define the number of characters (length) of the identifier.
309 -|ExtendedFacet| |(% style="width:897px" %)This has the same function as [[Facet>>doc:sdmx:Glossary 2\.1.Facet.WebHome]] but allows additionally an XHTML [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]]. This is constrained for use with a Metadata [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] and a Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]].
302 +|Representation| |(% style="width:897px" %)The allowable value or format for Component or Concept
303 +| |+enumerated|(% style="width:897px" %)Association to an enumerated list that contains the allowable content for the Component when reported in a data or metadata set. The type of enumerated list that is allowed for any concrete Component is shown in the constraints on the association.
304 +| |+nonEnumerated|(% style="width:897px" %)Association to a set of Facets that define the allowable format for the content of the Component when reported in a data or metadata set.
305 +|Facet| |(% style="width:897px" %)Defines the format for the content of the Component when reported in a data or metadata set.
306 +| |facetType|(% style="width:897px" %)A specific content type, which is constrained by the Facet Type enumeration.
307 +| |facetValueType|(% style="width:897px" %)The format of the value of a Component when reported in a data or metadata set. This is constrained by the Facet Value Type enumeration.
308 +| |+itemSchemeFacet|(% style="width:897px" %)Defines the format of the identifiers in an Item Scheme used by a Component. Typically, this would define the number of characters (length) of the identifier.
309 +|ExtendedFacet| |(% style="width:897px" %)This has the same function as Facet but allows additionally an XHTML representation. This is constrained for use with a Metadata Attribute and a Data Attribute.
310 310  
311 -The specification of the content and use of the sub classes to //ComponentList// and //[[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]]// can be found in the section in which they are used (DataStructureDefinition and MetadataStructureDefinition). Moreover, the FacetType SentinelValues is explained in the datastructure [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] diagram (see 5.3.2.2), since it only concerns DataStructureDefinitions.
311 +The specification of the content and use of the sub classes to //ComponentList// and //Component// can be found in the section in which they are used (DataStructureDefinition and MetadataStructureDefinition). Moreover, the FacetType SentinelValues is explained in the datastructure representation diagram (see 5.3.2.2), since it only concerns DataStructureDefinitions.
312 312  
313 313  ==== 3.6.3.3 Representation Constructs ====
314 314  
© Semantic R&D Group, 2026