Registry Interfaces 1.1 Theresa Dower NAVO/STScI May 2016 IVOA Interoperability Meeting -- Stellenbosch

RI 1.1 Overview Defines web interface for downloading registry contents in whole or partial updates Defines publishing-only and searchable registries NEW: describes IVOA registry ecosystem, Registry of Registries, and best practices for harvesting NEW: does NOT reference any one required web interface for search. May 2016 IVOA Interoperability Meeting -- Stellenbosch

RI 1.1 Status Current version: Working Draft Send to PR after addressing session comments? Current version: http://www.ivoa.net/documents/RegistryInterface/20160413/ (plus some RofR link changes in Volute, not yet rebuilt and re-submitted) https://volute.g-vo.org/svn/trunk/projects/registry/RegistryInterface May 2016 IVOA Interoperability Meeting -- Stellenbosch

RI 1.1 Drivers for Change Drivers for this version change: Remove reliance on specific, outdated technologies for search Include Registry of Registries and harvesting architecture in a formal IVOA document (had previously only been a note) May 2016 IVOA Interoperability Meeting -- Stellenbosch

Removing the obsolete Removed entire section 2 (REQUIRING a particular interface for “fully searchable registry”) ADQL 1.0 (deprecated) XQuery SOAP-based search interface (deprecated as a common practice in favor of REST) May 2016 IVOA Interoperability Meeting -- Stellenbosch

Replacing the obsolete New Section 5: Searching the Registry Cites RegTAP as an example Does not endorse any one particular search interface/technology Registries may advertise various search capabilities as technologies and standards progress May 2016 IVOA Interoperability Meeting -- Stellenbosch

Adding VOSI Added requirement to provide VOSI endpoints: http://www.ivoa.net/documents/VOSI/ CAPABILITY Harvest, old and new search interfaces AVAILABILITY TABLES Only relevant if RegTAP interface available? (for now) May 2016 IVOA Interoperability Meeting -- Stellenbosch

Minor Cleanup: Doc Versions Removed requirement for VOResource version number to match this document May 2016 IVOA Interoperability Meeting -- Stellenbosch

Minor Cleanup: OAI Added requirement for OAI (harvest) interface to support time in seconds Optional in OAI-PMH standard Simpler harvester/client operations All existing registries in the RofR support this already May 2016 IVOA Interoperability Meeting -- Stellenbosch

Minor Cleanup: OAI Dropped the requirement on registries to not deliver any records that the OAI-PMH interface would consider deleted, when no temporal constraint is given http://vao.stsci.edu/directory/oai.aspx?verb=ListRecords&metadataPrefix=ivo_vor&fro m=2016-01-01 vs http://vao.stsci.edu/directory/oai.aspx?verb=ListRecords&metadataPrefix=ivo_vor Extra complexity for server software Sometimes clients would want that information May 2016 IVOA Interoperability Meeting -- Stellenbosch

Minor Cleanup: deletion Clarified that the requirement to keep deleted records for six months only applies to registries claiming to hold records “transient”-ly Added text encouraging registries to support deleted records. Deletion support refers to general registry architecture; some individual interfaces like RegTAP can (or should!) ignore them Not required May 2016 IVOA Interoperability Meeting -- Stellenbosch

Minor Cleanup Harvesting capability’s standard ID now contains version: ivo://ivoa.net/std/Registry#OAI-2.0 Follows general trend to versioning in IVOA capabilities The OAI-PMH standard we are basing the harvesting interface on is at version 2.0 (for some time) https://www.openarchives.org/OAI/openarchivesprotocol.html Not already widely in use (will be a reg provider change) May 2016 IVOA Interoperability Meeting -- Stellenbosch

RofR & Best Practices Added description of RofR and its purpose, plus process for adding registries to the RofR listing and searching. This had previously been an IVOA note (Plante et al) http://www.ivoa.net/documents/cover/RegistryOfRegistries-20070628.html Largest change in the document: please review May 2016 IVOA Interoperability Meeting -- Stellenbosch

RofR & Best Practices Added process for adding a registry to the IVOA registry ecosystem, based on the Registry of Registries IVOA note. In coordination with RofR transfer to CfA Some simplified URLs (old versions will be maintained) http://rofr.ivoa.net/regvalidate/ May 2016 IVOA Interoperability Meeting -- Stellenbosch

RofR & Best Practices Added recommended process for discovery of registries and their resources using the Registry of Registries, based on the Registry of Registries IVOA note. Query RofR for list of registries with set ivo_publishers then Query each listed registry with set ivo_managed May 2016 IVOA Interoperability Meeting -- Stellenbosch

RofR & Best Practices Legacy issue: RofR still lists “fully searchable” registries based on support for ADQL/Xquery/SOAP interface. http://rofr.ivoa.net/ Suggestions for change? May 2016 IVOA Interoperability Meeting -- Stellenbosch

Case of the Missing XSLT One possible remaining todo in document .tex file: Add an appendix with code for translation in OAI interface, converting ivo_vor extension (how we keep our records) to oai_dc default (required by the OAI-PMH 2.0 interface). Note suggests Ray Plante had this available somewhere? May 2016 IVOA Interoperability Meeting -- Stellenbosch