Changes for page 3 SDMX Base Package

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

From version 6.6
edited by Helena
on 2025/05/20 00:25
Change comment: There is no comment for this version
To version 6.2
edited by Helena
on 2025/05/20 00:22
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -26,8 +26,10 @@
26 26  
27 27  This group of classes forms the nucleus of the administration facets of SDMX 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// may have Annotations (or notes): this supports the need to add notes to all SDMX-ML elements. The Annotation is used to convey extra information to describe any SDMX construct. This information may be in the form of a URL reference and/or a multilingual text (represented by the association to InternationalString).
29 +All classes derived from the abstract class //AnnotableArtefact// may have Annotations (or notes): this supports the need to add notes to all SDMX-ML elements. The Annotation is used to convey extra information to describe any SDMX construct. This information may be in the form of a URL reference and/or a multilingual text (represented by the association to
30 30  
31 +InternationalString).
32 +
31 31  The //IdentifiableArtefact// is an abstract class that comprises the basic attributes needed for identification. Concrete classes based on //IdentifiableArtefact// all inherit the ability to be uniquely identified.
32 32  
33 33  The //NamableArtefact// is an abstract class that inherits from //IdentifiableArtefact //and in addition the +description and +name roles support multilingual descriptions and names for all objects based on //NameableArtefact//. The InternationalString supports the representation of a description in multiple locales (locale is similar to language but includes geographic variations such as Canadian French, US English etc.). The //LocalisedString// supports the representation of a description in one locale.
... ... @@ -38,62 +38,70 @@
38 38  
39 39  The inheritance chain from //AnnotableArtefact// through to //MaintainableArtefact// allows SDMX classes to inherit the features they need, from simple annotation, through identity, naming, to versioning and maintenance.
40 40  
41 -==== 3.2.2.2 Definitions ====
43 +**3.2.2.2 Definitions**
42 42  
43 -(% style="width:902.294px" %)
44 -|**Class**|(% style="width:246px" %)**Feature**|(% style="width:480px" %)**Description**
45 -|//AnnotableArtefact//|(% style="width:246px" %)(((
45 +|**Class**|**Feature**|**Description**
46 +|//AnnotableArtefact//|(((
46 46  Base inheritance sub classes are:
48 +
47 47  //IdentifiableArtefact//
48 -)))|(% style="width:480px" %)Objects of classes derived from this can have attached annotations.
49 -|Annotation|(% style="width:246px" %) |(% style="width:480px" %)Additional descriptive information attached to an object.
50 -| |(% style="width:246px" %)id|(% style="width:480px" %)(((
50 +)))|Objects of classes derived from this can have attached annotations.
51 +|Annotation| |Additional descriptive information attached to an object.
52 +| |id|(((
51 51  Identifier for the Annotation.
54 +
52 52  It can be used to disambiguate one Annotation from another where there are several Annotations for the same annotated object.
53 53  )))
54 -| |(% style="width:246px" %)title|(% style="width:480px" %)A title used to identify an annotation.
55 -| |(% style="width:246px" %)type|(% style="width:480px" %)Specifies how the annotation is to be processed.
56 -| |(% style="width:246px" %)url|(% style="width:480px" %)A link to external descriptive text.
57 -| |(% style="width:246px" %)+text|(% style="width:480px" %)An International String provides the multilingual text content of the annotation via this role.
58 -|//IdentifiableArtefact//|(% style="width:246px" %)(((
57 +| |title//    //|A title used to identify an annotation.
58 +| |type|Specifies how the annotation is to be processed.
59 +| |url|A link to external descriptive text.
60 +| |+text|An International String provides the multilingual text content of the annotation via this role.
61 +|//IdentifiableArtefact//|(((
59 59  Superclass is
63 +
60 60  //AnnotableArtefact//
61 -Base inheritance sub classes are:
65 +
66 +Base inheritance sub classes are~://    //
67 +
62 62  //NameableArtefact//
63 -)))|(% style="width:480px" %)Provides identity to all derived classes. It also provides annotations to derived classes because it is a subclass of Annotable Artefact.
64 -| |(% style="width:246px" %)id|(% style="width:480px" %)The unique identifier of the object.
65 -| |(% style="width:246px" %)uri|(% style="width:480px" %)Universal resource identifier that may or may not be resolvable.
66 -| |(% style="width:246px" %)urn|(% style="width:480px" %)Universal resource name – this is for use in registries: all registered objects have a urn.
67 -|//NameableArtefact//|(% style="width:246px" %)(((
69 +)))|Provides identity to all derived classes. It also provides annotations to derived classes because it is a subclass of Annotable Artefact.
70 +| |id|The unique identifier of the object.
71 +| |uri|Universal resource identifier that may or may not be resolvable.
72 +| |urn|Universal resource name – this is for use in registries: all registered objects have a urn.
73 +|//NameableArtefact//|(((
68 68  Superclass is
75 +
69 69  //IdentifiableArtefact// Base inheritance sub classes are:
77 +
70 70  //VersionableArtefact//
71 -)))|(% style="width:480px" %)Provides a Name and Description to all derived classes in addition to identification and annotations.
72 -| |(% style="width:246px" %)+description|(% style="width:480px" %)A multi-lingual description is provided by this role via the International String class.
73 -| |(% style="width:246px" %)+name|(% style="width:480px" %)A multi-lingual name is provided by this role via the International String class
74 -|InternationalString|(% style="width:246px" %) |(% style="width:480px" %)The International String is a collection of Localised Strings and supports the representation of text in multiple locales.
75 -|LocalisedString|(% style="width:246px" %) |(% style="width:480px" %)The Localised String supports the representation of text in one locale (locale is similar to language but includes geographic variations such as Canadian French, US English etc.).
76 -| |(% style="width:246px" %)label|(% style="width:480px" %)Label of the string.
77 -| |(% style="width:246px" %)locale|(% style="width:480px" %)The geographic locale of the string e.g French, Canadian French.
78 -|//VersionableArtefact//|(% style="width:246px" %)(((
79 +)))|Provides a Name and Description to all derived classes in addition to identification and annotations.
80 +| |+description|A multi-lingual description is provided by this role via the International String class.
81 +| |+name|A multi-lingual name is provided by this role via the International String class
82 +|InternationalString| |The International String is a collection of Localised Strings and supports the representation of text in multiple locales.
83 +|LocalisedString| |The Localised String supports the representation of text in one locale (locale is similar to language but includes geographic variations such as Canadian French, US English etc.).
84 +| |label|Label of the string.
85 +| |locale|The geographic locale of the string e.g French, Canadian French.
86 +|//VersionableArtefact//|(((
79 79  Superclass is
88 +
80 80  //NameableArtefact// Base inheritance sub classes are:
90 +
81 81  //MaintainableArtefact//
82 -)))|(% style="width:480px" %)Provides versioning information for all derived objects.
83 -| |(% style="width:246px" %)version|(% style="width:480px" %)A version string following an agreed convention
84 -| |(% style="width:246px" %)validFrom|(% style="width:480px" %)Date from which the version is valid
85 -| |(% style="width:246px" %)validTo|(% style="width:480px" %)Date from which version is superceded
86 -|//MaintainableArtefact//|(% style="width:246px" %)(((
92 +)))|Provides versioning information for all derived objects.
93 +| |version|A version string following an agreed convention
94 +| |validFrom|Date from which the version is valid
95 +| |validTo|Date from which version is superceded
96 +|//MaintainableArtefact//|(((
87 87  Inherits from
88 88  
89 89  //VersionableArtefact//
90 -)))|(% style="width:480px" %)An abstract class to group together primary structural metadata artefacts that are maintained by an Agency.
91 -| |(% style="width:246px" %)final|(% style="width:480px" %)Defines whether a maintained artefact is draft or final.
92 -| |(% style="width:246px" %)isExternalReference|(% style="width:480px" %)If set to “true” it indicates that the content of the object is held externally.
93 -| |(% style="width:246px" %)structureURL|(% style="width:480px" %)The URL of an SDMX-ML document containing the external object.
94 -| |(% style="width:246px" %)serviceURL|(% style="width:480px" %)The URL of an SDMX-compliant web service from which the external object can be retrieved.
95 -| |(% style="width:246px" %)+maintainer|(% style="width:480px" %)Association to the Maintenance Agency responsible for maintaining the artefact.
96 -|Agency|(% style="width:246px" %) |(% style="width:480px" %)See section on “Organisations”
100 +)))|An abstract class to group together primary structural metadata artefacts that are maintained by an Agency.
101 +| |final|Defines whether a maintained artefact is draft or final.
102 +| |isExternalReference|If set to “true” it indicates that the content of the object is held externally.
103 +| |structureURL|The URL of an SDMX-ML document containing the external object.
104 +| |serviceURL|The URL of an SDMX-compliant web service from which the external object can be retrieved.
105 +| |+maintainer//    //|Association to the Maintenance Agency responsible for maintaining the artefact.
106 +|Agency| |See section on “Organisations”
97 97  
98 98  == {{id name="_Toc370972"/}}3.3 Basic Inheritance ==
99 99  
... ... @@ -159,8 +159,7 @@
159 159  
160 160  [[image:SDMX_2-1_SECTION_2_InformationModel_2020-07_a2879920.jpg||height="602" width="614"]]
161 161  
162 -(% class="wikigeneratedid" id="HFigure12TheItemSchemePattern" %)
163 -**Figure 12 The Item Scheme Pattern**
172 +====== Figure 12 The Item Scheme Pattern ======
164 164  
165 165  ===== {{id name="_Toc370981"/}}3.5.3 Explanation of the Diagram =====
166 166  
... ... @@ -186,47 +186,73 @@
186 186  
187 187  ==== 3.5.3.2 Definitions ====
188 188  
189 -(% style="width:911.294px" %)
190 -|**Class**|(% style="width:246px" %)**Feature**|(% style="width:478px" %)**Description**
191 -|//ItemScheme//|(% style="width:246px" %)(((
198 +|**Class**|**Feature**|**Description**
199 +|//ItemScheme//|(((
192 192  Inherits from:
201 +
193 193  //MaintainableArtefact//
203 +
194 194  Direct sub classes are:
205 +
195 195  CategoryScheme
207 +
196 196  ConceptScheme
209 +
197 197  Codelist
198 -)))|(% style="width:478px" %)The descriptive information for an arrangement or division of objects into groups based on characteristics, which the objects have in common.
199 -| |(% style="width:246px" %)(((
211 +)))|The descriptive information for an arrangement or division of objects into groups based on characteristics, which the objects have in common.
212 +| |(((
200 200  ReportingTaxonomy
214 +
201 201  //OrganisationScheme//
216 +
202 202  Transformation Scheme
218 +
203 203  CustomTypeScheme
220 +
204 204  NamePersonasationScheme
222 +
205 205  RuletScheme
224 +
206 206  VtlMappingScheme
226 +
207 207  UserDefinedOperatorScheme
208 -)))|(% style="width:478px" %)
209 -| |(% style="width:246px" %)isPartial|(% style="width:478px" %)Denotes whether the Item Scheme contains a sub set of the full set of Items in the maintained scheme.
210 -| |(% style="width:246px" %)items|(% style="width:478px" %)Association to the Items in the scheme.
211 -|//Item//|(% style="width:246px" %)(((
228 +)))|
229 +| |isPartial|Denotes whether the Item Scheme contains a sub set of the full set of Items in the maintained scheme.
230 +| |items|Association to the Items in the scheme.
231 +|//Item//|(((
212 212  Inherits from:
233 +
213 213  //NameableArtefact//
214 -Direct sub classes are Category
235 +
236 +Direct sub classes are
237 +
238 +Category
239 +
215 215  Concept
241 +
216 216  Code
243 +
217 217  ReportingCategory
245 +
218 218  //Organisation//
247 +
219 219  Transformation
249 +
220 220  CustomType
251 +
221 221  NamePersonlisation
253 +
222 222  Ruleset
255 +
223 223  VtlMapping
224 -UserDefinedOperator
225 -)))|(% style="width:478px" %)(((
257 +
258 +UserDefinedOperator//    //
259 +)))|(((
226 226  The Item is an item of content in an Item Scheme. This may be a node in a taxonomy or ontology, a code in a code list etc.
261 +
227 227  Note that at the conceptual level the Organisation is not hierarchic
228 228  )))
229 -| |(% style="width:246px" %)hierarchy|(% style="width:478px" %)This allows an Item optionally to have one or more child Items.
264 +| |hierarchy|This allows an Item optionally to have one or more child Items.
230 230  
231 231  == {{id name="_Toc370982"/}}3.6 The Structure Pattern ==
232 232  
... ... @@ -242,8 +242,7 @@
242 242  
243 243  [[image:SDMX_2-1_SECTION_2_InformationModel_2020-07_b6478a73.png||height="774" width="556"]]
244 244  
245 -(% class="wikigeneratedid" id="HFigure14:RepresentationwithintheStructurePattern" %)
246 -**Figure 14: Representation within the Structure Pattern**
280 +====== Figure 14: Representation within the Structure Pattern ======
247 247  
248 248  === {{id name="_Toc370985"/}}3.6.3 Explanation of the Diagrams ===
249 249  
... ... @@ -267,7 +267,7 @@
267 267  
268 268  __ReportStructure__: MetadataAttribute
269 269  
270 -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.
304 +Each Component takes its semantic (and possibly also its representation) from a Concept in 773 a ConceptScheme. This is represented by the conceptIdentity association to Concept.
271 271  
272 272  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.
273 273