Data Registration

From Fusion Registry Wiki
Jump to navigation Jump to search


Overview

A Data Registration tells the Fusion Registry that data exists for a Provision Agreement. Data Registrations are automatically managed by the Fusion Registry for data stores which are managed by the Fusion Registry (Fusion Store and Registry Managed Databases). For data stores which are accessed via a URL (Registered SDMX web services, Files) the Fusion Reigstry must be told where those URLs are via a Data Registration. For externally managed databases, the Fusion Registry will automaitcally create a data registration when the data store is initially linked to, when the data changes in the database, the Fusion Registry must be told to update it's caches via a re-registration request.

Re-Registering Data

User Interface

For registry managed, and external databases and Admin user can re-register data from the admin -> datasources page. For URLs and files data can be re-registered from the home page.

SDMX web Service

Data can be re-registered by submitting a SDMX Data Registration request to the following service.

Entry Point /ws/secure/sdmxapi/rest
Access Private (admin/agency/data provider for the Provision Agreement)
Http Method POST
Accepts SDXM-ML Submit Registration Request
Compression gzip
Content-Type xml
Response Format xml
Response Statuses

200 - registration success

400 - Bad URN syntax

401 - Unauthorized (if access has been restricted)

403 - No results (no data)

500 - Server Error

Example Document

<?xml version="1.0" encoding="UTF-8"?>
<mes:RegistryInterface xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xml="http://www.w3.org/XML/1998/namespace" xmlns:mes="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/message" xmlns:reg="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/registry" xmlns:com="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/common" xsi:schemaLocation="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/message https://registry.sdmx.org/schemas/v2_1/SDMXMessage.xsd">
 <mes:Header>
   <mes:ID>IREF981386</mes:ID>
   <mes:Test>false</mes:Test>
   <mes:Prepared>2020-02-20T11:28:51Z</mes:Prepared>
   <mes:Sender id="S1"/>
   <mes:Receiver id="not_supplied"/>
 </mes:Header>
   <mes:SubmitRegistrationsRequest>
     <reg:RegistrationRequest action="Replace">
       <reg:Registration lastUpdated="2019-03-21T12:58:17" indexReportingPeriod="false" indexDataSet="false" indexAttributes="false" id="1167332d21d37d8589879ce5ff7d35ee" indexTimeSeries="false">
         <reg:ProvisionAgreement>
           <Ref package="registry" agencyID="MY_ACY" id="PROV_ID" version="1.0" class="ProvisionAgreement"/>
         </reg:ProvisionAgreement>
         <reg:Datasource>
           <reg:SimpleDataSource>http://myserver.org/MYDATA.xml</reg:SimpleDataSource>
         </reg:Datasource>
       </reg:Registration>
     </reg:RegistrationRequest>
   </mes:SubmitRegistrationsRequest>
</mes:RegistryInterface>

Alternative web Service

An alternative, and simpler mechanism is via this web service

Entry Point /ws/registry/registration/reRegisterService
Access Private (admin/agency/data provider for the Provision Agreement)
Http Method POST
Accepts application/json
Compression N/A
Content-Type N/A
Response Format application/json
Response Statuses

200 - registration success

400 - Bad URN syntax

401 - Unauthorized (if access has been restricted)

403 - No results (no data)

500 - Server Error

The POST should include the URN of the Provision Agreement to re-register data for, in the body of the message.