Skip to Content
Last modified by Helena on 2025/09/10 11:19
From version 1.1
edited by Artur
on 2025/04/21 12:12
Change comment: Imported from XAR
To version 2.1
edited by Helena
on 2025/05/23 17:15
Change comment: There is no comment for this version

Summary

Details

Page properties
Parent
... ... @@ -1,1 +1,1 @@
1 -Methodology.SDMX 2\.1 User Guide.WebHome
1 +WebHome
Author
... ... @@ -1,1 +1,1 @@
1 -xwiki:XWiki.arturkryazhev
1 +xwiki:XWiki.helena
Content
... ... @@ -4,21 +4,21 @@
4 4  
5 5  == 15.1 Scope ==
6 6  
7 -This annex includes a set of example queries which walk through the process of querying a data source for the purposes of data discovery. It also includes an additional section which details some of the advanced features of the SDMX query message.
7 +This annex includes a set of example queries which walk through the process of querying a [[data source>>doc:sdmx:Glossary.Data source.WebHome]] for the purposes of data discovery. It also includes an additional section which details some of the advanced features of the [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] query message.
8 8  
9 9  == 15.2 Discovering Categories ==
10 10  
11 -The first step a user may take in discovering data is to see the categories which data might be classified against. In this example scenario, a user is trying to find exchange rate data from the European Central Bank. The first step is to discover if there is a category for such data.
11 +The first step a user may take in discovering data is to see the [[categories>>doc:sdmx:Glossary.Category.WebHome]] which data might be classified against. In this example scenario, a user is trying to find exchange rate data from the European Central Bank. The first step is to discover if there is a [[category>>doc:sdmx:Glossary.Category.WebHome]] for such data.
12 12  
13 13  === 15.2.1 REST ===
14 14  
15 -In the REST syntax, there is no means to search based on text, so the simplest means for the user to find the exchange rate category is to retrieve all categories and filter through the results. Such a query would be structured as follows:
15 +In the REST syntax, there is no means to search based on text, so the simplest means for the user to find the exchange rate [[category>>doc:sdmx:Glossary.Category.WebHome]] is to retrieve all [[categories>>doc:sdmx:Glossary.Category.WebHome]] and filter through the results. Such a query would be structured as follows:
16 16  
17 17  http:~/~/ws-entry-point/categoryscheme
18 18  
19 19  A sample result for this can be seen in the sample file, ecb_query/ecb_exr_category_rest.xml.
20 20  
21 -Note that the entire category scheme is returned. If the data source had more category schemes, these would have been returned as well.
21 +Note that the entire [[category scheme>>doc:sdmx:Glossary.Category scheme.WebHome]] is returned. If the [[data source>>doc:sdmx:Glossary.Data source.WebHome]] had more [[category schemes>>doc:sdmx:Glossary.Category scheme.WebHome]], these would have been returned as well.
22 22  
23 23  === 15.2.2 SOAP ===
24 24  
... ... @@ -36,10 +36,8 @@
36 36  
37 37  http:~/~/ws-entry-point/categoryscheme/ECB/SDW_ECONOMIC_CONCEPTS/1.0?references="parentan dsiblings"
38 38  
39 -Note the references parameter. It specifies parent (i.e. objects referencing the queried object) and siblings, objects referenced directly from the parent object. This will return categorisations which reference the categories of the queried category scheme and the objects which these categorisations categorise. The sample file,
39 +Note the references parameter. It specifies parent (i.e. objects referencing the queried object) and siblings, objects referenced directly from the parent object. This will return categorisations which reference the categories of the queried category scheme and the objects which these categorisations categorise. The sample file, ecb_query/ecb_exr_dataflow_rest.xml shows the result of this query. Note that this assumes that there is only one data flow categorised against the one category. In reality, all categorisations and their objects for the entire category scheme would be returned.
40 40  
41 -ecb_query/ecb_exr_dataflow_rest.xml shows the result of this query. Note that this assumes that there is only one data flow categorised against the one category. In reality, all categorisations and their objects for the entire category scheme would be returned.
42 -
43 43  === 15.3.2 SOAP ===
44 44  
45 45  The SOAP syntax is able to take a much more direct approach. It can query directly for categorisations which use the specific effective exchange rate category, and only categorisation which categorise data flows. Further, it can omit the actual categorisation from the results, leaving only the dataflow to be returned. The sample file, ecb_query\ecb_exr_dataflow_query.xml shows this sample query and ecb_query\ecb_exr_dataflow_soap.xml shows the result.