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

From version 5.1
edited by Helena
on 2025/06/24 15:00
Change comment: There is no comment for this version
To version 4.7
edited by Helena
on 2025/06/24 14:59
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -74,7 +74,6 @@
74 74  **GroupType: **GroupType defines a structure which is used to communicate attribute values for a group defined in a data structure definition. The group can consist of either a subset of the dimensions defined by the data structure definition, or an association to an attachment constraint, which in turn defines key sets to which attributes can be attached. In the case that the group is based on an attachment constraint, only the identification of group is provided. It is expected that a system which is processing this will relate that identifier to the key sets defined in the constraint and apply the values provided for the attributes appropriately.
75 75  
76 76  Derivation:
77 -
78 78  * //com:AnnotableType// (extension) 
79 79  ** GroupType
80 80  
... ... @@ -107,7 +107,6 @@
107 107  com:Annotations?, SeriesKey, Attributes?, Obs*
108 108  
109 109  Element Documentation:
110 -
111 111  |**Name**|**Type**|**Documentation**
112 112  |com:Annotations|com:AnnotationsType|Annotations is a reusable element the provides for a collection of annotations. It has been made global so that restrictions of types that extend AnnotatableType my reference it.
113 113  |SeriesKey|ValuesType|SeriesKey contains the values for each all dimensions defined in the data structure definition, except for that which is declared to be at the observation level for this data set. This key is required, and every dimension must be provided a value.
... ... @@ -125,7 +125,6 @@
125 125  com:Annotations?, ObsKey, ObsValue?, Attributes?
126 126  
127 127  Element Documentation:
128 -
129 129  |**Name**|**Type**|**Documentation**
130 130  |com:Annotations|com:AnnotationsType|Annotations is a reusable element the provides for a collection of annotations. It has been made global so that restrictions of types that extend AnnotatableType my reference it.
131 131  |ObsKey|ValuesType|ObsKey contains the values for every dimension defined in the data structure definition. A value must be provided for each dimension. This key serves to disambiguate the un-grouped observation within the data set.
... ... @@ -143,7 +143,6 @@
143 143  com:Annotations?, ObsDimension, ObsValue?, Attributes?
144 144  
145 145  Element Documentation:
146 -
147 147  |**Name**|**Type**|**Documentation**
148 148  |com:Annotations|com:AnnotationsType|Annotations is a reusable element the provides for a collection of annotations. It has been made global so that restrictions of types that extend AnnotatableType my reference it.
149 149  |ObsDimension|BaseValueType|ObsDimension holds the key for the grouped observation, i.e. the value of the observation dimension. Note that in this element, the reference to the dimension is optional, since it can be inferred from the structure specification for the data set. This saves having to repeat the value unnecessarily. It is assumed that any application processing the data set will have the information from the structure specification available, so that if a dimension identifier is not supplied here, the proper reference can be applied.
... ... @@ -156,7 +156,6 @@
156 156  Value+
157 157  
158 158  Element Documentation:
159 -
160 160  |**Name**|**Type**|**Documentation**
161 161  |Value|ComponentValueType|Value contains a component value and a reference to the component for which a value is being provided.
162 162  
... ... @@ -169,7 +169,6 @@
169 169  {Empty}
170 170  
171 171  Attribute Documentation:
172 -
173 173  |**Name**|**Type**|**Documentation**
174 174  |id|com:NCNameIDType|The id attribute contains the identifier for the component for which a value is being provided.
175 175  |value|xs:anySimpleType|The value attribute contains the provided component value.
... ... @@ -188,7 +188,6 @@
188 188  {Empty}
189 189  
190 190  Attribute Documentation:
191 -
192 192  |**Name**|**Type**|**Documentation**
193 193  |id (fixed: OBS_VALUE)|com:NCNameIDType|The id attribute contains a fixed reference to the primary measure component of the data structure definition.
194 194  |value|xs:string|The value attribute contains the provided component value.
... ... @@ -196,7 +196,6 @@
196 196  **ComponentValueType: **ComponentValueType is a derivation of the BaseValueType which requires that the component reference be provided. This is used when the identification of the component cannot be inferred from another context.
197 197  
198 198  Derivation:
199 -
200 200  * BaseValueType (restriction) 
201 201  ** ComponentValueType
202 202  
... ... @@ -207,7 +207,6 @@
207 207  {Empty}
208 208  
209 209  Attribute Documentation:
210 -
211 211  |**Name**|**Type**|**Documentation**
212 212  |id|com:NCNameIDType|The id attribute contains the identifier for the component for which a value is being provided.
213 213  |value|xs:string|The value attribute contains the provided component value.
... ... @@ -215,7 +215,6 @@
215 215  **TimeSeriesDataSetType: **TimeSeriesDataSetType is a derivation of the base DataSetType of the generic format the restricts the data set to only allow for grouped observations where the dimension at the observation level is the time dimension of the data structure definition. This means that unlike the base data set structure, there can be no un-grouped observations. Because this derivation is achieved using restriction, data sets conforming to this type will inherently conform to the base data set structure as well. In fact, data structured here will be identical to data in the base data set when the time dimension is the observation dimension. This means that the data contained in this structure can be processed in exactly the same manner as the base structure.
216 216  
217 217  Derivation:
218 -
219 219  * //com:AnnotableType// (extension) 
220 220  ** DataSetType (restriction) 
221 221  *** TimeSeriesDataSetType
... ... @@ -227,7 +227,6 @@
227 227  com:Annotations?, DataProvider?, Attributes?, Group*, Series*
228 228  
229 229  Attribute Documentation:
230 -
231 231  |**Name**|**Type**|**Documentation**
232 232  |structureRef|xs:IDREF|The structureRef contains a reference to a structural specification in the header of a data or reference metadata message. The structural specification details which structure the data or reference metadata conforms to, as well as providing additional information such as how the data is structure (e.g. which dimension occurs at the observation level for a data set).
233 233  |setID|com:IDType|The setID provides an identification of the data or metadata set.
... ... @@ -251,7 +251,6 @@
251 251  **TimeSeriesType: **TimeSeriesType defines a structure which is used to group a collection of observations which have a key in common, organised by time. The key for a series is every dimension defined in the data structure definition, save the time dimension. In addition to observations, values can be provided for attributes which are associated with the dimensions which make up this series key (so long as the attributes do not specify a group attachment or also have an relationship with the time dimension). It is possible for the series to contain only observations or only attribute values, or both.
252 252  
253 253  Derivation:
254 -
255 255  * //com:AnnotableType// (extension) 
256 256  ** SeriesType (restriction) 
257 257  *** TimeSeriesType
... ... @@ -260,7 +260,6 @@
260 260  com:Annotations?, SeriesKey, Attributes?, Obs*
261 261  
262 262  Element Documentation:
263 -
264 264  |**Name**|**Type**|**Documentation**
265 265  |com:Annotations|com:AnnotationsType|Annotations is a reusable element the provides for a collection of annotations. It has been made global so that restrictions of types that extend AnnotatableType my reference it.
266 266  |SeriesKey|ValuesType|SeriesKey contains the values for each all dimensions defined in the data structure definition, except for that which is declared to be at the observation level for this data set. This key is required, and every dimension must be provided a value.
... ... @@ -270,7 +270,6 @@
270 270  **TimeSeriesObsType: **TimeSeriesObsType defines the structure of a time series observation. The observation must be provided a value for the time dimension. This time value should disambiguate the observation within the series in which it is defined (i.e. there should not be another observation with the same time value). The observation can contain an observed value and/or attribute values.
271 271  
272 272  Derivation:
273 -
274 274  * //com:AnnotableType// (extension) 
275 275  ** ObsType (restriction) 
276 276  *** TimeSeriesObsType
... ... @@ -279,7 +279,6 @@
279 279  com:Annotations?, ObsDimension, ObsValue?, Attributes?
280 280  
281 281  Element Documentation:
282 -
283 283  |**Name**|**Type**|**Documentation**
284 284  |com:Annotations|com:AnnotationsType|Annotations is a reusable element the provides for a collection of annotations. It has been made global so that restrictions of types that extend AnnotatableType my reference it.
285 285  |ObsDimension|TimeValueType|ObsDimension holds the key for the grouped observation, i.e. the value of the observation dimension. Note that in this element, the reference to the dimension is optional, since it can be inferred from the structure specification for the data set. This saves having to repeat the value unnecessarily. It is assumed that any application processing the data set will have the information from the structure specification available, so that if a dimension identifier is not supplied here, the proper reference can be applied.
... ... @@ -289,7 +289,6 @@
289 289  **TimeValueType: **TimeValueType is a derivation of the BaseValueType which is used to provide a value for the time dimension. Since the identifier for the time dimension is fixed, the component reference for this structure is fixed. Note that this means that it is not necessary to provide a value in an instance as the fixed value will be provided in the post validation information set.
290 290  
291 291  Derivation:
292 -
293 293  * BaseValueType (restriction) 
294 294  ** TimeValueType
295 295  
... ... @@ -300,7 +300,6 @@
300 300  {Empty}
301 301  
302 302  Attribute Documentation:
303 -
304 304  |**Name**|**Type**|**Documentation**
305 305  |id (fixed: TIME_PERIOD)|com:NCNameIDType|The id attribute contains the identifier for the component for which a value is being provided.
306 306  |value|com: ObservationalTimePer iodType|The value attribute contains the provided component value.
... ... @@ -312,7 +312,6 @@
312 312  === Summary ===
313 313  
314 314  Referenced Namespaces:
315 -
316 316  |**Namespace**|**Prefix**
317 317  | |
318 318  |http:~/~/www.sdmx.org/resources/sdmxml/schemas/v2_1/common|com
... ... @@ -327,7 +327,6 @@
327 327  **//DataSetType//: **DataSetType is the abstract type which defines the base structure for any data structure definition specific data set. A derived data set type will be created that is specific to a data structure definition and the details of the organisation of the data (i.e. which dimension is the observation dimension and whether explicit measures should be used). Data is organised into either a collection of series (grouped observations) or a collection of un-grouped observations. The derived data set type will restrict this choice to be either grouped or un-grouped observations. If this dimension is "AllDimensions" then the derived data set type must consist of a collection of un-grouped observations; otherwise the data set will contain a collection of series with the observations in the series disambiguated by the specified dimension at the observation level. This data set is capable of containing data (observed values) and/or documentation (attribute values) and can be used for incremental updates and deletions (i.e. only the relevant updates or deletes are exchanged). It is assumed that each series or un-grouped observation will be distinct in its purpose. For example, if series contains both data and documentation, it assumed that each series will have a unique key. If the series contains only data or only documentation, then it is possible that another series with the same key might exist, but with not with the same purpose (i.e. to provide data or documentation) as the first series. This base type is designed such that derived types can be processed in a generic manner; it assures that data structure definition specific data will have a consistent structure. The group, series, and observation elements are unqualified, meaning that they are not qualified with a namespace in an instance. This means that in the derived data set types, the elements will always be the same, regardless of the target namespace of the schemas which defines these derived types. This allows for consistent processing of the structure without regard to what the namespace might be for the data structure definition specific schema. The data set can contain values for attributes which do not have an attribute relationship with any data structure definition components. These attribute values will exist in XML attributes in this element based on this type (DataSet). This is specified in the content model with the declaration of anyAttributes in the "local" namespace. The derived data set type will refine this structure so that the attributes are explicit. The XML attributes will be given a name based on the attribute's identifier. These XML attributes will be unqualified (meaning they do not have a namespace associated with them). To allow for generic processing, it is required that the only unqualified XML attributes in the derived data set type (outside of the standard data set attributes) be for attributes declared in the data structure definition. If additional attributes are required, these should be qualified with a namespace so that a generic application can easily distinguish them as not being meant to represent a data structure definition attribute.
328 328  
329 329  Derivation:
330 -
331 331  * //com:AnnotableType// (extension) 
332 332  ** //DataSetType//
333 333  
... ... @@ -338,7 +338,6 @@
338 338  com:Annotations?, DataProvider?, Group*, (Series+ | Obs+)?
339 339  
340 340  Attribute Documentation:
341 -
342 342  |**Name**|**Type**|**Documentation**
343 343  |structureRef|xs:IDREF|The structureRef contains a reference to a structural specification in the header of a data or reference metadata message. The structural specification details which structure the data or reference metadata conforms to, as well as providing additional information such as how the data is structure (e.g. which dimension occurs at the observation level for a data set).
344 344  |setID|com:IDType|The setID provides an identification of the data or metadata set.
... ... @@ -364,7 +364,6 @@
364 364  **//GroupType//: **GroupType is the abstract type which defines a structure which is used to communicate attribute values for a group defined in a data structure definition. The group can consist of either a subset of the dimensions defined by the data structure definition, or an association to an attachment constraint, which in turn defines key sets to which attributes can be attached. In the case that the group is based on an attachment constraint, only the identification of group is provided. It is expected that a system which is processing this will relate that identifier to the key sets defined in the constraint and apply the values provided for the attributes appropriately. Data structure definition schemas will drive types based on this for each group defined in the data structure definition. Both the dimension values which make up the key (if applicable) and the attribute values associated with the group will be represented with XML attributes. This is specified in the content model with the declaration of anyAttributes in the "local" namespace. The derived group type will refine this structure so that the attributes are explicit. The XML attributes will be given a name based on the attribute's identifier. These XML attributes will be unqualified (meaning they do not have a namespace associated with them). The dimension XML attributes will be required while the attribute XML attributes will be optional. To allow for generic processing, it is required that the only unqualified XML attributes in the derived group type be for the group dimensions and attributes declared in the data structure definition. If additional attributes are required, these should be qualified with a namespace so that a generic application can easily distinguish them as not being meant to represent a data structure definition dimension or attribute.
365 365  
366 366  Derivation:
367 -
368 368  * //com:AnnotableType// (extension) 
369 369  ** //GroupType//
370 370  
... ... @@ -375,7 +375,6 @@
375 375  com:Annotations?
376 376  
377 377  Attribute Documentation:
378 -
379 379  |**Name**|**Type**|**Documentation**
380 380  |type|com:IDType|The type attribute reference the identifier of the group as defined in the data structure definition. This is optional, but derived group types will provide a fixed value for this so that it always available in the post validation information set. This allows the group to be processed in a generic manner.
381 381  |REPORTING_YEAR_START_DAY|xs:gMonthDay|The REPORTING_YEAR_START_DAY attribute is an explict attribute for the reporting year start day, which provides context to the time dimension when its value contains a reporting period (e.g. 2010-Q1). This attribute is used to state the month and day that the reporting year begins (e.g. ~-~-07-01 for July 1st). In the absence of an explicit value provided in this attribute, all reporting period values will be assumed to be based on a reporting year start day of January 1. This is declared in the base schema since it has a fixed identifier and representation. The derived group types may either require or prohibit this attribute, depending on whether the data structure declared the reporting year start day attribute and if so, the attribute relationship and assignment status assigned to it.
... ... @@ -388,7 +388,6 @@
388 388  **//SeriesType//: **SeriesType is the abstract type which defines a structure which is used to group a collection of observations which have a key in common. The key for a series is every dimension defined in the data structure definition, save the dimension declared to be at the observation level for this data set. In addition to observations, values can be provided for attributes which are associated with the dimensions which make up this series key (so long as the attributes do not specify a group attachment or also have an relationship with the observation dimension). It is possible for the series to contain only observations or only attribute values, or both. Data structure definition schemas will drive a type based on this that is specific to the data structure definition and the variation of the format being expressed in the schema. Both the dimension values which make up the key and the attribute values associated with the key dimensions will be represented with XML attributes. This is specified in the content model with the declaration of anyAttributes in the "local" namespace. The derived series type will refine this structure so that the attributes are explicit. The XML attributes will be given a name based on the attribute's identifier. These XML attributes will be unqualified (meaning they do not have a namespace associated with them). The dimension XML attributes will be required while the attribute XML attributes will be optional. To allow for generic processing, it is required that the only unqualified XML attributes in the derived group type be for the series dimensions and attributes declared in the data structure definition. If additional attributes are required, these should be qualified with a namespace so that a generic application can easily distinguish them as not being meant to represent a data structure definition dimension or attribute.
389 389  
390 390  Derivation:
391 -
392 392  * //com:AnnotableType// (extension) 
393 393  ** //SeriesType//
394 394  
... ... @@ -399,7 +399,6 @@
399 399  com:Annotations?, Obs*
400 400  
401 401  Attribute Documentation:
402 -
403 403  |**Name**|**Type**|**Documentation**
404 404  |TIME_PERIOD|com: ObservationalTimePer iodType|The TIME_PERIOD attribute is an explict attribute for the time dimension. This is declared in the base schema since it has a fixed identifier and representation. The derived series type will either require or prohibit this attribute, depending on whether time is the observation dimension. If the time dimension specifies a more specific representation of time the derived type will restrict the type definition to the appropriate type.
405 405  |REPORTING_YEAR_START_DAY|xs:gMonthDay|The REPORTING_YEAR_START_DAY attribute is an explict attribute for the reporting year start day, which provides context to the time dimension when its value contains a reporting period (e.g. 2010-Q1). This attribute is used to state the month and day that the reporting year begins (e.g. ~-~-07-01 for July 1st). In the absence of an explicit value provided in this attribute, all reporting period values will be assumed to be based on a reporting year start day of January 1. This is declared in the base schema since it has a fixed identifier and representation. The derived series type may either require or prohibit this attribute, depending on whether the data structure declared the reporting year start day attribute and if so, the attribute relationship and assignment status assigned to it.
... ... @@ -413,7 +413,6 @@
413 413  **//ObsType//: **ObsType is the abstract type which defines the structure of a grouped or un-grouped observation. The observation must be provided a key, which is either a value for the dimension which is declared to be at the observation level if the observation is grouped, or a full set of values for all dimensions in the data structure definition if the observation is un-grouped. This key should disambiguate the observation within the context in which it is defined (e.g. there should not be another observation with the same dimension value in a series). The observation can contain an observed value and/or attribute values. Data structure definition schemas will drive a type or types based on this that is specific to the data structure definition and the variation of the format being expressed in the schema. The dimension value(s) which make up the key and the attribute values associated with the key dimension(s) or the primary measure will be represented with XML attributes. This is specified in the content model with the declaration of anyAttributes in the "local" namespace. The derived observation type will refine this structure so that the attributes are explicit. The XML attributes will be given a name based on the attribute's identifier. These XML attributes will be unqualified (meaning they do not have a namespace associated with them). The dimension XML attribute(s) will be required while the attribute XML attributes will be optional. To allow for generic processing, it is required that the only unqualified XML attributes in the derived observation type be for the observation dimension(s) and attributes declared in the data structure definition. If additional attributes are required, these should be qualified with a namespace so that a generic application can easily distinguish them as not being meant to represent a data structure definition dimension or attribute. If the data structure definition specific schema requires that explicit measures be used (only possible when the measure dimension is specified at the observation), then there will be types derived for each measure defined by the measure dimension. In this case, the types will be specific to each measure, which is to say that the representation of the primary measure (i.e. the observed value) will be restricted to that which is specified by the specific measure.
414 414  
415 415  Derivation:
416 -
417 417  * //com:AnnotableType// (extension) 
418 418  ** //ObsType//
419 419  
... ... @@ -424,7 +424,6 @@
424 424  com:Annotations?
425 425  
426 426  Attribute Documentation:
427 -
428 428  |**Name**|**Type**|**Documentation**
429 429  |type|com:IDType|The type attribute is used when the derived format requires that explicit measure be used. In this case, the derived type based on the measure will fix this value to be the identification of the measure concept. This will not be required, but since it is fixed it will be available in the post validation information set which will allow for generic processing of the data. If explicit measures are not used, then the derived type will prohibit the use of this attribute.
430 430  |TIME_PERIOD|com: ObservationalTimePer iodType|The TIME_PERIOD attribute is an explicit attribute for the time dimension. This is declared in the base schema since it has a fixed identifier and representation. The derived series type will either require or prohibit this attribute, depending on whether time is the observation dimension. If the time dimension specifies a more specific representation of time the derived type will restrict the type definition to the appropriate type.
... ... @@ -439,7 +439,6 @@
439 439  **//TimeSeriesDataSetType//: **TimeSeriesDataSetType is the abstract type which defines the base structure for any data structure definition specific time series based data set. A derived data set type will be created that is specific to a data structure definition. Unlike the base format, only one variation of this is allowed for a data structure definition. This variation is the time dimension as the observation dimension. Data is organised into a collection of time series. Because this derivation is achieved using restriction, data sets conforming to this type will inherently conform to the base data set structure as well. In fact, data structure specific here will be identical to data in the base data set when the time dimension is the observation dimension, even for the derived data set types. This means that the data contained in this structure can be processed in exactly the same manner as the base structure. The same rules for derivation as the base data set type apply to this specialized data set.
440 440  
441 441  Derivation:
442 -
443 443  * //com:AnnotableType// (extension) 
444 444  ** //DataSetType// (restriction) 
445 445  *** //TimeSeriesDataSetType//
... ... @@ -451,7 +451,6 @@
451 451  com:Annotations?, DataProvider?, Group*, Series*
452 452  
453 453  Attribute Documentation:
454 -
455 455  |**Name**|**Type**|**Documentation**
456 456  |structureRef|xs:IDREF|The structureRef contains a reference to a structural specification in the header of a data or reference metadata message. The structural specification details which structure the data or reference metadata conforms to, as well as providing additional information such as how the data is structure (e.g. which dimension occurs at the observation level for a data set).
457 457  |setID|com:IDType|The setID provides an identification of the data or metadata set.
... ... @@ -476,7 +476,6 @@
476 476  **TimeSeriesType: **TimeSeriesType defines an abstract structure which is used to group a collection of observations which have a key in common, organised by time. The key for a series is every dimension defined in the data structure definition, save the time dimension. In addition to observations, values can be provided for attributes which are associated with the dimensions which make up this series key (so long as the attributes do not specify a group attachment or also have an relationship with the time dimension). It is possible for the series to contain only observations or only attribute values, or both. The same rules for derivation as the base series type apply to this specialized series.
477 477  
478 478  Derivation:
479 -
480 480  * //com:AnnotableType// (extension) 
481 481  ** //SeriesType// (restriction) 
482 482  *** TimeSeriesType
... ... @@ -488,7 +488,6 @@
488 488  com:Annotations?, Obs*
489 489  
490 490  Attribute Documentation:
491 -
492 492  |**Name**|**Type**|**Documentation**
493 493  |REPORTING_YEAR_START_DAY|xs:gMonthDay|The REPORTING_YEAR_START_DAY attribute is an explict attribute for the reporting year start day, which provides context to the time dimension when its value contains a reporting period (e.g. 2010-Q1). This attribute is used to state the month and day that the reporting year begins (e.g. ~-~-07-01 for July 1st). In the absence of an explicit value provided in this attribute, all reporting period values will be assumed to be based on a reporting year start day of January 1. This is declared in the base schema since it has a fixed identifier and representation. The derived series type may either require or prohibit this attribute, depending on whether the data structure declared the reporting year start day attribute and if so, the attribute relationship and assignment status assigned to it.
494 494  
... ... @@ -501,7 +501,6 @@
501 501  **//TimeSeriesObsType//: **TimeSeriesObsType defines the abstract structure of a time series observation. The observation must be provided a value for the time dimension. This time value should disambiguate the observation within the series in which it is defined (i.e. there should not be another observation with the same time value). The observation can contain an observed value and/or attribute values. The same rules for derivation as the base observation type apply to this specialized observation.
502 502  
503 503  Derivation:
504 -
505 505  * //com:AnnotableType// (extension) 
506 506  ** //ObsType// (restriction) 
507 507  *** //TimeSeriesObsType//
... ... @@ -513,7 +513,6 @@
513 513  com:Annotations?
514 514  
515 515  Attribute Documentation:
516 -
517 517  |**Name**|**Type**|**Documentation**
518 518  |TIME_PERIOD|com: ObservationalTimePer iodType|The TIME_PERIOD attribute is an explicit attribute for the time dimension. This is declared in the base schema since it has a fixed identifier and representation. Since this data is structured to be time series only, this attribute is always required. If the time dimension specifies a more specific representation of time the derived type will restrict the type definition to the appropriate type.
519 519  |REPORTING_YEAR_START_DAY|xs:gMonthDay|The REPORTING_YEAR_START_DAY attribute is an explict attribute for the reporting year start day, which provides context to the time dimension when its value contains a reporting period (e.g. 2010-Q1). This attribute is used to state the month and day that the reporting year begins (e.g. ~-~-07-01 for July 1st). In the absence of an explicit value provided in this attribute, all reporting period values will be assumed to be based on a reporting year start day of January 1. This is declared in the base schema since it has a fixed identifier and representation. The derived observation type may either require or prohibit this attribute, depending on whether the data structure declared the reporting year start day attribute and if so, the attribute relationship and assignment status assigned to it.
... ... @@ -520,7 +520,6 @@
520 520  |OBS_VALUE|xs:anySimpleType|The OBS_VALUE attribute is an explicit attribute for the primary measure, which is intended to hold the value for the observation. This is declared in the base schema since it has a fixed identifier. This attribute is un-typed, since the representation of the observed value can vary widely. Derived types will restrict this to be a type based on the representation of the primary measure. In the case that an explicit measure is used, the derived type for a given measure might further restrict the type of the primary measure to be more specific to the core representation for the measure concept. Note that it is required that in the case of multiple measures being used, that the representation of the primary measure is broad enough to handle the various representations of the measure concepts.
521 521  
522 522  Element Documentation:
523 -
524 524  |**Name**|**Type**|**Documentation**
525 525  |com:Annotations|com:AnnotationsType|Annotations is a reusable element the provides for a collection of annotations. It has been made global so that restrictions of types that extend AnnotatableType my reference it.
526 526  
... ... @@ -531,7 +531,6 @@
531 531  Derived by restriction of xs:string .
532 532  
533 533  Enumerations:
534 -
535 535  |**Value**|**Documentation**
536 536  |DataStructure|The data set conforms simply to the data structure definition as it is defined, without regard to any constraints.
537 537  |ConstrainedDataStructure|The data set conforms to the known allowable content constraints applied to the data structure definition.
... ... @@ -545,7 +545,6 @@
545 545  === Summary ===
546 546  
547 547  Referenced Namespaces:
548 -
549 549  |**Namespace**|**Prefix**
550 550  |http:~/~/www.sdmx.org/resources/sdmxml/schemas/v2_1/common|com
551 551  |http:~/~/www.w3.org/2001/XMLSchema|xs
... ... @@ -558,7 +558,6 @@
558 558  **MetadataSetType: **MetadataSetType describes the structure for a metadata set, which contains a collection of reported metadata against a set of values for a given full or partial target identifier, as described in a metadata structure definition. The metadata set may contain reported metadata for multiple report structures defined in a metadata structure definition.
559 559  
560 560  Derivation:
561 -
562 562  * //com:AnnotableType// (extension) 
563 563  ** MetadataSetType
564 564  
... ... @@ -569,7 +569,6 @@
569 569  com:Annotations?, com:Name*, DataProvider?, Report+
570 570  
571 571  Attribute Documentation:
572 -
573 573  |**Name**|**Type**|**Documentation**
574 574  |structureRef|xs:IDREF|The structureRef contains a reference to a structural specification in the header of a data or reference metadata message. The structural specification details which structure the data or reference metadata conforms to, as well as providing additional information such as how the data is structure (e.g. which dimension occurs at the observation level for a data set).
575 575  |setID|com:IDType|The setID provides an identification of the data or metadata set.
... ... @@ -592,7 +592,6 @@
592 592  **ReportType: **ReportType contains a set of report attributes and identifies a target objects] to which they apply.
593 593  
594 594  Derivation:
595 -
596 596  * //com:AnnotableType// (extension) 
597 597  ** ReportType
598 598  
... ... @@ -603,7 +603,6 @@
603 603  com:Annotations?, Target, AttributeSet
604 604  
605 605  Attribute Documentation:
606 -
607 607  |**Name**|**Type**|**Documentation**
608 608  |id|com:IDType|The id attribute holds the identifier of the report structure as defined in the metadata structure definition. This identifies the report structure which defines the structure of metadata that is being reported.
609 609  
... ... @@ -623,12 +623,10 @@
623 623  ReferenceValue+
624 624  
625 625  Attribute Documentation:
626 -
627 627  |**Name**|**Type**|**Documentation**
628 628  |id|com:IDType|The id attribute holds the identifier of the metadata target as defined in the metadata structure definition. This identifies the metadata target of the report structure that identifies the target object(s) of the reported metadata.
629 629  
630 630  Element Documentation:
631 -
632 632  |**Name**|**Type**|**Documentation**
633 633  |ReferenceValue|ReferenceValueType|ReferenceValue contains a value for a target reference object reference. When this is taken with its sibling elements, they identify the object or objects to which the reported metadata apply. The content of this will either be a reference to an identifiable object, a data key, a reference to a data set, or a report period.
634 634  
... ... @@ -641,12 +641,10 @@
641 641  (ObjectReference | DataKey | DataSetReference | ConstraintContentReference | ReportPeriod)
642 642  
643 643  Attribute Documentation:
644 -
645 645  |**Name**|**Type**|**Documentation**
646 646  |id|com:IDType|The id attribute holds the identifier of the target reference object as defined in the metadata structure definition. This identifies the target reference of the metadata target that identifes one of the target references, that when taken together, identify the target of the reported metadata.
647 647  
648 648  Element Documentation:
649 -
650 650  |**Name**|**Type**|**Documentation**
651 651  |ObjectReference|com: ObjectReferenceType|ObjectReference provides a reference to an identifiable object in the SDMX information model. An identifiable object target will utilize this option as the representation of the target reference value.
652 652  |DataKey|com:DataKeyType|ObjectReference provides a set of dimension references and values for those dimension for the purpose of reporting metadata against a set of data. A key descriptor values target will utilize this option as the representation of the target reference value.
... ... @@ -660,7 +660,6 @@
660 660  ReportedAttribute+
661 661  
662 662  Element Documentation:
663 -
664 664  |**Name**|**Type**|**Documentation**
665 665  |ReportedAttribute|ReportedAttributeTyp e|ReportedAttribute provides the details of a reported attribute, including a value and/or child reported attributes.
666 666  
... ... @@ -667,7 +667,6 @@
667 667  **ReportedAttributeType: **ReportedAttributeType defines the structure for a reported metadata attribute. A value for the attribute can be supplied as either a single value, or multi-lingual text values (either structured or unstructured). An optional set of child metadata attributes is also available if the metadata attribute definition defines nested metadata attributes.
668 668  
669 669  Derivation:
670 -
671 671  * //com:AnnotableType// (extension) 
672 672  ** ReportedAttributeType
673 673  
... ... @@ -678,13 +678,11 @@
678 678  com:Annotations?, (com:Text+ | com:StructuredText+)?, AttributeSet?
679 679  
680 680  Attribute Documentation:
681 -
682 682  |**Name**|**Type**|**Documentation**
683 683  |id|com:IDType|The id attribute identifies the metadata attribute that the value is being reported for.
684 684  |value|xs:string|The value attribute holds any simple value for the metadata attribute.
685 685  
686 686  Element Documentation:
687 -
688 688  |**Name**|**Type**|**Documentation**
689 689  |com:Annotations|com:AnnotationsType|Annotations is a reusable element the provides for a collection of annotations. It has been made global so that restrictions of types that extend AnnotatableType my reference it.
690 690  |com:Text|com:TextType|Text is used to supply parallel multi-lingual textual values for the reported metadata attribute. This will be used if the text format of the metadata attribute has a type of string and the multi-lingual value is set to true.
... ... @@ -712,7 +712,6 @@
712 712  **//MetadataSetType//: **MetadataSetType is an abstract base type the forms the basis for a metadata structure specific metadata set. It is restricted by the metadata structure definition specific schema to meet its needs.
713 713  
714 714  Derivation:
715 -
716 716  * //com:AnnotableType// (extension) 
717 717  ** //MetadataSetType//
718 718  
... ... @@ -723,7 +723,6 @@
723 723  com:Annotations?, com:Name*, DataProvider?, Report+
724 724  
725 725  Attribute Documentation:
726 -
727 727  |**Name**|**Type**|**Documentation**
728 728  |structureRef|xs:IDREF|The structureRef contains a reference to a structural specification in the header of a data or reference metadata message. The structural specification details which structure the data or reference metadata conforms to, as well as providing additional information such as how the data is structure (e.g. which dimension occurs at the observation level for a data set).
729 729  |setID|com:IDType|The setID provides an identification of the data or metadata set.
... ... @@ -736,7 +736,6 @@
736 736  |publicationPeriod|com: ObservationalTimePer iodType|The publicationPeriod specifies the period of publication of the data or metadata in terms of whatever provisioning agreements might be in force (i.e., "Q1 2005" if that is the time of publication for a data set published on a quarterly basis).
737 737  
738 738  Element Documentation:
739 -
740 740  |**Name**|**Type**|**Documentation**
741 741  |com:Annotations|com:AnnotationsType|Annotations is a reusable element the provides for a collection of annotations. It has been made global so that restrictions of types that extend AnnotatableType my reference it.
742 742  |com:Name|com:TextType|Name is a reusable element, used for providing a human-readable name for an object.
... ... @@ -746,7 +746,6 @@
746 746  **//ReportType//: **ReportType is an abstract base type the forms the basis for a metadata structure definition specific report, based on the defined report structures. This type is restricted in the metadata structure definition specific schema so that the Target and AttributeSet conform to the prescribed report structure.
747 747  
748 748  Derivation:
749 -
750 750  * //com:AnnotableType// (extension) 
751 751  ** //ReportType//
752 752  
... ... @@ -757,12 +757,10 @@
757 757  com:Annotations?, Target, AttributeSet
758 758  
759 759  Attribute Documentation:
760 -
761 761  |**Name**|**Type**|**Documentation**
762 762  |id|com:IDType|The id attribute holds the identifier of the report structure as defined in the metadata structure definition. This identifies the report structure which defines the structure of metadata that is being reported. This is optional and not expected to be supplied as the metadata structure definition specific schema will specify a fixed value such that the reference to the report structure will always be available if required for processing.
763 763  
764 764  Element Documentation:
765 -
766 766  |**Name**|**Type**|**Documentation**
767 767  |com:Annotations|com:AnnotationsType|Annotations is a reusable element the provides for a collection of annotations. It has been made global so that restrictions of types that extend AnnotatableType my reference it.
768 768  |Target|//TargetType//|Target contains a set of target reference values which when taken together, identify the object or objects to which the reported metadata apply. This element is unqualified so that the metadata structure definition specific schema can refine the type of the element such that the references values can be validated against those defined in the metadata targets for the report structure.
... ... @@ -777,12 +777,10 @@
777 777  ReferenceValue+
778 778  
779 779  Attribute Documentation:
780 -
781 781  |**Name**|**Type**|**Documentation**
782 782  |id|com:IDType|The id attribute holds the identifier of the metadata target as defined in the metadata structure definition. This identifies the metadata target of the report structure that identifies the target object(s) of the reported metadata. This is optional and not expected to be supplied as the metadata structure definition specific schema will specify a fixed value such that the reference to the metadata target will always be available if required for processing.
783 783  
784 784  Element Documentation:
785 -
786 786  |**Name**|**Type**|**Documentation**
787 787  |ReferenceValue|//ReferenceValueType//|ReferenceValue contains a value for a target reference. When this is taken with its sibling elements, they identify the object or objects to which the reported metadata apply. The content of this will either be a reference to an identifiable object, a data key, a reference to a data set, or a report period. This element is unqualified so that the metadata structure definition specific schema can refine the type of the element such that value can be validated against the format defined in the metadata structure definition.
788 788  
... ... @@ -795,12 +795,10 @@
795 795  (ObjectReference | DataKey | DataSetReference | ConstraintContentReference | ReportPeriod)
796 796  
797 797  Attribute Documentation:
798 -
799 799  |**Name**|**Type**|**Documentation**
800 800  |id|com:IDType|The id attribute holds the identifier of the target reference object reference as defined in the metadata structure definition. This identifies the target reference of the metadata target that identifes one of the target references, that when taken together, identify the target of the reported metadata. This is optional and not expected to be supplied as the metadata structure definition specific schema will specify a fixed value such that the reference to the target object definition will always be available if required for processing.
801 801  
802 802  Element Documentation:
803 -
804 804  |**Name**|**Type**|**Documentation**
805 805  |ObjectReference|//com:ReferenceType//|ObjectReference provides a reference to an identifiable object in the SDMX information model. An identifiable object target will utilize this option as the representation of the target reference value. This element is unqualified so that the metadata structure definition specific schema can refine the type of the element such that the type of reference is valid according to the object type specified in the identifiable object target in the metadata structure definition. At the very least, the reference will be specific to the type of object being referenced so that a complete set of reference fields must be provided. In cases where an item object is restricted to be from a particular scheme, this type will be further restricted so that only a valid item reference can be supplied. The structure of this reference is such that it can be generically processed without needing to know what the intended target object type is prior to processing, as this information is part of the reference.
806 806  |DataKey|com:DataKeyType|ObjectReference provides a set of dimension references and values for those dimension for the purpose of reporting metadata against a set of data. A key descriptor values target will utilize this option as the representation of the target reference value. It is not expect that the metadata structure definition specific schema would refine this, but none the less, it is an unqualified element.
... ... @@ -811,7 +811,6 @@
811 811  **//ReportedAttributeType//: **ReportedAttributeType is an abstract base type that forms the basis for a metadata structure specific metadata attribute. A value for the attribute can be supplied as either a single value, or multi-lingual text values (either structured or unstructured). An optional set of child metadata attributes is also available if the metadata attribute definition defines nested metadata attributes. The metadata structure definition specific schema will refine this type for each metadata attribute such that the content can be validation against what is defined in the metadata structure definition.
812 812  
813 813  Derivation:
814 -
815 815  * //com:AnnotableType// (extension) 
816 816  ** //ReportedAttributeType//
817 817  
... ... @@ -822,7 +822,6 @@
822 822  com:Annotations?, (com:Text+ | com:StructuredText+)?, AttributeSet?
823 823  
824 824  Attribute Documentation:
825 -
826 826  |**Name**|**Type**|**Documentation**
827 827  |id|com:IDType|The id attribute identifies the metadata attribute that the value is being reported for. This is optional and not expected to be supplied as the metadata structure definition specific schema will specify a fixed value such that the reference to the metadata attribute will always be available if required for processing.
828 828  |value|xs:anySimpleType|The value attribute holds any simple value for the metadata attribute. This attribute is un-typed such that the metadata structure definition specific schema can specify any simple type according the text format / local representation defined by the metadata structure definition.
... ... @@ -829,7 +829,6 @@
829 829  |isMetadataAttribute (fixed: true)|xs:boolean|The isMetadataAttribute attribute is a fixed boolean (true) and is intended to designate to processing applications that a given element represents a reported attribute. This attribute is qualified (meaning that it will be qualified in an instance with the target namespace) to ensure that it can be properly identified by applications. The purpose of this is to allow applications to identify elements with unknown names as reported attributes so that they may process a metadata structure definition specific instance without knowledge of the underlying metadata structure definition.
830 830  
831 831  Element Documentation:
832 -
833 833  |**Name**|**Type**|**Documentation**
834 834  |com:Annotations|com:AnnotationsType|Annotations is a reusable element the provides for a collection of annotations. It has been made global so that restrictions of types that extend AnnotatableType my reference it.
835 835  |com:Text|com:TextType|Text is used to supply parallel multi-lingual textual values for the reported metadata attribute. This will be used if the text format of the metadata attribute has a type of string and the multi-lingual value is set to true.
... ... @@ -936,6 +936,7 @@
936 936  
937 937  A representation which defines an enumeration will result in a simple type that is a restriction of the common:IDType. The simple type will define enumerations for each item in the item scheme. The value for these enumerations will be identifier of the item. If desired, the names of the item may be placed in the documentation of the enumeration, but this is not required. Example:
938 938  
879 +
939 939  > <xs:simpleType name="ESTAT.CL_COUNTRY.1.0">
940 940  > <xs:restriction base="common:IDType">
941 941  > <xs:enumeration value="BE">
... ... @@ -944,7 +944,6 @@
944 944  > </xs:annotation>
945 945  > </xs:enumeration>
946 946  
947 -
948 948  === Representation with Text Format ===
949 949  
950 950  A representation which defines a text format will result in a simple type or primitive type. The first step is to determine the base type from the text format data type:
... ... @@ -989,7 +989,7 @@
989 989  |Day|xs:gDay
990 990  |Time|xs:time
991 991  |Duration|xs:duration
992 -|XHTML|N/A{{footnote}}These types are only used in complex types and will be discussed within their appropriate context.{{/footnote}}
932 +|XHTML|N/A[[~[1~]>>path:#_ftn1]]
993 993  |KeyValues|N/A^^1^^
994 994  |IdentifiableReference|N/A^^1^^
995 995  |DataSetReference|N/A^^1^^
... ... @@ -1000,7 +1000,7 @@
1000 1000  |**SDMX Facet**|**XML Schema Facet**
1001 1001  |minLength|xs:minLength
1002 1002  |maxLength|xs:maxLength
1003 -|minValue{{footnote}}Note that these options only apply to numeric representations and should be ignored if the data type is non-numeric{{/footnote}}|if ExclusiveValueRange: xs:minExclusives, else: xs:minInclusive
943 +|minValue[[~[2~]>>path:#_ftn2]]|if ExclusiveValueRange: xs:minExclusives, else: xs:minInclusive
1004 1004  |maxValue^^2^^|if ExclusiveValueRange: xs:maxExclusives, else: xs:maxInclusive
1005 1005  |decimals^^2^^|xs:fractionDigits
1006 1006  |pattern|xs:pattern
... ... @@ -1053,7 +1053,7 @@
1053 1053  111. If the dimension at the observation level is AllDimensions, a local element named Obs with a form of unqualified, a maximum occurrence of unbounded, and a type of ObsType (as defined in the ObsType section which follows)
1054 1054  1. If the reporting year start day attribute is not declared in the data structure definition or if it is declared but does not declare an attribute relationship of None, an attribute named REPORTING_YEAR_START_DAY with a type of xs:gMonthDay and a usage of prohibited
1055 1055  1. An attribute for each attribute defined in the data structured definition that declares an attribute relationship of None. The XML attribute [[name>>path:#_Component_Name_Determination]] and [[type>>path:#_Simple_/_Primitive]] are defined according to the general rules defined in the previous section, and the usage is optional
1056 -11.
996 +11.
1057 1057  
1058 1058  === GroupType ===
1059 1059  
... ... @@ -1172,8 +1172,7 @@
1172 1172  111. A local element named URN, with a form of unqualified, a minimum occurrence of 0, and the type defined above as [item scheme agency].[item scheme identifier].[item scheme version].URN
1173 1173  11. A local element named URN, with a form of unqualified, and the type defined above as [item scheme agency].[item scheme identifier].[item scheme version].URN
1174 1174  
1175 -
1176 -
1115 +
1177 1177  ==== Identifiable Object Target Type Determination ====
1178 1178  
1179 1179  An identifiable object target is meant to reference an SDMX identifiable object. In the metadata structure specific schema, the complex type which defines the reference is restricted according to the local representation and object type of the identifiable object target. If the identifiable object target does not provide an enumeration in its local representation, then the complex type for the target object is the specific reference type from the common namespace, based on the object type defined by the target object. For example, if the object type is DataProivder, the type will be common:DataProviderReferenceType. The general rule for the name of this type is common:[object type]ReferenceType.
... ... @@ -1251,19 +1251,24 @@
1251 1251  11. A local element for each metadata attribute defined as a direct child of the object for which the attribute set is being created. The recommended name of this element is [metadata attribute identifier] and it has a form of unqualified. If the metadata attribute defines a minOccurs and maxOccurs, these values are translated to this element. The type of this element is the type previously created as [report structure identifier].[nested metadata attribute identifier].
1252 1252  
1253 1253  = Special data functions =
1254 -
1255 1255  == Updates ==
1256 1256  
1257 1257  Both the generic and the structure-specific data messages allow for incremental updating of data. This purpose is noted in the action for the data set, which is either inherited from the header of the data message or explicitly stated at the data set level.
1258 1258  
1197 +
1259 1259  A dataset with an action of Append is assumed to be an incremental update. This means that one the information provided explicitly in the message should be altered. Any data attribute or observation value that is to be changed must be provided. However, the absence of an observation value or a data attribute at any level does not imply deletion; instead it is simply implied that the value is to remain unchanged. Therefore, it is valid and acceptable to send a data message with an action of Append which contains only a Series elements with attribute values. In this case, the values for the attributes will be updated. Note that it is not permissible to update data attributes using partial keys (outside of those associated with defined groups). In order to update an attribute, a full key must always be provided even if the message format does not require this.
1260 1260  
1261 -== Deletes ==
1200 +1.
1201 +11. Deletes
1262 1262  
1263 1263  Both the generic and the structure-specific data messages allow for incremental deletion of data. This purpose is noted in the action for the data set, which is either inherited from the header of the data message or explicitly stated at the data set level.
1264 1264  
1205 +
1265 1265  A dataset with an action of Delete is assumed to be an incremental deletion. The deletion is assumed to take place of the lowest level of detail provided in the message. For example, if a delete message is sent with only a data set element, the entire data set will be deleted. On the other hand, if that data set contains a data attribute, only that data attribute value will be deleted. This same dynamic continues through the data set hierarchy. A data set containing only a series with no data attributes or observations will result in that entire series (all observations and data attributes) being deleted. If the series contains data attributes, only the supplied data attributes for that series will be deleted. Finally, if a series contains observations, then only the specified observations will be deleted. If an entire observation is to be deleted (value and data attributes), only the observation dimension should be provided. If only the observation value or particular data attributes are to be deleted, then these should be specified for the observation. Note that a group can only be used to delete the data attributes associated with it. Although the format might not require it, a full key must be provided to delete a series or observation. It is not permissible to wild card a key in order to delete more than one series or observation. Finally, to delete a data attribute or observation value it is recommended that the value to be deleted be supplied; however, it is only required that any valid value be provided.
1266 1266  
1208 +
1267 1267  ----
1268 1268  
1269 -{{putFootnotes/}}
1211 +[[~[1~]>>path:#_ftnref1]] These types are only used in complex types and will be discussed within their appropriate context.
1212 +
1213 +[[~[2~]>>path:#_ftnref2]] Note that these options only apply to numeric representations and should be ignored if the data type is non-numeric