Difference between revisions of "Explain Plan Web Services"
Jump to navigation
Jump to search
(→'Explain Map' Web Service) |
(→'Explain Map' Web Service) |
||
| Line 16: | Line 16: | ||
|style="background-color:#eaecf0"|<b>Entry Point</b> || style="min-width:500px;" | <b> ws/secure/structuremap/explainmap</b> | |style="background-color:#eaecf0"|<b>Entry Point</b> || style="min-width:500px;" | <b> ws/secure/structuremap/explainmap</b> | ||
|- | |- | ||
| − | |style="background-color:#eaecf0"|<b>Access</b> || Secure </span> | + | |style="background-color:#eaecf0"|<b>Access</b>|| <span style='color:red'><b>Secure</b></span> Agency and Admin only |
|- | |- | ||
| − | |style="background-color:#eaecf0"|<b>Http Method</b> || POST | + | |style="background-color:#eaecf0"|<b>Authentication</b>|| HTTP Basic Authentication |
| + | |- | ||
| + | |style="background-color:#eaecf0"|<b>Http Method</b>|| POST | ||
| + | |- | ||
| + | |style="background-color:#eaecf0"|<b>Accepts</b>|| SDMX-ML, SDMX-JSON or SDMX-EDI structure message | ||
| + | |- | ||
| + | |style="background-color:#eaecf0"|<b>Content-Type</b>|| <p>1. multipart/form-data (if attaching file) – the attached file must be in field name of uploadFile</p> | ||
| + | <p>2. application/text or application/xml (if submitting data in the body of the POST)</p> | ||
|- | |- | ||
|style="background-color:#eaecf0"|<b>Response Format</b> || application/json (array of objects) | |style="background-color:#eaecf0"|<b>Response Format</b> || application/json (array of objects) | ||
|- | |- | ||
|style="background-color:#eaecf0"|<b>Response Statuses</b> || <p><b>200</b> - Query Ok<p> | |style="background-color:#eaecf0"|<b>Response Statuses</b> || <p><b>200</b> - Query Ok<p> | ||
| + | <p><b>401</b> - Unauthorized (if access has been restricted)</p> | ||
|} | |} | ||
Revision as of 00:53, 8 August 2023
Contents
Overview
The Registry has the User Interface feature "Test Mapping" which can be used to test an input file against a Mapping. This feature is very useful when debugging why a mapping did not occur. This page details how to directly call the Web Services that perform the explanation of a mapping
Note: This UI feature and the Web Services require authentication into the Registry
The Web Services
There are 2 Web Services. The firsts "explains" why the
'Explain Map' Web Service
- An HTTP POST request
- Takes the parameters "URN" and the input file
- Returns the mapped and unmapped keys
| Entry Point | ws/secure/structuremap/explainmap |
| Access | Secure Agency and Admin only |
| Authentication | HTTP Basic Authentication |
| Http Method | POST |
| Accepts | SDMX-ML, SDMX-JSON or SDMX-EDI structure message |
| Content-Type | 1. multipart/form-data (if attaching file) – the attached file must be in field name of uploadFile 2. application/text or application/xml (if submitting data in the body of the POST) |
| Response Format | application/json (array of objects) |
| Response Statuses | 200 - Query Ok
401 - Unauthorized (if access has been restricted) |
'Explain Plan' Web Service
- An HTTP GET request
- Takes the parameters "dsd", "map", "key"
- Returns the input, mappings and output
Entry Point: <registry>ws/secure/structuremap/explainplan
