Skip to Content
Last modified by Artur on 2025/09/10 11:19
From version 3.5
edited by Helena
on 2025/05/19 15:15
Change comment: There is no comment for this version
To version 4.1
edited by Helena
on 2025/05/19 15:20
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -24,7 +24,7 @@
24 24  1. SDMX-ML - the XML format for the exchange of SDMX-structured data and metadata. This document has normative sections describing the use of the XML syntax in SDMX messages, and is accompanied by a set of normative XML schemas and non-normative sample XML document instances.
25 25  1. The SDMX Registry Specification provides for a central registry of information about available data and reference metadata, and for a repository containing structural metadata and provisioning information. This specification defines the basic services offered by the SDMX Registry: registration of data and metadata; querying for data and metadata; and subscription/notification regarding updates to the registry. This document has normative sections.
26 26  1. The SDMX Technical Notes – this is a guide to help those who wish to use the SDMX specifications. It includes notes on the expressive differences of the various messages and syntaxes; versioning; maintenance agencies; the SDMX Registry. This document is not normative.
27 -1. Web Services Guidelines – this is a guide for those who wish to implement SDMX using web-services technologies. It places an emphasis on those aspects of web-services technologies (including, but not requiring, an SDMXconformant registry) which will work regardless of the development environment or platform used to create the web services. This document contains normative sections.^^[[(% class="wikiinternallink wikiinternallink wikiinternallink" %)^^1^^>>path:#sdfootnote1sym||name="sdfootnote1anc"]](%%)^^
27 +1. Web Services Guidelines – this is a guide for those who wish to implement SDMX using web-services technologies. It places an emphasis on those aspects of web-services technologies (including, but not requiring, an SDMXconformant registry) which will work regardless of the development environment or platform used to create the web services. This document contains normative sections.{{footnote}}SOAP and REST specifications are not maintained any more in this section, see the SDMX website.{{/footnote}}
28 28  
29 29  In July 2020 it was released an important improvement of the SDMX 2.1 specifications for the SDMX implementation of the Validation and Transformation Language (VTL). This implied a revision of some of the SDMX 2.1 sections. The relevant changes are not described in the next section but in the section 10 below.
30 30  
... ... @@ -42,38 +42,22 @@
42 42  
43 43  * **Reference Metadata**: In addition to describing and specifying data structures and formats (along with related structural metadata), the version 2.0 specification also provides for the exchange of metadata which is distinct from the structural metadata in the 1.0 version. This category 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 information, description of the data and metadata provided, etc.); and metadata relevant to the exchange of categorization schemes.
44 44  * **SDMX Registry**: 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/notification.
45 -* **Structural Metadata**: The support for exchange of statistical data and related structural metadata has been expanded. Some support is provided for qualitative data; data cube structures are described; hierarchical code 98 lists are supported; relationships between data structures can be expressed, 99 providing support for extensibility of data structures; and the description of 100 functional dependencies within cubes are supported.
45 +* **Structural Metadata**: The support for exchange of statistical data and related structural metadata has been expanded. Some support is provided for qualitative data; data cube structures are described; hierarchical code lists 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.
46 46  
47 47  The major changes from 2.0 to 2.1 can be briefly summarized:
48 48  
49 -**Web-Services-Oriented Changes:** Several organizations have been implementing web services applications using SDMX, and these 106 implementations have resulted in several changes to the specifications.
49 +* **Web-Services-Oriented Changes:** Several organizations have been implementing web services applications using SDMX, and these 106 implementations have resulted in several changes to the specifications. Because the nature of SDMX web services could not be anticipated at the time of the original drafting of the specifications, the web services guidelines have been completely re-developed.
50 +* **Presentational Changes: **Much work has gone into using various technologies for the visualization of SDMX data and metadata, and some changes have been proposed as a result, to better leverage this graphical visualization. These changes are largely to leverage the Cross-domain Concepts of the Content Oriented Guidelines.
51 +* **Consistency Issues:** There have been some areas where the draft specifications were inconsistent in minor ways, and these have been addressed.
52 +* **Clarifications in Documentation:** In some cases it has been identified that the documentation of specific fields within the standard needed clarification and elaboration, and these issues have been addressed.
53 +* **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 object-oriented features of W3C XML Schema to allow for easier processing of SDMX data and metadata.
54 +* **Consistency between the SDMX-ML and the SDMX Information Model: **Certain aspects of the XML schemas and UML model have been more closely aligned, to allow for easier comprehension of the SDMX model.
55 +* **Technical Bugs:** Some minor technical bugs have been identified in the registry interfaces and elsewhere. These bugs have been addressed.
56 +* **Support for Non-Time-Series Data in the Generic Format: **One area which has been extended is the ability to express non-time-series data as part of the generic data message.
57 +* **Simplification of the data structure definition - specific message types: **Both time series (version 2.0 Compact) and non-time series data sets (version 2.0 Cross Sectional) use the same underlying structure for a structure-specific formatted message, which is specific to the Data Structure Definition of the data set.
58 +* **Simplification and better support for the metadata structure: **New use 140 cases have been reported and these are now supported by a re-modelled metadata structure definition.
59 +* **Support for partial item schemes such as a code list: **The concept of a 143 partial (sub-set) item scheme such as a partial code list for use in exchange scenarios has been introduced**.**
50 50  
51 -Because the nature of SDMX web services could not be anticipated at the time of the original drafting of the specifications, the web services guidelines have been completely re-developed.
52 -
53 -**Presentational Changes: **Much work has gone into using various technologies for the visualization of SDMX data and metadata, and some changes have been proposed as a result, to better leverage this graphical visualization. These changes are largely to leverage the Cross-domain Concepts of the Content Oriented Guidelines.** **
54 -
55 -**Consistency Issues:** There have been some areas where the draft specifications were inconsistent in minor ways, and these have been addressed.
56 -
57 -**Clarifications in Documentation:** In some cases it has been identified that the documentation of specific fields within the standard needed clarification and elaboration, and these issues have been addressed.** **
58 -
59 -**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 object-oriented features of W3C XML Schema to allow for easier processing of SDMX data and metadata.** **
60 -
61 -**Consistency between the SDMX-ML and the SDMX Information Model:**
62 -
63 -Certain aspects of the XML schemas and UML model have been more closely aligned, to allow for easier comprehension of the SDMX model.
64 -
65 -**Technical Bugs:** Some minor technical bugs have been identified in the registry interfaces and elsewhere. These bugs have been addressed.
66 -
67 -**Support for Non-Time-Series Data in the Generic Format: **One area which has been extended is the ability to express non-time-series data as part of the generic data message.** **
68 -
69 -**Simplification of the data structure definition - specific message types:**
70 -
71 -Both time series (version 2.0 Compact) and non-time series data sets (version 2.0 Cross Sectional) use the same underlying structure for a structure-specific formatted message, which is specific to the Data Structure Definition of the data set.
72 -
73 -**Simplification and better support for the metadata structure: **New use 140 cases have been reported and these are now supported by a re-modelled metadata structure definition.
74 -
75 -**Support for partial item schemes such as a code list: **The concept of a 143 partial (sub-set) item scheme such as a partial code list for use in exchange scenarios has been introduced**.**
76 -
77 77  = {{id name="_Toc38910"/}}3. Processes and Business Scope =
78 78  
79 79  == {{id name="_Toc38911"/}}3.1 Process Patterns ==
... ... @@ -129,7 +129,7 @@
129 129  
130 130  [[image:SDMX_2-1_SECTION_1_Framework_2020-07_b3f80ada.jpg||height="417" width="564"]]
131 131  
132 -**Figure 1: High Level Schematic of Major Artefacts in the SDMX Information Model**
116 +**Figure 1: High Level Schematic of Major Artefacts in the SDMX Information Model**
133 133  
134 134  == {{id name="_Toc38914"/}}3.4 The SDMX View of Statistical Exchange ==
135 135  
... ... @@ -248,10 +248,7 @@
248 248  While the SDMX-EDI format is primarily designed to support batch exchange, SDMXML supports a wider range of requirements. XML formats are used for many different types of automated processing, and thus must support more varied processing scenarios. That is why there are several types of messages available as SDMX-ML formats. Each is suited to support a specific set of processing requirements.
249 249  
250 250  1. //Structure Definition~:// All SDMX-ML message types share a common XML expression of the metadata needed to understand and process a data set or metadata set, and additional metadata about category schemes and organisations is included. Also, the structural aspects of data and metadata provision – dataflows and metadataflows – are described using this format.
251 -1. //Generic Data~:// All statistical data expressible in SDMX-ML can be marked up according to this data format, in agreement with the contents of a Structure Definition message. It is designed for any scenario where applications receiving the data need to process it according to a single format. Such applications may need independent access to the data set's structure before they process it. Data marked up in this format are not particularly compact, but they make easily available all aspects of the data set. This format does
252 -
253 -not provide strict validation between the data set and its structural definition using a generic XML parser. It supports the transmission of partial data sets (incremental updates) as well as whole data sets. It supports both the timeseries and the cross-sectional use cases.
254 -
235 +1. //Generic Data~:// All statistical data expressible in SDMX-ML can be marked up according to this data format, in agreement with the contents of a Structure Definition message. It is designed for any scenario where applications receiving the data need to process it according to a single format. Such applications may need independent access to the data set's structure before they process it. Data marked up in this format are not particularly compact, but they make easily available all aspects of the data set. This format does not provide strict validation between the data set and its structural definition using a generic XML parser. It supports the transmission of partial data sets (incremental updates) as well as whole data sets. It supports both the timeseries and the cross-sectional use cases.
255 255  1. //Structure-specific Data~:// This format is specific to the Data Structure Definition of the data set (in other terms, it is DSD-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 in XML format (typically the size of the data set is 50% of the same data expressed as Generic Data), provides strict validation of conformance with the DSD using a generic XML parser, and supports the transmission of partial data sets (incremental updates) as well as whole data sets. The Structure-specific Data format specified in SDMX 2.1 supports both the time-series and the cross-sectional use cases which were covered by two distinct formats in SDMX 2.0. 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.
256 256  1. //Generic Metadata~:// All reference metadata expressible in SDMX-ML format can be marked up according to this schema. It performs only a minimum of validation, and is somewhat verbose, but it does support the creation of generic software tools and services for processing reference metadata.
257 257  1. //Structure-specific Metadata~:// For each metadata structure definition, an XML schema specific to that structure can be created, to perform validation on sets of reported metadata. This structure is less verbose than the Generic Metadata format, and, because the XML mark-up relates directly to the reported concepts, it is appropriate for applications that are designed to process a specific type of metadata report. It is analogous to the Structurespecific Data format for data in its approach to the use of XML.
... ... @@ -294,10 +294,8 @@
294 294  
295 295  = {{id name="_Toc38926"/}}10 Validation and Transformation Language =
296 296  
297 -For many years the SDMX initiative has been fostering and supporting the development of a standard calculation language, called Validation and Transformation Language (VTL). A blueprint for defining calculations was already described in the original SDMX 2.1 specifications (package 13 of the Information
278 +For many years the SDMX initiative has been fostering and supporting the development of a standard calculation language, called Validation and Transformation Language (VTL). A blueprint for defining calculations was already described in the original SDMX 2.1 specifications (package 13 of the Information Model - “Transformations and Expressions”). It was just a basic framework that required further developments to became operational in order to achieve a calculation language able to manipulate SDMX artefacts.
298 298  
299 -Model - “Transformations and Expressions”). It was just a basic framework that required further developments to became operational in order to achieve a calculation language able to manipulate SDMX artefacts.
300 -
301 301  These developments started in late 2012 and were put in charge of the Validation and Transformation Language Task Force (VTL TF), which included members of the SDMX Technical Working Group (TWG) and Statistical Working Group (SWG), besides experts coming from the DDI and GSIM communities. The intent was to define a stardard language to be implemented in SDMX and applicable also to GSIM and DDI. This brought to the publication of the VTL 1.0 in 2015. Then new requirements came from a number of proofs of concepts and tests of VTL 1.0 made by several organisations and triggered a large improvement of the language. A new provisional version, the VTL 1.1, was released in public consultation in 2017. The high number of comments received triggered another phase of intensive work, with the main goal of achieving a more robust and forward compatible version. Finally, the VTL 2.0 was published between April and July 2018 (see the SDMX website).
302 302  
303 303  The implementation in the SDMX standards of the VTL 2.0 started in late 2018. It allows to write VTL 2.0 programs for validating and transforming SDMX data, to store these programs in a SDMX metadata registry and to exchange them through SDMX messages, also together the definition of the data structures of the involved data.
... ... @@ -306,10 +306,8 @@
306 306  
307 307  The new SDMX 2.1 parts relevant to VTL are in Section 2 (Information Model), Section 3A (SDMX-ML: XML formats), Section 3B (SDMX-ML: XML Schema, Samples, WADL and WSDL), Section 5 (Registry Specifications), Section 6 (Technical Notes) and in the REST specifications of the SDMX web services. On the contrary, the VTL is not supported in the UN/EDIFACT SDMX formats (Section 4) and in the SDMX SOAP web service interface.
308 308  
309 -As for the Section 2 (Information Model), the change is relevant to the package 13
288 +As for the Section 2 (Information Model), the change is relevant to the package 13 “Transformations and Expressions”, which previously contained only a blueprint for future elaboration and was not operational. This package is renamed to “Validation and Transformation Language” and is completely reformulated by introducing the actual object classes needed to define and manage VTL 2.0 programs. The other parts of the IM are not impacted.
310 310  
311 -“Transformations and Expressions”, which previously contained only a blueprint for future elaboration and was not operational. This package is renamed to “Validation and Transformation Language” and is completely reformulated by introducing the actual object classes needed to define and manage VTL 2.0 programs. The other parts of the IM are not impacted.
312 -
313 313  In the Section 3A and 3B, new schemas, samples and documentation aimed at exchanging VTL programs through SDMX structure messages have been introduced. Other parts are not impacted.
314 314  
315 315  In the section 5 (Registry Specifications), the VTL artefacts have been added. The other artefacts are not impacted.
... ... @@ -318,4 +318,6 @@
318 318  
319 319  Finally, new REST interfaces for VTL have been added. These are not maintained any more in the section 7; the link to these specifications can be found on the SDMX website.
320 320  
321 -[[1>>path:#sdfootnote1anc||name="sdfootnote1sym"]] SOAP and REST specifications are not maintained any more in this section, see the SDMX website.
298 +----
299 +
300 +{{putFootnotes/}}