Sdmx-Ml: Schema and Documentation (Version 2.0)

Total Page:16

File Type:pdf, Size:1020Kb

Sdmx-Ml: Schema and Documentation (Version 2.0) STATISTICAL DATA AND METADATA EXCHANGE INITIATIVE SDMX-ML: SCHEMA AND DOCUMENTATION (VERSION 2.0) November 2005 STATISTICAL DATA AND METADATA EXCHANGE INITIATIVE 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 © SDMX 2005 52 http://www.sdmx.org/ 2 STATISTICAL DATA AND METADATA EXCHANGE INITIATIVE 53 Contents 54 55 1 BACKGROUND............................................................................................................ 5 56 1.1 History and Version 2.0 Developments ........................................................................ 5 57 1.2 The XML Design........................................................................................................... 5 58 1.3 Fostering the Use of a Standard SDMX-ML................................................................. 6 59 2 NORMATIVE REFERENCES....................................................................................... 6 60 3 CONFORMANCE ......................................................................................................... 6 61 4 DESIGN OVERVIEW ................................................................................................... 6 62 4.1 Scope and Requirements ............................................................................................. 6 63 4.2 Design Approach .......................................................................................................... 8 64 4.3 SDMX-ML Packaging: Namespace Modules ............................................................. 10 65 5 GENERIC (NON-STRUCTURE-DEFINITION-SPECIFIC) SCHEMAS...................... 12 66 5.1 SDMX Message Namespace Module ........................................................................ 12 67 5.2 SDMX Structure Namespace Module......................................................................... 18 68 5.3 SDMX Generic Data Namespace Module.................................................................. 65 69 5.4 SDMX Generic Metadata Namespace Module .......................................................... 69 70 5.5 SDMX Query Namespace Module ............................................................................. 73 71 5.6 SDMX Common Namespace Module ........................................................................ 82 72 5.7 SDMX Registry Interfaces Namespace Module......................................................... 86 73 5.8 Data Formatting and Character Encoding................................................................ 105 74 5.9 Missing Observation Values ..................................................................................... 105 75 6 KEY-FAMILY- AND METADATA-STRUCTURE-DEFINITION-SPECIFIC SCHEMAS: 76 CORE STRUCTURES & STANDARD MAPPINGS .............................................................. 105 77 6.1 Compact Data Message Core Structure .................................................................. 106 78 6.2 Utility Data Message Core Structure ........................................................................ 108 79 6.3 Cross-Sectional Data Message Core Structure ....................................................... 110 80 6.4 Metadata Report Core Structure .............................................................................. 111 81 6.5 Mappings to Key-Family-Specific Data Schemas .................................................... 113 3 STATISTICAL DATA AND METADATA EXCHANGE INITIATIVE 82 6.6 Mappings to Metadata Structure Definition-Specific Metadata Schemas ................ 125 83 7 APPENDIX: SAMPLE SDMX-ML DATA MESSAGES ............................................. 127 84 7.1 CompactSample.xml ................................................................................................ 127 85 7.2 UtilitySample.xml ...................................................................................................... 129 86 7.3 GenericSample.xml .................................................................................................. 129 87 7.4 CrossSectionalSample.xml....................................................................................... 130 88 4 STATISTICAL DATA AND METADATA EXCHANGE INITIATIVE 89 1 BACKGROUND 90 1.1 History and Version 2.0 Developments 91 The SDMX Technical Standards Version 1.0 established an information model which 92 described aggregated statistical data sets and the structural metadata needed to 93 exchange them in a standard fashion. This drew on the earlier example of the 94 GESMES/TS standard. Based on the SDMX information model, several formats were 95 developed: XML formats for exchange of structural metadata, data sets, and queries 96 for these (SDMX-ML), and EDIFACT formats for the structural metadata and data 97 sets (SDMX-EDI). These standards supported a number of exchange patterns, 98 characterized as "bilateral", "gateway", and "data-sharing" models, as described in 99 the Framework document in the Version 1.0 standards package. 100 101 Version 2.0 builds on this foundation to provide a higher degree of support for all of 102 these models, with an emphasis on data sharing in the form of a set of standard 103 registry services interfaces. It has also expanded to include support for new types of 104 metadata exchange and reporting, with a focus on "reference metadata" concerned 105 with quality, methodology, and other issues. Further, the ability to provide metadata 106 about the relationships between data sets and structures has been expanded, 107 providing more support for data cubes. Finally, experience has shown that some 108 minor additions to the existing structural metadata and dataset structures will allow 109 SDMX to support more different types of statistical information. 110 111 The scope of the Version 2.0 SDMX Technical Standards is thus much broader, and 112 is accompanied by a larger set of message types in the SDMX-ML formats. While the 113 XML formats described here have grown in number and scope, the EDI formats 114 remain relatively unchanged. 115 1.2 The XML Design 116 All of these document types will share a common "envelope" at the message level 117 ("SDMXMessage.xsd"), as well as a set of common low-level components 118 (“SDMXCommon.xsd”) so that header information and basic structure will always be 119 the same. 120 121 • Schema for describing all types of structural metadata – for data sets (key 122 families), for metadata sets (metadata structure definitions), for related groups 123 of metadata and data structures, and for all types of structural objects 124 involved in registry-based exchanges ("SDMXStructure.xsd") 125 • Generic data schema for data-sharing exchange ("SDMXGenericData.xsd") 126 • Generic query schema for invoking web services ("SDMXQuery.xsd") 127 • Key-family-specific schema for updates and revisions/bilateral exchange 128 ("SDMXCompactData.xsd") 129 • Key-family-specific schema for presentational processing and internal use 130 ("SDMXUtilityData.xsd") 5 STATISTICAL DATA AND METADATA EXCHANGE INITIATIVE 131 • Key-family-specific schema for cross-sectional data 132 ("SDMXCrossSectionalData.xsd") 133 • Generic schema for registry interfaces (“SDMXRegistry.xsd”) 134 • Generic schema for reference metadata sets (“SDMXRefMetadata.xsd”) 135 • Metadata-structure-definition-specific schema for metadata sets 136 (“SDMXMetadataReport.xsd”) 137 138 1.3 Fostering the Use of a Standard SDMX-ML 139 In addition to these different formats, standard mappings and corresponding 140 transformation tools have been developed for the creation of key-family-specific 141 schemas from structure descriptions, to transform XML data instances from one XML 142 data description format to another, and from these formats into the corresponding 143 SDMX-ML messages. This level of free tools support will foster the early use of 144 SDMX and permit the data to be easily used across all processes, which is otherwise 145 a difficult requirement to meet. Ultimately, it is the fact that all formats share a 146 common information model that enables this approach to meet the wide set of SDMX 147 requirements. 148 149 2 NORMATIVE REFERENCES 150 W3C XML Schema Definition Language, version 1.0 (URL: 151 http://www.w3c.org/XML/Schema#dev), World Wide Web Consortium 152 W3C Extensible Markup Language, version 1.0, Third Edition (URL: 153 http://www.w3c.org/TR/2004/REC-xml-20040204/), World Wide Web Consortium 154 155 3 CONFORMANCE 156 Sections V and VI of this document are normative, providing rules for the creation of 157 conformant SDMX-ML XML instances and W3C XML Schemas. 158 159 4 DESIGN OVERVIEW 160 4.1 Scope and Requirements 161 To understand the relationships between the several document types, it is important 162 to have some familiarity with the requirements they are designed to fulfil. 163 164 • Large amounts of data must be captured in a reasonably compact format, 165 because of the potential size of databases being exchanged. 166 • It must be possible to send incremental updates, rather than entire, complete 167 databases. The validation of such exchanges demands not that an entire data 168 set be exchanged, but only that enough information be sent to ensure 169 accurate updating and revision processes. 6 STATISTICAL DATA AND METADATA EXCHANGE INITIATIVE 170 • Structural information as well as data will need to be transmitted. 171 • There must be a reliable transformation to and from the GESMES/TS 172 EDIFACT syntax. 173 • It should be possible to present natural-language
Recommended publications
  • The Statistical Data and Metadata Exchange Standard (SDMX)
    UNITED NATIONS ECONOMIC AND SOCIAL COMMISSION FOR ASIA AND THE PACIFIC Expert Group Meeting: Opportunities and advantages of enhanced collaboration on statistical information management in Asia and the Pacific 20-22 June 2011 Swissotel Nailert Park, Bangkok Tuesday, 21 June 2011 Session 3: Emerging generic business process models and common frameworks and terminology – A basis for practical cooperation? Integrating statistical information systems: The Statistical Data and Metadata eXchange Standard (SDMX) Brian Studman Australian Bureau of Statistics [email protected] Session Overview •SDMX – Background –History – What can it represent – SDMX & Other Standards (particularly DDI) • ABS & SDMX: Integration via IMTP (ABS major business programme) • Using SDMX in the context of GSBPM • Examples of Use: ABS main projects that utilise SDMX • A quick preview of GSIM v 0.1 (if we have time) 1 SDMX • Origins – Bank for International Settlements, European Central Bank, Eurostat, IMF, UN, OECD, and the World Bank (SDMX Consortium) • Format for statistical returns for aggregated data • Version 2.1 (April 2011 public comment) • http://sdmx.org/ (best starting place) • SDMX comes from the international agencies (OECD, IMF, Eurostat, UNSD, World Bank, ECB, BIS) – they get aggregate statistical tables from many countries regularly over time – they wanted to automate and manage the process • they need standard agreed definitions and classifications, standard agreed table structures, standard agreed formats for both data and metadata – They commissioned
    [Show full text]
  • Joint Adb – Unescap Sdmx Capacity Building Initiative Sdmx Starter Kit for National Statistical Agencies
    JOINT ADB – UNESCAP SDMX CAPACITY BUILDING INITIATIVE SDMX STARTER KIT FOR NATIONAL STATISTICAL AGENCIES Version: 5 October 2014 1 FOREWORD The aim of the Starter Kit is to provide a resource for national statistical agencies in countries in the Asia and Pacific region contemplating the implementation of the Statistical Data and Metadata Exchange (SDMX) technical standards and content-oriented guidelines for the exchange of aggregate data and their related methodological information (metadata). It outlines a structured process for the implementation of SDMX by agencies that have little knowledge about SDMX and how they would go about the implementation of the standards and guidelines. In order to avoid duplicating the work of the SDMX sponsoring agencies the Kit makes extensive use of links to existing SDMX background documents and artifacts that have been developed at the global level. The Starter Kit was developed under the auspices of the joint 2014 Asian Development Bank– United Nations Economic and Social Commission for Asia and the Pacific SDMX initiative to improve the efficiency of data and metadata exchange between national statistical agencies in the Asia and Pacific region and international organizations through the ongoing use of SDMX standards. The aim of the joint initiative is to build the capacity of countries in the region to apply SDMX standards through mapping national concepts to specific identified SDMX Data Structure Definitions (DSDs) and Metadata Structure Definitions (MSDs). The initiative also aims at enabling national agencies to determine which, of a range of available tools for SDMX implementation, best meets the needs of the organisation. The basic premise of the Kit is that SDMX implementation must be seen in the context of a wide range of corporate institutional, infrastructure and statistical initiatives currently underway in almost all statistical agencies around the globe to improve the quality and relevance of the service they provide to government and non-government users of their outputs.
    [Show full text]
  • Central Banks' Use of the SDMX Standard
    Irving Fisher Committee on Central Bank Statistics IFC Report No 4 Central banks’ use of the SDMX standard 2015 Survey, conducted by the SDMX Global Conference Organising Committee (this report includes only the central bank responses) March 2016 1 Contributors to the IFC report Bank for International Settlements (BIS) Heinrich Ehrmann Bruno Tissot (IFC Secretariat) Central Bank of the Republic of Turkey (CBRT) Erdem Başer Timur Hülagü This publication is available on the BIS website (www.bis.org). © Bank for International Settlements 2016. All rights reserved. Brief excerpts may be reproduced or translated provided the source is stated. ISSN 1991-7511 (online) ISBN 978-92-9197-480-1 (online) 1 The views expressed in this document reflect those of the contributors and are not necessarily the views of the institutions they represent. Contents 1. Executive summary .......................................................................................................................... 1 2. Background: SDMX ......................................................................................................................... 3 3. Survey findings .................................................................................................................................. 5 Annex A: List of participating central banks and respondents ........................................... 12 Annex B: IFC Questionnaire on central banks’ use of SDMX standard ............................ 14 Annex C: SDMX Roadmap 2020 .....................................................................................................
    [Show full text]
  • Implementor's Guide for Sdmx Format Standards (Version
    STATISTICAL DATA AND METADATA EXCHANGE INITIATIVE IMPLEMENTOR’S GUIDE FOR SDMX FORMAT STANDARDS (VERSION 1.0) STATISTICAL DATA AND METADATA EXCHANGE INITIATIVE 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 Initial Release September 2004 26 First Revision December 2004 27 © SDMX 2004 28 http://www.sdmx.org/ 29 30 31 32 33 3 STATISTICAL DATA AND METADATA EXCHANGE INITIATIVE 34 1 INTRODUCTION ............................................................................................................................ 5 35 2 SDMX INFORMATION MODEL FOR FORMAT IMPLEMENTORS .............................................. 5 36 2.1 Introduction...................................................................................................................................................5 37 2.2 Fundamental Parts of the Information Model .................................................................................6 38 2.3 Data Set.....................................................................................................................................................6 39 2.4 Attachment Levels and Data Formats....................................................................................................8 40 2.5 Concepts, Definitions, Properties and Rules.......................................................................................9 41 3 SDMX-ML AND SDMX-EDI: COMPARISON OF EXPRESSIVE CAPABILITIES AND 42 FUNCTION .........................................................................................................................................
    [Show full text]
  • SDMX 2.1 User Guide Aims at Providing Guidance to Users of the Version 2.1 of the Technical Specification, Released in April 2011
    EUROSTAT – SDMX Training – March 2015 UNDERSTANDING SDMX Introduction to a training course March 2015 1 | P a g e EUROSTAT – SDMX Training – March 2015 Table of Contents 1 SDMX in short ................................................................................................. 3 2 Why should you be interested in SDMX? ........................................................... 4 3 Background: origin and purpose of SDMX .......................................................... 5 4 The existing versions of SDMX .......................................................................... 8 5 The SDMX information model .......................................................................... 9 6 Uptake of SDMX within Domains .................................................................... 10 7 How to know more: SDMX Tutorials ............................................................... 12 8 How to know more: the SDMX User Guide ...................................................... 12 Marco Pellegrino (Eurostat) March 2015 2 | P a g e EUROSTAT – SDMX Training – March 2015 What is SDMX This document provides some background information on the SDMX Initiative, the issues which SDMX addresses and the areas in which SDMX is playing a role today. It also provides a description of a training course on the Basics of SDMX, scheduled for GCC-Stat. 1 SDMX in short SDMX provides support for things that are important to statisticians and are often difficult for them to achieve, and it enables tools to be developed to provide support for these things. It does this by providing standard, well-designed formats for holding all of the elements involved in the statistical process and linking them all together in a clear model. The result is an approach that maximises the amount of metadata and statistical context information that can be passed through to statistical clients, maximises the possibility of relating statistics from similar or different sources, and allows for the automation of processes that are often difficult and costly to manage otherwise.
    [Show full text]
  • SDMX Roadmap 2021-2025
    SDMX Roadmap 2021-2025 Executive Summary The Statistical Data and Metadata eXchange (SDMX) is a standard developed to facilitate the exchange of data and metadata in the international statistical community. It is widely used by international organizations, national statistical offices, and other data producing agencies. The development of SDMX is guided by a roadmap that sets forth the objectives for a span of five years. The SDMX Roadmap 2021-2025 (“the Roadmap”) provides a strategic plan for the continuous development of SDMX over the next five years. The Roadmap has two main drivers: addressing a broadening set of needs and improving the usability of the standard. These two drivers come together under the umbrella of the SDMX 3.0 project. The new roadmap continues to group the objectives into four pillars: (i) Implementation, (ii) Simplification, (iii) Modernisation and (iv) Communication. The Roadmap aims to strengthen the implementation of SDMX. SDMX will be expanded to new statistical domains. Existing SDMX packages will be upgraded based on updates of international classification standards. The adoption of established global code-lists and data structure definitions (DSDs) will be encouraged. Finally, SDMX tools will be finalized to facilitate the exchange of referential metadata. Simplification will be required to facilitate the use of SDMX. Main directions of work will be to simplify referential metadata exchange mechanisms, explore links between SDMX and other standards, and develop tools that simplify the complexities of SDMX for novice users. SDMX will be leveraged to modernise statistical processes and IT infrastructure. The development of SDMX 3.0 will incorporate modern features of data management.
    [Show full text]
  • Policy-Making for Research Data in Repositories: a Guide
    Policy-making for Research Data in Repositories: A Guide http://www.disc-uk.org/docs/guide.pdf Image © JupiterImages Corporation 2007 May 2009 Version 1.2 by Ann Green Stuart Macdonald Robin Rice DISC-UK DataShare project Data Information Specialists Committee -UK Table of Contents i. Introduction 3 ii. Acknowledgements 4 iii. How to use this guide 4 1. Content Coverage 5 a. Scope: subjects and languages 5 b. Kinds of research data 5 c. Status of the research data 6 d. Versions 7 e. Data file formats 8 f. Volume and size limitations 10 2. Metadata 13 a. Access to metadata 13 b. Reuse of metadata 13 c. Metadata types and sources 13 d. Metadata schemas 16 3. Submission of Data (Ingest) 18 a. Eligible depositors 18 b. Moderation by repository 19 c. Data quality requirements 19 d. Confidentiality and disclosure 20 e. Embargo status 21 f. Rights and ownership 22 4. Access and Reuse of Data 24 a. Access to data objects 24 b. Use and reuse of data objects 27 c. Tracking users and use statistics 29 5. Preservation of Data 30 a. Retention period 30 b. Functional preservation 30 c. File preservation 30 d. Fixity and authenticity 31 6. Withdrawal of Data and Succession Plans 33 7. Next Steps 34 8. References 35 INTRODUCTION The Policy-making for Research Data in Repositories: A Guide is intended to be used as a decision-making and planning tool for institutions with digital repositories in existence or in development that are considering adding research data to their digital collections.
    [Show full text]
  • Information Model for Format Implementers
    SDMX STANDARDS: SECTION 6 SDMX TECHNICAL NOTES VERSION 2.1 April 2011 © SDMX 2011 http://www.sdmx.org/ Contents 1 Purpose and Structure.....................................................................................1 1.1 Purpose..............................................................................................................1 1.2 Structure.............................................................................................................1 2 General Notes on This Document...................................................................1 3 Guide for SDMX Format Standards ................................................................2 3.1 Introduction.........................................................................................................2 3.2 SDMX Information Model for Format Implementers...........................................2 3.2.1 Introduction....................................................................................................2 3.3 SDMX-ML and SDMX-EDI: Comparison of Expressive Capabilities and Function .......................................................................................................................3 3.3.1 Format Optimizations and Differences ..........................................................3 3.3.2 Data Types ....................................................................................................4 3.4 SDMX-ML and SDMX-EDI Best Practices .........................................................6 3.4.1 Reporting and Dissemination
    [Show full text]
  • Annex 1 Technology Architecture 1 Source Layer
    Annex 1 Technology Architecture The Technology Architecture is the combined set of software, hardware and networks able to develop and support IT services. This is a high-level map or plan of the information assets in an organization, including the physical design of the building that holds the hardware. This annex is intended to be an overview of software packages existing on the market or developed on request in NSIs in order to describe the solutions that would meet NSI needs, implement S-DWH concept and provide the necessary functionality for each S-DWH level. 1 Source layer The Source layer is the level in which we locate all the activities related to storing and managing internal or external data sources. Internal data are from direct data capturing carried out by CAWI, CAPI or CATI while external data are from administrative archives, for example from Customs Agencies, Revenue Agencies, Chambers of Commerce, Social Security Institutes. Generally, data from direct surveys are well-structured so they can flow directly into the integration layer. This is because NSIs have full control of their own applications. Differently, data from others institution’s archives must come into the S-DWH with their metadata in order to be read correctly. In the early days extracting data from source systems, transforming and loading the data to the target data warehouse was done by writing complex codes which with the advent of efficient tools was an inefficient way to process large volumes of complex data in a timely manner. Nowadays ETL (Extract, Transform and Load) is essential component used to load data into data warehouses from the external sources.
    [Show full text]
  • PDF Presentation
    Dexterity: Data Exchange Tools and Standards for Social Sciences Louise Corti, Herve L’Hours, Matthew Woollard (UKDA) Arofan Gregory, Pascal Heus (ODaF) I-Pres, 29-30 September 2008, London Introduction to DExT data exchange models and data conversion tools for primary research data two aims: z a standard format for representing richly encoded qualitative data z conversion tools from proprietary statistical software to open formats Project Environment JISC funded funded by JISC (Joint Information Systems Committee) Capital Programme: Repositories and Preservation (Tools and Innovations strand) small budget for one year – proof of concept Project Environment UKDA z the leading UK social science data archive z documenting, preserving and disseminating data for over 40 years z pioneered the archiving and sharing of qualitative data at national level z commitment to open standards and formats z support to DExT project through testing, maintaining and embedding conversion tools and standards 1. DExT: qualitative data data selected were from the social sciences ‘qualitative’ data: annotated and coded text, multimedia, linked sources z in-depth and semi-structured interviews z focus groups, observations, field notes, case study notes z diaries, open-ended survey questions z personal documents and photographs the data formats are typically found across all domains of primary research ESDS Qualidata z national service providing access to and support for a range of social science qualitative datasets z part of the ESRC funded Economic and Social
    [Show full text]
  • (I) Functions of Metadata in Statistical Production
    The SDMX Istat Framework. Prepared by Mauro Bianchi, Dario Camol and Laura Vignola, ISTAT, Italy I. INTRODUCTION ISTAT in the two last years have been involved in several Eurostat SDMX projects the Eurostat SODI project, "Demography Pilot Project" and recently to the "Census Hub Pilot Project". The experience acquired during those projects has brought the development team in building the SDMX Framework. The idea was to create a new environment to manage the entire data flow that conducts to the reporting of data and reference metadata in SDMX format. The SDMX Framework, released as open source package, is composed by building blocks that can be also used separately, so that other statistical agencies can re-use and integrate them in their environments II. ARCHITECTURE A. The data framework The framework is composed by modules and classes that permit the user to create the environment, load data, create SDMX data file in compact and cross sectional format and the corresponding RSS (pull method without a web service) and make available data by a web service. 1.2 Manager The application Manager is a Client-Server application that creates the structure of the database. This structure is “SDMX compliant” that is the tables created inside the database contains as object the elements belong to the information model of SDMX (concepts, descriptors, code lists, key families). These tables are populated using the structure files, containing the Data Structure Definitions and all the information contained in these files are stored in specific tables created in the first loading and updated in every future loading if necessary.
    [Show full text]
  • The SDMX Service Architecture for the Perspective of a National Statistical
    Meeting of the Joint OECD/UNECE Expert Group on Statistical Data and Metadata Exchange 8-9 March Palais des Nations, UNECE, Geneva, Switzerland The SDMX service architecture for the perspective of a National Statistical Institute Prepared by [Francesco Rizzo, ISTAT Italy; Adam Wronski, Eurostat; Bengt-Ake Lindblad, Eurostat] I. Introduction 1. For several years the SDMX Sponsor Organisations have been developing software and tools in order to facilitate the introduction of SDMX in their countries. 2. Eurostat has been discussing the effectiveness of these tools with the Member States (MSs) during task forces meetings and working groups. Many suggestions from the MSs were collected which led in 2009 to an internal project named "SDMX implementation and support for Member States". The aim of that project was to develop a set of software, organized in re-usable building blocks and tools to help MSs in implementing an SDMX service infrastructure for a more efficient participation to some SDMX projects currently running within the European Statistical System (e.g. European Census Hub project). 3. A prototype was presented during the "Statistics, Telematic Networks & EDI" Working Group (STNE) in June 2009. The participants welcomed with enthusiasm the initiative and encouraged Eurostat to proceed forward. 4. The main objectives of the project can be listed as follows: (a) To support for the Census Hub project and other Eurostat projects; (b) To facilitate SDMX implementations within the MSs with a particular attention to the large PC- AXIS community; (c) To stimulate a "SDMX community of developer". 5. The project deliverables consist essentially of: (a) the SDMX NSI Reference infrastructure document.
    [Show full text]