Skip to Content
Last modified by Helena K. on 2026/06/09 19:45
From version 33.3
edited by Helena K.
on 2026/06/09 19:21
Change comment: There is no comment for this version
To version 33.8
edited by Helena K.
on 2026/06/09 19:24
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -211,12 +211,12 @@
211 211  * that a simple [[data source>>doc:sdmx:Glossary 2\.1.Data source.WebHome]] exists (i.e., a file accessible at a URL);
212 212  * that the correct [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] is used by the registered data;
213 213  * that the [[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]] ([[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]], [[Attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]], [[Measures>>doc:sdmx:Glossary 2\.1.Measure.WebHome]]) are consistent with the [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]];
214 -* that the valid [[representations>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] of the (% style="color:#e74c3c" %)concepts(%%) to which these [[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]] correspond conform to the definition in the [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]].
214 +* that the valid [[representations>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] of the [[concepts>>doc:sdmx:Glossary 2\.1.Concept.WebHome]] to which these [[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]] correspond conform to the definition in the [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]].
215 215  
216 216  The Registration has an action [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] which takes one of the following values:
217 217  
218 218  (% style="width:893.835px" %)
219 -|(% style="width:241px" %)**Action [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] Value**|(% style="width:650px" %)**Behaviour**
219 +|(% style="width:241px" %)**Action Attribute Value**|(% style="width:650px" %)**Behaviour**
220 220  |(% style="width:241px" %)Append|(% style="width:650px" %)Add this registration to the registry
221 221  |(% style="width:241px" %)Replace|(% style="width:650px" %)Replace the existing Registration with this Registration identified by the id in the Registration of the Submit Registration Request
222 222  |(% style="width:241px" %)Delete|(% style="width:650px" %)Delete the existing Registration identified by the id in the Registration of the Submit Registration Request
... ... @@ -224,7 +224,7 @@
224 224  The Registration has three Boolean [[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] which may be present to determine how an [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] compliant [[dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] or metadataset indexing application must index the [[datasets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] or metadatasets upon registration. The indexing application behaviour is as follows:
225 225  
226 226  (% style="width:896.835px" %)
227 -|**Boolean [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]**|(% style="width:712px" %)**Behaviour if Value is “true”**
227 +|**Boolean Attribute**|(% style="width:712px" %)**Behaviour if Value is “true”**
228 228  |indexTimeSeries|(% style="width:712px" %)A compliant indexing application must index all the [[time series>>doc:sdmx:Glossary 2\.1.Series.WebHome]] keys
229 229  |indexDataSet|(% style="width:712px" %)(((
230 230  A compliant indexing application must index the range of actual (present) values for each [[dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] of the [[Dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]].
... ... @@ -251,7 +251,7 @@
251 251  
252 252  [[Subscription>>doc:sdmx:Glossary 2\.1.Subscription.WebHome]] management involves a user submitting a [[subscription>>doc:sdmx:Glossary 2\.1.Subscription.WebHome]] request which contains:
253 253  
254 -* a query or (% style="color:#e74c3c" %)constraint(%%) expression in terms of a filter which defines the events for which the user is interested (e.g., new data for a specific [[dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]], or for a domain [[category>>doc:sdmx:Glossary 2\.1.Category.WebHome]], or changes to a [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]).
254 +* a query or [[constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] expression in terms of a filter which defines the events for which the user is interested (e.g., new data for a specific [[dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]], or for a domain [[category>>doc:sdmx:Glossary 2\.1.Category.WebHome]], or changes to a [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]).
255 255  * a list of URIs or endpoints to which an XML [[notification>>doc:sdmx:Glossary 2\.1.Notification.WebHome]] message can be sent. Supported endpoint types will be email (mailto and HTTP POST (a normal http:~/~/ address);
256 256  * request for a list of submitted [[subscriptions>>doc:sdmx:Glossary 2\.1.Subscription.WebHome]];
257 257  * deletion of a [[subscription>>doc:sdmx:Glossary 2\.1.Subscription.WebHome]];
... ... @@ -260,11 +260,11 @@
260 260  
261 261  === 5.2.7 Registry Behaviour ===
262 262  
263 -The following table defines the behaviour of the [[SDMX Registry>>doc:sdmx:Glossary 2\.1.SDMX Registry.WebHome]] for the various Registry Interface messages. It should be noted, though, that as of [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] 3.0, an extended versioning scheme newly including semantic versioning is foreseen for all [[Maintainable Artefacts>>doc:sdmx:Glossary 2\.1.Maintainable artefact.WebHome]]. Moreover, while the old versioning scheme is allowed, given there is no more
263 +The following table defines the behaviour of the [[SDMX Registry>>doc:sdmx:Glossary 2\.1.SDMX Registry.WebHome]] for the various Registry Interface messages. It should be noted, though, that as of [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] 3.0, an extended versioning scheme newly incl
264 264  
265 -a "final" flag, there is no way guaranteeing the consistency across (% style="color:#e74c3c" %)version(%%) of a Maintainable, unless semantic versioning is used.
265 +uding semantic versioning is foreseen for all [[Maintainable Artefacts>>doc:sdmx:Glossary 2\.1.Maintainable artefact.WebHome]]. Moreover, while the old versioning scheme is allowed, given there is no more a "final" flag, there is no way guaranteeing the consistency across [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] of a Maintainable, unless semantic versioning is used.
266 266  
267 -Given the above, the behaviour described in the following table concerns either draft [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] using semantic versioning or any [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] using the old versioning scheme. Nevertheless, in the case of semantic versioning the registry must respect the versioning rules when performing the actions below. For example, it is not possible to replace a non-draft [[Artefact>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] that follows semantic versioning, unless a newer (% style="color:#e74c3c" %)version(%%) is introduced according to the semantic versioning rules. Furthermore, even when draft [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] are submitted, the registry has to verify semantic versioning is respected against the previous non-draft (% style="color:#e74c3c" %)versions(%%). It is worth noting that the rules for semantic versioning and replacing or maintaining semantically versioned [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] applies to externally shared [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]]. This means that any system may internally perform any change within a (% style="color:#e74c3c" %)version(%%) of an [[Artefact>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]], until the latter is shared outside of that system or becomes public. Then (as also explained in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Standards Section 6 “Technical Notes”) the [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] must adhere to the Semantic Versioning rules.
267 +Given the above, the behaviour described in the following table concerns either draft [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] using semantic versioning or any [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] using the old versioning scheme. Nevertheless, in the case of semantic versioning the registry must respect the versioning rules when performing the actions below. For example, it is not possible to replace a non-draft [[Artefact>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] that follows semantic versioning, unless a newer [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] is introduced according to the semantic versioning rules. Furthermore, even when draft [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] are submitted, the registry has to verify semantic versioning is respected against the previous non-draft [[versions>>doc:sdmx:Glossary 2\.1.Version.WebHome]]. It is worth noting that the rules for semantic versioning and replacing or maintaining semantically versioned [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] applies to externally shared [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]]. This means that any system may internally perform any change within a [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] of an [[Artefact>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]], until the latter is shared outside of that system or becomes public. Then (as also explained in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Standards Section 6 “Technical Notes”) the [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] must adhere to the Semantic Versioning rules.
268 268  
269 269  (% style="width:982.835px" %)
270 270  |(% style="width:217px" %)**Interface**|(% style="width:763px" %)**Behaviour**
... ... @@ -273,13 +273,13 @@
273 273  1. Cross referenced structures MUST exist in either the submitted document (in Structures or Structure Location) or in the registry to which the request is submitted.
274 274  1. If the action is set to “delete” (or a [[maintainable Artefact>>doc:sdmx:Glossary 2\.1.Maintainable artefact.WebHome]] is DELETEd) then the Registry MUST verify that the object can be deleted. In order to qualify for deletion, the object must:
275 275  
276 -a) Be a draft (% style="color:#e74c3c" %)version(%%).
276 +a) Be a draft [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]].
277 277  b) Not be explicitly{{footnote}}With semantic versioning, it is allowed to reference a range of artefacts, e.g., a DSD referencing a Codelist with version 1.2.3+ means all patch versions greater than 1.2.3. This means that deleting 1.2.4draft does not break integrity of the aforementioned DSD.{{/footnote}} referenced from any other object in the Registry.
278 278  
279 279  4) The semantic versioning rules in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] documentation MUST be obeyed.
280 280  )))
281 281  |(% style="width:217px" %)Structure submission|(% style="width:763px" %)(((
282 -Structures are submitted at the (% style="color:#e74c3c" %)level(%%) of the [[Maintainable Artefact>>doc:sdmx:Glossary 2\.1.Maintainable artefact.WebHome]] and the behaviour in “All” above is therefore at the (% style="color:#e74c3c" %)level(%%) of the [[Maintainable Artefact>>doc:sdmx:Glossary 2\.1.Maintainable artefact.WebHome]].
282 +Structures are submitted at the level of the [[Maintainable Artefact>>doc:sdmx:Glossary 2\.1.Maintainable artefact.WebHome]] and the behaviour in “All” above is therefore at the level of the [[Maintainable Artefact>>doc:sdmx:Glossary 2\.1.Maintainable artefact.WebHome]].
283 283  )))
284 284  |(% style="width:217px" %)SubmitRegistrationRequest|(% style="width:763px" %)If the datasource is a file (simple datasource) then the file MAY be retrieved and indexed according to the Boolean [[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] set in the Registration. For a queryable datasource the Registry MAY validate that the source exists and can accept an [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] data query.
285 285  
... ... @@ -291,7 +291,7 @@
291 291  
292 292  * //**IdentifiableArtefact**// – this gives an object the ability to be uniquely identified (see following section on identification), to have a user-defined URI, and to have multi-lingual [[annotations>>doc:sdmx:Glossary 2\.1.Annotation.WebHome]].
293 293  * //**NameableArtefact**// – this has all of the features of //IdentifiableArtefact// plus the ability to have a multi-lingual name and description.
294 -* //**VersionableArtefact**// – this has all of the above features plus a (% style="color:#e74c3c" %)version(%%) number, according to the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] versioning rules in [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Standards Section 6 “Technical Notes”, paragraph “4.3 Versioning”, and a validity period.
294 +* //**VersionableArtefact**// – this has all of the above features plus a [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] number, according to the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] versioning rules in [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Standards Section 6 “Technical Notes”, paragraph “4.3 Versioning”, and a validity period.
295 295  * //**MaintainableArtefact**// – this has all of the above features, plus registry and structure URIs, and an association to the maintenance organisation of the object.
296 296  
297 297  === 6.1.1 Identification, Naming, Versioning, and Maintenance Model ===
... ... @@ -298,7 +298,7 @@
298 298  
299 299  [[image:SDMX 3.1 Section 5_en_4a9b2cfc.jpg||height="688" width="587"]]
300 300  
301 -**Figure 5: Class diagram of fundamental [[artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] in the [[SDMX-IM>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]**
301 +**Figure 5: Class diagram of fundamental artefacts in the SDMX-IM**
302 302  
303 303  The table below shows the identification and related data [[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] to be stored in a registry for objects that are one of:
304 304  
... ... @@ -309,7 +309,7 @@
309 309  * //Maintainable//
310 310  
311 311  (% style="width:1038.83px" %)
312 -|(% colspan="2" %)**Object Type**|(% colspan="2" %)**Data [[Attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]**|(% colspan="2" %)**Status**|(% colspan="2" %)**Data type**|(% colspan="2" %)**Notes**
312 +|(% colspan="2" %)**Object Type**|(% colspan="2" %)**Data Attributes**|(% colspan="2" %)**Status**|(% colspan="2" %)**Data type**|(% colspan="2" %)**Notes**
313 313  |(% colspan="2" rowspan="4" %)//Annotable//|(% colspan="2" %)AnnotationTitle|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %)
314 314  |(% colspan="2" %)AnnotationType|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %)
315 315  |(% colspan="2" %)AnnotationURN|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %)
... ... @@ -334,7 +334,7 @@
334 334  
335 335  //Identifiable// plus
336 336  )))|(% colspan="2" %) |(% colspan="2" %) |(% colspan="2" %)
337 -|(% colspan="2" %)(% style="color:#e74c3c" %)version|(% colspan="2" %)M|(% colspan="2" %)string|(% colspan="2" %)This is the (% style="color:#e74c3c" %)version(%%) number according to [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] versioning rules.
337 +|(% colspan="2" %)[[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]]|(% colspan="2" %)M|(% colspan="2" %)string|(% colspan="2" %)This is the [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] number according to [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] versioning rules.
338 338  |(% colspan="2" %)validFrom|(% colspan="2" %)C|(% colspan="2" %)Date/time|(% colspan="2" %)
339 339  |(% colspan="2" %)validTo|(% colspan="2" %)C|(% colspan="2" %)Date/time|(% colspan="2" %)
340 340  |(% colspan="2" %)//Maintainable//|(% colspan="2" %)All content as for //Versionable// plus|(% colspan="2" %) |(% colspan="2" %) |(% colspan="2" %)
... ... @@ -343,7 +343,7 @@
343 343  |(% colspan="2" %) |(% colspan="2" %)structureURL|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %)The url of the resource.
344 344  |(% colspan="2" %) |(% colspan="2" %)(Maintenance) organisationId|(% colspan="2" %)M|(% colspan="2" %)string|(% colspan="2" %)The object must be linked to a maintenance organisation, i.e., Agency or Metadata Provider.
345 345  
346 -**Table 1: Common [[Attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] of Object Types**
346 +**Table 1: Common Attributes of Object Types**
347 347  
348 348  == 6.2 Unique identification of SDMX objects ==
349 349  
© Semantic R&D Group, 2026