Skip to Content
Last modified by Artur on 2025/09/10 11:19
From version 2.1
edited by Helena
on 2025/05/19 23:53
Change comment: Created by office importer.
To version 5.2
edited by Helena
on 2025/05/22 11:22
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,0 +1,1 @@
1 +7 Metadata Structure Definition and Metadata Set
Parent
... ... @@ -1,0 +1,1 @@
1 +Methodology.SDMX 2\.1 Standards\. Section 2\. Information model\: UML conceptual design.WebHome
Content
... ... @@ -1,4 +1,6 @@
1 -= {{id name="_Toc371023"/}}7 Metadata Structure Definition and Metadata Set =
1 +{{box title="**Contents**"}}
2 +{{toc/}}
3 +{{/box}}
2 2  
3 3  == {{id name="_Toc371024"/}}7.1 Context ==
4 4  
... ... @@ -37,8 +37,8 @@
37 37  
38 38  The concrete classes in this part of the SDMX metamodel which require to be maintained by Maintenance Agencies all inherit from MaintainableArtefact. These are:
39 39  
40 -* //StructureUsage// (concrete class is MetadataflowDefinition)//  //
41 -* //Structure// (concrete class is MetadataStructureDefinition)//  //
42 +* //StructureUsage// (concrete class is MetadataflowDefinition)
43 +* //Structure// (concrete class is MetadataStructureDefinition)
42 42  
43 43  These classes also inherit the identity and versioning facets of //IdentifiableArtefact, NameableArtefact,// and //VersionableArtefact//.
44 44  
... ... @@ -70,6 +70,8 @@
70 70  
71 71  === {{id name="_Toc371032"/}}7.3.3 Class Diagram – Relationship ===
72 72  
75 +[[image:1747902064472-244.png]]
76 +
73 73  **Figure 28: Relationship class diagram of the Metadata Structure Definition**
74 74  
75 75  === {{id name="_Toc371033"/}}7.3.4 Explanation of the Diagram ===
... ... @@ -93,10 +93,8 @@
93 93  
94 94  The valid content of a //TargetObject// when reported in a MetadataSet is defined in the Representation. This can be an enumerated representation (i.e. a reference to one of the sub clases of ItemScheme – these are Codelist, ConceptScheme, //OrganisationScheme,// CategoryScheme, or ReportingTaxonomy) or nonenumerated.
95 95  
96 -Thus a single MetadataStructureDefinition can be defined for a discrete set of related object types. For example, a single definition can be constructed to define the metadata that can be attached to any part of a Data Structure Definition, or that can be attached to any artefact concerned with the reporting of quality metadata (such as data provider and (data) category). The MetadataTarget specifies the identification properties of a specific object type to which metadata can be attached in a MetadataSet. For example, in a DataStructureDefinition the MetadataTarget might be a Dimension, and therefore the //TargetObject//s are those that uniquely identify a Dimension. This will include both the
100 +Thus a single MetadataStructureDefinition can be defined for a discrete set of related object types. For example, a single definition can be constructed to define the metadata that can be attached to any part of a Data Structure Definition, or that can be attached to any artefact concerned with the reporting of quality metadata (such as data provider and (data) category). The MetadataTarget specifies the identification properties of a specific object type to which metadata can be attached in a MetadataSet. For example, in a DataStructureDefinition the MetadataTarget might be a Dimension, and therefore the //TargetObject//s are those that uniquely identify a Dimension. This will include both the DataStructureDefinition and he Dimension both of these are an //IdentifiableArtefact //and will use the// //IdentitifableObjectTarget) as both //TargetObject//s are required in order to identify uniquely a Dimension).
97 97  
98 -DataStructureDefinition and he Dimension both of these are an //IdentifiableArtefact //and will use the// //IdentitifableObjectTarget) as both //TargetObject//s are required in order to identify uniquely a Dimension).
99 -
100 100  The ReportStructure comprises a set of MetadataAttributes - these can be defined as a hierarchy. Each MetadataAttribute// //identifies a Concept that is reported or disseminated in a MetadataSet (/conceptIdentity) that uses this MetadataStructureDefinition. Different MetadataAttributes in the same ReportStructure can use Concepts from different ConceptSchemes. Note that a MetadataAttribute does not link to a Concept that defines its role in this MetadataStructureDefinition (i.e. the MetadataAttribute does not play a role).
101 101  
102 102  The MetadataAttribute can be specified as having multiple occurrences and/or specified as being mandatory (minOccurs=1 or more) or conditional (minOccurs=0). A hierarchical ReportStructure can be defined by specifying a hierarchy for a MetadataAttribute.
... ... @@ -113,84 +113,69 @@
113 113  
114 114  ==== 7.3.4.2 Definitions ====
115 115  
116 -|**Class**|**Feature**|**Description**
117 -|StructureUsage||See “SDMX Base”.
118 +(% style="width:1144.29px" %)
119 +|**Class**|**Feature**|(% style="width:704px" %)**Description**
120 +|StructureUsage| |(% style="width:704px" %)See “SDMX Base”.
118 118  |Metadataflow Definition|(((
119 119  Inherits from:
120 -
121 121  //StructureUsage//
122 -)))|Abstract concept (i.e. the structure without any metadata) of a flow of metadata that providers will provide for different reference periods.
123 -||/structure|Associates a Metadata Structure Definition.
124 -|MetadataStructure Definition||A collection of metadata concepts, their structure and usage when used to collect or disseminate reference metadata.
125 -||/grouping|An association to a Metadata Target or Report Structure.
124 +)))|(% style="width:704px" %)Abstract concept (i.e. the structure without any metadata) of a flow of metadata that providers will provide for different reference periods.
125 +| |/structure|(% style="width:704px" %)Associates a Metadata Structure Definition.
126 +|MetadataStructure Definition| |(% style="width:704px" %)A collection of metadata concepts, their structure and usage when used to collect or disseminate reference metadata.
127 +| |/grouping|(% style="width:704px" %)An association to a Metadata Target or Report Structure.
126 126  |MetadataTarget|(((
127 127  Inherits from
128 -
129 129  //ComponentList//
130 -)))|A set of components that define a key of an object type to which metadata may be attached.
131 -||/components|Associates the Target Object components that define the key of the Metadata Target.
131 +)))|(% style="width:704px" %)A set of components that define a key of an object type to which metadata may be attached.
132 +| |/components|(% style="width:704px" %)Associates the Target Object components that define the key of the Metadata Target.
132 132  |//TargetObject//|(((
133 133  Abstract Class
134 -
135 135  Sub Classes
136 -
137 137  DimensionDescriptorValues
138 -
139 139  Target
140 -
141 141  IdentifiableObjectTarget
142 -
143 143  DataSetTarget
144 -
145 145  ReportPeriodTarget
146 -)))|
147 -||/localRepresentation|Associates a Representation to the Target Object that must be respected when the object is identified in a Metadata Set. This may be enumerated or nonenumerated.
141 +)))|(% style="width:704px" %)
142 +| |/localRepresentation|(% style="width:704px" %)Associates a Representation to the Target Object that must be respected when the object is identified in a Metadata Set. This may be enumerated or nonenumerated.
148 148  |DimensionDescriptor ValuesTarget|(((
149 149  Inherits from
150 150  
151 151  //TargetObject//
152 -)))|The target object is the key of a data series.
147 +)))|(% style="width:704px" %)The target object is the key of a data series.
153 153  |IdentifiableObject Target|(((
154 154  Inherits from
155 -
156 156  //TargetObject//
157 -)))|The target object is a specified object type.
158 -||objectType|Identifies the object type.
151 +)))|(% style="width:704px" %)The target object is a specified object type.
152 +| |objectType|(% style="width:704px" %)Identifies the object type.
159 159  |DataSetTarget|(((
160 160  Inherits from
161 -
162 162  //TargetObject//
163 -)))|The target object is a Data Set.
156 +)))|(% style="width:704px" %)The target object is a Data Set.
164 164  |ReportPeriodTarget|(((
165 165  Inherits from
166 -
167 167  //TargetObject//
168 -)))|The target is a report period. Note that this does not describe the use of an object, but rather serves as a unique metadata key for metadata reports. Metadata reports attached to a particular object may vary over time, and this time identifier component can be used to disambiguate the reports, much like the time dimension disambiguates observations in a data series.
160 +)))|(% style="width:704px" %)The target is a report period. Note that this does not describe the use of an object, but rather serves as a unique metadata key for metadata reports. Metadata reports attached to a particular object may vary over time, and this time identifier component can be used to disambiguate the reports, much like the time dimension disambiguates observations in a data series.
169 169  |ConstraintTarget|(((
170 170  Inherits from
171 -
172 172  //TargetObject//
173 -)))|The target object is the data or reference metadata that is identified in the content of an Attachment Constraint.
164 +)))|(% style="width:704px" %)The target object is the data or reference metadata that is identified in the content of an Attachment Constraint.
174 174  |ReportStructure|(((
175 175  Inherits from:
176 -
177 177  //ComponentList//
178 -)))|Defines a set of concepts that comprises the Metadata Attributes to be reported.
179 -||/components|An association to the Metadata Attributes relevant to the Report Structure.
180 -||+reportFor|Associates the Metadata Targets for which this Report Structure is used.
181 -|MetadataAttribute||Identifies a Concept for which a value may be reported in a Metadata Set.
182 -||/hierarchy|Association to one or more child Metadata Attribute.
183 -||/conceptIdentity|An association to the concept which defines the semantic of the attribute.
184 -||isPresentational|Indication that the Metadata Attribute is present for structural purposes (i.e. it has child attributes) and that no value for this attribute is expected to be reported in a Metadata Set using this Report Structure.
185 -||minOccurs maxOccurs|Specifies how many occurrences of the Metadata Attribute may be reported at this point in the Metadata Report.
186 -|ConceptUsage||The use of a Concept as Metadata Attribute.
187 -||concept|Association to a Concept in a ConceptScheme.
188 -||/localRepresentation|Associates a Representation that overrides any core representation specified for the Concept itself.
189 -|Representation||The representation of the Metadata Attribute.
168 +)))|(% style="width:704px" %)Defines a set of concepts that comprises the Metadata Attributes to be reported.
169 +| |/components|(% style="width:704px" %)An association to the Metadata Attributes relevant to the Report Structure.
170 +| |+reportFor|(% style="width:704px" %)Associates the Metadata Targets for which this Report Structure is used.
171 +|MetadataAttribute| |(% style="width:704px" %)Identifies a Concept for which a value may be reported in a Metadata Set.
172 +| |/hierarchy|(% style="width:704px" %)Association to one or more child Metadata Attribute.
173 +| |/conceptIdentity|(% style="width:704px" %)An association to the concept which defines the semantic of the attribute.
174 +| |isPresentational|(% style="width:704px" %)Indication that the Metadata Attribute is present for structural purposes (i.e. it has child attributes) and that no value for this attribute is expected to be reported in a Metadata Set using this Report Structure.
175 +| |minOccurs maxOccurs|(% style="width:704px" %)Specifies how many occurrences of the Metadata Attribute may be reported at this point in the Metadata Report.
176 +|ConceptUsage| |(% style="width:704px" %)The use of a Concept as Metadata Attribute.
177 +| |concept|(% style="width:704px" %)Association to a Concept in a ConceptScheme.
178 +| |/localRepresentation|(% style="width:704px" %)Associates a Representation that overrides any core representation specified for the Concept itself.
179 +|Representation| |(% style="width:704px" %)The representation of the Metadata Attribute.
190 190  
191 -
192 -
193 -
194 194  == {{id name="_Toc371034"/}}7.4 Metadata Set ==
195 195  
196 196  === {{id name="_Toc371035"/}}7.4.1 Class Diagram ===
... ... @@ -237,31 +237,31 @@
237 237  ==== 7.4.2.2 Definitions ====
238 238  
239 239  |**Class**|**Feature**|**Description**
240 -|MetadataSet||Any organised collection of metadata.
241 -||reportingBegin|A specific time period in a known system of time periods that identifies the start period of a report.
242 -||reportingEnd|A specific time period in a known system of time periods that identifies the ebd period of a report.
243 -||dataExtractionDate|A specific time period that identifies the date and time that the data are extracted from a data source.
244 -||validFrom|Indicates the inclusive start time indicating the validity of the information in the data set.
245 -||validTo|Indicates the inclusive end time indicating the validity of the information in the metadata set.
246 -||publicationYear|Specifies the year of publication of the data or metadata in terms of whatever provisioning agreements might be in force.
247 -||publicationPeriod|Specifies the period of publication of the data or metadata in terms of whatever provisioning agreements might be in force.
248 -||setId|Provides an identification of the metadata set.
249 -||action|Defines the action to be taken by the recipient system (update, replace, delete)
250 -||+describedBy|Associates a Metadataflow Definition to the Metadata Set.
251 -||+structuredBy|Associates the Metadata Structure Definition that defines the structure of the Metadata Set. Note that the Metadata Structure Definition is the same as that associated (nonmandatory) to the Metadataflow Definition.
252 -||+publishedBy|Associates the Data Provider that reports/publishes the metadata.
253 -||+describedBy|Reference to the Report Structure.
254 -|MetadataReport||A set of values for Metadata Attributes defined in a Report Structure of a Metadata Structure Definition.
255 -||+attachesTo|Associates the object key to which metadata is to be attached.
256 -||+target|Associates the Metadata Target that defines the target object to which the metadata are to be associated.
257 -||+metadata|Associates the Reported Attribute values which are to be associated with the object or objects identified by the Target Object Key.
258 -|TargetObjectKey||Identifies the key of the object to which the metadata are to be attached.
259 -||+valueFor|(((
227 +|MetadataSet| |Any organised collection of metadata.
228 +| |reportingBegin|A specific time period in a known system of time periods that identifies the start period of a report.
229 +| |reportingEnd|A specific time period in a known system of time periods that identifies the ebd period of a report.
230 +| |dataExtractionDate|A specific time period that identifies the date and time that the data are extracted from a data source.
231 +| |validFrom|Indicates the inclusive start time indicating the validity of the information in the data set.
232 +| |validTo|Indicates the inclusive end time indicating the validity of the information in the metadata set.
233 +| |publicationYear|Specifies the year of publication of the data or metadata in terms of whatever provisioning agreements might be in force.
234 +| |publicationPeriod|Specifies the period of publication of the data or metadata in terms of whatever provisioning agreements might be in force.
235 +| |setId|Provides an identification of the metadata set.
236 +| |action|Defines the action to be taken by the recipient system (update, replace, delete)
237 +| |+describedBy|Associates a Metadataflow Definition to the Metadata Set.
238 +| |+structuredBy|Associates the Metadata Structure Definition that defines the structure of the Metadata Set. Note that the Metadata Structure Definition is the same as that associated (nonmandatory) to the Metadataflow Definition.
239 +| |+publishedBy|Associates the Data Provider that reports/publishes the metadata.
240 +| |+describedBy|Reference to the Report Structure.
241 +|MetadataReport| |A set of values for Metadata Attributes defined in a Report Structure of a Metadata Structure Definition.
242 +| |+attachesTo|Associates the object key to which metadata is to be attached.
243 +| |+target|Associates the Metadata Target that defines the target object to which the metadata are to be associated.
244 +| |+metadata|Associates the Reported Attribute values which are to be associated with the object or objects identified by the Target Object Key.
245 +|TargetObjectKey| |Identifies the key of the object to which the metadata are to be attached.
246 +| |+valueFor|(((
260 260  Associates the Metadata Target that identifies the object type and the component structure of the Target Object Key.
261 261  
262 262  Note that this is a conceptual association showing the link to the MSD construct.
263 263  )))
264 -||+keyValues|Associates the Target Object Values of the Target Object Key.
251 +| |+keyValues|Associates the Target Object Values of the Target Object Key.
265 265  |//TargetObjectValue//|(((
266 266  Abstract class
267 267  
... ... @@ -273,7 +273,7 @@
273 273  
274 274  TargetReportPeriod
275 275  )))|The key of an individual object of the type specified in the Metadata Target of the Metadata Structure Definition.
276 -||+valueFor|(((
263 +| |+valueFor|(((
277 277  Associates the Target Object for which this value is provided.
278 278  
279 279  Note that this is a conceptual association showing the link to the MSD construct.
... ... @@ -283,17 +283,17 @@
283 283  
284 284  //TargetObjectValue//
285 285  )))|The identification of the components and the values that form the data or metadata key.
286 -|ComponentValue||Collectively contain the identification of the components and the values that form the data key.
287 -|value||The key value.
288 -||+valueFor|Associates the Component for which the value is declared.
289 -|TimeDimensionValue||Contains identification of the Time Dimension and the value.
273 +|ComponentValue| |Collectively contain the identification of the components and the values that form the data key.
274 +|value| |The key value.
275 +| |+valueFor|Associates the Component for which the value is declared.
276 +|TimeDimensionValue| |Contains identification of the Time Dimension and the value.
290 290  |TargetIdentifiable Object|(((
291 291  Inherits from
292 292  
293 293  //TargetObjectValue    //
294 294  )))|Specifies the identification of an Identifiable object.
295 -|StructureRef||Contains the identification of an Identifiable object.
296 -||structureType|The object type of the target object.
282 +|StructureRef| |Contains the identification of an Identifiable object.
283 +| |structureType|The object type of the target object.
297 297  |(((
298 298  Maintainable
299 299  
... ... @@ -302,8 +302,8 @@
302 302  Identifiable
303 303  
304 304  ArtefactRef
305 -)))||Identification of the target object by means of its identifier constructs i.e agency ID, id, version for Maintainable Object plus, for Identifiable Object, the id.
306 -||+containedObject|Association to a contained object in a hierarchy of Identifiable Objects such as a Transition in a Process Step.
292 +)))| |Identification of the target object by means of its identifier constructs i.e agency ID, id, version for Maintainable Object plus, for Identifiable Object, the id.
293 +| |+containedObject|Association to a contained object in a hierarchy of Identifiable Objects such as a Transition in a Process Step.
307 307  |TargetDataSet|(((
308 308  Inherits from
309 309  
... ... @@ -319,14 +319,14 @@
319 319  
320 320  //NonEnumeratedAttributeValue//
321 321  
322 -EnumeratedAttributeValue//    //
309 +EnumeratedAttributeValue//    //
323 323  )))|The value for a Metadata Attribute.
324 -||+valueFor|(((
311 +| |+valueFor|(((
325 325  Association to the Metadata Attribute in the Metadata Structure Definition that identifies the Concept and allowed Representation for the Reported Attribute.
326 326  
327 327  Note that this is a conceptual association showing the link to the MSD construct. The syntax for the Reported Attribute will state, in some form, the id of the Metadata Attribute.
328 328  )))
329 -||+child|Association to a child Reported Attribute consistent with the hierarchy defined in the Report Structure for the Metadata Attribute for which this child is a Reported Attribute.
316 +| |+child|Association to a child Reported Attribute consistent with the hierarchy defined in the Report Structure for the Metadata Attribute for which this child is a Reported Attribute.
330 330  |//NonEnumerated AttributeValue//|(((
331 331  Inherits from
332 332  
... ... @@ -342,19 +342,19 @@
342 342  
343 343  //AttributeValue//
344 344  )))|The content of a Reported Attribute where this is textual.
345 -|XHTMLAttributeValue||This contains XHTML.
346 -||value|The string value of the XHTML.
347 -|TextAttributeValue||This value of a Reported Attribute where the content is humanreadable text.
348 -||text|The string value is text. This can be present in multiple language versions.
349 -|OtherNonEnumerated AttributeValue||The value of a Reported Attribute where the content is not of humanreadable text.
350 -||value|A text string that is consistent in format to that defined in the Representation of the Metadata Attribute for which this is a Reported Attribute.
332 +|XHTMLAttributeValue| |This contains XHTML.
333 +| |value|The string value of the XHTML.
334 +|TextAttributeValue| |This value of a Reported Attribute where the content is humanreadable text.
335 +| |text|The string value is text. This can be present in multiple language versions.
336 +|OtherNonEnumerated AttributeValue| |The value of a Reported Attribute where the content is not of humanreadable text.
337 +| |value|A text string that is consistent in format to that defined in the Representation of the Metadata Attribute for which this is a Reported Attribute.
351 351  |EnumeratedAttribute Value|(((
352 352  Inherits from
353 353  
354 354  //MetadataAttributeValue//
355 355  )))|The content of a Reported Attribute that is taken from a Code in a Code list.
356 -||value|The Code value of the Reported Attribute.
357 -||+value|(((
343 +| |value|The Code value of the Reported Attribute.
344 +| |+value|(((
358 358  Association to a Code in the Code list specified in the Representation of the Metadata Attribute for which this Reported Attribute is the value
359 359  
360 360  Note that this shows the conceptual link to the Item that is the value. In reality, the value itself will be contained in the Enumerated Attribute Value.
... ... @@ -362,4 +362,4 @@
362 362  
363 363  
364 364  
365 -
352 +
1747902064472-244.png
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.helena
Size
... ... @@ -1,0 +1,1 @@
1 +56.8 KB
Content
SUZ.Methodology.Code.MethodologyClass[0]
index
... ... @@ -1,0 +1,1 @@
1 +8