Last modified by Artur on 2025/09/30 13:28
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -163,7 +163,7 @@ 163 163 164 164 The registry interfaces are invoked in one of two ways: 165 165 166 -* 166 +* 167 167 *1. The interface is the name of the root node of the SDMX-ML document 168 168 *1. The interface is invoked as a child element of the RegistryInterface message where the RegistryInterface is the root node of the SDMX-ML document. 169 169 ... ... @@ -263,26 +263,28 @@ 263 263 264 264 Given the above, the behaviour described in the following table concerns either draft Artefacts using semantic versioning or any Artefacts 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 that follows semantic versioning, unless a newer version is introduced according to the semantic versioning rules. Furthermore, even when draft Artefacts are submitted, the registry has to verify semantic versioning is respected against the previous non-draft versions. It is worth noting that the rules for semantic versioning and replacing or maintaining semantically versioned Artefacts applies to externally shared Artefacts. This means that any system may internally perform any change within a version of an Artefact, until the latter is shared outside of that system or becomes public. Then (as also explained in the SDMX Standards Section 6 “Technical Notes”) the Artefacts must adhere to the Semantic Versioning rules. 265 265 266 -(% style="width:982.835px" %) 267 -|(% style="width:217px" %)**Interface**|(% style="width:763px" %)**Behaviour** 268 -|(% style="width:217px" %)All|(% style="width:763px" %)((( 266 +|**Interface**|**Behaviour** 267 +|All|((( 269 269 1. If the action is set to “replace” (or a maintainable Artefact is PUT or POSTed) then the entire contents of the existing maintainable object in the Registry MUST be replaced by the object submitted. 270 270 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. 271 271 1. If the action is set to “delete” (or a maintainable Artefact is DELETEd) then the Registry MUST verify that the object can be deleted. In order to qualify for deletion, the object must: 272 272 273 -a) Be a draft version. 274 -b) Not be explicitly^^[[(% class="wikiinternallink wikiinternallink wikiinternallink" %)^^1^^>>path:#sdfootnote1sym||name="sdfootnote1anc"]](%%)^^ referenced from any other object in the Registry. 272 +1. Be a draft version. 275 275 274 +b) Not be explicitly^^[[(% class="wikiinternallink wikiinternallink" %)^^1^^>>path:#sdfootnote1sym||name="sdfootnote1anc"]](%%)^^ referenced from any other object in the Registry. 275 + 276 276 4) The semantic versioning rules in the SDMX documentation MUST be obeyed. 277 277 ))) 278 -|(% style="width:217px" %)Structure submission|(% style="width:763px" %)((( 279 -Structures are submitted at the level of the Maintainable Artefact and the behaviour in “All” above is therefore at the level of the Maintainable Artefact. 278 +|Structure submission|((( 279 +Structures are submitted at the level of the 280 + 281 +Maintainable Artefact and the behaviour in “All” above is therefore at the level of the Maintainable Artefact. 280 280 ))) 281 -| (% 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 set in the Registration. For a queryable datasource the Registry MAY validate that the source exists and can accept an SDMX data query.283 +|SubmitRegistrationRequest|If the datasource is a file (simple datasource) then the file MAY be retrieved and indexed according to the Boolean attributes set in the Registration. For a queryable datasource the Registry MAY validate that the source exists and can accept an SDMX data query. 282 282 283 -= 6 Identification of SDMX Objects = 285 += {{id name="_Toc90802"/}}6 Identification of SDMX Objects = 284 284 285 -== 6.1 Identification, Versioning, and Maintenance == 287 +=== {{id name="_Toc90803"/}}6.1 Identification, Versioning, and Maintenance === 286 286 287 287 All major classes of the SDMX Information model inherit from one of: 288 288 ... ... @@ -291,7 +291,7 @@ 291 291 * //**VersionableArtefact**// – this has all of the above features plus a version number, according to the SDMX versioning rules in SDMX Standards Section 6 “Technical Notes”, paragraph “4.3 Versioning”, and a validity period. 292 292 * //**MaintainableArtefact**// – this has all of the above features, plus registry and structure URIs, and an association to the maintenance organisation of the object. 293 293 294 -=== 6.1.1 Identification, Naming, Versioning, and Maintenance Model === 296 +===== {{id name="_Toc90804"/}}6.1.1 Identification, Naming, Versioning, and Maintenance Model ===== 295 295 296 296 [[image:SDMX 3.1 Section 5_en_4a9b2cfc.jpg||height="688" width="587"]] 297 297 ... ... @@ -300,11 +300,13 @@ 300 300 The table below shows the identification and related data attributes to be stored in a registry for objects that are one of: 301 301 302 302 * //Annotable// 303 -* //Identifiable// 304 -* //Nameable// 305 -* //Versionable// 306 -* //Maintainable// 307 307 306 +//Identifiable// • //Nameable// 307 + 308 +• //Versionable// 309 + 310 +• //Maintainable// 311 + 308 308 | |(% colspan="2" %)**Object Type**|(% colspan="2" %)**Data Attributes**|(% colspan="2" %)**Status**|(% colspan="2" %)**Data type**|(% colspan="2" %)**Notes** 309 309 | |(% colspan="2" rowspan="4" %)//Annotable//|(% colspan="2" %)AnnotationTitle|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %) 310 310 | |(% colspan="2" %)AnnotationType|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %) ... ... @@ -349,9 +349,9 @@ 349 349 350 350 **Table 1: Common Attributes of Object Types** 351 351 352 -== 6.2 Unique identification of SDMX objects == 356 +=== {{id name="_Toc90805"/}}6.2 Unique identification of SDMX objects === 353 353 354 -=== 6.2.1 Agencies and Metadata Providers === 358 +===== {{id name="_Toc90806"/}}6.2.1 Agencies and Metadata Providers ===== 355 355 356 356 The Maintenance Agency in SDMX is maintained in an Agency Scheme which itself is a sub class of Organisation Scheme – this is shown in the class diagram below. 357 357 ... ... @@ -606,7 +606,7 @@ 606 606 urn:sdmx.org.sdmx.infomodel.{package}.{classname}= 607 607 608 608 |**Classname**|**Ending URN pattern**|**Example** 609 -|Agency^^[[(% class="wikiinternallink wikiinternallink wikiinternallink" %)^^2^^>>path:#sdfootnote2sym||name="sdfootnote2anc"]](%%)^^|agencySchemeAgencyId:**AGENCIES**(**1.0**).agencyId|ECB:**AGENCIES**(**1.0**).AA613 +|Agency^^[[(% class="wikiinternallink wikiinternallink" %)^^2^^>>path:#sdfootnote2sym||name="sdfootnote2anc"]](%%)^^|agencySchemeAgencyId:**AGENCIES**(**1.0**).agencyId|ECB:**AGENCIES**(**1.0**).AA 610 610 |//AgencyScheme//|agencySchemeAgencyId:**AGENCIES**(**1.0**)|ECB:**AGENCIES**(**1.0**) 611 611 |//Categorisation//|categorisationAgencyId:categorisationId(version)|IMF:cat001(1.0.0) 612 612 |Category|categorySchemeAgencyId:categorySchemeId(versi on).categoryId.categoryId.categoryId etc.|IMF:SDDS(1.0.0):level_1_category.level_2_category … ... ... @@ -831,7 +831,7 @@ 831 831 The artefacts included in the structural definitions are: 832 832 833 833 * All types of Item Scheme (Codelist, Concept Scheme, Category Scheme, Organisation Scheme, Agency Scheme, Data Provider Scheme, Metadata Provider Scheme, Data Consumer Scheme, Organisation Unit Scheme, Transformation Scheme, Name Personalisation Scheme, Custom Type Scheme, Vtl Mapping Scheme, Ruleset Scheme, User Defined Operator Scheme) 834 -* All types of Enumerated List (ValueList)^^[[(% class="wikiinternallink wikiinternallink wikiinternallink" %)^^3^^>>path:#sdfootnote3sym||name="sdfootnote3anc"]](%%)^^838 +* All types of Enumerated List (ValueList)^^[[(% class="wikiinternallink wikiinternallink" %)^^3^^>>path:#sdfootnote3sym||name="sdfootnote3anc"]](%%)^^ 835 835 * All types of Structure (Data Structure Definition, Metadata Structure Definition) 836 836 * All types of Structure Usage (Dataflow, Metadataflow) 837 837 ... ... @@ -855,13 +855,13 @@ 855 855 856 856 In addition to the maintenance of the Dataflow and the Metadataflow, the following links must be maintained in the registry: 857 857 858 -1. 862 +1. 859 859 1*. Dataflow to Data Structure Definition 860 860 1*. Metadataflow to Metadata Structure Definition 861 861 862 862 The following links may be created by means of a Categorisation 863 863 864 -1. 868 +1. 865 865 1*. Categorisation to Dataflow and Category 866 866 1*. Categorisation to Metadataflow and Category 867 867 ... ... @@ -1057,7 +1057,7 @@ 1057 1057 1. A validity period which defines both when the subscription becomes active and expires. The subscriber may be sent a notification on expiration of the subscription. 1058 1058 1. A selector which specifies which type of events are of interest. The set of event types is: 1059 1059 1060 -: 1064 +: 1061 1061 :: 1062 1062 1063 1063 (((