Last modified by Helena K. on 2026/06/09 19:45

From version 33.4
edited by Helena K.
on 2026/06/09 19:21
Change comment: There is no comment for this version
To version 33.9
edited by Helena K.
on 2026/06/09 19:31
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -216,7 +216,7 @@
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  
... ... @@ -353,20 +353,20 @@
353 353  
354 354  [[image:SDMX 3.1 Section 5_en_67b3555e.jpg||height="313" width="554"]]
355 355  
356 -**Figure 6: [[Agency Scheme>>doc:sdmx:Glossary 2\.1.Agency scheme.WebHome]] Model**
356 +**Figure 6: Agency Scheme Model**
357 357  
358 -The Agency in [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] is extremely important. The Agency Id system used in [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] is an nlevel structure. The top (% style="color:#e74c3c" %)level(%%) of this structure is maintained by [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]. Any Agency in this top (% style="color:#e74c3c" %)level(%%) can declare sub agencies and any sub agency can also declare sub agencies. The [[Agency Scheme>>doc:sdmx:Glossary 2\.1.Agency scheme.WebHome]] has a fixed id and (% style="color:#e74c3c" %)version(%%) ((% style="color:#e74c3c" %)version(%%) ‘1.0’) and is never declared explicitly in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] object identification mechanism.
358 +The Agency in [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] is extremely important. The Agency Id system used in [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] is an nlevel structure. The top level of this structure is maintained by [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]. Any Agency in this top level can declare sub agencies and any sub agency can also declare sub agencies. The [[Agency Scheme>>doc:sdmx:Glossary 2\.1.Agency scheme.WebHome]] has a fixed id and version (version ‘1.0’) and is never declared explicitly in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] object identification mechanism.
359 359  
360 360  In order to achieve this [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] adopts the following rules:
361 361  
362 362  * Agencies are maintained in an [[Agency Scheme>>doc:sdmx:Glossary 2\.1.Agency scheme.WebHome]] (which is a sub class of Organisation Scheme).
363 363  * The agency of the [[Agency Scheme>>doc:sdmx:Glossary 2\.1.Agency scheme.WebHome]] must also be declared in a (different) [[Agency Scheme>>doc:sdmx:Glossary 2\.1.Agency scheme.WebHome]].
364 -* The “top-(% style="color:#e74c3c" %)level(%%)” agency is [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] and maintains the “top-(% style="color:#e74c3c" %)level(%%)” [[Agency Scheme>>doc:sdmx:Glossary 2\.1.Agency scheme.WebHome]].
365 -* Agencies registered in the top-(% style="color:#e74c3c" %)level(%%) scheme can themselves maintain a single [[Agency Scheme>>doc:sdmx:Glossary 2\.1.Agency scheme.WebHome]]. Agencies in these second-tier schemes can themselves maintain a single [[Agency Scheme>>doc:sdmx:Glossary 2\.1.Agency scheme.WebHome]] and so on.
366 -* The AgencyScheme has a fixed (% style="color:#e74c3c" %)version(%%), i.e., ‘1.0’, hence it is an exception from the Semantic Versioning that other [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] follow.
364 +* The “top-level” agency is [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] and maintains the “top-level” [[Agency Scheme>>doc:sdmx:Glossary 2\.1.Agency scheme.WebHome]].
365 +* Agencies registered in the top-level scheme can themselves maintain a single [[Agency Scheme>>doc:sdmx:Glossary 2\.1.Agency scheme.WebHome]]. Agencies in these second-tier schemes can themselves maintain a single [[Agency Scheme>>doc:sdmx:Glossary 2\.1.Agency scheme.WebHome]] and so on.
366 +* The AgencyScheme has a fixed version, i.e., ‘1.0’, hence it is an exception from the Semantic Versioning that other [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] follow.
367 367  * There can be only one AgencyScheme maintained by any one Agency. It has a fixed id of AGENCIES.
368 368  * The /[[hierarchy>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]] of Organisation is not inherited by [[Maintenance Agency>>doc:sdmx:Glossary 2\.1.Maintenance agency.WebHome]] – thus each [[Agency Scheme>>doc:sdmx:Glossary 2\.1.Agency scheme.WebHome]] is a flat list of [[Maintenance Agencies>>doc:sdmx:Glossary 2\.1.Maintenance agency.WebHome]].
369 -* The format of the agency identifier is agencyID.agencyID etc. The top-(% style="color:#e74c3c" %)level(%%) agency in this identification mechanism is the agency registered in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] [[agency scheme>>doc:sdmx:Glossary 2\.1.Agency scheme.WebHome]]. In other words, [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] is not a part of the hierarchical ID structure for agencies. However, [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] is, itself, a [[maintenance agency>>doc:sdmx:Glossary 2\.1.Maintenance agency.WebHome]] and is contained in the top-(% style="color:#e74c3c" %)level(%%) [[Agency Scheme>>doc:sdmx:Glossary 2\.1.Agency scheme.WebHome]].
369 +* The format of the agency identifier is agencyID.agencyID etc. The top-level agency in this identification mechanism is the agency registered in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] [[agency scheme>>doc:sdmx:Glossary 2\.1.Agency scheme.WebHome]]. In other words, [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] is not a part of the hierarchical ID structure for agencies. However, [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] is, itself, a [[maintenance agency>>doc:sdmx:Glossary 2\.1.Maintenance agency.WebHome]] and is contained in the top-level [[Agency Scheme>>doc:sdmx:Glossary 2\.1.Agency scheme.WebHome]].
370 370  
371 371  This supports a hierarchical structure of agencyID.
372 372  
... ... @@ -401,27 +401,29 @@
401 401  
402 402  ==== 6.2.2.1 Introduction ====
403 403  
404 -To provide interoperability between [[SDMX Registry>>doc:sdmx:Glossary 2\.1.SDMX Registry.WebHome]]/Repositories in a distributed network environment, it is important to have a scheme for uniquely identifying (and thus accessing) all first-class (Identifiable) [[SDMX-IM>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]] objects. Most of these unique identifiers are composite (containing [[maintenance agency>>doc:sdmx:Glossary 2\.1.Maintenance agency.WebHome]], or parent object identifiers), and there is a need to be able to construct a unique reference as a single string. This is achieved by having a globally unique identifier called a universal resource name (URN) which is generated from the actual identification [[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]] in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]-RR APIs. In other words, the URN for any [[Identifiable Artefact>>doc:sdmx:Glossary 2\.1.Identifiable artefact.WebHome]] is constructed from its [[component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] identifiers (agency, id, (% style="color:#e74c3c" %)version(%%) etc.).
404 +To provide interoperability between [[SDMX Registry>>doc:sdmx:Glossary 2\.1.SDMX Registry.WebHome]]/Repositories in a distributed network environment, it is important to have a scheme for uniquely identifying (and thus accessing) all first-class (Identifiable) [[SDMX-IM>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]] objects. Most of these unique identifiers are composite (containing [[maintenance agency>>doc:sdmx:Glossary 2\.1.Maintenance agency.WebHome]], or parent object identifiers), and there is a need to be able to construct a unique reference as a single string. This is achieved by having a globally unique identifier called a universal resource name (URN) which is generated from the actual identification [[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]] in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]-RR APIs. In other words, the URN for any [[Identifiable Artefact>>doc:sdmx:Glossary 2\.1.Identifiable artefact.WebHome]] is constructed from its [[component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] identifiers (agency, id, [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] etc.).
405 405  
406 406  ==== 6.2.2.2 URN Structure //__Case Rules for URN__// ====
407 407  
408 408  For the URN, all parts of the string are case sensitive. The generic structure of the URN is as follows:
409 409  
410 -SDMXprefix.[[SDMX-IM>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]-package-name.class-name=agencyid:maintainedobjectid(maintainedobject-(% style="color:#e74c3c" %)version(%%)).*containerobject-id.object-id
410 +SDMXprefix.[[SDMX-IM>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]-package-name.class-name=agencyid:maintainedobjectid(maintainedobject-version).*containerobject-id.object-id
411 411  
412 412  ~* this can repeat and may not be present (see explanation below)
413 413  
414 -Note that in the [[SDMX Information Model>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]] there are no concrete [[Versionable Artefacts>>doc:sdmx:Glossary 2\.1.Versionable artefact.WebHome]] that are not a [[Maintainable Artefact>>doc:sdmx:Glossary 2\.1.Maintainable artefact.WebHome]]. For this reason, the only (% style="color:#e74c3c" %)version(%%) information that is allowed is for the maintainable object.
414 +Note that in the [[SDMX Information Model>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]] there are no concrete [[Versionable Artefacts>>doc:sdmx:Glossary 2\.1.Versionable artefact.WebHome]] that are not a [[Maintainable Artefact>>doc:sdmx:Glossary 2\.1.Maintainable artefact.WebHome]].
415 415  
416 -The [[Maintenance agency>>doc:sdmx:Glossary 2\.1.Maintenance agency.WebHome]] identifier is separated from the [[maintainable artefact>>doc:sdmx:Glossary 2\.1.Maintainable artefact.WebHome]] identifier by a colon ‘:’. All other identifiers in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] URN syntax are separated by a period ‘.’. The (% style="color:#e74c3c" %)version(%%) information is encapsulated in parentheses ‘()’ and adheres to the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] versioning rules, as explained in [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Standards Section 6 “Technical Notes”, paragraph “4.3 Versioning.
416 +For this reason, the only [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] information that is allowed is for the maintainable object.
417 417  
418 +The [[Maintenance agency>>doc:sdmx:Glossary 2\.1.Maintenance agency.WebHome]] identifier is separated from the [[maintainable artefact>>doc:sdmx:Glossary 2\.1.Maintainable artefact.WebHome]] identifier by a colon ‘:’. All other identifiers in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] URN syntax are separated by a period ‘.’. The [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] information is encapsulated in parentheses ‘()’ and adheres to the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] versioning rules, as explained in [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Standards Section 6 “Technical Notes”, paragraph “4.3 Versioning.
419 +
418 418  ==== 6.2.2.3 Explanation of the generic structure ====
419 419  
420 420  In the explanation below the actual object that is the target of the URN is called the **actual object**.
421 421  
422 -**SDMXPrefix**: urn:[[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]:org
424 +**SDMXPrefix**: urn:sdmx:org
423 423  
424 -**[[SDMX-IM>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]-package-name**: [[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]].infomodel.package=
426 +**SDMX-IM-package-name**: sdmx.infomodel.package=
425 425  
426 426  The packages are:
427 427  
... ... @@ -429,13 +429,13 @@
429 429  
430 430  **maintainable-object-id** is the identifier of the maintainable object. This will always be present as all identifiable objects are either a maintainable object or contained in a maintainable object.
431 431  
432 -**maintainable-object-(% style="color:#e74c3c" %)version(%%)** is the (% style="color:#e74c3c" %)version(%%), according to the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] versioning rules, of the maintainable object and is enclosed in parentheses ‘()’, which are always present.
434 +**maintainable-object-version** is the [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]], according to the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] versioning rules, of the maintainable object and is enclosed in parentheses ‘()’, which are always present.
433 433  
434 -**container-object-id** is the identifier of an intermediary object that contains the actual object which the URN is identifying. It is not mandatory as many actual objects do not have an intermediary container object. For instance, a [[Code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] is in a maintained object ([[Codelist>>doc:sdmx:Glossary 2\.1.Code list.WebHome]]) and has no intermediary container object, whereas a MetadataAttribute has an intermediary container object (MetadataAttributeDescriptor) and may have an intermediary container object, which is its parent MetadataAttribute. For this reason, the container object id may repeat, with each repetition identifying the object at the next-lower (% style="color:#e74c3c" %)level(%%) in its [[hierarchy>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]]. Note that if there is only a single containing object in the model then it is NOT included in the URN structure. This applies to AttributeDescriptor, DimensionDescriptor, and MeasureDescriptor where there can be only one such object and this object has a fixed id. Therefore, whilst each of these has a URN, the id of the AttributeDescriptor, DimensionDescriptor, and MeasureDescriptor is not included when the actual object is a DataAttribute or a [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]/ TimeDimension, or a [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]].
436 +**container-object-id** is the identifier of an intermediary object that contains the actual object which the URN is identifying. It is not mandatory as many actual objects do not have an intermediary container object. For instance, a [[Code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] is in a maintained object ([[Codelist>>doc:sdmx:Glossary 2\.1.Code list.WebHome]]) and has no intermediary container object, whereas a MetadataAttribute has an intermediary container object (MetadataAttributeDescriptor) and may have an intermediary container object, which is its parent MetadataAttribute. For this reason, the container object id may repeat, with each repetition identifying the object at the next-lower [[level>>doc:sdmx:Glossary 2\.1.Level.WebHome]] in its [[hierarchy>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]]. Note that if there is only a single containing object in the model then it is NOT included in the URN structure. This applies to AttributeDescriptor, DimensionDescriptor, and MeasureDescriptor where there can be only one such object and this object has a fixed id. Therefore, whilst each of these has a URN, the id of the AttributeDescriptor, DimensionDescriptor, and MeasureDescriptor is not included when the actual object is a DataAttribute or a [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]/ TimeDimension, or a [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]].
435 435  
436 -Note that although a [[Code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] can have a parent [[Code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] and a (% style="color:#e74c3c" %)Concept(%%) can have a parent (% style="color:#e74c3c" %)Concept(%%) these are maintained in a flat structure and therefore do not have a containerobject-id.
438 +Note that although a [[Code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] can have a parent [[Code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] and a [[Concept>>doc:sdmx:Glossary 2\.1.Concept.WebHome]] can have a parent [[Concept>>doc:sdmx:Glossary 2\.1.Concept.WebHome]] these are maintained in a flat structure and therefore do not have a containerobject-id.
437 437  
438 -For example, the sequence is agency:DSDid((% style="color:#e74c3c" %)version(%%)).DimensionId and not agency:DSDid((% style="color:#e74c3c" %)version(%%)).DimensionDescriptorId.DimensionId.
440 +For example, the sequence is agency:DSDid(version).DimensionId and not agency:DSDid(version).DimensionDescriptorId.DimensionId.
439 439  
440 440  object-id is the identifier of the actual object unless the actual object is a //Maintainable// object. If present it is always the last id and is not followed by any other character.
441 441  
... ... @@ -443,54 +443,56 @@
443 443  
444 444  __Actual object is a maintainable__
445 445  
446 -SDMXPrefix.[[SDMX-IM>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]-package-name.classname=agencyid:maintained-objectid((% style="color:#e74c3c" %)version(%%))
448 +SDMXPrefix.[[SDMX-IM>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]-package-name.classname=agencyid:maintained-objectid(version)
447 447  
448 448  __Actual object is contained in a maintained object with no intermediate containing object__
449 449  
450 -SDMXPrefix.[[SDMX-IM>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]-package-name.classname=agencyid:maintained-objectid((% style="color:#e74c3c" %)version(%%)).object-id
452 +SDMXPrefix.[[SDMX-IM>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]-package-name.classname=agencyid:maintained-objectid(version).object-id
451 451  
452 452  __Actual object is contained in a maintained object with an intermediate containing object__
453 453  
454 -SDMXPrefix.[[SDMX-IM>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]-package-name.classname=agencyid:maintained-objectid((% style="color:#e74c3c" %)version(%%)).contained-object-id.object-id
456 +SDMXPrefix.[[SDMX-IM>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]-package-name.classname=agencyid:maintained-objectid(version).contained-object-id.object-id
455 455  
456 456  __Actual object is contained in a maintained object with no intermediate containing__ __object but__ __the object type itself is hierarchical__
457 457  
458 458  In this case the object id may not be unique in itself but only within the context of the [[hierarchy>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]]. In the general syntax of the URN all intermediary objects in the structure (with the exception, of course, of the maintained object) are shown as a contained object. An example here would be a [[Category>>doc:sdmx:Glossary 2\.1.Category.WebHome]] in a CategoryScheme. The [[Category>>doc:sdmx:Glossary 2\.1.Category.WebHome]] is hierarchical, and all intermediate [[Categories>>doc:sdmx:Glossary 2\.1.Category.WebHome]] are shown as a contained object. The example below shows the generic structure for CategoryScheme/ [[Category>>doc:sdmx:Glossary 2\.1.Category.WebHome]]/ [[Category>>doc:sdmx:Glossary 2\.1.Category.WebHome]].
459 459  
460 -SDMXPrefix.[[SDMX-IM>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]-package-name.classname=agencyid:maintained-objectid((% style="color:#e74c3c" %)version(%%)).contained-object-id.object-id
462 +SDMXPrefix.[[SDMX-IM>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]-package-name.classname=agencyid:maintained-objectid(version).contained-object-id.object-id
461 461  
462 462  Actual object is contained in a maintained object with an intermediate containing object and the object type itself is hierarchical
463 463  
464 464  In this case the generic syntax is the same as for the example above as the parent object is regarded as a containing object, even if it is of the same type. An example here is a MetadataAttribute where the contained objects are MetadataAttributeDescriptor (first contained object id) and MetadataAttribute (subsequent contained object ids). The example below shows the generic structure for [[MSD>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]]/ MetadataAttributeDescriptor/ MetadataAttribute/ MetadataAttribute
465 465  
466 -SDMXPrefix.[[SDMX-IM>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]-package-name.classname=agencyid:maintained-objectid((% style="color:#e74c3c" %)version(%%)).contained-object-id.contained-object-id contained-objectid.object-id
468 +SDMXPrefix.[[SDMX-IM>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]-package-name.classname=agencyid:maintained-objectid(version).contained-object-id.contained-object-id contained-objectid.object-id
467 467  
468 468  //__**Concrete Examples of the URN Structure**__//
469 469  
470 -The [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] CRED_EXT_DEBT of legacy (% style="color:#e74c3c" %)version(%%) 2.1 maintained by the toplevel Agency TFFS would have the URN:
472 +The [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] CRED_EXT_DEBT of legacy [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] 2.1 maintained by the toplevel Agency TFFS would have the URN:
471 471  
472 472  urn:[[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]:org.[[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]].infomodel.datastructure.DataStucture=TFFS:CRED_EXT_ DEBT(2.1)
473 473  
474 -The URN for a [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] for Argentina maintained by ISO in the [[code list>>doc:sdmx:Glossary 2\.1.Code list.WebHome]] CL_3166A2 of semantic (% style="color:#e74c3c" %)version(%%) 1.0.0 would be:
476 +The URN for a [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] for Argentina maintained by ISO in the [[code list>>doc:sdmx:Glossary 2\.1.Code list.WebHome]] CL_3166A2 of semantic
475 475  
476 -urn:[[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]:org.[[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]].infomodel.[[codelist>>doc:sdmx:Glossary 2\.1.Code list.WebHome]].[[Code>>doc:sdmx:Glossary 2\.1.Code.WebHome]]=ISO:CL_3166A2(1.0.0).AR
478 +[[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] 1.0.0 would be:
477 477  
478 -The URN for a [[category>>doc:sdmx:Glossary 2\.1.Category.WebHome]] (id of 1) which has parent [[category>>doc:sdmx:Glossary 2\.1.Category.WebHome]] (id of 2) maintained by [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] in the [[category scheme>>doc:sdmx:Glossary 2\.1.Category scheme.WebHome]] SUBJECT_MATTER_DOMAINS of the semantic extended (% style="color:#e74c3c" %)version(%%) 1.0.0draft would be:
480 +urn:[[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]:org.[[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]].infomodel.codelist.Code=ISO:CL_3166A2(1.0.0).AR
479 479  
480 -urn:[[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]:org.[[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]].infomodel.categoryscheme.[[Category>>doc:sdmx:Glossary 2\.1.Category.WebHome]]=[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]:SUBJECT_MATT ER_DOMAINS(1.0.0-draft).1.2
482 +The URN for a [[category>>doc:sdmx:Glossary 2\.1.Category.WebHome]] (id of 1) which has parent [[category>>doc:sdmx:Glossary 2\.1.Category.WebHome]] (id of 2) maintained by [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] in the [[category scheme>>doc:sdmx:Glossary 2\.1.Category scheme.WebHome]] SUBJECT_MATTER_DOMAINS of the semantic extended [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] 1.0.0draft would be:
481 481  
482 -The URN for a Metadata [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] maintained by [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] in the [[MSD>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]] CONTACT_METADATA of semantic (% style="color:#e74c3c" %)version(%%) 1.0.0 where the [[hierarchy>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]] of the Metadata [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is CONTACT_DETAILS/CONTACT_NAME would be:
484 +urn:sdmx:org.sdmx.infomodel.categoryscheme.[[Category>>doc:sdmx:Glossary 2\.1.Category.WebHome]]=[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]:SUBJECT_MATT ER_DOMAINS(1.0.0-draft).1.2
483 483  
486 +The URN for a Metadata [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] maintained by [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] in the [[MSD>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]] CONTACT_METADATA of semantic [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] 1.0.0 where the [[hierarchy>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]] of the Metadata [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] is CONTACT_DETAILS/CONTACT_NAME would be:
487 +
484 484  urn:[[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]:org.[[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]].infomodel.metadatastructure.MetadataAttribute=[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]: CONTACT_METADATA(1.0.0).CONTACT_DETAILS.CONTACT_NAME
485 485  
486 -The TFFS defines ABC as a sub-Agency of TFFS then the URN of a [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] maintained by ABC and identified as EXTERNAL_DEBT of semantic (% style="color:#e74c3c" %)version(%%) 1.0.0 would be:
490 +The TFFS defines ABC as a sub-Agency of TFFS then the URN of a [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] maintained by ABC and identified as EXTERNAL_DEBT of semantic [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] 1.0.0 would be:
487 487  
488 -urn:[[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]:org.[[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]].infomodel.datastructure.[[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]=TFFS.ABC:EXTERNAL_ DEBT(1.0.0)
492 +urn:sdmx:org.sdmx.infomodel.datastructure.Dataflow=TFFS.ABC:EXTERNAL_ DEBT(1.0.0)
489 489  
490 490  The [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]-RR MUST support this globally unique identification scheme. The [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]-RR MUST be able to create the URN from the individual identification [[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] submitted and to transform the URN to these identification [[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]. The identification [[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] are:
491 491  
492 492  * **Identifiable and [[Nameable Artefacts>>doc:sdmx:Glossary 2\.1.Nameable artefact.WebHome]]**: id (in some cases this id may be hierarchic)
493 -* **[[Maintainable Artefacts>>doc:sdmx:Glossary 2\.1.Maintainable artefact.WebHome]]**: id, (% style="color:#e74c3c" %)version(%%), agencyId
497 +* **[[Maintainable Artefacts>>doc:sdmx:Glossary 2\.1.Maintainable artefact.WebHome]]**: id, [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]], agencyId
494 494  
495 495  The [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]-RR MUST be able to resolve the unique identifier of an [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] [[artefact>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] and to produce an [[SDMX-ML>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]] rendering of that [[artefact>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] if it is located in the Registry.
496 496  
... ... @@ -558,7 +558,7 @@
558 558  |(% style="width:221px" %) |(% style="width:528px" %)HierarchicalCode
559 559  |(% style="width:221px" %) |(% style="width:528px" %)[[Hierarchy>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]]
560 560  |(% style="width:221px" %) |(% style="width:528px" %)HierarchyAssociation
561 -|(% style="width:221px" %) |(% style="width:528px" %)(% style="color:#e74c3c" %)Level
565 +|(% style="width:221px" %) |(% style="width:528px" %)[[Level>>doc:sdmx:Glossary 2\.1.Level.WebHome]]
562 562  |(% style="width:221px" %) |(% style="width:528px" %)ValueList
563 563  |(% style="width:221px" %) |(% style="width:528px" %)
564 564  |(% style="width:221px" %)categoryscheme|(% style="width:528px" %)[[Categorisation>>doc:sdmx:Glossary 2\.1.Categorisation.WebHome]]
... ... @@ -567,7 +567,7 @@
567 567  |(% style="width:221px" %) |(% style="width:528px" %)ReportingCategory
568 568  |(% style="width:221px" %) |(% style="width:528px" %)ReportingTaxonomy
569 569  |(% style="width:221px" %) |(% style="width:528px" %)
570 -|(% style="width:221px" %)conceptscheme|(% style="width:528px" %)(% style="color:#e74c3c" %)Concept
574 +|(% style="width:221px" %)conceptscheme|(% style="width:528px" %)[[Concept>>doc:sdmx:Glossary 2\.1.Concept.WebHome]]
571 571  |(% style="width:221px" %) |(% style="width:528px" %)ConceptScheme
572 572  |(% style="width:221px" %) |(% style="width:528px" %)
573 573  |(% style="width:221px" %)transformation|(% style="width:528px" %)CustomType
... ... @@ -587,7 +587,7 @@
587 587  |(% style="width:221px" %) |(% style="width:528px" %)
588 588  )))
589 589  
590 -**Table 2: [[SDMX-IM>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]] Packages and Contained Classes**
594 +**Table 2: SDMX-IM Packages and Contained Classes**
591 591  
592 592  === 6.2.4 URN Identification components of SDMX objects ===
593 593  
... ... @@ -595,32 +595,32 @@
595 595  
596 596  Note that for brevity the URN examples omit the prefix (classnames in italics indicate maintainable objects, keywords in bold indicate fixed value) All URNs have the prefix:
597 597  
598 -urn:[[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]].org.[[sdmx>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]].infomodel.{package}.{classname}=
602 +urn:sdmx.org.sdmx.infomodel.{package}.{classname}=
599 599  
600 600  (% style="width:1272.83px" %)
601 601  |(% style="width:289px" %)**Classname**|(% style="width:600px" %)**Ending URN pattern**|(% style="width:383px" %)**Example**
602 602  |(% style="width:289px" %)Agency{{footnote}}The object must be linked to a maintenance organisation, i.e., Agency or Metadata Provider.{{/footnote}}|(% style="width:600px" %)agencySchemeAgencyId:**AGENCIES**(**1.0**).agencyId|(% style="width:383px" %)ECB:**AGENCIES**(**1.0**).AA
603 603  |(% style="width:289px" %)//AgencyScheme//|(% style="width:600px" %)agencySchemeAgencyId:**AGENCIES**(**1.0**)|(% style="width:383px" %)ECB:**AGENCIES**(**1.0**)
604 -|(% style="width:289px" %)//[[Categorisation>>doc:sdmx:Glossary 2\.1.Categorisation.WebHome]]//|(% style="width:600px" %)categorisationAgencyId:categoris(% style="color:#000000" %)ationId((% style="color: rgb(0, 0, 0); color: rgb(231, 76, 60)" %)version(% style="color:#000000" %))|(% style="width:383px" %)IMF:cat001(1.0.0)
608 +|(% style="width:289px" %)//[[Categorisation>>doc:sdmx:Glossary 2\.1.Categorisation.WebHome]]//|(% style="width:600px" %)(% style="color:#000000" %)categorisationAgencyId:categorisationId(version)|(% style="width:383px" %)IMF:cat001(1.0.0)
605 605  |(% style="width:289px" %)[[Category>>doc:sdmx:Glossary 2\.1.Category.WebHome]]|(% style="width:600px" %)categorySchemeAgencyId:categorySchemeId(versi on).categoryId.categoryId.categoryId etc.|(% style="width:383px" %)IMF:SDDS(1.0.0):level_1_category.level_2_category …
606 606  |(% style="width:289px" %)//CategoryScheme//|(% style="width:600px" %)categorySchemeAgencyId:categorySchemeId(versi on)|(% style="width:383px" %)IMF:SDDS(1.0.0)
607 607  
608 608  |(% style="width:285px" %)**Classname**|(% style="width:569px" %)**Ending URN pattern**|(% style="width:794px" %)**Example**
609 609  |(% style="width:285px" %)//CategorySchemeMap//|(% style="width:569px" %)(((
610 -(% style="color:#000000" %)catSchemeMapAgencyId:catSchemeMapId((% style="color: rgb(0, 0, 0); color: rgb(231, 76, 60)" %)version(% style="color:#000000" %))
611 -)))|(% style="width:794px" %)[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]:EUROSTAT_SUBJECT_DOMAIN(1.0.0)
612 -|(% style="width:285px" %)[[Code>>doc:sdmx:Glossary 2\.1.Code.WebHome]]|(% style="width:569px" %)(% style="color:#000000" %)codeListAgencyId:codelistId((% style="color: rgb(0, 0, 0); color: rgb(231, 76, 60)" %)version(% style="color:#000000" %)).codeId|(% style="width:794px" %)[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]:CL_FREQ(1.0.0).Q
613 -|(% style="width:285px" %)//[[Codelist>>doc:sdmx:Glossary 2\.1.Code list.WebHome]]//|(% style="width:569px" %)(% style="color:#000000" %)codeListAgencyId:codeListId((% style="color: rgb(0, 0, 0); color: rgb(231, 76, 60)" %)version(% style="color:#000000" %))|(% style="width:794px" %)[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]:CL_FREQ(1.0.0)
614 -|(% style="width:285px" %)ComponentMap|(% style="width:569px" %)(% style="color:#000000" %)structureMapAgencyId:structureMap((% style="color: rgb(0, 0, 0); color: rgb(231, 76, 60)" %)version(% style="color:#000000" %)).com ponentMapId|(% style="width:794px" %)[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]:BOP_STRUCTURES(1.0.0).REF_AREA_TO_COUNT RY
615 -|(% style="width:285px" %)(% style="color:#e74c3c" %)Concept|(% style="width:569px" %)(% style="color:#000000" %)conceptSchemeAgencyId:conceptSchemeId(versio n).conceptId|(% style="width:794px" %)[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]:CROSS_DOMAIN_CONCEPTS(1.0.0).FREQ
616 -|(% style="width:285px" %)//ConceptScheme//|(% style="width:569px" %)(% style="color:#000000" %)conceptSchemeAgencyId:conceptSchemeId(versio n)|(% style="width:794px" %)[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]:CROSS_DOMAIN_CONCEPTS(1.0.0)
614 +(% style="color:#000000" %)catSchemeMapAgencyId:catSchemeMa(%%)pId(version)
615 +)))|(% style="width:794px" %)SDMX:EUROSTAT_SUBJECT_DOMAIN(1.0.0)
616 +|(% style="width:285px" %)[[Code>>doc:sdmx:Glossary 2\.1.Code.WebHome]]|(% style="width:569px" %)(% style="color:#000000" %)codeListAgencyId:codelistId(%%)(version).c(% style="color:#000000" %)odeId|(% style="width:794px" %)SDMX:CL_FREQ(1.0.0).Q
617 +|(% style="width:285px" %)//[[Codelist>>doc:sdmx:Glossary 2\.1.Code list.WebHome]]//|(% style="width:569px" %)(% style="color:#000000" %)codeListAgencyId:codeLis(%%)tId(version)|(% style="width:794px" %)SDMX:CL_FREQ(1.0.0)
618 +|(% style="width:285px" %)ComponentMap|(% style="width:569px" %)(% style="color:#000000" %)structureMapAgencyId:structureM(%%)ap(version).co(% style="color:#000000" %)m ponentMapId|(% style="width:794px" %)SDMX:BOP_STRUCTURES(1.0.0).REF_AREA_TO_COUNT RY
619 +|(% style="width:285px" %)[[Concept>>doc:sdmx:Glossary 2\.1.Concept.WebHome]]|(% style="width:569px" %)(% style="color:#000000" %)conceptSchemeAgencyId:conceptSchemeId(versio n).conceptId|(% style="width:794px" %)SDMX:CROSS_DOMAIN_CONCEPTS(1.0.0).FREQ
620 +|(% style="width:285px" %)//ConceptScheme//|(% style="width:569px" %)(% style="color:#000000" %)conceptSchemeAgencyId:conceptSchemeId(versio n)|(% style="width:794px" %)SDMX:CROSS_DOMAIN_CONCEPTS(1.0.0)
617 617  |(% style="width:285px" %)//ConceptSchemeMap//|(% style="width:569px" %)(((
618 -(% style="color:#000000" %)conceptSchemeMapAgencyId:conceptSchemeMap Id((% style="color: rgb(0, 0, 0); color: rgb(231, 76, 60)" %)version(% style="color:#000000" %))
619 -)))|(% style="width:794px" %)[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]:CONCEPT_MAP(1.0.0)
620 -|(% style="width:285px" %)CustomType|(% style="width:569px" %)(% style="color:#000000" %)customTypeSchemeAgencyId customTypeSchemeId((% style="color: rgb(0, 0, 0); color: rgb(231, 76, 60)" %)version(% style="color:#000000" %)) customTypeId|(% style="width:794px" %)ECB: CUSTOM_TYPE_SCHEME(1.0.0).CUSTOM_TYPE_1
621 -|(% style="width:285px" %)//CustomTypeScheme//|(% style="width:569px" %)(% style="color:#000000" %)customTypeSchemeAgencyId customTypeSchemeId((% style="color: rgb(0, 0, 0); color: rgb(231, 76, 60)" %)version(% style="color:#000000" %))|(% style="width:794px" %)ECB:CUSTOM_TYPE_SCHEME(1.0.0)
622 -|(% style="width:285px" %)DataAttrribute|(% style="width:569px" %)(% style="color:#000000" %)dataStructureDefinitionAgencyId:dataStructureDef initionId((% style="color: rgb(0, 0, 0); color: rgb(231, 76, 60)" %)version(% style="color:#000000" %)).dataAttributeId|(% style="width:794px" %)TFFS:EXT_DEBT(1.0.0).OBS_STATUS
623 -|(% style="width:285px" %)//DataConstraint//|(% style="width:569px" %)(% style="color:#000000" %)dataConstraintAgencyId:dataConstraintId((% style="color: rgb(0, 0, 0); color: rgb(231, 76, 60)" %)version(% style="color:#000000" %))|(% style="width:794px" %)TFFS:CREDITOR_DATA_CONTENT(1.0.0)
622 +(% style="color:#000000" %)conceptSchemeMapAgencyId:conceptSchemeMap Id(version)
623 +)))|(% style="width:794px" %)SDMX:CONCEPT_MAP(1.0.0)
624 +|(% style="width:285px" %)CustomType|(% style="width:569px" %)(% style="color:#000000" %)customTypeSchemeAgencyId customTypeSchemeId(version) customTypeId|(% style="width:794px" %)ECB: CUSTOM_TYPE_SCHEME(1.0.0).CUSTOM_TYPE_1
625 +|(% style="width:285px" %)//CustomTypeScheme//|(% style="width:569px" %)(% style="color:#000000" %)customTypeSchemeAgencyId customTypeSchemeId(version)|(% style="width:794px" %)ECB:CUSTOM_TYPE_SCHEME(1.0.0)
626 +|(% style="width:285px" %)DataAttrribute|(% style="width:569px" %)(% style="color:#000000" %)dataStructureDefinitionAgencyId:dataStructureDef initionId(version).dataAttributeId|(% style="width:794px" %)TFFS:EXT_DEBT(1.0.0).OBS_STATUS
627 +|(% style="width:285px" %)//DataConstraint//|(% style="width:569px" %)(% style="color:#000000" %)dataConstraintAgencyId:dataConstraintId(version)|(% style="width:794px" %)TFFS:CREDITOR_DATA_CONTENT(1.0.0)
624 624  
625 625  |(% style="width:279px" %)**Classname**|(% style="width:563px" %)**Ending URN pattern**|(% style="width:776px" %)**Example**
626 626  |(% style="width:279px" %)DataConsumer|(% style="width:563px" %)dataConsumerSchemeAgencyId:**DATA_CONSUME RS**(**1.0**).dataConsumerId|(% style="width:776px" %)[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]:**DATA_CONSUMERS**(**1.0**).CONSUMER_1
... ... @@ -627,7 +627,7 @@
627 627  |(% style="width:279px" %)//DataConsumerScheme//|(% style="width:563px" %)(((
628 628  dataConsumerSchemeAgencyId:**DATA_CONSUME RS**(**1.0**)
629 629  )))|(% style="width:776px" %)[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]:**DATA_CONSUMERS**(**1.0**)
630 -|(% style="width:279px" %)//[[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]//|(% style="width:563px" %)(% style="color:#000000" %)dataflowAgencyId:dataflowId((% style="color: rgb(0, 0, 0); color: rgb(231, 76, 60)" %)version(% style="color:#000000" %))|(% style="width:776px" %)TFFS:CRED_EXT_DEBT(1.0.0)
634 +|(% style="width:279px" %)//[[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]//|(% style="width:563px" %)(% style="color:#000000" %)dataflowAgencyId:d(%%)ataflowId(version)|(% style="width:776px" %)TFFS:CRED_EXT_DEBT(1.0.0)
631 631  |(% style="width:279px" %)DataProvider|(% style="width:563px" %)(((
632 632  (% style="color:#000000" %)dataProviderSchemeAgencyId:**DATA_PROVIDERS**(**1.0**).dataProviderId
633 633  )))|(% style="width:776px" %)[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]:**DATA_PROVIDERS**(**1.0**).PROVIDER_1
... ... @@ -634,7 +634,7 @@
634 634  |(% style="width:279px" %)//DataProviderScheme//|(% style="width:563px" %)(((
635 635  (% style="color:#000000" %)dataProviderSchemeAgencyId:**DATA_PROVIDERS**(**1.0**)
636 636  )))|(% style="width:776px" %)[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]:**DATA_PROVIDERS**(**1.0**)
637 -|(% style="width:279px" %)//DataStructure//|(% style="width:563px" %)(% style="color:#000000" %)dataStructureDefinitionAgencyId:dataStructureDef initionId((% style="color: rgb(0, 0, 0); color: rgb(231, 76, 60)" %)version(% style="color:#000000" %))|(% style="width:776px" %)TFFS:EXT_DEBT(1.0.0)
641 +|(% style="width:279px" %)//DataStructure//|(% style="width:563px" %)(% style="color:#000000" %)dataStructureDefinitionAgencyId:dataStructureDef initi(%%)onId(version)|(% style="width:776px" %)TFFS:EXT_DEBT(1.0.0)
638 638  |(% style="width:279px" %)[[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]|(% style="width:563px" %)(% style="color:#000000" %)dataStructureDefinitionAgencyId:dataStructureDef initionId((% style="color: rgb(0, 0, 0); color: rgb(231, 76, 60)" %)version(% style="color:#000000" %)).dimensionId|(% style="width:776px" %)TFFS:EXT_DEBT(1.0.0).FREQ
639 639  |(% style="width:279px" %)(((
640 640  DimensionDescriptor
© Semantic R&D Group, 2026