Jumps: IvoaResReg :: registry mail archive :: RegistryMetadata :: VOResourceV10 :: RegUpgradeSummer2006
Meetings: InterOpMay2011Registry :: InterOpMay2006ResReg :: InterOpSep2006ResReg

Registry Interfaces

This page tracks the evolution of IVOA Registry Interfaces, particularly the standard interfaces and supporting tools.

Current Development

Work is beginning to develop a new registry search interface. See RestfulRegistryInterfaceReq where we are gathering requirements and use cases, and RI2Discussion for a fairly concrete proposal ("RegTAP").

Registry Interfaces v1.0

IVOA Standard Specification

IVOA Recommendation

IVOA Registry Interfaces v1.0 2009-11-04
KevinBenson, RayPlante, Editors
Closed Request For Comment

This document defines two interfaces to Registries: a search interface for discovery of resources based on their descriptions' contents, and a harvest interface that allows registries to replicated other registries' records.

Earlier versions can be found in document repository as well as attached to this page.

WSDLs and Schemas

The RI specification defines 2 WSDL file--one for the search interface and one for the harvest interface. Both import a common RegistryInterface schema. These are available here:

• RegistrySearch-v1.0.wsdl
• RegistryHarvest-v1.0.wsdl
• RegistryInterface-v1.0.xsd

The above files import the VOResource-v1.0.xsd schema, and so legal VOResource extensions can be used as part of the interface messages. The currently IVOA-recognized VOResource extension schemas, including samples, are available from RegUpgradeSummer2006 individually or as a bundle (tar, zip).

KevinBenson has zipped up all the schema and WSDL files necessary to generate software stubs into a single zip bundle. Note that this contains a slightly out-of-date version of VOResource-v1.0.xsd, and an old version of OpenSkyNode schema. While it is probably not necessary to update the VOResource schema file; one should download the latest OpenSkyNode-v0.2.xsd

Note: The RegistrySearch-v1.0.wsdl file is changing prior to PR; for details see the note, RIWSDLCorrection

Useful Software

Registry Implementations

• VORegistryInABox: As an implementation of a publishing registry, this provides supports on the Harvesting interface
• Carnivore: A full registry implementation built on an XML database
• Astrogrid Registry: A deployable implementation of a publishing or full registry, built upon an XML database.

Registry Clients

• IVOAHarvester: a reference implementation of a harvester of other registries that includes validation
• IVOARegistry: a client command-line application and reference library for querying searchable registries
• VOExplorer : a graphical client application for searching registries
• commandline scripts for querying searchable registries. Uses Astro Runtime

ADQL to SQL Parsing

Deprecated

An XSLT stylesheet for converting ADQL v1.0 to SQL can be downloaded here : adql2sql_v10_registry.xsl.
This file should work just fine for v0.9 and v0.8, just by changing the namespace declaration.
Note that the xPath expressions still need to be converted to your database column names. -- AurelienStebe - 23 Aug 2005