Use the Web Services Page to build queries on Structures

Overview

The Web Services page allows you to use the on-screen options to build a Query URL. The query URL can be used for a variety of purposes and more detail can be found in the Web Services User Guide. This article concentrates on using this page to retrieve and submit structures.

As selections are made from the options, you will notice that the URL will change. The URL can also be manipulated manually by adding other path parameters as detailed in the Web Services User Guide however some useful examples are shown later in this article.

Options

Structure Type

Clicking the dropdown will display a list of all possible structures. The last option on the list is All Structures which should be used with caution depending on the size of the Registry.

Agency

Clicking the dropdown will display a list of all the Agencies in the Registry. The first option on the list is All Agencies which should be used with caution depending on the on the size of the Registry and the Structure Type selected above.

Version

The default is Latest but it is possible to choose All or to select a specific Version Number too.

Structure Format

The Structure Format and Structure Sub-Format dropdown messages display the options available. For structures which are not part of the SDMX 2.1 Standards, Fusion-JSON can be used.

Pretty Print XML

The output produced will use an indented style which makes it easier to view.

Detail

Option	Description
Full (Default)	The structures will be output in full (including any referenced structures)
All Stubs	Instead of full, the output will be embedded as “stubs” that contain the reference from where the structures can be retrieved.
Reference Stubs	The selected structure(s) will be output if full with and referenced structures as stubs.
Reference Partial	Outputs the full query result and any referenced Codelists, Concept Schemes, Agency Schemes are returned as partial lists based on the Codes, Concepts, and Agencies used by the referencing Provision Agreements, Dataflows, Data Structures, Hierarchical Codelists. Partial Codelists are derived from Content Constraints used to define allowable content for data reporting.

Useful Parameters=

Multiple Versions

+ Operator	URL
Use this to obtain a number of versions as shown in the example which is a request for versions 1.0, 1.1 and 1.2 of a specific Codelist	http://localhost:8085/FusionRegistry/ws/public/sdmxapi/rest/codelist/MY_AGENCY/CL_AREAS/1.0+1.1+1.2/?format=sdmx-2.1&detail=full&references=none