Changes for page 3 SDMX Base Package

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

From version 37.1
edited by Artur K.
on 2026/06/05 15:55
Change comment: There is no comment for this version
To version 29.8
edited by Helena K.
on 2026/06/04 18:05
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -xwiki:XWiki.arturkryazhev
1 +xwiki:XWiki.helena
Tags
... ... @@ -1,0 +1,1 @@
1 +Annotation|Artefact|Attribute|Code|Code list|Component|Concept|Concept scheme|Constraint|Data structure definition|Dataflow|Decimals|Dimension|Facet|Incremental update|International string|Item scheme|Maintenance agency|Measure|Metadata set|Metadata structure definition|Metadataflow|Representation|SDMX Information Model|SDMX-ML|Statistical data and metadata exchange|Structural metadata|Title|Version
Content
... ... @@ -4,7 +4,7 @@
4 4  
5 5  == 3.1 Introduction ==
6 6  
7 -The constructs in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Base package comprise the fundamental building blocks that support many of the other structures in the model. For this reason, many of the classes in this package are abstract (i.e., only derived sub-classes can exist in an implementation).
7 +The constructs in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Base package comprise the fundamental building blocks that support many of the other structures in the model. For this reason, many of the classes in this package are abstract (i.e., only derived sub-classes can exist in an implementation).
8 8  
9 9  The motivation for establishing the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Base package is as follows:
10 10  
... ... @@ -26,7 +26,7 @@
26 26  
27 27  This group of classes forms the nucleus of the administration facets of [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] objects. They provide features which are reusable by derived classes to support horizontal functionality such as identity, versioning etc.
28 28  
29 -All classes derived from the abstract class //[[AnnotableArtefact>>doc:IMElements.AnnotableArtefact.WebHome]]// may have Annotations (or notes): this supports the need to add notes to all [[SDMX-ML>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]] elements. The Annotation is used to convey extra information to describe any [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] construct. This information may be in the form of a URL reference and/or a multilingual [[text>>doc:IMElements.text.WebHome]] (represented by the association to [[InternationalString>>doc:IMElements.InternationalString.WebHome]]).
29 +All classes derived from the abstract class //[[AnnotableArtefact>>doc:IMElements.AnnotableArtefact.WebHome]]// may have Annotations (or notes): this supports the need to add notes to all [[SDMX-ML>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]] elements. The [[Annotation>>doc:IMElements.Annotation.WebHome]] is used to convey extra information to describe any [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] construct. This information may be in the form of a URL reference and/or a multilingual [[text>>doc:IMElements.text.WebHome]] (represented by the association to [[InternationalString>>doc:IMElements.InternationalString.WebHome]]).
30 30  
31 31  The //[[IdentifiableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.WebHome]]// is an abstract class that comprises the basic [[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] needed for identification. Concrete classes based on //[[IdentifiableArtefact>>doc:IMElements.AnnotableArtefact.IdentifiableArtefact.WebHome]]// all inherit the ability to be uniquely identified.
32 32  
... ... @@ -312,7 +312,7 @@
312 312  
313 313  ==== 3.6.3.3 Representation Constructs ====
314 314  
315 -The majority of [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] FacetValueTypes are compatible with those found in XML Schema, and have equivalents in most current implementation platforms:
315 +The majority of [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] FacetValueTypes are compatible with those found in XML Schema, and have equivalents in most current implementation platforms:
316 316  
317 317  |(% style="width:198px" %)(((
318 318  **SDMX Facet Value Type**
... ... @@ -324,7 +324,7 @@
324 324  |(% style="width:198px" %)Integer|(% style="width:204px" %)xsd:int|(% style="width:209px" %)integer|(% style="width:187px" %)System.Int32|(% style="width:817px" %)int
325 325  |(% style="width:198px" %)Long|(% style="width:204px" %)xsd.long|(% style="width:209px" %)integer|(% style="width:187px" %)System.Int64|(% style="width:817px" %)long
326 326  |(% style="width:198px" %)Short|(% style="width:204px" %)xsd:short|(% style="width:209px" %)integer|(% style="width:187px" %)System.Int16|(% style="width:817px" %)short
327 -|(% style="width:198px" %)[[Decimal>>doc:sdmx:Glossary 2\.1.Decimals.WebHome]]|(% style="width:204px" %)xsd:decimal|(% style="width:209px" %)number|(% style="width:187px" %)System.Decimal|(% style="width:817px" %)java.math.BigDecimal
327 +|(% style="width:198px" %)[[Decimal>>doc:Glossary.Decimals.WebHome]]|(% style="width:204px" %)xsd:decimal|(% style="width:209px" %)number|(% style="width:187px" %)System.Decimal|(% style="width:817px" %)java.math.BigDecimal
328 328  |(% style="width:198px" %)Float|(% style="width:204px" %)xsd:float|(% style="width:209px" %)number|(% style="width:187px" %)System.Single|(% style="width:817px" %)float
329 329  |(% style="width:198px" %)Double|(% style="width:204px" %)xsd:double|(% style="width:209px" %)number|(% style="width:187px" %)System.Double|(% style="width:817px" %)double
330 330  |(% style="width:198px" %)Boolean|(% style="width:204px" %)xsd:boolean|(% style="width:209px" %)boolean|(% style="width:187px" %)System.Boolean|(% style="width:817px" %)boolean
... ... @@ -337,25 +337,25 @@
337 337  |(% style="width:198px" %)Day, MonthDay, Month|(% style="width:204px" %)xsd:g*|(% style="width:209px" %)string|(% style="width:187px" %)System.DateTime|(% style="width:817px" %)javax.xml.datatype.XML GregorianCalendar
338 338  |(% style="width:198px" %)Duration|(% style="width:204px" %)xsd:duration|(% style="width:209px" %)string|(% style="width:187px" %)System.TimeSpan|(% style="width:817px" %)javax.xml.datatype.Dur ation
339 339  
340 -There are also a number of [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] data types which do not have these direct correspondences, often because they are composite representations or restrictions of a broader data [[type>>doc:IMElements.type.WebHome]]. These are detailed in Section 6 of the standards.
340 +There are also a number of [[SDMX>>doc:Glossary.Statistical data and metadata exchange.WebHome]] data types which do not have these direct correspondences, often because they are composite representations or restrictions of a broader data [[type>>doc:IMElements.type.WebHome]]. These are detailed in Section 6 of the standards.
341 341  
342 -The [[Representation>>doc:IMElements.Representation.WebHome]] is composed of Facets, each of which conveys characteristic information related to the definition of a [[value>>doc:IMElements.value.WebHome]] domain. Often a set of Facets are needed to convey the required semantic. For example, a [[sequence>>doc:IMElements.sequence.WebHome]] is defined by a minimum of two Facets: one to define the start [[value>>doc:IMElements.value.WebHome]], and one to define the interval.
342 +The [[Representation>>doc:IMElements.Representation.WebHome]] is composed of Facets, each of which conveys characteristic information related to the definition of a value domain. Often a set of Facets are needed to convey the required semantic. For example, a [[sequence>>doc:IMElements.sequence.WebHome]] is defined by a minimum of two Facets: one to define the start value, and one to define the interval.
343 343  
344 344  (% style="width:981.835px" %)
345 345  |(% style="width:107px" %)**Facet Type**|(% style="width:872px" %)**Explanation**
346 -|(% style="width:107px" %)isSequence|(% style="width:872px" %)The isSequence facet indicates whether the values are intended to be ordered, and it may work in combination with the interval, startValue,and endValue facet or the timeInterval, [[startTime>>doc:IMElements.startTime.WebHome]], and endTime, facets. If this [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] holds a [[value>>doc:IMElements.value.WebHome]] of true, a start [[value>>doc:IMElements.value.WebHome]] or time and a numeric or time interval must be supplied. If an end [[value>>doc:IMElements.value.WebHome]] is not given, then the [[sequence>>doc:IMElements.sequence.WebHome]] continues indefinitely.
347 -|(% style="width:107px" %)interval|(% style="width:872px" %)The interval [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] specifies the permitted interval (increment) in a [[sequence>>doc:IMElements.sequence.WebHome]]. In order for this to be used, the isSequence [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] must have a [[value>>doc:IMElements.value.WebHome]] of true.
348 -|(% style="width:107px" %)startValue|(% style="width:872px" %)The startValue facet is used in conjunction with the isSequence and interval facets (which must be set in order to use this facet). This facet isused for a numeric [[sequence>>doc:IMElements.sequence.WebHome]] and indicates the starting point of the [[sequence>>doc:IMElements.sequence.WebHome]]. This [[value>>doc:IMElements.value.WebHome]] is mandatory for a numeric [[sequence>>doc:IMElements.sequence.WebHome]] to be expressed.
346 +|(% style="width:107px" %)isSequence|(% style="width:872px" %)The isSequence facet indicates whether the values are intended to be ordered, and it may work in combination with the interval, startValue,and endValue facet or the timeInterval, startTime, and endTime, facets. If this [[attribute>>doc:Glossary.Attribute.WebHome]] holds a value of true, a start value or time and a numeric or time interval must be supplied. If an end value is not given, then the [[sequence>>doc:IMElements.sequence.WebHome]] continues indefinitely.
347 +|(% style="width:107px" %)interval|(% style="width:872px" %)The interval [[attribute>>doc:Glossary.Attribute.WebHome]] specifies the permitted interval (increment) in a [[sequence>>doc:IMElements.sequence.WebHome]]. In order for this to be used, the isSequence [[attribute>>doc:Glossary.Attribute.WebHome]] must have a value of true.
348 +|(% style="width:107px" %)startValue|(% style="width:872px" %)The startValue facet is used in conjunction with the isSequence and interval facets (which must be set in order to use this facet). This facet isused for a numeric [[sequence>>doc:IMElements.sequence.WebHome]] and indicates the starting point of the [[sequence>>doc:IMElements.sequence.WebHome]]. This value is mandatory for a numeric [[sequence>>doc:IMElements.sequence.WebHome]] to be expressed.
349 349  |(% style="width:107px" %)endValue|(% style="width:872px" %)The endValue facet is used in conjunction with the isSequence and interval facets (which must be set in order to use this facet). This facet is used for a numeric [[sequence>>doc:IMElements.sequence.WebHome]] and indicates that ending point (if any) of the [[sequence>>doc:IMElements.sequence.WebHome]].
350 -|(% style="width:107px" %)timeInterval|(% style="width:872px" %)The timeInterval facet indicates the permitted duration in a time [[sequence>>doc:IMElements.sequence.WebHome]]. In order for this to be used, the isSequence facet must have a [[value>>doc:IMElements.value.WebHome]] of true.
351 -|(% style="width:107px" %)[[startTime>>doc:IMElements.startTime.WebHome]]|(% style="width:872px" %)The [[startTime>>doc:IMElements.startTime.WebHome]] facet is used in conjunction with the isSequence and timeInterval facets (which must be set in order to use this facet). Thisnattribute is used for a time [[sequence>>doc:IMElements.sequence.WebHome]] and indicates the start time of thensequence. This [[value>>doc:IMElements.value.WebHome]] is mandatory for a time [[sequence>>doc:IMElements.sequence.WebHome]] to be expressed.
350 +|(% style="width:107px" %)timeInterval|(% style="width:872px" %)The timeInterval facet indicates the permitted duration in a time [[sequence>>doc:IMElements.sequence.WebHome]]. In order for this to be used, the isSequence facet must have a value of true.
351 +|(% style="width:107px" %)startTime|(% style="width:872px" %)The startTime facet is used in conjunction with the isSequence and timeInterval facets (which must be set in order to use this facet). Thisnattribute is used for a time [[sequence>>doc:IMElements.sequence.WebHome]] and indicates the start time of thensequence. This value is mandatory for a time [[sequence>>doc:IMElements.sequence.WebHome]] to be expressed.
352 352  |(% style="width:107px" %)endTime|(% style="width:872px" %)The endTime facet is used in conjunction with the isSequence and timeInterval facets (which must be set in order to use this facet). This facet is used for a time [[sequence>>doc:IMElements.sequence.WebHome]] and indicates that ending point (if any) ofnthe [[sequence>>doc:IMElements.sequence.WebHome]].
353 -|(% style="width:107px" %)minLength|(% style="width:872px" %)The minLength facet specifies the minimum and length of the [[value>>doc:IMElements.value.WebHome]] in characters.
354 -|(% style="width:107px" %)maxLength|(% style="width:872px" %)The maxLength facet specifies the maximum length of the [[value>>doc:IMElements.value.WebHome]] in characters.
355 -|(% style="width:107px" %)minValue|(% style="width:872px" %)The minValue facet is used for inclusive and exclusive ranges, indicating what the lower bound of the range is. If this is used with an inclusive range, a valid [[value>>doc:IMElements.value.WebHome]] will be greater than or equal to the [[value>>doc:IMElements.value.WebHome]] specified here. If the inclusive and exclusive data [[type>>doc:IMElements.type.WebHome]] is not specified (e.g., this facet is used with an integer data [[type>>doc:IMElements.type.WebHome]]), the [[value>>doc:IMElements.value.WebHome]] is assumed to be inclusive.
356 -|(% style="width:107px" %)maxValue|(% style="width:872px" %)The maxValue facet is used for inclusive and exclusive ranges, indicating what the upper bound of the range is. If this is used with an inclusive range, a valid [[value>>doc:IMElements.value.WebHome]] will be less than or equal to the [[value>>doc:IMElements.value.WebHome]] specified here. If the inclusive and exclusive data [[type>>doc:IMElements.type.WebHome]] is not specified (e.g., this facet is used with an integer data [[type>>doc:IMElements.type.WebHome]]), the [[value>>doc:IMElements.value.WebHome]] is assumed to be inclusive.
357 -|(% style="width:107px" %)[[Decimals>>doc:sdmx:Glossary 2\.1.Decimals.WebHome]]|(% style="width:872px" %)The [[decimals>>doc:sdmx:Glossary 2\.1.Decimals.WebHome]] facet indicates the number of characters allowed after the [[decimal>>doc:sdmx:Glossary 2\.1.Decimals.WebHome]] separator.
358 -|(% style="width:107px" %)pattern|(% style="width:872px" %)The pattern [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] holds any regular expression permitted in the implementation syntax (e.g., W3C XML Schema).
353 +|(% style="width:107px" %)minLength|(% style="width:872px" %)The minLength facet specifies the minimum and length of the value in characters.
354 +|(% style="width:107px" %)maxLength|(% style="width:872px" %)The maxLength facet specifies the maximum length of the value in characters.
355 +|(% style="width:107px" %)minValue|(% style="width:872px" %)The minValue facet is used for inclusive and exclusive ranges, indicating what the lower bound of the range is. If this is used with an inclusive range, a valid value will be greater than or equal to the value specified here. If the inclusive and exclusive data [[type>>doc:IMElements.type.WebHome]] is not specified (e.g., this facet is used with an integer data [[type>>doc:IMElements.type.WebHome]]), the value is assumed to be inclusive.
356 +|(% style="width:107px" %)maxValue|(% style="width:872px" %)The maxValue facet is used for inclusive and exclusive ranges, indicating what the upper bound of the range is. If this is used with an inclusive range, a valid value will be less than or equal to the value specified here. If the inclusive and exclusive data [[type>>doc:IMElements.type.WebHome]] is not specified (e.g., this facet is used with an integer data [[type>>doc:IMElements.type.WebHome]]), the value is assumed to be inclusive.
357 +|(% style="width:107px" %)[[Decimals>>doc:Glossary.Decimals.WebHome]]|(% style="width:872px" %)The [[decimals>>doc:Glossary.Decimals.WebHome]] facet indicates the number of characters allowed after the [[decimal>>doc:Glossary.Decimals.WebHome]] separator.
358 +|(% style="width:107px" %)pattern|(% style="width:872px" %)The pattern [[attribute>>doc:Glossary.Attribute.WebHome]] holds any regular expression permitted in the implementation syntax (e.g., W3C XML Schema).
359 359  
360 360  ----
361 361  
© Semantic R&D Group, 2026