Skip to Content
Last modified by Artur on 2025/09/30 13:28
From version 21.2
edited by Helena
on 2025/06/08 16:27
Change comment: There is no comment for this version
To version 19.1
edited by Helena
on 2025/06/08 16:26
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,0 +1,1 @@
1 +1 Introduction
Content
... ... @@ -1,16 +5,15 @@
1 -{{box title="**Contents**"}}
2 -{{toc/}}
3 -{{/box}}
4 -
5 5  **Revision History**
6 6  
7 -(% style="width:824.835px" %)
8 -|(% style="width:184px" %)**Revision**|(% style="width:195px" %)**Date**|(% style="width:442px" %)**Contents**
9 -|(% style="width:184px" %)DRAFT 1.0|(% style="width:195px" %)December 2024|(% style="width:442px" %)Draft release updated for SDMX 3.1 for public consultation
10 -|(% style="width:184px" %)1.0|(% style="width:195px" %)May 2025|(% style="width:442px" %)Public release for SDMX 3.1
3 +:
11 11  
12 -= 1 Introduction =
5 +(((
6 +|**Revision**|**Date**|**Contents**
7 +|DRAFT 1.0|December 2024|Draft release updated for SDMX 3.1 for public consultation
8 +|1.0|May 2025|Public release for SDMX 3.1
9 +)))
13 13  
11 += {{id name="_Toc90780"/}}1 Introduction =
12 +
14 14  The business vision for SDMX envisages the promotion of a “data sharing” model to facilitate low-cost, high-quality statistical data and metadata exchange. Data sharing reduces the reporting burden of organisations by allowing them to publish data once and let their counterparties “pull” data and related metadata as required. The scenario is based on:
15 15  
16 16  * the availability of an abstract information model capable of supporting time series and cross-sectional data, structural metadata, and reference metadata (SDMX-IM)
... ... @@ -272,7 +272,7 @@
272 272  
273 273  1. Be a draft version.
274 274  
275 -b) Not be explicitly^^[[(% class="wikiinternallink wikiinternallink" %)^^1^^>>path:#sdfootnote1sym||name="sdfootnote1anc"]](%%)^^ referenced from any other object in the Registry.
274 +b) Not be explicitly^^[[^^1^^>>path:#sdfootnote1sym||name="sdfootnote1anc"]]^^ referenced from any other object in the Registry.
276 276  
277 277  4) The semantic versioning rules in the SDMX documentation MUST be obeyed.
278 278  )))
... ... @@ -310,47 +310,47 @@
310 310  
311 311  • //Maintainable//
312 312  
313 -| |(% colspan="2" %)**Object Type**|(% colspan="2" %)**Data Attributes**|(% colspan="2" %)**Status**|(% colspan="2" %)**Data type**|(% colspan="2" %)**Notes**
314 -| |(% colspan="2" rowspan="4" %)//Annotable//|(% colspan="2" %)AnnotationTitle|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %)
315 -| |(% colspan="2" %)AnnotationType|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %)
316 -| |(% colspan="2" %)AnnotationURN|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %)
317 -| |(% colspan="2" %)(((
312 +||(% colspan="2" %)**Object Type**|(% colspan="2" %)**Data Attributes**|(% colspan="2" %)**Status**|(% colspan="2" %)**Data type**|(% colspan="2" %)**Notes**
313 +||(% colspan="2" rowspan="4" %)//Annotable//|(% colspan="2" %)AnnotationTitle|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %)
314 +||(% colspan="2" %)AnnotationType|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %)
315 +||(% colspan="2" %)AnnotationURN|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %)
316 +||(% colspan="2" %)(((
318 318  AnnotationText in the form of
319 319  
320 320  InternationalString
321 -)))|(% colspan="2" %)C|(% colspan="2" %) |(% colspan="2" %)This can have languagespecific variants
322 -| |(% colspan="2" rowspan="4" %)//Identifiable//|(% colspan="2" %)All content as for //Annotable// plus|(% colspan="2" %) |(% colspan="2" %) |(% colspan="2" %)
323 -| |(% colspan="2" %)id|(% colspan="2" %)M|(% colspan="2" %)string|(% colspan="2" %)
324 -| |(% colspan="2" %)uri|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %)
325 -| |(% colspan="2" %)urn|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %)Although the urn is computable and therefore may not be submitted or stored physically, the Registry must return the urn for each object, and must be able to service a query on an object referenced solely by its urn.
326 -| |(% colspan="2" rowspan="3" %)//Nameable//|(% colspan="2" %)(((
320 +)))|(% colspan="2" %)C|(% colspan="2" %)|(% colspan="2" %)This can have languagespecific variants
321 +||(% colspan="2" rowspan="4" %)//Identifiable//|(% colspan="2" %)All content as for //Annotable// plus|(% colspan="2" %)|(% colspan="2" %)|(% colspan="2" %)
322 +||(% colspan="2" %)id|(% colspan="2" %)M|(% colspan="2" %)string|(% colspan="2" %)
323 +||(% colspan="2" %)uri|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %)
324 +||(% colspan="2" %)urn|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %)Although the urn is computable and therefore may not be submitted or stored physically, the Registry must return the urn for each object, and must be able to service a query on an object referenced solely by its urn.
325 +||(% colspan="2" rowspan="3" %)//Nameable//|(% colspan="2" %)(((
327 327  All content as for
328 328  
329 329  //Identifiable// plus
330 -)))|(% colspan="2" %) |(% colspan="2" %) |(% colspan="2" %)
331 -| |(% colspan="2" %)(((
329 +)))|(% colspan="2" %)|(% colspan="2" %)|(% colspan="2" %)
330 +||(% colspan="2" %)(((
332 332  Name in the form of
333 333  
334 334  InternationalString
335 335  )))|(% colspan="2" %)M|(% colspan="2" %)string|(% colspan="2" %)This can have language specific variants.
336 -| |(% colspan="2" %)(((
335 +||(% colspan="2" %)(((
337 337  Description in the form of
338 338  
339 339  InternationalString
340 340  )))|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %)This can have language specific variants.
341 -| |(% colspan="2" rowspan="4" %)//Versionable//|(% colspan="2" %)(((
340 +||(% colspan="2" rowspan="4" %)//Versionable//|(% colspan="2" %)(((
342 342  All content as for
343 343  
344 344  //Identifiable// plus
345 -)))|(% colspan="2" %) |(% colspan="2" %) |(% colspan="2" %)
346 -| |(% colspan="2" %)version|(% colspan="2" %)M|(% colspan="2" %)string|(% colspan="2" %)This is the version number according to SDMX versioning rules.
347 -| |(% colspan="2" %)validFrom|(% colspan="2" %)C|(% colspan="2" %)Date/time|(% colspan="2" %)
348 -| |(% colspan="2" %)validTo|(% colspan="2" %)C|(% colspan="2" %)Date/time|(% colspan="2" %)
349 -|(% colspan="2" rowspan="5" %)//Maintainable//|(% colspan="2" %)All content as for //Versionable// plus|(% colspan="2" %) |(% colspan="2" %) |(% colspan="2" %) |
350 -|(% colspan="2" %)isExternalReference|(% colspan="2" %)C|(% colspan="2" %)boolean|(% colspan="2" %)Value of “true” indicates that the actual resource is held outside of this registry. The actual reference is given in the registry URI or the structureURL, each of which must return a valid SDMX-ML file.|
351 -|(% colspan="2" %)serviceURL|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %)The url of the service that can be queried for this resource.|
352 -|(% colspan="2" %)structureURL|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %)The url of the resource.|
353 -|(% 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.|
344 +)))|(% colspan="2" %)|(% colspan="2" %)|(% colspan="2" %)
345 +||(% colspan="2" %)version|(% colspan="2" %)M|(% colspan="2" %)string|(% colspan="2" %)This is the version number according to SDMX versioning rules.
346 +||(% colspan="2" %)validFrom|(% colspan="2" %)C|(% colspan="2" %)Date/time|(% colspan="2" %)
347 +||(% colspan="2" %)validTo|(% colspan="2" %)C|(% colspan="2" %)Date/time|(% colspan="2" %)
348 +|(% colspan="2" rowspan="5" %)//Maintainable//|(% colspan="2" %)All content as for //Versionable// plus|(% colspan="2" %)|(% colspan="2" %)|(% colspan="2" %)|
349 +|(% colspan="2" %)isExternalReference|(% colspan="2" %)C|(% colspan="2" %)boolean|(% colspan="2" %)Value of “true” indicates that the actual resource is held outside of this registry. The actual reference is given in the registry URI or the structureURL, each of which must return a valid SDMX-ML file.|
350 +|(% colspan="2" %)serviceURL|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %)The url of the service that can be queried for this resource.|
351 +|(% colspan="2" %)structureURL|(% colspan="2" %)C|(% colspan="2" %)string|(% colspan="2" %)The url of the resource.|
352 +|(% 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.|
354 354  
355 355  **Table 1: Common Attributes of Object Types**
356 356  
... ... @@ -512,92 +512,92 @@
512 512  
513 513  |**Package**|**URN class name (model class name where this is different)**
514 514  |base|Agency
515 -| |AgencyScheme
516 -| |DataConsumer
517 -| |DataConsumerScheme
518 -| |DataProvider
519 -| |DataProviderScheme
520 -| |MetadataProvider
521 -| |MetadataProviderScheme
522 -| |OrganisationUnit
523 -| |OrganisationUnitScheme
524 -| |
514 +||AgencyScheme
515 +||DataConsumer
516 +||DataConsumerScheme
517 +||DataProvider
518 +||DataProviderScheme
519 +||MetadataProvider
520 +||MetadataProviderScheme
521 +||OrganisationUnit
522 +||OrganisationUnitScheme
523 +||
525 525  |datastructure|AttributeDescriptor
526 -| |DataAttribute
527 -| |Dataflow
528 -| |DataStructure (DataStructureDefinition)
529 -| |Dimension
530 -| |DimensionDescriptor
531 -| |GroupDimensionDescriptor
532 -| |Measure
533 -| |MeasureDescriptor
534 -| |TimeDimension
535 -| |
525 +||DataAttribute
526 +||Dataflow
527 +||DataStructure (DataStructureDefinition)
528 +||Dimension
529 +||DimensionDescriptor
530 +||GroupDimensionDescriptor
531 +||Measure
532 +||MeasureDescriptor
533 +||TimeDimension
534 +||
536 536  |metadatastructure|MetadataAttribute
537 -| |MetadataAttributeDescriptor
538 -| |(((
536 +||MetadataAttributeDescriptor
537 +||(((
539 539  MetadataStructure
540 540  
541 541  (MetadataStructureDefinition)
542 542  )))
543 543  
544 -:
543 +:
545 545  
546 546  (((
547 547  |**Package**|**URN class name (model class name where this is different)**
548 -| |Metadataflow
549 -| |MetadataSet
550 -| |
547 +||Metadataflow
548 +||MetadataSet
549 +||
551 551  |process|Process
552 -| |ProcessStep
553 -| |Transition
554 -| |
551 +||ProcessStep
552 +||Transition
553 +||
555 555  |registry|DataConstraint
556 -| |MetadataConstraint
557 -| |MetadataProvisionAgreement
558 -| |ProvisionAgreement
559 -| |Subscription
560 -| |
555 +||MetadataConstraint
556 +||MetadataProvisionAgreement
557 +||ProvisionAgreement
558 +||Subscription
559 +||
561 561  |structuremapping|CategorySchemeMap
562 -| |ConceptSchemeMap
563 -| |OrganisationSchemeMap
564 -| |ReportingTaxonomyMap
565 -| |RepresentationMap
566 -| |StructureMap
567 -| |
561 +||ConceptSchemeMap
562 +||OrganisationSchemeMap
563 +||ReportingTaxonomyMap
564 +||RepresentationMap
565 +||StructureMap
566 +||
568 568  |codelist|Code
569 -| |Codelist
570 -| |HierarchicalCode
571 -| |Hierarchy
572 -| |HierarchyAssociation
573 -| |Level
574 -| |ValueList
575 -| |
568 +||Codelist
569 +||HierarchicalCode
570 +||Hierarchy
571 +||HierarchyAssociation
572 +||Level
573 +||ValueList
574 +||
576 576  |categoryscheme|Categorisation
577 -| |Category
578 -| |CategoryScheme
579 -| |ReportingCategory
580 -| |ReportingTaxonomy
576 +||Category
577 +||CategoryScheme
578 +||ReportingCategory
579 +||ReportingTaxonomy
581 581  |**Package**|**URN class name (model class name where this is different)**
582 -| |
581 +||
583 583  |conceptscheme|Concept
584 -| |ConceptScheme
585 -| |
583 +||ConceptScheme
584 +||
586 586  |transformation|CustomType
587 -| |CustomTypeScheme
588 -| |NamePersonalisation
589 -| |NamePersonalisationScheme
590 -| |Ruleset
591 -| |RulesetScheme
592 -| |Transformation
593 -| |TransformationScheme
594 -| |UserDefinedOperator
595 -| |UserDefinedOperatorScheme
596 -| |VtlCodelistMapping
597 -| |VtlConceptMapping
598 -| |VtlDataflowMapping
599 -| |VtlMappingScheme
600 -| |
586 +||CustomTypeScheme
587 +||NamePersonalisation
588 +||NamePersonalisationScheme
589 +||Ruleset
590 +||RulesetScheme
591 +||Transformation
592 +||TransformationScheme
593 +||UserDefinedOperator
594 +||UserDefinedOperatorScheme
595 +||VtlCodelistMapping
596 +||VtlConceptMapping
597 +||VtlDataflowMapping
598 +||VtlMappingScheme
599 +||
601 601  )))
602 602  
603 603  **Table 2: SDMX-IM Packages and Contained Classes**
... ... @@ -611,7 +611,7 @@
611 611  urn:sdmx.org.sdmx.infomodel.{package}.{classname}=
612 612  
613 613  |**Classname**|**Ending URN pattern**|**Example**
614 -|Agency^^[[(% class="wikiinternallink wikiinternallink" %)^^2^^>>path:#sdfootnote2sym||name="sdfootnote2anc"]](%%)^^|agencySchemeAgencyId:**AGENCIES**(**1.0**).agencyId|ECB:**AGENCIES**(**1.0**).AA
613 +|Agency^^[[^^2^^>>path:#sdfootnote2sym||name="sdfootnote2anc"]]^^|agencySchemeAgencyId:**AGENCIES**(**1.0**).agencyId|ECB:**AGENCIES**(**1.0**).AA
615 615  |//AgencyScheme//|agencySchemeAgencyId:**AGENCIES**(**1.0**)|ECB:**AGENCIES**(**1.0**)
616 616  |//Categorisation//|categorisationAgencyId:categorisationId(version)|IMF:cat001(1.0.0)
617 617  |Category|categorySchemeAgencyId:categorySchemeId(versi on).categoryId.categoryId.categoryId etc.|IMF:SDDS(1.0.0):level_1_category.level_2_category …
... ... @@ -770,22 +770,22 @@
770 770  The following table lists the Maintainable Artefacts.
771 771  
772 772  |(% colspan="2" %)**Maintainable Artefacts**|**Content**
773 -|**Abstract Class**|**Concrete Class**|
772 +|**Abstract Class**|**Concrete Class**|
774 774  |Item Scheme|Codelist|Code
775 -| |Concept Scheme|Concept
776 -| |Category Scheme|Category
777 -| |Organisation Unit Scheme|Organisation Unit
778 -| |Agency Scheme|Agency
779 -| |Data Provider Scheme|Data Provider
780 -| |Metadata Provider Scheme|Metadata Provider
781 -| |Data Consumer Scheme|Data Consumer
782 -| |Reporting Taxonomy|Reporting Category
783 -| |Transformation Scheme|Transformation
784 -| |Custom Type Scheme|Custom Type
785 -| |Name Personalisation Scheme|Name Personalisation
786 -| |Vtl Mapping Scheme|Vtl Codelist Mapping Vtl Concept Mapping
787 -| |Ruleset Scheme|Ruleset
788 -| |User Defined Operator Scheme|User Defined Operator
774 +||Concept Scheme|Concept
775 +||Category Scheme|Category
776 +||Organisation Unit Scheme|Organisation Unit
777 +||Agency Scheme|Agency
778 +||Data Provider Scheme|Data Provider
779 +||Metadata Provider Scheme|Metadata Provider
780 +||Data Consumer Scheme|Data Consumer
781 +||Reporting Taxonomy|Reporting Category
782 +||Transformation Scheme|Transformation
783 +||Custom Type Scheme|Custom Type
784 +||Name Personalisation Scheme|Name Personalisation
785 +||Vtl Mapping Scheme|Vtl Codelist Mapping Vtl Concept Mapping
786 +||Ruleset Scheme|Ruleset
787 +||User Defined Operator Scheme|User Defined Operator
789 789  |Enumerated List|ValueList|Value Item
790 790  |Structure|Data Structure Definition|(((
791 791  Dimension Descriptor
... ... @@ -804,9 +804,9 @@
804 804  
805 805  Measure
806 806  )))
807 -| |Metadata Structure Definition|Metadata Attribute Descriptor Metadata Attribute
808 -|Structure Usage|Dataflow|
809 -| |Metadataflow|
806 +||Metadata Structure Definition|Metadata Attribute Descriptor Metadata Attribute
807 +|Structure Usage|Dataflow|
808 +||Metadataflow|
810 810  |None|Process|Process Step
811 811  |None|Structure Map|(((
812 812  Component Map
... ... @@ -817,16 +817,16 @@
817 817  )))
818 818  |None|Representation Map|Representation Mapping
819 819  |Item Scheme Map|Organisation Scheme Map|Item Map
820 -| |Concept Scheme Map|Item Map
821 -| |Category Scheme Map|Item Map
822 -| |Reporting Taxonomy Map|Item Map
823 -|None|Provision Agreement|
824 -|None|Metadata Provision Agreement|
819 +||Concept Scheme Map|Item Map
820 +||Category Scheme Map|Item Map
821 +||Reporting Taxonomy Map|Item Map
822 +|None|Provision Agreement|
823 +|None|Metadata Provision Agreement|
825 825  |None|Hierarchy|Hierarchical Code
826 -|None|Hierarchy Association|
827 -|None|Categorisation|
825 +|None|Hierarchy Association|
826 +|None|Categorisation|
828 828  |Constraint|Data Constraint|DataKeySet
829 -| | |CubeRegion
828 +|||CubeRegion
830 830  |Constraint|Metadata Constraint|MetadataTargetRegion
831 831  
832 832  **Table 4: Table of Maintainable Artefacts for Structural Definition Metadata**
... ... @@ -836,7 +836,7 @@
836 836  The artefacts included in the structural definitions are:
837 837  
838 838  * 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)
839 -* All types of Enumerated List (ValueList)^^[[(% class="wikiinternallink wikiinternallink" %)^^3^^>>path:#sdfootnote3sym||name="sdfootnote3anc"]](%%)^^
838 +* All types of Enumerated List (ValueList)^^[[^^3^^>>path:#sdfootnote3sym||name="sdfootnote3anc"]]^^
840 840  * All types of Structure (Data Structure Definition, Metadata Structure Definition)
841 841  * All types of Structure Usage (Dataflow, Metadataflow)
842 842  
... ... @@ -972,7 +972,7 @@
972 972  
973 973  The Registration has an action attribute which takes one of the following values:
974 974  
975 -:
974 +:
976 976  
977 977  (((
978 978  |**Action Attribute Value**|**Behaviour**
... ... @@ -997,7 +997,7 @@
997 997  
998 998  https:~/~/github.com/sdmx-twg/sdmx-rest/blob/master/doc/availability.md
999 999  
1000 -:
999 +:
1001 1001  
1002 1002  (((
1003 1003  |**Indexing Required**|**Registration Process Activity**
... ... @@ -1020,7 +1020,7 @@
1020 1020  Components of the Constraints model in the
1021 1021  )))
1022 1022  |**Indexing Required**|**Registration Process Activity**
1023 -| |SDMX-IM. Note that the content is not stored in the Selection Value.
1022 +||SDMX-IM. Note that the content is not stored in the Selection Value.
1024 1024  )))
1025 1025  
1026 1026  Constraints that specify the contents of a //QueryDatasource// are submitted to the Registry via the structure submission service (i.e., the RESTful API).
... ... @@ -1063,7 +1063,7 @@
1063 1063  1. A selector which specifies which type of events are of interest. The set of event types is:
1064 1064  
1065 1065  :
1066 -::
1065 +::
1067 1067  
1068 1068  (((
1069 1069  |**Event Type**|**Comment**
... ... @@ -1137,7 +1137,7 @@
1137 1137  
1138 1138  Whenever a dataset or metadata-set is registered a registration event is created. A subscription may be observing all data or metadata registrations, or it may focus on specific registrations as shown in the table below:
1139 1139  
1140 -:
1139 +:
1141 1141  
1142 1142  (((
1143 1143  |**Selector**|**Comment**
SDMX 3.1 Section 5_en_b08fd1a2.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -xwiki:XWiki.helena
Size
... ... @@ -1,1 +1,0 @@
1 -46.3 KB
Content
SDMX 3.1 Section 5_en_c63d10ab.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -xwiki:XWiki.helena
Size
... ... @@ -1,1 +1,0 @@
1 -101.3 KB
Content