Changes for page SDMX 3.1 Standards. Section 1. Framework
Last modified by Helena K. on 2026/06/08 15:16
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Tags
-
... ... @@ -1,0 +1,1 @@ 1 +Adjustment|Artefact|Attribute|Bilateral exchange|Categorisation|Category|Category Scheme|Code|Codelist|Comment|Component|Concept|Concept Scheme|Constraint|Coverage|Cross-domain Concept|Currency|Data Consumer|Data Provider|Data Set|Data Source|Data Structure Definition|Data exchange|Dataflow|Dimension|Frequency of observation|Global Registry|Hierarchical Codelist|Hierarchy|Incremental update|Item Scheme|Language|Maintenance agency|Map|Measure|Metadata Set|Metadata Structure Definition|Metadata repository|Metadataflow|Notification|Provision Agreement|Reference metadata|Release policy - release calendar|Reporting Taxonomy|Representation|SDMX Information Model|SDMX Registry|SDMX Technical Specification|SDMX-CSV|SDMX-EDI|SDMX-JSON|SDMX-ML|Series|Statistical Data and Metadata eXchange|Statistical classification|Statistical subject-matter domain|Statistical unit|Structural metadata|Subscription|Timeliness|Validation and Transformation Language|Version - Content
-
... ... @@ -10,13 +10,13 @@ 10 10 11 11 = 1 Introduction = 12 12 13 -The [[Statistical Data and Metadata Exchange>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] ([[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]) initiative (https:~/~/www.sdmx.org) sets standards that can facilitate the exchange of statistical data and metadata using modern information technology. 13 +The [[Statistical Data and Metadata Exchange>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] ([[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]) initiative ([[https:~~/~~/www.sdmx.org>>https://https:www.sdmx.org||rel="noopener noreferrer" target="_blank"]]) sets standards that can facilitate the exchange of statistical data and metadata using modern information technology. 14 14 15 15 The [[SDMX Technical Specifications>>doc:sdmx:Glossary 2\.1.SDMX Technical Specification.WebHome]] are organised into several discrete sections. 16 16 17 -The following are published on the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] website ([[__https:~~/~~/www.sdmx.org__>>https://https:www.sdmx.org]]): 17 +The following are published on the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] website ([[__https:~~/~~/www.sdmx.org__>>https://https:www.sdmx.org||rel="noopener noreferrer" target="_blank"]]): 18 18 19 -**Section 1** **Framework for SDMX Technical Standards** – this document providing an introduction to the technical standards. 19 +**Section 1** **Framework for [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Technical Standards** – this document providing an introduction to the technical standards. 20 20 21 21 **Section 2** **SDMX Information Model** - the [[SDMX information model>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]] is a standardised object model for modelling [[statistical domains>>doc:sdmx:Glossary 2\.1.Statistical subject-matter domain.WebHome]] centring on the structure of their data and [[metadata sets>>doc:sdmx:Glossary 2\.1.Metadata set.WebHome]], the coding schemes used for [[classification>>doc:sdmx:Glossary 2\.1.Statistical Classification.WebHome]], and the rules for controlling the exchange of data and metadata between organisations. This document provides a UML specification with supporting narrative. 22 22 ... ... @@ -24,7 +24,7 @@ 24 24 25 25 **Section 6** **SDMX Technical Notes** – detailed technical guidance for implementors of the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] standard. 26 26 27 -The following are published on the GitHub repository of the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Standards Technical Working Group ([[__https:~~/~~/github.com/sdmx-twg__>>https://https:github.comsdmx-twg]]): sdmx-twg/sdmx-rest – REST API 27 +The following are published on the GitHub repository of the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Standards Technical Working Group ([[__https:~~/~~/github.com/sdmx-twg__>>https://https:github.comsdmx-twg||rel="noopener noreferrer" target="_blank"]]): sdmx-twg/sdmx-rest – REST API 28 28 29 29 Technical specifications for the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] RESTful web services application programming interfaces (API). 30 30 ... ... @@ -42,9 +42,9 @@ 42 42 43 43 The following sections are obsolete: 44 44 45 -Section 3 - SDMX-ML - replaced by the sdmx-twg/sdmx-ml GitHub repository 45 +Section 3 - [[SDMX-ML>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]] - replaced by the sdmx-twg/sdmx-ml GitHub repository 46 46 47 -Section 4 - SDMX-EDI 47 +Section 4 - [[SDMX-EDI>>doc:sdmx:Glossary 2\.1.SDMX-EDI.WebHome]] 48 48 49 49 Section 7 - API - replaced by the sdmx-twg/sdmx-rest GitHub repository [[VTL>>doc:sdmx:Glossary 2\.1.Validation and transformation language.WebHome]] 50 50 ... ... @@ -62,10 +62,9 @@ 62 62 63 63 == 2.1 Major Changes from 1.0 to 2.0 == 64 64 65 -* 66 66 * **[[Reference Metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]]**: In addition to describing and specifying data structures and formats (along with related [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]]), the version 2.0 specification also provides for the exchange of metadata which is distinct from the [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] in the 1.0 version. This [[category>>doc:sdmx:Glossary 2\.1.Category.WebHome]] includes “reference” metadata (regarding data quality, methodology, and similar types – it can be configured by the user to include whatever concepts require reporting); metadata related to data provisioning ([[release calendar>>doc:sdmx:Glossary 2\.1.Release policy - release calendar.WebHome]] information, description of the data and metadata provided, etc.); and metadata relevant to the exchange of categorization schemes. 67 67 * **[[SDMX Registry>>doc:sdmx:Glossary 2\.1.SDMX Registry.WebHome]]**: Provision is made in the 2.0 standard for standard communication with registry services, to support a data-sharing model of statistical exchange. These services include registration of data and metadata, querying of registered data and metadata, and [[subscription>>doc:sdmx:Glossary 2\.1.Subscription.WebHome]]/[[notification>>doc:sdmx:Glossary 2\.1.Notification.WebHome]]. 68 -* **[[Structural Metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]]**: The support for exchange of statistical data and related [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] has been expanded. Some support is provided for qualitative data; data cube structures are described; [[hierarchical code>>doc:sdmx:Glossary 2\.1.Hierarchical code.WebHome]] listsare supported; relationships between data structures can be expressed, providing support for extensibility of data structures; and the description of functional dependencies within cubes are supported.67 +** **[[Structural Metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]]**: The support for exchange of statistical data and related [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] has been expanded. Some support is provided for qualitative data; data cube structures are described; [[hierarchical code lists>>doc:sdmx:Glossary 2\.1.Hierarchical code list.WebHome]] are supported; relationships between data structures can be expressed, providing support for extensibility of data structures; and the description of functional dependencies within cubes are supported. 69 69 70 70 == 2.2 Major Changes from 2.0 to 2.1 == 71 71 ... ... @@ -76,14 +76,13 @@ 76 76 * **Optimization for XML Technologies:** Implementation has shown that it is possible to better organize the XML schemas for use within common technology development tools which work with XML. These changes are primarily focused on leveraging the objectoriented features of W3C XML Schema to allow for easier processing of [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] data and metadata. 77 77 * **Consistency between the [[SDMX-ML>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]] and the [[SDMX Information Model>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]: **Certain aspects of the XML schemas and UML model have been more closely aligned, to allow for easier comprehension of the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] model. 78 78 * **Technical Bugs:** Some minor technical bugs have been identified in the registry interfaces and elsewhere. These bugs have been addressed. 79 -* **Support for Non-Time- [[Series>>doc:sdmx:Glossary2\.1.Series.WebHome]]Data in the Generic Format: **One area which has been extended is the ability to express non-time-[[series>>doc:sdmx:Glossary 2\.1.Series.WebHome]] data as part of the generic data message.78 +* **Support for Non-Time-Series Data in the Generic Format: **One area which has been extended is the ability to express non-time-[[series>>doc:sdmx:Glossary 2\.1.Series.WebHome]] data as part of the generic data message. 80 80 * **Simplification of the [[data structure definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] - specific message types: **Both [[time series>>doc:sdmx:Glossary 2\.1.Series.WebHome]] (version 2.0 Compact) and non-[[time series>>doc:sdmx:Glossary 2\.1.Series.WebHome]] [[data sets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] (version 2.0 Cross Sectional) use the same underlying structure for a structure-specific formatted message, which is specific to the [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] of the [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]. 81 81 * **Simplification and better support for the metadata structure: **New use cases have been reported and these are now supported by a re-modelled [[metadata structure definition>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]]. 82 -* **Support for partial [[item schemes>>doc:sdmx:Glossary 2\.1.Item scheme.WebHome]] such as a [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] list: **The concept of a partial (subset) [[item scheme>>doc:sdmx:Glossary 2\.1.Item scheme.WebHome]] such as a partial [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]]listfor use in exchange scenarios has been introduced**.**81 +* **Support for partial [[item schemes>>doc:sdmx:Glossary 2\.1.Item scheme.WebHome]] such as a [[code list>>doc:sdmx:Glossary 2\.1.Code list.WebHome]]: **The concept of a partial (subset) [[item scheme>>doc:sdmx:Glossary 2\.1.Item scheme.WebHome]] such as a partial [[code list>>doc:sdmx:Glossary 2\.1.Code list.WebHome]] for use in exchange scenarios has been introduced**.** 83 83 84 84 == 2.3 Major Changes from 2.1 to 3.0 == 85 85 86 - 87 87 [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] version 3.0 introduces new features, improvements and changes to the Standard in the following key areas: 88 88 89 89 (% class="wikigeneratedid" id="HInformationModel" %) ... ... @@ -92,15 +92,15 @@ 92 92 * Simplification and improvement of the [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] model 93 93 * Support for microdata 94 94 * Support for geospatial data 95 -* Support for [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] listextension and discriminated union of [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]]lists93 +* Support for [[code list>>doc:sdmx:Glossary 2\.1.Code list.WebHome]] extension and discriminated union of [[code lists>>doc:sdmx:Glossary 2\.1.Code list.WebHome]] 96 96 * Improvements to structure mapping 97 97 * Improvements to [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] [[hierarchies>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]] for data discovery 98 -* Improvements to constraints 96 +* Improvements to [[constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] 99 99 100 100 (% class="wikigeneratedid" id="HVersioningofStructuralMetadataArtefacts" %) 101 101 **Versioning of Structural Metadata Artefacts** 102 102 103 -Adoption of the three-number semantic versioning standard for [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] [[artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] ([[__https:~~/~~/semver.org__>>https://https:semver.org]]) 101 +Adoption of the three-number semantic versioning standard for [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] [[artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] ([[__https:~~/~~/semver.org__>>https://https:semver.org||rel="noopener noreferrer" target="_blank"]]) 104 104 105 105 (% class="wikigeneratedid" id="HRESTWebServicesApplicationProgrammingInterface28API29" %) 106 106 **REST Web Services Application Programming Interface (API)** ... ... @@ -139,27 +139,26 @@ 139 139 (% class="wikigeneratedid" id="HInformationModel-1" %) 140 140 **Information Model** 141 141 142 -* Addition of [[Dimension>>doc:sdmx:Glossary2\.1.Dimension.WebHome]] (% style="color:#e74c3c" %)Constraint(%%)property to a[[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]143 -* Addition of evolving structure property to a [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]144 -* Remove (% style="color:#e74c3c" %)version(%%) property on[[Categorisation>>doc:sdmx:Glossary 2\.1.Categorisation.WebHome]]145 -* Simplification of (% style="color:#e74c3c" %)Constraints146 -** Removal of Advanced [[Release Calendar>>doc:sdmx:Glossary 2\.1.Release policy - release calendar.WebHome]]147 -** Removal of Role, Data (% style="color:#e74c3c" %)Constraints(%%)only restrict data that can be reported148 -** Restrict (%style="color:#e74c3c"%)constraint(%%)targets to Identifiable structures (not URLs)149 -** Addition of Availability (% style="color:#e74c3c" %)Constraint(%%)to define actual data140 +* Addition of Dimension Constraint property to a Dataflow 141 +* Addition of evolving structure property to a Data Structure Definition 142 +* Remove [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] property on Categorisation 143 +* Simplification of Constraints 144 +** Removal of Advanced Release Calendar 145 +** Removal of Role, Data Constraints only restrict data that can be reported 146 +** Restrict [[constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] targets to Identifiable structures (not URLs) 147 +** Addition of Availability Constraint to define actual data 150 150 151 151 (% class="wikigeneratedid" id="HDocumentation" %) 152 152 **Documentation** 153 153 154 -* Registering [[Reference Metadata>>doc:sdmx:Glossary2\.1.Referencemetadata.WebHome]] removed from documentation, to align with XML Registration object which is unable to reference a Metadata Provision, and REST API which is unable to query for registered[[reference metadata>>doc:sdmx:Glossary2\.1.Reference metadata.WebHome]]sources.152 +* Registering Reference Metadata removed from documentation, to align with XML Registration object which is unable to reference a Metadata Provision, and REST API which is unable to query for registered reference metadata sources. 155 155 156 -The [[SDMX>>doc:sdmx:Glossary2\.1.Statistical data andmetadata exchange.WebHome]] standards specified here are designed to support the requirements of all of these automation processes and technologies.154 +The SDMX standards specified here are designed to support the requirements of all of these automation processes and technologies. 157 157 158 158 = 3 Processes and Business Scope = 159 159 160 160 == 3.1 Process Patterns == 161 161 162 - 163 163 [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] identifies three basic process patterns regarding the exchange of statistical data and metadata. These can be described as follows: 164 164 165 165 1. //**[[Bilateral exchange>>doc:sdmx:Glossary 2\.1.Bilateral exchange.WebHome]]**~:// All aspects of the exchange process are agreed between counterparties, including the mechanism for exchange of data and metadata, the formats, the frequency or schedule, and the mode used for communications regarding the exchange. This is perhaps the most common process pattern. ... ... @@ -233,12 +233,11 @@ 233 233 234 234 * //**[[Data Set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]:**// Data is organized into discrete sets, which include particular observations for a specific period of time. A [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] can be understood as a collection of similar data, sharing a structure, which covers a fixed period of time. 235 235 * //**[[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] ([[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]], also known as Key Family in (% style="color:#e74c3c" %)Version(%%) 2.0): **//Each [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] has a set of [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]]. These descriptions are referred to in [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] as [[Data Structure Definitions>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]], which include information about how (% style="color:#e74c3c" %)concepts(%%) are associated with the [[measures>>doc:sdmx:Glossary 2\.1.Measure.WebHome]], [[dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]], and [[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] of a data “cube,” along with information about the [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] of data and related identifying and descriptive (structural) metadata. In (% style="color:#e74c3c" %)Version(%%) 2.1, the term "Key Family" was replaced by "[[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]" ([[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]) both in XML Schemas and the Information Model. The [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] has been modified in (% style="color:#e74c3c" %)version(%%) 3.0 to better support microdata by providing the option to define multiple [[measures>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] and for [[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] and [[measures>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] to take arrays of values. An optional reference to a [[Metadata Structure Definition>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]] has also been added for describing the [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] associated with the data. When reported, these [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] are included as part of the [[dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]. 236 -* //**[[Code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] list:**// [[Code>>doc:sdmx:Glossary 2\.1.Code.WebHome]]listsenumerate a set of [[codes>>doc:sdmx:Glossary 2\.1.Code.WebHome]] to be used in the [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] of [[dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]], [[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]], and other structural parts of [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]. [[Codes>>doc:sdmx:Glossary 2\.1.Code.WebHome]] can be organised into simple [[hierarchies>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]] within a [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]]list, and more complex [[hierarchies>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]] potentially involving multiple [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]]listsusing [[hierarchy>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]] and [[hierarchy>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]] association structures.237 -* //**Value list:**// Value lists introduced in (% style="color:#e74c3c" %)version(%%) 3.0 are similar to [[codelists>>doc:sdmx:Glossary 2\.1.Code list.WebHome]] with the exception that the items do not need to conform to the usual [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] rules for identifiable objects. That allows the values to include characters such as [[currency>>doc:sdmx:Glossary 2\.1.Currency.WebHome]] symbols (e.g. ¥) which would otherwise make illegal [[codes>>doc:sdmx:Glossary 2\.1.Code.WebHome]]. However, unlike [[codes>>doc:sdmx:Glossary 2\.1.Code.WebHome]], values are not individually identifiable. Value lists find application in (% style="color:#e74c3c" %)concepts(%%) and [[data structures definitions>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] for less structured data and microdata enumerations and can be (% style="color:#e74c3c" %)mapped(%%) to other value or [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] listsusing [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] (% style="color:#e74c3c" %)maps(%%).233 +* //**[[Code list>>doc:sdmx:Glossary 2\.1.Code list.WebHome]]:**// [[Code lists>>doc:sdmx:Glossary 2\.1.Code list.WebHome]] enumerate a set of [[codes>>doc:sdmx:Glossary 2\.1.Code.WebHome]] to be used in the [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] of [[dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]], [[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]], and other structural parts of [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]. [[Codes>>doc:sdmx:Glossary 2\.1.Code.WebHome]] can be organised into simple [[hierarchies>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]] within a [[code list>>doc:sdmx:Glossary 2\.1.Code list.WebHome]], and more complex [[hierarchies>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]] potentially involving multiple [[code lists>>doc:sdmx:Glossary 2\.1.Code list.WebHome]] using [[hierarchy>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]] and [[hierarchy>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]] association structures. 234 +* //**Value list:**// Value lists introduced in (% style="color:#e74c3c" %)version(%%) 3.0 are similar to [[codelists>>doc:sdmx:Glossary 2\.1.Code list.WebHome]] with the exception that the items do not need to conform to the usual [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] rules for identifiable objects. That allows the values to include characters such as [[currency>>doc:sdmx:Glossary 2\.1.Currency.WebHome]] symbols (e.g. ¥) which would otherwise make illegal [[codes>>doc:sdmx:Glossary 2\.1.Code.WebHome]]. However, unlike [[codes>>doc:sdmx:Glossary 2\.1.Code.WebHome]], values are not individually identifiable. Value lists find application in (% style="color:#e74c3c" %)concepts(%%) and [[data structures definitions>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] for less structured data and microdata enumerations and can be (% style="color:#e74c3c" %)mapped(%%) to other value or [[code lists>>doc:sdmx:Glossary 2\.1.Code list.WebHome]] using [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] (% style="color:#e74c3c" %)maps(%%). 238 238 * //**Organisation Scheme:**// Organisations and organisation structure can be defined in an Organisation Scheme. Specific Organisation Schemes exist for [[Maintenance Agency>>doc:sdmx:Glossary 2\.1.Maintenance agency.WebHome]], [[Data Provider>>doc:sdmx:Glossary 2\.1.Data provider.WebHome]], Metadata Provider, [[Data Consumer>>doc:sdmx:Glossary 2\.1.Data consumer.WebHome]], and Organisation [[Unit>>doc:sdmx:Glossary 2\.1.Statistical unit.WebHome]]. 239 239 * //**[[Category Scheme>>doc:sdmx:Glossary 2\.1.Category scheme.WebHome]] and [[Categorisation>>doc:sdmx:Glossary 2\.1.Categorisation.WebHome]]:**// [[Category schemes>>doc:sdmx:Glossary 2\.1.Category scheme.WebHome]] are made up of a [[hierarchy>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]] of [[categories>>doc:sdmx:Glossary 2\.1.Category.WebHome]], which in [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] may include any type of useful [[classification>>doc:sdmx:Glossary 2\.1.Statistical Classification.WebHome]] for the organization of data and metadata. A [[Categorisation>>doc:sdmx:Glossary 2\.1.Categorisation.WebHome]] links a [[category>>doc:sdmx:Glossary 2\.1.Category.WebHome]] to an identifiable object. In this way sets of objects can be categorised. A statistical subjectmatter domain scheme is implemented in [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] as a [[Category Scheme>>doc:sdmx:Glossary 2\.1.Category scheme.WebHome]]. 240 -* //**[[Concept Scheme>>doc:sdmx:Glossary 2\.1.Concept scheme.WebHome]]:**// A [[concept scheme>>doc:sdmx:Glossary 2\.1.Concept scheme.WebHome]] is a maintained list of (% style="color:#e74c3c" %)concepts(%%) that are used in [[data structure definitions>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] and [[metadata structure definitions>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]]. There can be many such [[concept schemes>>doc:sdmx:Glossary 2\.1.Concept scheme.WebHome]]. A “core” [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] of the (% style="color:#e74c3c" %)concept(%%) can be specified (e.g. a core [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] list, or other [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] such as “date”). Note that this core [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] can be overridden in the [[data structure definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] or [[metadata structure definition>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]] that uses the (% style="color:#e74c3c" %)concept(%%). Indeed, organisations wishing to remain with (% style="color:#e74c3c" %)version(%%) 1.0 key family schema specifications will continue to declare the [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] in the key family definition. 241 -* 237 +* //**[[Concept Scheme>>doc:sdmx:Glossary 2\.1.Concept scheme.WebHome]]:**// A [[concept scheme>>doc:sdmx:Glossary 2\.1.Concept scheme.WebHome]] is a maintained list of (% style="color:#e74c3c" %)concepts(%%) that are used in [[data structure definitions>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] and [[metadata structure definitions>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]]. There can be many such [[concept schemes>>doc:sdmx:Glossary 2\.1.Concept scheme.WebHome]]. A “core” [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] of the (% style="color:#e74c3c" %)concept(%%) can be specified (e.g. a core [[code list>>doc:sdmx:Glossary 2\.1.Code list.WebHome]], or other [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] such as “date”). Note that this core [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] can be overridden in the [[data structure definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] or [[metadata structure definition>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]] that uses the (% style="color:#e74c3c" %)concept(%%). Indeed, organisations wishing to remain with (% style="color:#e74c3c" %)version(%%) 1.0 key family schema specifications will continue to declare the [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] in the key family definition. 242 242 * //**[[Metadata Set>>doc:sdmx:Glossary 2\.1.Metadata set.WebHome]]:**// A [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] set is a set of information pertaining to an object within the formal [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] view of statistical exchange: they may describe the maintainers of data or structural definitions; they may describe the schedule on which data is released; they may describe the flow of a single type of data over time; they may describe the quality of data, etc. In [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]], the creators of [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] may take whatever (% style="color:#e74c3c" %)concepts(%%) they are concerned with, or obliged to report, and provide a [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] set containing that information. 243 243 * //**[[Metadata Structure Definition>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]]:**// A [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] set also has a set of [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] which describes how it is organized. This [[metadata set>>doc:sdmx:Glossary 2\.1.Metadata set.WebHome]] identifies what [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] (% style="color:#e74c3c" %)concepts(%%) are being reported, how these (% style="color:#e74c3c" %)concepts(%%) relate to each other (typically as [[hierarchies>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]]), what their presentational structure is, how they may be represented (as free text, as coded values, etc.), and with which formal [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] object types they are associated. 244 244 * //**[[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] Definition:**// In [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]], [[data sets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] are reported or disseminated according to a [[data flow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] definition. The [[data flow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] definition identifies the [[data structure definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] and may be associated with one or more subject matter domains via a [[Categorisation>>doc:sdmx:Glossary 2\.1.Categorisation.WebHome]] (this facilitates the search for data according to organised [[category schemes>>doc:sdmx:Glossary 2\.1.Category scheme.WebHome]]). (% style="color:#e74c3c" %)Constraints(%%), in terms of reporting [[periodicity>>doc:sdmx:Glossary 2\.1.Frequency of observation.WebHome]] or sub set of possible keys that are allowed in a [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]], may be attached to the [[data flow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] definition. ... ... @@ -250,11 +250,11 @@ 250 250 * //**Metadata (% style="color:#e74c3c" %)Constraint(%%):**// Used to restrict content (such as enumerations) and are used by metadata [[provision agreements>>doc:sdmx:Glossary 2\.1.Provision agreement.WebHome]], [[metadata flows>>doc:sdmx:Glossary 2\.1.Metadataflow.WebHome]], [[metadata structure definitions>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]] in order to provide a set of reporting restrictions in the context of a collection 251 251 * //**Available Data (% style="color:#e74c3c" %)Constraint(%%):**// Used to report the set of [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] values that have data reported against them in the context of a Data Query. This structure allows a user to know what valid filters can be applied to a cube of data, such that the resulting cube will contain data. 252 252 * //**Structure (% style="color:#e74c3c" %)Map(%%): **//Structure (% style="color:#e74c3c" %)maps(%%) describes a mapping between [[data structure definitions>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] or [[dataflows>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] for the purpose of transforming a [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] into a different structure. The mapping rules are defined using one or more [[component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] (% style="color:#e74c3c" %)maps(%%) which each (% style="color:#e74c3c" %)map(%%) in turn describes how one or more [[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]] from the source [[data structure definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] (% style="color:#e74c3c" %)map(%%) to one or more [[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]] in that of the target. Represent (% style="color:#e74c3c" %)maps(%%) act as lookup tables and specific provision is made for mapping dates and times. 253 -* //**[[Representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] (% style="color:#e74c3c" %)Map(%%):**// [[Representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] (% style="color:#e74c3c" %)maps(%%) describe mappings between source value(s) and target value(s) where the values are restricted to those in a [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] list, value list or be of a certain type such as integer or string.254 -* //**[[Item Scheme>>doc:sdmx:Glossary 2\.1.Item scheme.WebHome]] (% style="color:#e74c3c" %)Map(%%):**// An [[item scheme>>doc:sdmx:Glossary 2\.1.Item scheme.WebHome]] (% style="color:#e74c3c" %)map(%%) describes mapping rules between any [[item scheme>>doc:sdmx:Glossary 2\.1.Item scheme.WebHome]] with the exception of [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] listsand value lists which use [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] (% style="color:#e74c3c" %)maps(%%). The (% style="color:#e74c3c" %)version(%%) 3.0 information model provides four [[item scheme>>doc:sdmx:Glossary 2\.1.Item scheme.WebHome]] (% style="color:#e74c3c" %)maps(%%): organisation scheme (% style="color:#e74c3c" %)map(%%), [[concept scheme>>doc:sdmx:Glossary 2\.1.Concept scheme.WebHome]] (% style="color:#e74c3c" %)map(%%), [[category scheme>>doc:sdmx:Glossary 2\.1.Category scheme.WebHome]] (% style="color:#e74c3c" %)map(%%) and [[reporting taxonomy>>doc:sdmx:Glossary 2\.1.Reporting taxonomy.WebHome]] (% style="color:#e74c3c" %)map(%%). Organisation scheme (% style="color:#e74c3c" %)map(%%) and reporting scheme (% style="color:#e74c3c" %)map(%%) have been omitted from the information model schematic in Figure 1.249 +* //**[[Representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] (% style="color:#e74c3c" %)Map(%%):**// [[Representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] (% style="color:#e74c3c" %)maps(%%) describe mappings between source value(s) and target value(s) where the values are restricted to those in a [[code list>>doc:sdmx:Glossary 2\.1.Code list.WebHome]], value list or be of a certain type such as integer or string. 250 +* //**[[Item Scheme>>doc:sdmx:Glossary 2\.1.Item scheme.WebHome]] (% style="color:#e74c3c" %)Map(%%):**// An [[item scheme>>doc:sdmx:Glossary 2\.1.Item scheme.WebHome]] (% style="color:#e74c3c" %)map(%%) describes mapping rules between any [[item scheme>>doc:sdmx:Glossary 2\.1.Item scheme.WebHome]] with the exception of [[code lists>>doc:sdmx:Glossary 2\.1.Code list.WebHome]] and value lists which use [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] (% style="color:#e74c3c" %)maps(%%). The (% style="color:#e74c3c" %)version(%%) 3.0 information model provides four [[item scheme>>doc:sdmx:Glossary 2\.1.Item scheme.WebHome]] (% style="color:#e74c3c" %)maps(%%): organisation scheme (% style="color:#e74c3c" %)map(%%), [[concept scheme>>doc:sdmx:Glossary 2\.1.Concept scheme.WebHome]] (% style="color:#e74c3c" %)map(%%), [[category scheme>>doc:sdmx:Glossary 2\.1.Category scheme.WebHome]] (% style="color:#e74c3c" %)map(%%) and [[reporting taxonomy>>doc:sdmx:Glossary 2\.1.Reporting taxonomy.WebHome]] (% style="color:#e74c3c" %)map(%%). Organisation scheme (% style="color:#e74c3c" %)map(%%) and reporting scheme (% style="color:#e74c3c" %)map(%%) have been omitted from the information model schematic in Figure 1. 255 255 * //**[[Reporting Taxonomy>>doc:sdmx:Glossary 2\.1.Reporting taxonomy.WebHome]]: **//A [[reporting taxonomy>>doc:sdmx:Glossary 2\.1.Reporting taxonomy.WebHome]] allows an organisation to link (possibly in a hierarchical way) a number of cube or [[data flow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] definitions which together form a complete “report” of data or metadata. This supports primary reporting which often comprises multiple cubes of heterogeneous data, but may also support other collection and reporting functions. It also supports the specification of publications such as a yearbook, in terms of the data or metadata contained in the publication. 256 256 * //**Process:**// The process class provides a way to model statistical processes as a set of interconnected //process steps.// Although not central to the exchange and dissemination of statistical data and metadata, having a shared description of processing allows for the interoperable exchange and dissemination of [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] sets which describe processes-related (% style="color:#e74c3c" %)concepts(%%). 257 -* //**[[Hierarchy>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]]**//: Describes complex [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] [[hierarchies>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]] principally for data discovery purposes. The [[codes>>doc:sdmx:Glossary 2\.1.Code.WebHome]] themselves are referenced from the [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] lists in which they are maintained.253 +* //**[[Hierarchy>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]]**//: Describes complex [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] [[hierarchies>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]] principally for data discovery purposes. The [[codes>>doc:sdmx:Glossary 2\.1.Code.WebHome]] themselves are referenced from the [[code lists>>doc:sdmx:Glossary 2\.1.Code list.WebHome]] in which they are maintained. 258 258 * //**[[Hierarchy>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]] Association**//: A [[hierarchy>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]] association links a [[hierarchy>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]] to something that needs it like a [[dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]. Furthermore, the linking can be specified in the context of another object such as a [[dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] in the context of a [[dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]. Thus, a [[dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] in a [[data structure definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] could have different [[hierarchies>>doc:sdmx:Glossary 2\.1.Hierarchy.WebHome]] depending on the [[dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]. 259 259 * //**Transformation Scheme:**// A transformation scheme is a set of [[Validation and Transformation Language>>doc:sdmx:Glossary 2\.1.Validation and transformation language.WebHome]] ([[VTL>>doc:sdmx:Glossary 2\.1.Validation and transformation language.WebHome]]) transformations aimed at obtaining some meaningful results for the user (e.g., the validation of one or more [[data sets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]). The set of transformations is meant to be executed together (in the same run) and may contain 597 any number of transformations in order to produce any number of results. Thus, a transformation scheme can be considered as a [[VTL>>doc:sdmx:Glossary 2\.1.Validation and transformation language.WebHome]] ‘program’. 260 260 ... ... @@ -268,7 +268,7 @@ 268 268 269 269 The registry services discussed here can be briefly summarized: 270 270 271 -* //**Maintenance of [[Structural Metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]]**//**:** This registry service allows users with [[maintenance agency>>doc:sdmx:Glossary 2\.1.Maintenance agency.WebHome]] access privileges to submit and modify [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]]. In this aspect the registry is acting as a [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] repository. However, it is permissible in an [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] structure to submit just the “stub” of the structural object, such as a [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] list, and for this stub to reference the actual location from where the metadata can be retrieved, either from a file or a [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] resource, such as another registry.267 +* //**Maintenance of [[Structural Metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]]**//**:** This registry service allows users with [[maintenance agency>>doc:sdmx:Glossary 2\.1.Maintenance agency.WebHome]] access privileges to submit and modify [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]]. In this aspect the registry is acting as a [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] repository. However, it is permissible in an [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] structure to submit just the “stub” of the structural object, such as a [[code list>>doc:sdmx:Glossary 2\.1.Code list.WebHome]], and for this stub to reference the actual location from where the metadata can be retrieved, either from a file or a [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] resource, such as another registry. 272 272 * //**Registration of [[Data Sources>>doc:sdmx:Glossary 2\.1.Data source.WebHome]]: **//This registry service allows users with [[maintenance agency>>doc:sdmx:Glossary 2\.1.Maintenance agency.WebHome]] access privileges to inform the registry of the existence and location (for retrieval) of [[data sets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] and [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] sets. The registry stores metadata about these objects, and links it to the [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] that give sufficient structural information for an application to process it, or for an application to discover its existence. Objects in the registry are organized and categorized according to one or more [[category schemes>>doc:sdmx:Glossary 2\.1.Category scheme.WebHome]]. 273 273 * //**Querying: **//The registry services have interfaces for querying the metadata contained in a registry, so that applications and users can discover the existence of [[data sets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] and [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] sets, [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]], the providers/agencies associated with those objects, and the provider agreements which describe how the data and metadata are made available, and how they are categorized. 274 274 * //**[[Subscription>>doc:sdmx:Glossary 2\.1.Subscription.WebHome]]/[[Notification>>doc:sdmx:Glossary 2\.1.Notification.WebHome]]:**// It is possible to “subscribe” to specific objects in a registry, so that a [[notification>>doc:sdmx:Glossary 2\.1.Notification.WebHome]] will be sent to all subscribers whenever the registry objects are updated. ... ... @@ -277,7 +277,7 @@ 277 277 278 278 Web services allow computer applications to exchange data directly over the Internet, essentially allowing modular or distributed computing in a more flexible fashion than ever before. In order to allow web services to function, however, many standards are required: for requesting and supplying data; for expressing the enveloping data which is used to package exchanged data; for describing web services to one another, to allow for easy integration into applications that use other web services as data resources. 279 279 280 -(% style="color:#e74c3c" %)Version(%%) 3.1 has standardized on RESTful web services with a OpenAPI specification published on the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Technical Working Group’s GitHub repository [[__https:~~/~~/github.com/sdmx-twg__>>https://https:github.comsdmx-twg]]. 276 +(% style="color:#e74c3c" %)Version(%%) 3.1 has standardized on RESTful web services with a OpenAPI specification published on the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Technical Working Group’s GitHub repository [[__https:~~/~~/github.com/sdmx-twg__>>https://https:github.comsdmx-twg||rel="noopener noreferrer" target="_blank"]]. 281 281 282 282 There are five ‘resources’: 283 283 ... ... @@ -288,16 +288,15 @@ 288 288 * metadata – retrieval of [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] 289 289 * registration – retrieval of data locations (URL) for specific [[provision agreements>>doc:sdmx:Glossary 2\.1.Provision agreement.WebHome]] 290 290 291 -The following conceptual example uses the ‘data’ resource to query a data repository for a [[series>>doc:sdmx:Glossary 2\.1.Series.WebHome]] identified by the key ‘M.USD.EUR.SP00.A’ in the EXR (ECB exchange rates) [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]: https:~/~/ws-entry-point/data/dataflow/ECB/EXR/1.0.0/M.USD.EUR.SP00.A 287 +The following conceptual example uses the ‘data’ resource to query a data repository for a [[series>>doc:sdmx:Glossary 2\.1.Series.WebHome]] identified by the key ‘M.USD.EUR.SP00.A’ in the EXR (ECB exchange rates) [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]: [[https:~~/~~/ws-entry-point/data/dataflow/ECB/EXR/1.0.0/M.USD.EUR.SP00.A>>https://https:ws-entry-pointdatadataflowECBEXR1.0.0M.USD.EUR.SP00.A]] 292 292 293 293 = 4 The SDMX Information Model = 294 294 295 - 296 296 [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] provides a way of modelling statistical data, and defines the set of metadata constructs used for this purpose. Because [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] specifies a number of transmission formats for expressing data and [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]], the model is used as a mechanism for guaranteeing that transformation between the different formats is lossless. In this sense, all of the formats are syntax-bound expressions of the common information model. 297 297 298 -[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] recognizes that statistical data is structured; in [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] this structure is termed a [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]. “[[Data sets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]” are made up of one or more lower-(% style="color:#e74c3c" %)level(%%) “groups”, based on their degrees of similarity. Each group is in turn comprised of one or more “[[series>>doc:sdmx:Glossary 2\.1.Series.WebHome]]” of data. Each [[series>>doc:sdmx:Glossary 2\.1.Series.WebHome]] or section has a “key” - values for each of a cluster of (% style="color:#e74c3c" %)concepts(%%), also called "[[dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]" - which identifies it, and one or more “observations”, which typically combine the time of the observation, and the value of the observation (e.g., measurement). Additionally, metadata may be attached at any (% style="color:#e74c3c" %)level(%%) of this structure as descriptive “[[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]”. [[Code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] lists(enumerations) and other patterns for [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] of data and metadata are also modelled.293 +[[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] recognizes that statistical data is structured; in [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] this structure is termed a [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]. “[[Data sets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]” are made up of one or more lower-(% style="color:#e74c3c" %)level(%%) “groups”, based on their degrees of similarity. Each group is in turn comprised of one or more “[[series>>doc:sdmx:Glossary 2\.1.Series.WebHome]]” of data. Each [[series>>doc:sdmx:Glossary 2\.1.Series.WebHome]] or section has a “key” - values for each of a cluster of (% style="color:#e74c3c" %)concepts(%%), also called "[[dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]" - which identifies it, and one or more “observations”, which typically combine the time of the observation, and the value of the observation (e.g., measurement). Additionally, metadata may be attached at any (% style="color:#e74c3c" %)level(%%) of this structure as descriptive “[[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]”. [[Code lists>>doc:sdmx:Glossary 2\.1.Code list.WebHome]] (enumerations) and other patterns for [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] of data and metadata are also modelled. 299 299 300 -There is some similarity between “cube” structures commonly used to process statistical data, and the [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] idea in the [[SDMX Information Model>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]. It is important to note that the data as structured according to the [[SDMX Information Model>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]] is optimized for exchange, potentially with partners who may have no ability to process a “cube” of data coming from complex statistical systems. [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] [[time series>>doc:sdmx:Glossary 2\.1.Series.WebHome]] can be understood as “slices” of the cube. Such a slice is identified by its key. A "[[series>>doc:sdmx:Glossary 2\.1.Series.WebHome]]" key consists of the values for all [[dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] specified by the key family except time. Thus, it is possible to reconstruct and describe data cubes from [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]-structured data, and to exchange such databases using the interfaces and formats provided for that purpose in the standard. Additional objects such as [[hierarchical code>>doc:sdmx:Glossary 2\.1.Hierarchical code.WebHome]] lists, (% style="color:#e74c3c" %)constraints(%%) and structure (% style="color:#e74c3c" %)maps(%%) make it possible to more fully model the structure of cubes.295 +There is some similarity between “cube” structures commonly used to process statistical data, and the [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] idea in the [[SDMX Information Model>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]. It is important to note that the data as structured according to the [[SDMX Information Model>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]] is optimized for exchange, potentially with partners who may have no ability to process a “cube” of data coming from complex statistical systems. [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] [[time series>>doc:sdmx:Glossary 2\.1.Series.WebHome]] can be understood as “slices” of the cube. Such a slice is identified by its key. A "[[series>>doc:sdmx:Glossary 2\.1.Series.WebHome]]" key consists of the values for all [[dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] specified by the key family except time. Thus, it is possible to reconstruct and describe data cubes from [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]-structured data, and to exchange such databases using the interfaces and formats provided for that purpose in the standard. Additional objects such as [[hierarchical code lists>>doc:sdmx:Glossary 2\.1.Hierarchical code list.WebHome]], (% style="color:#e74c3c" %)constraints(%%) and structure (% style="color:#e74c3c" %)maps(%%) make it possible to more fully model the structure of cubes. 301 301 302 302 The information model also provides a view of [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]]: a mechanism for referencing the meaningful “objects” within the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] view of statistical exchange processes ([[data providers>>doc:sdmx:Glossary 2\.1.Data provider.WebHome]], structures, [[provisioning agreements>>doc:sdmx:Glossary 2\.1.Provision agreement.WebHome]], [[dataflows>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]], [[metadata flows>>doc:sdmx:Glossary 2\.1.Metadataflow.WebHome]], etc.) to which metadata is attached; a mechanism for describing a set of meaningful (% style="color:#e74c3c" %)concepts(%%), of organizing them into a presentational structure, and of indicating how their values are represented. This is based on a simple, hierarchical view of [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] which is common to many metadata systems and [[classification>>doc:sdmx:Glossary 2\.1.Statistical Classification.WebHome]]/categorization schemes. [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] provides a model (and XML and JSON formats) for both describing [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] structures, and of reporting [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] according to those structures. 303 303 ... ... @@ -311,12 +311,11 @@ 311 311 312 312 == 5.1 SDMX-ML == 313 313 314 - 315 315 [[SDMX-ML>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]] is the XML transmission format specification for exchanging [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]], data and [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]], and interacting with [[SDMX registry>>doc:sdmx:Glossary 2\.1.SDMX Registry.WebHome]] services. It is designed as a general-purpose format for all automation and data / metadata exchange tasks, and provides the most complete [[coverage>>doc:sdmx:Glossary 2\.1.Coverage.WebHome]]. 316 316 317 317 There are four distinct types of message: 318 318 319 -1. //**Structure Definition**~:// For the exchange of [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]]. A [[SDMX-ML>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]] structure message can carry details of any number and combination of [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] [[artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] like DSDs, [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] listsand (% style="color:#e74c3c" %)constraints(%%).313 +1. //**Structure Definition**~:// For the exchange of [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]]. A [[SDMX-ML>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]] structure message can carry details of any number and combination of [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] [[artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] like DSDs, [[code lists>>doc:sdmx:Glossary 2\.1.Code list.WebHome]] and (% style="color:#e74c3c" %)constraints(%%). 320 320 1. //**Structure-specific Data**~:// For the exchange of data. This format is specific to the [[Data Structure Definitions>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] of the [[data sets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] (in other terms, it is [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]-specific) and is created by following mappings between the metadata constructs defined in the Structure Definition message and the technical specification of the format. It supports the exchange of large [[data sets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] in XML format, provides strict validation of conformance with the [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] using a generic XML parser, and supports the transmission of partial [[data sets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] ([[incremental updates>>doc:sdmx:Glossary 2\.1.Incremental update.WebHome]]) as well as whole [[data sets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]]. 321 321 322 322 Many XML tools and technologies have expectations about the functions performed by an XML schema, one of which is a very direct relationship between the XML constructs described in the XML schema and the tagged data in the XML instance. Strong data typing is also considered normal, supporting full validation of the tagged data. These message types are designed to support validation and other expected XML schema functions. ... ... @@ -326,7 +326,6 @@ 326 326 327 327 == 5.2 SDMX-JSON == 328 328 329 - 330 330 [[SDMX-JSON>>doc:sdmx:Glossary 2\.1.SDMX-JSON.WebHome]] is the JSON transmission format specification for exchanging [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]], data and [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]]. It provides an alternative to [[SDMX-ML>>doc:sdmx:Glossary 2\.1.SDMX-ML.WebHome]] and is most suited to applications like web data dissemination. 331 331 332 332 [[SDMX-JSON>>doc:sdmx:Glossary 2\.1.SDMX-JSON.WebHome]] messages serve the same function as those of the XML formats but have a different structure. For data, an important distinction is that they carry both [[component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] [[codes>>doc:sdmx:Glossary 2\.1.Code.WebHome]] and labels which provides all the information needed to display the content in a single JSON response. The XML Structure-specific Data format by contrast carries only [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] IDs thus requiring applications obtain and hold [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] about the [[data set>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] in order to display the content in human-readable form. ... ... @@ -341,7 +341,6 @@ 341 341 342 342 == 5.3 SDMX-CSV == 343 343 344 - 345 345 [[SDMX-CSV>>doc:sdmx:Glossary 2\.1.SDMX-CSV.WebHome]] is the CSV transmission format specification for exchanging data and [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] only. 346 346 347 347 [[SDMX-CSV>>doc:sdmx:Glossary 2\.1.SDMX-CSV.WebHome]] provides a simple columnar format for data and metadata that can be readily created and interpreted by standard software tools such as Microsoft Excel. Nevertheless, data and metadata can still be converted between the CSV and the JSON / XML formats without loss. ... ... @@ -374,7 +374,7 @@ 374 374 375 375 == 6.1 Cross-Domain Concepts == 376 376 377 -The [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] [[Cross-Domain Concepts>>doc:sdmx:Glossary 2\.1.Cross-domain concept.WebHome]] is a content guideline concerning (% style="color:#e74c3c" %)concepts(%%) which are used across [[statistical domains>>doc:sdmx:Glossary 2\.1.Statistical subject-matter domain.WebHome]]. This list is expected to grow and to be subject to revision as [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] is used in a growing number of domains. The use of the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] [[Cross-Domain Concepts>>doc:sdmx:Glossary 2\.1.Cross-domain concept.WebHome]], where appropriate, provides a framework to further promote interoperability among organisations using the technical standards presented here. The harmonization of statistical (% style="color:#e74c3c" %)concepts(%%) includes not only the definitions of the (% style="color:#e74c3c" %)concepts(%%), and their names, but also, where appropriate, their [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] with standard [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] lists, and the role they play within [[data structure definitions>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] and [[metadata structure definitions>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]].369 +The [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] [[Cross-Domain Concepts>>doc:sdmx:Glossary 2\.1.Cross-domain concept.WebHome]] is a content guideline concerning (% style="color:#e74c3c" %)concepts(%%) which are used across [[statistical domains>>doc:sdmx:Glossary 2\.1.Statistical subject-matter domain.WebHome]]. This list is expected to grow and to be subject to revision as [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] is used in a growing number of domains. The use of the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] [[Cross-Domain Concepts>>doc:sdmx:Glossary 2\.1.Cross-domain concept.WebHome]], where appropriate, provides a framework to further promote interoperability among organisations using the technical standards presented here. The harmonization of statistical (% style="color:#e74c3c" %)concepts(%%) includes not only the definitions of the (% style="color:#e74c3c" %)concepts(%%), and their names, but also, where appropriate, their [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] with standard [[code lists>>doc:sdmx:Glossary 2\.1.Code list.WebHome]], and the role they play within [[data structure definitions>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] and [[metadata structure definitions>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]]. 378 378 379 379 The intent of this guideline is two-fold: to provide a core set of (% style="color:#e74c3c" %)concepts(%%) which can be used to structure statistical data and metadata, to promote interoperability between systems (“[[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]]”, as described above); and to promote the exchange of metadata more widely, with a set of harmonized (% style="color:#e74c3c" %)concept(%%) names and definitions for other types of metadata (“[[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]]”, as defined above.) 380 380