Skip to Content
Version 33.1 by Artur on 2025/09/10 15:05
Hide last authors
Artur 1.1 1 {{box title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 == 3.1 Scope of this Chapter ==
6
Helena 2.1 7 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>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] [[structural metadata>>doc:sdmx:Glossary.Structural metadata.WebHome]] used.
Artur 1.1 8
9 == 3.2 Use Cases ==
10
Helena 2.1 11 [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] supports many use cases.
Artur 1.1 12
13 (% style="width:1268.45px" %)
14 |(% style="width:262px" %)**Use Case**|(% style="width:401px" %)(((
15 **System Processing**
16
17 **Activity**
18 )))|(% style="width:601px" %)**Structural Metadata Requirements**
Helena 2.1 19 |(% style="width:262px" %)Data Reporting|(% style="width:401px" %)Extract data from the source (database, file, spreadsheet)|(% style="width:601px" %)Access to [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]].
20 |(% style="width:262px" %) |(% style="width:401px" %)Write an [[SDMX-ML>>doc:sdmx:Glossary.SDMX-ML.WebHome]] or [[SDMX-EDI>>doc:sdmx:Glossary.SDMX-EDI.WebHome]] [[data set>>doc:sdmx:Glossary.Data set.WebHome]]|(% style="width:601px" %)Access to [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] and possibly [[code>>doc:sdmx:Glossary.Code.WebHome]] transformations and aggregations.
21 |(% style="width:262px" %) |(% style="width:401px" %)Validate the [[data set>>doc:sdmx:Glossary.Data set.WebHome]]|(% style="width:601px" %)Access to the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] or an XML schema derived from it.
Artur 1.1 22 |(% style="width:262px" %)Load data into a database|(% style="width:401px" %)(((
Helena 2.1 23 Read an [[SDMX-ML>>doc:sdmx:Glossary.SDMX-ML.WebHome]] or [[SDMX-EDI>>doc:sdmx:Glossary.SDMX-EDI.WebHome]] [[data set>>doc:sdmx:Glossary.Data set.WebHome]].
Artur 1.1 24
Helena 2.1 25 Validate the [[data set>>doc:sdmx:Glossary.Data set.WebHome]].
Artur 1.1 26
27 Write data to database
Helena 2.1 28 )))|(% style="width:601px" %)Access to [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] and possibly [[code>>doc:sdmx:Glossary.Code.WebHome]] transformations.
29 |(% style="width:262px" %)Report [[reference metadata>>doc:sdmx:Glossary.Reference metadata.WebHome]]|(% style="width:401px" %)Extract metadata from a database|(% style="width:601px" %)Access to [[MSD>>doc:sdmx:Glossary.Metadata structure definition.WebHome]].
30 |(% style="width:262px" %) |(% style="width:401px" %)Write [[metadata set>>doc:sdmx:Glossary.Metadata set.WebHome]]|(% style="width:601px" %)Access to [[MSD>>doc:sdmx:Glossary.Metadata structure definition.WebHome]].
31 |(% style="width:262px" %) |(% style="width:401px" %)Validate [[metadata set>>doc:sdmx:Glossary.Metadata set.WebHome]]|(% style="width:601px" %)Access to [[MSD>>doc:sdmx:Glossary.Metadata structure definition.WebHome]] or schema derived from it.
32 |(% style="width:262px" %)Load [[reference metadata>>doc:sdmx:Glossary.Reference metadata.WebHome]] into a database (often called a [[metadata repository>>doc:sdmx:Glossary.Metadata repository.WebHome]])|(% style="width:401px" %)Read [[SDMX-ML>>doc:sdmx:Glossary.SDMX-ML.WebHome]] metadata.|(% style="width:601px" %)Access to [[MSD>>doc:sdmx:Glossary.Metadata structure definition.WebHome]] and possibly [[code>>doc:sdmx:Glossary.Code.WebHome]] transformations.
33 |(% style="width:262px" %) |(% style="width:401px" %)Write metadata to database|(% style="width:601px" %)Access to [[MSD>>doc:sdmx:Glossary.Metadata structure definition.WebHome]].
Artur 1.1 34 |(% style="width:262px" %)Report data by means of the “pull” method|(% style="width:401px" %)(((
35 Extract data
36
Helena 2.1 37 Write [[data set>>doc:sdmx:Glossary.Data set.WebHome]]
Artur 1.1 38
Helena 2.1 39 Validate [[data set>>doc:sdmx:Glossary.Data set.WebHome]]
40 )))|(% style="width:601px" %)Access to [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]]
Artur 1.1 41 |(% style="width:262px" %) |(% style="width:401px" %)Place the file at a URL location|(% style="width:601px" %)
Helena 2.1 42 |(% style="width:262px" %) |(% style="width:401px" %)Publish the existence of the [[dataset>>doc:sdmx:Glossary.Data set.WebHome]] by means of an [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] Registration|(% style="width:601px" %)[[Provision Agreement>>doc:sdmx:Glossary.Provision agreement.WebHome]] in an [[SDMX Registry>>doc:sdmx:Glossary.SDMX Registry.WebHome]].
43 |(% style="width:262px" %)Database Administration (automatic generation of database tables)|(% style="width:401px" %)Create database tables|(% style="width:601px" %)Access to [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]]
44 |(% style="width:262px" %) |(% style="width:401px" %)Load database|(% style="width:601px" %)Access to [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]]
Artur 1.1 45 |(% style="width:262px" %)(((
Helena 2.1 46 Enable database to be compatible with [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] Web
Artur 1.1 47
48 Services
Elena 4.2 49 )))|(% style="width:401px" %)Accept and process and [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] structure query|(% style="width:601px" %)Access to [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] [[structural metadata>>doc:sdmx:Glossary.Structural metadata.WebHome]] such as [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]], [[MSD>>doc:sdmx:Glossary.Metadata structure definition.WebHome]], [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]], [[Metadata flow>>doc:sdmx:Glossary.Metadataflow.WebHome]], [[Data Provider>>doc:sdmx:Glossary.Data provider.WebHome]], [[Provision Agreement>>doc:sdmx:Glossary.Provision agreement.WebHome]], [[Constraint>>doc:Glossary.Constraint.WebHome]], [[Category Scheme>>doc:sdmx:Glossary.Category scheme.WebHome]].
Helena 2.1 50 |(% style="width:262px" %) |(% style="width:401px" %)Accept and process an [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] data query|(% style="width:601px" %)Access to [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]].
51 |(% style="width:262px" %) |(% style="width:401px" %)Write [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] [[data set>>doc:sdmx:Glossary.Data set.WebHome]]|(% style="width:601px" %)Access to [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]].
52 |(% style="width:262px" %)Data Discovery|(% style="width:401px" %)Locate [[data source>>doc:sdmx:Glossary.Data source.WebHome]]|(% style="width:601px" %)[[Category Scheme>>doc:sdmx:Glossary.Category scheme.WebHome]] and links to [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]], [[Provision Agreement>>doc:sdmx:Glossary.Provision agreement.WebHome]] and data Registration
53 |(% style="width:262px" %)Data and Metadata Query and Visualisation|(% style="width:401px" %)Query an [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] structural repository.|(% style="width:601px" %)Access to [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] [[structural metadata>>doc:sdmx:Glossary.Structural metadata.WebHome]].
54 |(% style="width:262px" %) |(% style="width:401px" %)Create an [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] query from the user selections|(% style="width:601px" %)Access to [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]].
55 |(% style="width:262px" %) |(% style="width:401px" %)Access a [[metadata repository>>doc:sdmx:Glossary.Metadata repository.WebHome]] to extract referential metadata pertaining to the data.|(% style="width:601px" %)Access to [[code lists>>doc:sdmx:Glossary.Code list.WebHome]] and concepts.
56 |(% style="width:262px" %) |(% style="width:401px" %)Transform the [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] data and referential metadata into tables, graphs, charts etc|(% style="width:601px" %)Access to [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] and metadata [[code lists>>doc:sdmx:Glossary.Code list.WebHome]] and concepts.
Artur 1.1 57
58 == 3.3 Scenario ==
59
60 === 3.3.1 Web Dissemination Use Case ===
61
Helena 2.1 62 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>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]]. For instance, a [[Data Structure Definition>>doc:sdmx:Glossary.Data structure definition.WebHome]] is relevant to all use cases concerning data, and an [[SDMX Registry>>doc:sdmx:Glossary.SDMX Registry.WebHome]] is relevant to virtually all use cases. The reason for choosing web dissemination of data and related metadata is twofold:
Artur 1.1 63
Helena 2.1 64 * this single use case uses many of the [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] constructs
65 * it is an increasingly popular use of [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] as it enables organizations to build a self-updating dissemination system
Artur 1.1 66
67 [[image:SDMX_2-1_User_Guide_draft_0-1_html_4cced818dadfe93f.jpg||data-xwiki-image-style-alignment="center" height="409" width="576"]]
68
69 (% style="text-align: center;" %)
Helena 2.1 70 **{{id name="image_1"/}}Figure 1: Process flow of an [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] Web Data Dissemination System**
Artur 1.1 71
72 |**Process**|**Description**
Helena 2.1 73 |1|Retrieve the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] from a [[structural metadata>>doc:sdmx:Glossary.Structural metadata.WebHome]] source (e.g. an [[SDMX Registry>>doc:sdmx:Glossary.SDMX Registry.WebHome]]), and create database tables.
74 |2|Read an [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] [[data set>>doc:sdmx:Glossary.Data set.WebHome]] file and load the data into the database
75 |3|Data discovery system continually synchronises its metadata with the [[structural metadata>>doc:sdmx:Glossary.Structural metadata.WebHome]] source. A user makes a data selection from choices built from the information held in an [[SDMX Registry>>doc:sdmx:Glossary.SDMX Registry.WebHome]] ([[structural metadata>>doc:sdmx:Glossary.Structural metadata.WebHome]] such as [[category scheme>>doc:sdmx:Glossary.Category scheme.WebHome]], [[dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]], [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]], [[data provider>>doc:sdmx:Glossary.Data provider.WebHome]], [[provision agreements>>doc:sdmx:Glossary.Provision agreement.WebHome]] and data registration)
76 |4|These choices are logical choices, built from the [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] selections.
77 |5|The logical choice is formatted as an [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] data query. This is passed to the Data Base which responds with an [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] [[data set>>doc:sdmx:Glossary.Data set.WebHome]].
78 |6|[[Reference metadata>>doc:sdmx:Glossary.Reference metadata.WebHome]] relevant to the data returned is retrieved from a [[metadata repository>>doc:sdmx:Glossary.Metadata repository.WebHome]].
Elena 4.2 79 |7|The 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>>doc:sdmx:Glossary.Data structure definition.WebHome]] or [[MSD>>doc:sdmx:Glossary.Metadata structure definition.WebHome]].
Artur 1.1 80
81 === 3.3.2 Structural Metadata ===
82
Helena 2.1 83 The following [[structural metadata>>doc:sdmx:Glossary.Structural metadata.WebHome]] and provisioning metadata is used in the scenario.
Artur 1.1 84
Helena 2.1 85 [[image:SDMX_2-1_User_Guide_draft_0-1_html_a35ea5c2f2cc1e43.jpg||data-xwiki-image-style-alignment="center" height="436" width="575"]]
Artur 1.1 86
87 (% style="text-align: center;" %)
88 **{{id name="image_2"/}}Figure 2: Structural and Provisioning Metadata Used in the Scenario**
89
90 The content of these metadata is described in the chapters that follow.