Upgrade to Registry Interface v1.0 (Spring 2007)

This page will provide useful information for registry providers regarding the upgrade schedule, upgrade requirements, links to schemas and tools, etc.

Contents

Roadmap

Please update this schedule as necessary. The initial dates have been taken from the roadmap described in InterOpMay2006ResReg and are subject to change pending discussion by the WG.

We are strongly encouraging registry providers to maintain the old registry interfaces beyond the "change-over" date to support existing applications. Note, however, that after the switch, the old interfaces may not continue to be updated.

Meetings and Discussion

• Registry Provider Telecon, 14 June 2006: Minutes
• Moscow Interop Meeting: InterOpSep2006ResReg

Standard Schemas and WSDLs

VOResource Schemas and Example Instances (Release Candidate 11 2006-11-07)

The VOResource core schema is documented in the Working Draft, VOResource: an XML Encoding Schema for Resource Metadata. The current version under review is VOResource-20061107; the associated Schema files is available at both at http://www.ivoa.net/xml/ and below.

All of the schemas and examples can be downloaded together: VOResource-v1.0.tar.gz, VOResource-v1.0.zip.

Individual examples:

Several of the examples use STC which requires stc-v1.30.xsd and xlink.xsd.

Note: Prior to 26 June, several of the schemas had versions set to 0.9; they have now been elevated to v1.0.

-- RayPlante - 5 April 2007

Interface WSDLs

A version 1.0 of the RI spec has been submitted to the IVOA document repository. There is a small errata plus an internal WD waiting in the wings on the RegistryInterface twiki page. Consult this document for examples of how to include VOResource metadata within the interface messages.

The RI specification defines 2 WSDL files--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

More info about the RI spec, including getting Kevin's last bundle of WSDLs and Schemas, conult the RegistryInterface page.

Remember: The WSDL/SOAP-based Harvesting interface is optional; if your registry is harvestable, the standard GET-based version of OAI is required.

XSL conversion stylesheets

For v1.02 (Release Cand. 11):

VOResource-v0.10-v1.0.xsl2

XSL stylesheet for converting v0.10 to v1.0 records. (Updated 5 April 2007)

This stylesheet requires an XSLT 2.0 processor, such as the Saxon engine, available in saxon8.jar. To run, type:

java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml

where resource-v0.10.xml is the v0.10 resource record to convert.

Caveats

• If you notice any problems let RayPlante know
• I have not yet plugged in support for CEA
• When you process a registry record, a warning message is generated indicating that you must update certain information "by hand".
• The created and updated attributes are now required by the VOResource core schema; if they are not set in the input document, a dummy value will be inserted and a warning message generated.

An update of the earlier released XSLTv1.0 stylesheet is also available; however, it does not set namespace declarations properly.

-- RayPlante - 31 Oct 2006

Software Tools and Testers

• ivoaregistry: a registry search Java library and tester.
  • Download as a zip file: ireg-linux.zip
    • "linux" means the command line wrapper script is for *nix OSes; the Windows version is not yet included.
    • It is pre-built, but can be re-built with ant
    • Requires at least Java 1.5
  • The net.ivoa.registry.search.RegistrySearchClient class provides a Java API to the standard IVOA Registry Search Interface.
  • The regsearch command line tool can be used to test the interface
    • to install, first run "bin/install_tools"
    • see top section of bin/regsearch for usage details
    • it's still a little clunky for using in scripts.

• Registry of Registries: Preliminary release
  • OAI interface at http://nvo.ncsa.uiuc.edu/cgi-bin/rofr
  • Fully v1.0 compliant
  • can be used to test Harvesting
  • registration and registry checking coming next.

<-- 

 

 

 Set ALLOWTOPICRENAME = TWikiAdminGroup
 
 
-->

Upgrade to Registry Interface v1.0 (Spring 2007)

This page will provide useful information for registry providers regarding the upgrade schedule, upgrade requirements, links to schemas and tools, etc.

Contents

Roadmap

Please update this schedule as necessary. The initial dates have been taken from the roadmap described in InterOpMay2006ResReg and are subject to change pending discussion by the WG.

We are strongly encouraging registry providers to maintain the old registry interfaces beyond the "change-over" date to support existing applications. Note, however, that after the switch, the old interfaces may not continue to be updated.

Meetings and Discussion

• Registry Provider Telecon, 14 June 2006: Minutes
• Moscow Interop Meeting: InterOpSep2006ResReg

Standard Schemas and WSDLs

VOResource Schemas and Example Instances (Release Candidate 11 2006-11-07)

The VOResource core schema is documented in the Working Draft, VOResource: an XML Encoding Schema for Resource Metadata. The current version under review is VOResource-20061107; the associated Schema files is available at both at http://www.ivoa.net/xml/ and below.

All of the schemas and examples can be downloaded together: VOResource-v1.0.tar.gz, VOResource-v1.0.zip.

Individual examples:

Several of the examples use STC which requires stc-v1.30.xsd and xlink.xsd.

Note: Prior to 26 June, several of the schemas had versions set to 0.9; they have now been elevated to v1.0.

-- RayPlante - 5 April 2007

Interface WSDLs

A version 1.0 of the RI spec has been submitted to the IVOA document repository. There is a small errata plus an internal WD waiting in the wings on the RegistryInterface twiki page. Consult this document for examples of how to include VOResource metadata within the interface messages.

The RI specification defines 2 WSDL files--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

More info about the RI spec, including getting Kevin's last bundle of WSDLs and Schemas, conult the RegistryInterface page.

Remember: The WSDL/SOAP-based Harvesting interface is optional; if your registry is harvestable, the standard GET-based version of OAI is required.

XSL conversion stylesheets

For v1.02 (Release Cand. 11):

VOResource-v0.10-v1.0.xsl2

XSL stylesheet for converting v0.10 to v1.0 records. (Updated 5 April 2007)

This stylesheet requires an XSLT 2.0 processor, such as the Saxon engine, available in saxon8.jar. To run, type:

java -jar saxon8.jar resource-v0.10.xml VOResource-v0.10-v1.0.xsl2 > resource-v1.0.xml

where resource-v0.10.xml is the v0.10 resource record to convert.

Caveats

• If you notice any problems let RayPlante know
• I have not yet plugged in support for CEA
• When you process a registry record, a warning message is generated indicating that you must update certain information "by hand".
• The created and updated attributes are now required by the VOResource core schema; if they are not set in the input document, a dummy value will be inserted and a warning message generated.

An update of the earlier released XSLTv1.0 stylesheet is also available; however, it does not set namespace declarations properly.

-- RayPlante - 31 Oct 2006

Software Tools and Testers

• ivoaregistry: a registry search Java library and tester.
  • Download as a zip file: ireg-linux.zip
    • "linux" means the command line wrapper script is for *nix OSes; the Windows version is not yet included.
    • It is pre-built, but can be re-built with ant
    • Requires at least Java 1.5
  • The net.ivoa.registry.search.RegistrySearchClient class provides a Java API to the standard IVOA Registry Search Interface.
  • The regsearch command line tool can be used to test the interface
    • to install, first run "bin/install_tools"
    • see top section of bin/regsearch for usage details
    • it's still a little clunky for using in scripts.

• Registry of Registries: Preliminary release
  • OAI interface at http://nvo.ncsa.uiuc.edu/cgi-bin/rofr
  • Fully v1.0 compliant
  • can be used to test Harvesting
  • registration and registry checking coming next.

<-- 

 

 

 Set ALLOWTOPICRENAME = TWikiAdminGroup
 
 
-->