3 Use Cases, Scenario, and Example

Last modified by Artur on 2025/07/14 10:19

3.1 Scope of this Chapter

In order to present a common theme throughout this User Guide a common set of use cases, a common scenario, and a common set of examples are used. This chapter specifies the use cases, scenario, and the example SDMX structural metadata used.

3.2 Use Cases

SDMX supports many use cases.

Use Case

System Processing

Activity

Structural Metadata Requirements
Data ReportingExtract data from the source (database, file, spreadsheet)Access to DSD.
 Write an SDMX-ML or SDMX-EDI data setAccess to DSD and possibly code transformations and aggregations.
 Validate the data setAccess to the DSD or an XML schema derived from it.
Load data into a database

Read an SDMX-ML or SDMX-EDI data set.

Validate the data set.

Write data to database

Access to DSD and possibly code transformations.
Report reference metadataExtract metadata from a databaseAccess to MSD.
 Write metadata setAccess to MSD.
 Validate metadata setAccess to MSD or schema derived from it.
Load reference metadata into a database (often called a metadata repository)Read SDMX-ML metadata.Access to MSD and possibly code transformations.
 Write metadata to databaseAccess to MSD.
Report data by means of the “pull” method

Extract data

Write data set

Validate data set

Access to DSD
 Place the file at a URL location 
 Publish the existence of the dataset by means of an SDMX RegistrationProvision Agreement in an SDMX Registry.
Database Administration (automatic generation of database tables)Create database tablesAccess to DSD
 Load databaseAccess to DSD

Enable database to be compatible with SDMX Web

Services

Accept and process and SDMX structure queryAccess to SDMX structural metadata such as DSD, MSD, Dataflow, Metadata flow, Data Provider, Provision Agreement, Constraint, Category Scheme.
 Accept and process an SDMX data queryAccess to DSD.
 Write SDMX data setAccess to DSD.
Data DiscoveryLocate data sourceCategory Scheme and links to Dataflow, Provision Agreement and data Registration
Data and Metadata Query and VisualisationQuery an SDMX structural repository.Access to SDMX structural metadata.
 Create an SDMX query from the user selectionsAccess to DSD.
 Access a metadata repository to extract referential metadata pertaining to the data.Access to code lists and concepts.
 Transform the SDMX data and referential metadata into tables, graphs, charts etcAccess to DSD and metadata code lists and concepts.

3.3 Scenario

3.3.1 Web Dissemination Use Case

The use of web dissemination is the prime use case for this User Guide and the chapters in this guide follow this process flow. However, the topic of each chapter is relevant to more than this single use case of SDMX. For instance, a Data Structure Definition is relevant to all use cases concerning data, and an SDMX Registry is relevant to virtually all use cases. The reason for choosing web dissemination of data and related metadata is twofold:

  • this single use case uses many of the SDMX constructs
  • it is an increasingly popular use of SDMX as it enables organizations to build a self-updating dissemination system

SDMX_2-1_User_Guide_draft_0-1_html_4cced818dadfe93f.jpg

Figure 1: Process flow of an SDMX Web Data Dissemination System

ProcessDescription
1Retrieve the DSD from a structural metadata source (e.g. an SDMX Registry), and create database tables.
2Read an SDMX data set file and load the data into the database
3Data discovery system continually synchronises its metadata with the structural metadata source. A user makes a data selection from choices built from the information held in an SDMX Registry (structural metadata such as category scheme, dataflow, DSD, data provider, provision agreements and data registration)
4These choices are logical choices, built from the dimension selections.
5The logical choice is formatted as an SDMX data query. This is passed to the Data Base which responds with an SDMX data set.
6Reference metadata relevant to the data returned is retrieved from a metadata repository.
7The data and metadata are passed to a visualization tool to display the data in tables, charts, graphs, maps etc. Often a download is offered in various formats. The download options often include also the DSD or MSD.

3.3.2 Structural Metadata

The following structural metadata and provisioning metadata is used in the scenario.

SDMX_2-1_User_Guide_draft_0-1_html_a35ea5c2f2cc1e43.jpg

Figure 2: Structural and Provisioning Metadata Used in the Scenario

The content of these metadata is described in the chapters that follow.