Difference: VOResourceV010 (1 vs. 13)

Revision 132012-06-26 - root

 
META TOPICPARENT name="RWP03Specs"
Jumps: IvoaResReg :: registry mail archive :: ResourceMetadata :: RWP03RefBack :: RWP03Disc

Registry Working Group WP3 (Metadata Specifications)

VOResource v0.10 and its Standard Extensions

Contents


News

3 Nov 2004: VOResource-v0.10.xsd was updated with a bug fix to allow multiple occurances of the Type element. As a bug fix (that happens to be backward compatible), the version number is not changed.

The Schemas

VOResource, in general, refers to a family of schemas that includes the core schema (VOResource-v0.10) and a set of standard extensions. These schemas are have been released from the official IVOA schema distribution area. To validate documents compliant with this release you need each of the following schemas:

Schema Description Documentation
VOResource-v0.10.xsd requires VOResourceRelType-v0.10.xsd core resource metadata coming soon
VORegistry-v0.3.xsd extension for describing registries and naming authorities coming soon
VODataService-v0.5.xsd requires VODataServiceCoverage-v0.5.xsd extension for describing data and services coming soon

The following two extensions are extensions that define specific, standard tabular sky services.

ConeSearch-v0.3.xsd extension for describing Cone Search Services service spec.,
schema docs: coming soon
SIA-v0.7.xsd extension for describing Simple Image Access Services service spec.,
schema docs: coming soon

You can download all the schemas (with the examples) in a single bundle. Two versions are available. When these packages are unpacked, all of the files are put in the current directory.

VOResource-v0.10 (tar.gzzip)
the official schemas from the table above.

VOResource-v0.10-local (tar.gzzip)
the official schemas with "schemaLocation" set to look for imports on local disk. This version enables a verifier to look for schemas in the current directory instead from the IVOA site. Use this version when developing off-line or with tools that have trouble finding imported schemas.

Example documents

organisation.xml
o  a simple description of an organisation
o  uses only the core VOResource schema

collection.xml
o  a description of a data collection
o  uses VOResource and VODataService
o  includes a simple coverage description

webform.xml
o  a description of an archive search page used interactively with a browser
o  described as a resource of type SkyService
o  illustrates the use of the "service-for" relationship
o  uses VOResource and VODataService

conesearch.xml
o  a description of a Cone Search service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and ConeSearch

sia.xml
o  a description of a Simple Image Access service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and SIA

registry.xml
o  a description of a registry (as a service).
o  uses VOResource, VODataService, and VORegistry

authority.xml
o  a description of a naming authority
o  used to register authority names in a registry.
o  uses uses VOResource and VORegistry

What's New in this Release

The primary change is the way extensions are handled: we have dropped the use of substitution groups and replaced them with the use of xsi:type. What looked like this in release v0.9...

<!-- the old way -->
<VOResource xmlns="..." >
   <vs:SkyService>
      ...
   </vr:SkyService>

...now looks like this...

&lt;!-- the new way --&gt;
&lt;resource xsi:type="vs:SkyService" xmlns="..." &gt;
      ...

That is, you now see both specific type (SkyService) and the base concept it extends (resource) in the same element.

Here's an abridged list of changes made. (A more complete description can be found here.)

  • only global types are defined (anonymous types are avoided).
  • no global elements are defined; an application that uses VOResource can define its own global element(s) to use as a root element as necessary.
  • references to other resources has been simplified
  • the logical ID element has been dropped
  • the generic Capabilities element has been dropped; specific standard services (e.g. ConeSearch, SimpleImageAccess) define these in their extensions.

About the root element

As mentioned above, VOResource defines no global elements. The proper root element is expected to be defined by the application, as necessary, via its own application schema. For example, a particular application might define the following schema:

&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;xs:schema targetNamespace="http://astroservices.org/ResourceApplication"
           xmlns:xs="http://www.w3.org/2001/XMLSchema" 
           xmlns:vr="http://www.ivoa.net/xml/VOResource/v0.10" 
           xmlns:ra="http://astroservices.org/ResourceApplication" 
           elementFormDefault="qualified"
           attributeFormDefault="unqualified"
           version="0.10"&gt;

   &lt;xs:annotation&gt;
      &lt;xs:documenation&gt; application schema using VOResource &lt;/xs:documenation&gt;
   &lt;/xs:annotation&gt;

   &lt;xs:import namespace="http://www.ivoa.net/xml/VOResource/v0.10" /&gt;

   &lt;xs:element name="ResourceDescription" type="vr:Resource"/&gt;

   &lt;xs:element name="Resources"&gt;
      &lt;xs:complexType&gt;
         &lt;xs:sequence&gt;
            &lt;xs:element ref="ra:ResourceDescription" maxOccurs="unbounded" /&gt;
         &lt;/xs:sequence&gt;
      &lt;/xs:complexType&gt;
   &lt;/xs:element&gt;

&lt;/xs:schema&gt;

In this example, two global elements have been defined, either which can be used as a root element. The application would use this simple schema to verify its documents.

Note that in the example instance documents listed above, an application schema is not needed. That's because the root element in each case specifies its type using an xsi:type attribute. According to the XML Schema standard, this is sufficient to verify the document.

It is expected that registry applications will use "resource" as the root element, just like in the examples listed above.

Useful Tools

Conversion Stylesheets

Background Materials

What's Ahead in Future Versions

  • If no fundemental problems are found with this release, it is expected that:
    • the next release of VOResource will be v1.0
    • each of the extensions will begin to evolve separately.
  • VORegistry will likely be updated as the standard Registry Interface is refined.




META FILEATTACHMENT attr="" comment="Converts v0.9 VOResource documents to v0.10" date="1097707415" name="VOResource-v0.9-v0.10.xsl" path="VOResource-v0.9-v0.10.xsl" size="56896" user="RayPlante" version="1.2"
META FILEATTACHMENT attr="" comment="Converts v0.10 VOResource documents to v0.9" date="1089836202" name="VOResource-v0.10-v0.9.xsl" path="VOResource-v0.10-v0.9.xsl" size="59716" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="All schemas and examples in the v0.10 release" date="1099498982" name="VOResource-v0.10.tar.gz" path="VOResource-v0.10.tar.gz" size="20866" user="RayPlante" version="1.2"
META FILEATTACHMENT attr="" comment="All schemas and examples in the v0.10 release" date="1099499076" name="VOResource-v0.10.zip" path="VOResource-v0.10.zip" size="28931" user="RayPlante" version="1.2"
META FILEATTACHMENT attr="" comment="Alll schemas & examples, for local disk access" date="1099499159" name="VOResource-v0.10-local.tar.gz" path="VOResource-v0.10-local.tar.gz" size="20950" user="RayPlante" version="1.2"
META FILEATTACHMENT attr="" comment="All schemas & examples, for local disk access" date="1099499270" name="VOResource-v0.10-local.zip" path="VOResource-v0.10-local.zip" size="29108" user="RayPlante" version="1.2"
META FILEATTACHMENT attr="h" comment="" date="1089951746" name="authority.xml" path="authority.xml" size="1666" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951798" name="collection.xml" path="collection.xml" size="3056" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951870" name="conesearch.xml" path="conesearch.xml" size="3810" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951964" name="organisation.xml" path="organisation.xml" size="1592" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952026" name="registry.xml" path="registry.xml" size="2448" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952189" name="sia.xml" path="sia.xml" size="8248" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952320" name="webform.xml" path="webform.xml" size="2518" user="RayPlante" version="1.1"

Revision 122006-05-20 - RayPlante

 
META TOPICPARENT name="RWP03Specs"
Jumps: IvoaResReg :: registry mail archive :: ResourceMetadata :: RWP03RefBack :: RWP03Disc

Registry Working Group WP3 (Metadata Specifications)

VOResource v0.10 and its Standard Extensions

Contents


News

3 Nov 2004: VOResource-v0.10.xsd was updated with a bug fix to allow multiple occurances of the Type element. As a bug fix (that happens to be backward compatible), the version number is not changed.

The Schemas

VOResource, in general, refers to a family of schemas that includes the core schema (VOResource-v0.10) and a set of standard extensions. These schemas are have been released from the official IVOA schema distribution area. To validate documents compliant with this release you need each of the following schemas:

Schema Description Documentation
VOResource-v0.10.xsd requires VOResourceRelType-v0.10.xsd core resource metadata coming soon
VORegistry-v0.3.xsd extension for describing registries and naming authorities coming soon
VODataService-v0.5.xsd requires VODataServiceCoverage-v0.5.xsd extension for describing data and services coming soon

The following two extensions are extensions that define specific, standard tabular sky services.

ConeSearch-v0.3.xsd extension for describing Cone Search Services service spec.,
schema docs: coming soon
SIA-v0.7.xsd extension for describing Simple Image Access Services service spec.,
schema docs: coming soon

You can download all the schemas (with the examples) in a single bundle. Two versions are available. When these packages are unpacked, all of the files are put in the current directory.

VOResource-v0.10 (tar.gzzip)
the official schemas from the table above.

VOResource-v0.10-local (tar.gzzip)
the official schemas with "schemaLocation" set to look for imports on local disk. This version enables a verifier to look for schemas in the current directory instead from the IVOA site. Use this version when developing off-line or with tools that have trouble finding imported schemas.

Example documents

organisation.xml
o  a simple description of an organisation
o  uses only the core VOResource schema

collection.xml
o  a description of a data collection
o  uses VOResource and VODataService
o  includes a simple coverage description

webform.xml
o  a description of an archive search page used interactively with a browser
o  described as a resource of type SkyService
o  illustrates the use of the "service-for" relationship
o  uses VOResource and VODataService

conesearch.xml
o  a description of a Cone Search service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and ConeSearch

sia.xml
o  a description of a Simple Image Access service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and SIA

registry.xml
o  a description of a registry (as a service).
o  uses VOResource, VODataService, and VORegistry

authority.xml
o  a description of a naming authority
o  used to register authority names in a registry.
o  uses uses VOResource and VORegistry

What's New in this Release

The primary change is the way extensions are handled: we have dropped the use of substitution groups and replaced them with the use of xsi:type. What looked like this in release v0.9...

Changed:
<
<
<!-- the old way --> <VOResource xmlns="..." > <vs:SkyService>
>
>
<-- the old way -->
  ...
Added:
>
>
 

...now looks like this...

&lt;!-- the new way --&gt;
&lt;resource xsi:type="vs:SkyService" xmlns="..." &gt;
      ...

That is, you now see both specific type (SkyService) and the base concept it extends (resource) in the same element.

Here's an abridged list of changes made. (A more complete description can be found here.)

  • only global types are defined (anonymous types are avoided).
  • no global elements are defined; an application that uses VOResource can define its own global element(s) to use as a root element as necessary.
  • references to other resources has been simplified
  • the logical ID element has been dropped
  • the generic Capabilities element has been dropped; specific standard services (e.g. ConeSearch, SimpleImageAccess) define these in their extensions.

About the root element

As mentioned above, VOResource defines no global elements. The proper root element is expected to be defined by the application, as necessary, via its own application schema. For example, a particular application might define the following schema:

&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;xs:schema targetNamespace="http://astroservices.org/ResourceApplication"
           xmlns:xs="http://www.w3.org/2001/XMLSchema" 
           xmlns:vr="http://www.ivoa.net/xml/VOResource/v0.10" 
           xmlns:ra="http://astroservices.org/ResourceApplication" 
           elementFormDefault="qualified"
           attributeFormDefault="unqualified"
           version="0.10"&gt;

   &lt;xs:annotation&gt;
      &lt;xs:documenation&gt; application schema using VOResource &lt;/xs:documenation&gt;
   &lt;/xs:annotation&gt;

   &lt;xs:import namespace="http://www.ivoa.net/xml/VOResource/v0.10" /&gt;

   &lt;xs:element name="ResourceDescription" type="vr:Resource"/&gt;

   &lt;xs:element name="Resources"&gt;
      &lt;xs:complexType&gt;
         &lt;xs:sequence&gt;
            &lt;xs:element ref="ra:ResourceDescription" maxOccurs="unbounded" /&gt;
         &lt;/xs:sequence&gt;
      &lt;/xs:complexType&gt;
   &lt;/xs:element&gt;

&lt;/xs:schema&gt;

In this example, two global elements have been defined, either which can be used as a root element. The application would use this simple schema to verify its documents.

Note that in the example instance documents listed above, an application schema is not needed. That's because the root element in each case specifies its type using an xsi:type attribute. According to the XML Schema standard, this is sufficient to verify the document.

It is expected that registry applications will use "resource" as the root element, just like in the examples listed above.

Useful Tools

Conversion Stylesheets

Background Materials

What's Ahead in Future Versions

  • If no fundemental problems are found with this release, it is expected that:
    • the next release of VOResource will be v1.0
    • each of the extensions will begin to evolve separately.
  • VORegistry will likely be updated as the standard Registry Interface is refined.




<--  
-->

META FILEATTACHMENT attr="" comment="Converts v0.9 VOResource documents to v0.10" date="1097707415" name="VOResource-v0.9-v0.10.xsl" path="VOResource-v0.9-v0.10.xsl" size="56896" user="RayPlante" version="1.2"
META FILEATTACHMENT attr="" comment="Converts v0.10 VOResource documents to v0.9" date="1089836202" name="VOResource-v0.10-v0.9.xsl" path="VOResource-v0.10-v0.9.xsl" size="59716" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="All schemas and examples in the v0.10 release" date="1099498982" name="VOResource-v0.10.tar.gz" path="VOResource-v0.10.tar.gz" size="20866" user="RayPlante" version="1.2"
META FILEATTACHMENT attr="" comment="All schemas and examples in the v0.10 release" date="1099499076" name="VOResource-v0.10.zip" path="VOResource-v0.10.zip" size="28931" user="RayPlante" version="1.2"
META FILEATTACHMENT attr="" comment="Alll schemas & examples, for local disk access" date="1099499159" name="VOResource-v0.10-local.tar.gz" path="VOResource-v0.10-local.tar.gz" size="20950" user="RayPlante" version="1.2"
META FILEATTACHMENT attr="" comment="All schemas & examples, for local disk access" date="1099499270" name="VOResource-v0.10-local.zip" path="VOResource-v0.10-local.zip" size="29108" user="RayPlante" version="1.2"
META FILEATTACHMENT attr="h" comment="" date="1089951746" name="authority.xml" path="authority.xml" size="1666" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951798" name="collection.xml" path="collection.xml" size="3056" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951870" name="conesearch.xml" path="conesearch.xml" size="3810" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951964" name="organisation.xml" path="organisation.xml" size="1592" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952026" name="registry.xml" path="registry.xml" size="2448" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952189" name="sia.xml" path="sia.xml" size="8248" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952320" name="webform.xml" path="webform.xml" size="2518" user="RayPlante" version="1.1"

Revision 112005-03-12 - ChenzhouCui

 
META TOPICPARENT name="RWP03Specs"
Jumps: IvoaResReg :: registry mail archive :: ResourceMetadata :: RWP03RefBack :: RWP03Disc

Registry Working Group WP3 (Metadata Specifications)

VOResource v0.10 and its Standard Extensions

Contents


News

3 Nov 2004: VOResource-v0.10.xsd was updated with a bug fix to allow multiple occurances of the Type element. As a bug fix (that happens to be backward compatible), the version number is not changed.

The Schemas

VOResource, in general, refers to a family of schemas that includes the core schema (VOResource-v0.10) and a set of standard extensions. These schemas are have been released from the official IVOA schema distribution area. To validate documents compliant with this release you need each of the following schemas:

Schema Description Documentation
VOResource-v0.10.xsd requires VOResourceRelType-v0.10.xsd core resource metadata coming soon
VORegistry-v0.3.xsd extension for describing registries and naming authorities coming soon
VODataService-v0.5.xsd requires VODataServiceCoverage-v0.5.xsd extension for describing data and services coming soon

The following two extensions are extensions that define specific, standard tabular sky services.

ConeSearch-v0.3.xsd extension for describing Cone Search Services service spec.,
schema docs: coming soon
SIA-v0.7.xsd extension for describing Simple Image Access Services service spec.,
schema docs: coming soon

You can download all the schemas (with the examples) in a single bundle. Two versions are available. When these packages are unpacked, all of the files are put in the current directory.

VOResource-v0.10 (tar.gzzip)
the official schemas from the table above.

VOResource-v0.10-local (tar.gzzip)
the official schemas with "schemaLocation" set to look for imports on local disk. This version enables a verifier to look for schemas in the current directory instead from the IVOA site. Use this version when developing off-line or with tools that have trouble finding imported schemas.

Example documents

organisation.xml
o  a simple description of an organisation
o  uses only the core VOResource schema

collection.xml
o  a description of a data collection
o  uses VOResource and VODataService
o  includes a simple coverage description

webform.xml
o  a description of an archive search page used interactively with a browser
o  described as a resource of type SkyService
o  illustrates the use of the "service-for" relationship
o  uses VOResource and VODataService
Changed:
<
<
conesearch.xml
o  a description of a Cone Search service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and ConeSearch
>
>
conesearch.xml
o  a description of a Cone Search service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and ConeSearch
 
sia.xml
o  a description of a Simple Image Access service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and SIA

registry.xml
o  a description of a registry (as a service).
o  uses VOResource, VODataService, and VORegistry

authority.xml
o  a description of a naming authority
o  used to register authority names in a registry.
o  uses uses VOResource and VORegistry

What's New in this Release

The primary change is the way extensions are handled: we have dropped the use of substitution groups and replaced them with the use of xsi:type. What looked like this in release v0.9...

&lt;!-- the old way --&gt;
&lt;VOResource xmlns="..." &gt;
   &lt;vs:SkyService&gt;
      ...

...now looks like this...

&lt;!-- the new way --&gt;
&lt;resource xsi:type="vs:SkyService" xmlns="..." &gt;
      ...

That is, you now see both specific type (SkyService) and the base concept it extends (resource) in the same element.

Here's an abridged list of changes made. (A more complete description can be found here.)

  • only global types are defined (anonymous types are avoided).
  • no global elements are defined; an application that uses VOResource can define its own global element(s) to use as a root element as necessary.
  • references to other resources has been simplified
  • the logical ID element has been dropped
  • the generic Capabilities element has been dropped; specific standard services (e.g. ConeSearch, SimpleImageAccess) define these in their extensions.

About the root element

As mentioned above, VOResource defines no global elements. The proper root element is expected to be defined by the application, as necessary, via its own application schema. For example, a particular application might define the following schema:

&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;xs:schema targetNamespace="http://astroservices.org/ResourceApplication"
           xmlns:xs="http://www.w3.org/2001/XMLSchema" 
           xmlns:vr="http://www.ivoa.net/xml/VOResource/v0.10" 
           xmlns:ra="http://astroservices.org/ResourceApplication" 
           elementFormDefault="qualified"
           attributeFormDefault="unqualified"
           version="0.10"&gt;

   &lt;xs:annotation&gt;
      &lt;xs:documenation&gt; application schema using VOResource &lt;/xs:documenation&gt;
   &lt;/xs:annotation&gt;

   &lt;xs:import namespace="http://www.ivoa.net/xml/VOResource/v0.10" /&gt;

   &lt;xs:element name="ResourceDescription" type="vr:Resource"/&gt;

   &lt;xs:element name="Resources"&gt;
      &lt;xs:complexType&gt;
         &lt;xs:sequence&gt;
            &lt;xs:element ref="ra:ResourceDescription" maxOccurs="unbounded" /&gt;
         &lt;/xs:sequence&gt;
      &lt;/xs:complexType&gt;
   &lt;/xs:element&gt;

&lt;/xs:schema&gt;

In this example, two global elements have been defined, either which can be used as a root element. The application would use this simple schema to verify its documents.

Note that in the example instance documents listed above, an application schema is not needed. That's because the root element in each case specifies its type using an xsi:type attribute. According to the XML Schema standard, this is sufficient to verify the document.

It is expected that registry applications will use "resource" as the root element, just like in the examples listed above.

Useful Tools

Conversion Stylesheets

Background Materials

What's Ahead in Future Versions

  • If no fundemental problems are found with this release, it is expected that:
    • the next release of VOResource will be v1.0
    • each of the extensions will begin to evolve separately.
  • VORegistry will likely be updated as the standard Registry Interface is refined.




<--  
-->

META FILEATTACHMENT attr="" comment="Converts v0.9 VOResource documents to v0.10" date="1097707415" name="VOResource-v0.9-v0.10.xsl" path="VOResource-v0.9-v0.10.xsl" size="56896" user="RayPlante" version="1.2"
META FILEATTACHMENT attr="" comment="Converts v0.10 VOResource documents to v0.9" date="1089836202" name="VOResource-v0.10-v0.9.xsl" path="VOResource-v0.10-v0.9.xsl" size="59716" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="All schemas and examples in the v0.10 release" date="1099498982" name="VOResource-v0.10.tar.gz" path="VOResource-v0.10.tar.gz" size="20866" user="RayPlante" version="1.2"
META FILEATTACHMENT attr="" comment="All schemas and examples in the v0.10 release" date="1099499076" name="VOResource-v0.10.zip" path="VOResource-v0.10.zip" size="28931" user="RayPlante" version="1.2"
META FILEATTACHMENT attr="" comment="Alll schemas & examples, for local disk access" date="1099499159" name="VOResource-v0.10-local.tar.gz" path="VOResource-v0.10-local.tar.gz" size="20950" user="RayPlante" version="1.2"
META FILEATTACHMENT attr="" comment="All schemas & examples, for local disk access" date="1099499270" name="VOResource-v0.10-local.zip" path="VOResource-v0.10-local.zip" size="29108" user="RayPlante" version="1.2"
META FILEATTACHMENT attr="h" comment="" date="1089951746" name="authority.xml" path="authority.xml" size="1666" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951798" name="collection.xml" path="collection.xml" size="3056" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951870" name="conesearch.xml" path="conesearch.xml" size="3810" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951964" name="organisation.xml" path="organisation.xml" size="1592" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952026" name="registry.xml" path="registry.xml" size="2448" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952189" name="sia.xml" path="sia.xml" size="8248" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952320" name="webform.xml" path="webform.xml" size="2518" user="RayPlante" version="1.1"

Revision 102004-11-03 - RayPlante

 
META TOPICPARENT name="RWP03Specs"
Jumps: IvoaResReg :: registry mail archive :: ResourceMetadata :: RWP03RefBack :: RWP03Disc

Registry Working Group WP3 (Metadata Specifications)

VOResource v0.10 and its Standard Extensions

Contents


Added:
>
>

News

 
Added:
>
>
3 Nov 2004: VOResource-v0.10.xsd was updated with a bug fix to allow multiple occurances of the Type element. As a bug fix (that happens to be backward compatible), the version number is not changed.
 

The Schemas

VOResource, in general, refers to a family of schemas that includes the core schema (VOResource-v0.10) and a set of standard extensions. These schemas are have been released from the official IVOA schema distribution area. To validate documents compliant with this release you need each of the following schemas:

Schema Description Documentation
VOResource-v0.10.xsd requires VOResourceRelType-v0.10.xsd core resource metadata coming soon
VORegistry-v0.3.xsd extension for describing registries and naming authorities coming soon
VODataService-v0.5.xsd requires VODataServiceCoverage-v0.5.xsd extension for describing data and services coming soon

The following two extensions are extensions that define specific, standard tabular sky services.

ConeSearch-v0.3.xsd extension for describing Cone Search Services service spec.,
schema docs: coming soon
SIA-v0.7.xsd extension for describing Simple Image Access Services service spec.,
schema docs: coming soon

You can download all the schemas (with the examples) in a single bundle. Two versions are available. When these packages are unpacked, all of the files are put in the current directory.

VOResource-v0.10 (tar.gzzip)
the official schemas from the table above.

VOResource-v0.10-local (tar.gzzip)
the official schemas with "schemaLocation" set to look for imports on local disk. This version enables a verifier to look for schemas in the current directory instead from the IVOA site. Use this version when developing off-line or with tools that have trouble finding imported schemas.

Example documents

organisation.xml
o  a simple description of an organisation
o  uses only the core VOResource schema

collection.xml
o  a description of a data collection
o  uses VOResource and VODataService
o  includes a simple coverage description

webform.xml
o  a description of an archive search page used interactively with a browser
o  described as a resource of type SkyService
o  illustrates the use of the "service-for" relationship
o  uses VOResource and VODataService

conesearch.xml
o  a description of a Cone Search service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and ConeSearch

sia.xml
o  a description of a Simple Image Access service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and SIA

registry.xml
o  a description of a registry (as a service).
o  uses VOResource, VODataService, and VORegistry

authority.xml
o  a description of a naming authority
o  used to register authority names in a registry.
o  uses uses VOResource and VORegistry

What's New in this Release

The primary change is the way extensions are handled: we have dropped the use of substitution groups and replaced them with the use of xsi:type. What looked like this in release v0.9...

&lt;!-- the old way --&gt;
&lt;VOResource xmlns="..." &gt;
   &lt;vs:SkyService&gt;
      ...

...now looks like this...

&lt;!-- the new way --&gt;
&lt;resource xsi:type="vs:SkyService" xmlns="..." &gt;
      ...

That is, you now see both specific type (SkyService) and the base concept it extends (resource) in the same element.

Here's an abridged list of changes made. (A more complete description can be found here.)

  • only global types are defined (anonymous types are avoided).
  • no global elements are defined; an application that uses VOResource can define its own global element(s) to use as a root element as necessary.
  • references to other resources has been simplified
  • the logical ID element has been dropped
  • the generic Capabilities element has been dropped; specific standard services (e.g. ConeSearch, SimpleImageAccess) define these in their extensions.

About the root element

As mentioned above, VOResource defines no global elements. The proper root element is expected to be defined by the application, as necessary, via its own application schema. For example, a particular application might define the following schema:

&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;xs:schema targetNamespace="http://astroservices.org/ResourceApplication"
           xmlns:xs="http://www.w3.org/2001/XMLSchema" 
           xmlns:vr="http://www.ivoa.net/xml/VOResource/v0.10" 
           xmlns:ra="http://astroservices.org/ResourceApplication" 
           elementFormDefault="qualified"
           attributeFormDefault="unqualified"
           version="0.10"&gt;

   &lt;xs:annotation&gt;
      &lt;xs:documenation&gt; application schema using VOResource &lt;/xs:documenation&gt;
   &lt;/xs:annotation&gt;

   &lt;xs:import namespace="http://www.ivoa.net/xml/VOResource/v0.10" /&gt;

   &lt;xs:element name="ResourceDescription" type="vr:Resource"/&gt;

   &lt;xs:element name="Resources"&gt;
      &lt;xs:complexType&gt;
         &lt;xs:sequence&gt;
            &lt;xs:element ref="ra:ResourceDescription" maxOccurs="unbounded" /&gt;
         &lt;/xs:sequence&gt;
      &lt;/xs:complexType&gt;
   &lt;/xs:element&gt;

&lt;/xs:schema&gt;

In this example, two global elements have been defined, either which can be used as a root element. The application would use this simple schema to verify its documents.

Note that in the example instance documents listed above, an application schema is not needed. That's because the root element in each case specifies its type using an xsi:type attribute. According to the XML Schema standard, this is sufficient to verify the document.

It is expected that registry applications will use "resource" as the root element, just like in the examples listed above.

Useful Tools

Conversion Stylesheets

Background Materials

What's Ahead in Future Versions

  • If no fundemental problems are found with this release, it is expected that:
    • the next release of VOResource will be v1.0
    • each of the extensions will begin to evolve separately.
  • VORegistry will likely be updated as the standard Registry Interface is refined.




<--  
-->

META FILEATTACHMENT attr="" comment="Converts v0.9 VOResource documents to v0.10" date="1097707415" name="VOResource-v0.9-v0.10.xsl" path="VOResource-v0.9-v0.10.xsl" size="56896" user="RayPlante" version="1.2"
META FILEATTACHMENT attr="" comment="Converts v0.10 VOResource documents to v0.9" date="1089836202" name="VOResource-v0.10-v0.9.xsl" path="VOResource-v0.10-v0.9.xsl" size="59716" user="RayPlante" version="1.1"
Changed:
<
<
META FILEATTACHMENT attr="" comment="All schemas and examples in the v0.10 release" date="1089951180" name="VOResource-v0.10.tar.gz" path="VOResource-v0.10.tar.gz" size="20854" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="All schemas and examples in the v0.10 release" date="1089951338" name="VOResource-v0.10.zip" path="VOResource-v0.10.zip" size="28928" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="Alll schemas & examples, for local disk access" date="1089951469" name="VOResource-v0.10-local.tar.gz" path="VOResource-v0.10-local.tar.gz" size="20863" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="All schemas & examples, for local disk access" date="1089951600" name="VOResource-v0.10-local.zip" path="VOResource-v0.10-local.zip" size="29105" user="RayPlante" version="1.1"
>
>
META FILEATTACHMENT attr="" comment="All schemas and examples in the v0.10 release" date="1099498982" name="VOResource-v0.10.tar.gz" path="VOResource-v0.10.tar.gz" size="20866" user="RayPlante" version="1.2"
META FILEATTACHMENT attr="" comment="All schemas and examples in the v0.10 release" date="1099499076" name="VOResource-v0.10.zip" path="VOResource-v0.10.zip" size="28931" user="RayPlante" version="1.2"
META FILEATTACHMENT attr="" comment="Alll schemas & examples, for local disk access" date="1099499159" name="VOResource-v0.10-local.tar.gz" path="VOResource-v0.10-local.tar.gz" size="20950" user="RayPlante" version="1.2"
META FILEATTACHMENT attr="" comment="All schemas & examples, for local disk access" date="1099499270" name="VOResource-v0.10-local.zip" path="VOResource-v0.10-local.zip" size="29108" user="RayPlante" version="1.2"
 
META FILEATTACHMENT attr="h" comment="" date="1089951746" name="authority.xml" path="authority.xml" size="1666" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951798" name="collection.xml" path="collection.xml" size="3056" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951870" name="conesearch.xml" path="conesearch.xml" size="3810" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951964" name="organisation.xml" path="organisation.xml" size="1592" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952026" name="registry.xml" path="registry.xml" size="2448" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952189" name="sia.xml" path="sia.xml" size="8248" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952320" name="webform.xml" path="webform.xml" size="2518" user="RayPlante" version="1.1"

Revision 92004-10-13 - RayPlante

 
META TOPICPARENT name="RWP03Specs"
Jumps: IvoaResReg :: registry mail archive :: ResourceMetadata :: RWP03RefBack :: RWP03Disc

Registry Working Group WP3 (Metadata Specifications)

VOResource v0.10 and its Standard Extensions

Contents


The Schemas

VOResource, in general, refers to a family of schemas that includes the core schema (VOResource-v0.10) and a set of standard extensions. These schemas are have been released from the official IVOA schema distribution area. To validate documents compliant with this release you need each of the following schemas:

Schema Description Documentation
VOResource-v0.10.xsd requires VOResourceRelType-v0.10.xsd core resource metadata coming soon
VORegistry-v0.3.xsd extension for describing registries and naming authorities coming soon
VODataService-v0.5.xsd requires VODataServiceCoverage-v0.5.xsd extension for describing data and services coming soon

The following two extensions are extensions that define specific, standard tabular sky services.

ConeSearch-v0.3.xsd extension for describing Cone Search Services service spec.,
schema docs: coming soon
SIA-v0.7.xsd extension for describing Simple Image Access Services service spec.,
schema docs: coming soon

You can download all the schemas (with the examples) in a single bundle. Two versions are available. When these packages are unpacked, all of the files are put in the current directory.

VOResource-v0.10 (tar.gzzip)
the official schemas from the table above.

VOResource-v0.10-local (tar.gzzip)
the official schemas with "schemaLocation" set to look for imports on local disk. This version enables a verifier to look for schemas in the current directory instead from the IVOA site. Use this version when developing off-line or with tools that have trouble finding imported schemas.

Example documents

organisation.xml
o  a simple description of an organisation
o  uses only the core VOResource schema

collection.xml
o  a description of a data collection
o  uses VOResource and VODataService
o  includes a simple coverage description

webform.xml
o  a description of an archive search page used interactively with a browser
o  described as a resource of type SkyService
o  illustrates the use of the "service-for" relationship
o  uses VOResource and VODataService

conesearch.xml
o  a description of a Cone Search service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and ConeSearch

sia.xml
o  a description of a Simple Image Access service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and SIA

registry.xml
o  a description of a registry (as a service).
o  uses VOResource, VODataService, and VORegistry

authority.xml
o  a description of a naming authority
o  used to register authority names in a registry.
o  uses uses VOResource and VORegistry

What's New in this Release

The primary change is the way extensions are handled: we have dropped the use of substitution groups and replaced them with the use of xsi:type. What looked like this in release v0.9...

&lt;!-- the old way --&gt;
&lt;VOResource xmlns="..." &gt;
   &lt;vs:SkyService&gt;
      ...

...now looks like this...

&lt;!-- the new way --&gt;
&lt;resource xsi:type="vs:SkyService" xmlns="..." &gt;
      ...

That is, you now see both specific type (SkyService) and the base concept it extends (resource) in the same element.

Here's an abridged list of changes made. (A more complete description can be found here.)

  • only global types are defined (anonymous types are avoided).
  • no global elements are defined; an application that uses VOResource can define its own global element(s) to use as a root element as necessary.
  • references to other resources has been simplified
  • the logical ID element has been dropped
  • the generic Capabilities element has been dropped; specific standard services (e.g. ConeSearch, SimpleImageAccess) define these in their extensions.

About the root element

As mentioned above, VOResource defines no global elements. The proper root element is expected to be defined by the application, as necessary, via its own application schema. For example, a particular application might define the following schema:

&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;xs:schema targetNamespace="http://astroservices.org/ResourceApplication"
           xmlns:xs="http://www.w3.org/2001/XMLSchema" 
           xmlns:vr="http://www.ivoa.net/xml/VOResource/v0.10" 
           xmlns:ra="http://astroservices.org/ResourceApplication" 
           elementFormDefault="qualified"
           attributeFormDefault="unqualified"
           version="0.10"&gt;

   &lt;xs:annotation&gt;
      &lt;xs:documenation&gt; application schema using VOResource &lt;/xs:documenation&gt;
   &lt;/xs:annotation&gt;

   &lt;xs:import namespace="http://www.ivoa.net/xml/VOResource/v0.10" /&gt;

   &lt;xs:element name="ResourceDescription" type="vr:Resource"/&gt;

   &lt;xs:element name="Resources"&gt;
      &lt;xs:complexType&gt;
         &lt;xs:sequence&gt;
            &lt;xs:element ref="ra:ResourceDescription" maxOccurs="unbounded" /&gt;
         &lt;/xs:sequence&gt;
      &lt;/xs:complexType&gt;
   &lt;/xs:element&gt;

&lt;/xs:schema&gt;

In this example, two global elements have been defined, either which can be used as a root element. The application would use this simple schema to verify its documents.

Note that in the example instance documents listed above, an application schema is not needed. That's because the root element in each case specifies its type using an xsi:type attribute. According to the XML Schema standard, this is sufficient to verify the document.

It is expected that registry applications will use "resource" as the root element, just like in the examples listed above.

Useful Tools

Conversion Stylesheets

Background Materials

What's Ahead in Future Versions

  • If no fundemental problems are found with this release, it is expected that:
    • the next release of VOResource will be v1.0
    • each of the extensions will begin to evolve separately.
  • VORegistry will likely be updated as the standard Registry Interface is refined.




<--  
-->

Changed:
<
<
META FILEATTACHMENT attr="" comment="Converts v0.9 VOResource documents to v0.10" date="1089836148" name="VOResource-v0.9-v0.10.xsl" path="VOResource-v0.9-v0.10.xsl" size="56781" user="RayPlante" version="1.1"
>
>
META FILEATTACHMENT attr="" comment="Converts v0.9 VOResource documents to v0.10" date="1097707415" name="VOResource-v0.9-v0.10.xsl" path="VOResource-v0.9-v0.10.xsl" size="56896" user="RayPlante" version="1.2"
 
META FILEATTACHMENT attr="" comment="Converts v0.10 VOResource documents to v0.9" date="1089836202" name="VOResource-v0.10-v0.9.xsl" path="VOResource-v0.10-v0.9.xsl" size="59716" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="All schemas and examples in the v0.10 release" date="1089951180" name="VOResource-v0.10.tar.gz" path="VOResource-v0.10.tar.gz" size="20854" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="All schemas and examples in the v0.10 release" date="1089951338" name="VOResource-v0.10.zip" path="VOResource-v0.10.zip" size="28928" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="Alll schemas & examples, for local disk access" date="1089951469" name="VOResource-v0.10-local.tar.gz" path="VOResource-v0.10-local.tar.gz" size="20863" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="All schemas & examples, for local disk access" date="1089951600" name="VOResource-v0.10-local.zip" path="VOResource-v0.10-local.zip" size="29105" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951746" name="authority.xml" path="authority.xml" size="1666" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951798" name="collection.xml" path="collection.xml" size="3056" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951870" name="conesearch.xml" path="conesearch.xml" size="3810" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951964" name="organisation.xml" path="organisation.xml" size="1592" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952026" name="registry.xml" path="registry.xml" size="2448" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952189" name="sia.xml" path="sia.xml" size="8248" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952320" name="webform.xml" path="webform.xml" size="2518" user="RayPlante" version="1.1"

Revision 82004-10-08 - MarcoLeoni

 
META TOPICPARENT name="RWP03Specs"
Changed:
<
<
Jumps: IvoaResReg :: registry mail archive :: ResourceMetadata :: RWP03RefBack :: RWP03Disc
Meetings: Registry19032003 :: InterOpMay2003ResReg :: InterOpMay2004ResReg
>
>
Jumps: IvoaResReg :: registry mail archive :: ResourceMetadata :: RWP03RefBack :: RWP03Disc
 

Registry Working Group WP3 (Metadata Specifications)

VOResource v0.10 and its Standard Extensions

Contents


The Schemas

VOResource, in general, refers to a family of schemas that includes the core schema (VOResource-v0.10) and a set of standard extensions. These schemas are have been released from the official IVOA schema distribution area. To validate documents compliant with this release you need each of the following schemas:

Schema Description Documentation
VOResource-v0.10.xsd requires VOResourceRelType-v0.10.xsd core resource metadata coming soon
VORegistry-v0.3.xsd extension for describing registries and naming authorities coming soon
VODataService-v0.5.xsd requires VODataServiceCoverage-v0.5.xsd extension for describing data and services coming soon

The following two extensions are extensions that define specific, standard tabular sky services.

ConeSearch-v0.3.xsd extension for describing Cone Search Services service spec.,
schema docs: coming soon
SIA-v0.7.xsd extension for describing Simple Image Access Services service spec.,
schema docs: coming soon

You can download all the schemas (with the examples) in a single bundle. Two versions are available. When these packages are unpacked, all of the files are put in the current directory.

Changed:
<
<
VOResource-v0.10 (tar.gzzip)
the official schemas from the table above.
>
>
VOResource-v0.10 (tar.gzzip)
the official schemas from the table above.
 
Changed:
<
<
VOResource-v0.10-local (tar.gzzip)
the official schemas with "schemaLocation" set to look for imports on local disk. This version enables a verifier to look for schemas in the current directory instead from the IVOA site. Use this version when developing off-line or with tools that have trouble finding imported schemas.
>
>
VOResource-v0.10-local (tar.gzzip)
the official schemas with "schemaLocation" set to look for imports on local disk. This version enables a verifier to look for schemas in the current directory instead from the IVOA site. Use this version when developing off-line or with tools that have trouble finding imported schemas.
 

Example documents

organisation.xml
o  a simple description of an organisation
o  uses only the core VOResource schema

collection.xml
o  a description of a data collection
o  uses VOResource and VODataService
o  includes a simple coverage description

webform.xml
o  a description of an archive search page used interactively with a browser
o  described as a resource of type SkyService
o  illustrates the use of the "service-for" relationship
o  uses VOResource and VODataService

conesearch.xml
o  a description of a Cone Search service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and ConeSearch

sia.xml
o  a description of a Simple Image Access service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and SIA

registry.xml
o  a description of a registry (as a service).
o  uses VOResource, VODataService, and VORegistry

authority.xml
o  a description of a naming authority
o  used to register authority names in a registry.
o  uses uses VOResource and VORegistry

What's New in this Release

The primary change is the way extensions are handled: we have dropped the use of substitution groups and replaced them with the use of xsi:type. What looked like this in release v0.9...

&lt;!-- the old way --&gt;
&lt;VOResource xmlns="..." &gt;
   &lt;vs:SkyService&gt;
      ...

...now looks like this...

&lt;!-- the new way --&gt;
&lt;resource xsi:type="vs:SkyService" xmlns="..." &gt;
      ...

That is, you now see both specific type (SkyService) and the base concept it extends (resource) in the same element.

Here's an abridged list of changes made. (A more complete description can be found here.)

  • only global types are defined (anonymous types are avoided).
  • no global elements are defined; an application that uses VOResource can define its own global element(s) to use as a root element as necessary.
  • references to other resources has been simplified
  • the logical ID element has been dropped
  • the generic Capabilities element has been dropped; specific standard services (e.g. ConeSearch, SimpleImageAccess) define these in their extensions.

About the root element

As mentioned above, VOResource defines no global elements. The proper root element is expected to be defined by the application, as necessary, via its own application schema. For example, a particular application might define the following schema:

&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;xs:schema targetNamespace="http://astroservices.org/ResourceApplication"
           xmlns:xs="http://www.w3.org/2001/XMLSchema" 
           xmlns:vr="http://www.ivoa.net/xml/VOResource/v0.10" 
           xmlns:ra="http://astroservices.org/ResourceApplication" 
           elementFormDefault="qualified"
           attributeFormDefault="unqualified"
           version="0.10"&gt;

   &lt;xs:annotation&gt;
      &lt;xs:documenation&gt; application schema using VOResource &lt;/xs:documenation&gt;
   &lt;/xs:annotation&gt;

   &lt;xs:import namespace="http://www.ivoa.net/xml/VOResource/v0.10" /&gt;

   &lt;xs:element name="ResourceDescription" type="vr:Resource"/&gt;

   &lt;xs:element name="Resources"&gt;
      &lt;xs:complexType&gt;
         &lt;xs:sequence&gt;
            &lt;xs:element ref="ra:ResourceDescription" maxOccurs="unbounded" /&gt;
         &lt;/xs:sequence&gt;
      &lt;/xs:complexType&gt;
   &lt;/xs:element&gt;

&lt;/xs:schema&gt;

In this example, two global elements have been defined, either which can be used as a root element. The application would use this simple schema to verify its documents.

Note that in the example instance documents listed above, an application schema is not needed. That's because the root element in each case specifies its type using an xsi:type attribute. According to the XML Schema standard, this is sufficient to verify the document.

It is expected that registry applications will use "resource" as the root element, just like in the examples listed above.

Useful Tools

Conversion Stylesheets

Background Materials

What's Ahead in Future Versions

  • If no fundemental problems are found with this release, it is expected that:
    • the next release of VOResource will be v1.0
    • each of the extensions will begin to evolve separately.
  • VORegistry will likely be updated as the standard Registry Interface is refined.




<--  
-->

META FILEATTACHMENT attr="" comment="Converts v0.9 VOResource documents to v0.10" date="1089836148" name="VOResource-v0.9-v0.10.xsl" path="VOResource-v0.9-v0.10.xsl" size="56781" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="Converts v0.10 VOResource documents to v0.9" date="1089836202" name="VOResource-v0.10-v0.9.xsl" path="VOResource-v0.10-v0.9.xsl" size="59716" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="All schemas and examples in the v0.10 release" date="1089951180" name="VOResource-v0.10.tar.gz" path="VOResource-v0.10.tar.gz" size="20854" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="All schemas and examples in the v0.10 release" date="1089951338" name="VOResource-v0.10.zip" path="VOResource-v0.10.zip" size="28928" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="Alll schemas & examples, for local disk access" date="1089951469" name="VOResource-v0.10-local.tar.gz" path="VOResource-v0.10-local.tar.gz" size="20863" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="All schemas & examples, for local disk access" date="1089951600" name="VOResource-v0.10-local.zip" path="VOResource-v0.10-local.zip" size="29105" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951746" name="authority.xml" path="authority.xml" size="1666" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951798" name="collection.xml" path="collection.xml" size="3056" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951870" name="conesearch.xml" path="conesearch.xml" size="3810" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951964" name="organisation.xml" path="organisation.xml" size="1592" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952026" name="registry.xml" path="registry.xml" size="2448" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952189" name="sia.xml" path="sia.xml" size="8248" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952320" name="webform.xml" path="webform.xml" size="2518" user="RayPlante" version="1.1"

Revision 72004-10-08 - MarcoLeoni

 
META TOPICPARENT name="RWP03Specs"
Jumps: IvoaResReg :: registry mail archive :: ResourceMetadata :: RWP03RefBack :: RWP03Disc
Meetings: Registry19032003 :: InterOpMay2003ResReg :: InterOpMay2004ResReg

Registry Working Group WP3 (Metadata Specifications)

VOResource v0.10 and its Standard Extensions

Contents

Added:
>
>

 

The Schemas

VOResource, in general, refers to a family of schemas that includes the core schema (VOResource-v0.10) and a set of standard extensions. These schemas are have been released from the official IVOA schema distribution area. To validate documents compliant with this release you need each of the following schemas:

Schema
<-- -->
Sorted ascending
Description Documentation
VODataService-v0.5.xsd requires VODataServiceCoverage-v0.5.xsd extension for describing data and services coming soon
VORegistry-v0.3.xsd extension for describing registries and naming authorities coming soon
VOResource-v0.10.xsd requires VOResourceRelType-v0.10.xsd core resource metadata coming soon

The following two extensions are extensions that define specific, standard tabular sky services.

ConeSearch-v0.3.xsd extension for describing Cone Search Services service spec.,
schema docs: coming soon
SIA-v0.7.xsd extension for describing Simple Image Access Services service spec.,
schema docs: coming soon

You can download all the schemas (with the examples) in a single bundle. Two versions are available. When these packages are unpacked, all of the files are put in the current directory.

VOResource-v0.10 (tar.gzzip)
the official schemas from the table above.

VOResource-v0.10-local (tar.gzzip)
the official schemas with "schemaLocation" set to look for imports on local disk. This version enables a verifier to look for schemas in the current directory instead from the IVOA site. Use this version when developing off-line or with tools that have trouble finding imported schemas.

Example documents

organisation.xml
o  a simple description of an organisation
o  uses only the core VOResource schema

collection.xml
o  a description of a data collection
o  uses VOResource and VODataService
o  includes a simple coverage description

webform.xml
o  a description of an archive search page used interactively with a browser
o  described as a resource of type SkyService
o  illustrates the use of the "service-for" relationship
o  uses VOResource and VODataService

conesearch.xml
o  a description of a Cone Search service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and ConeSearch

sia.xml
o  a description of a Simple Image Access service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and SIA

registry.xml
o  a description of a registry (as a service).
o  uses VOResource, VODataService, and VORegistry

authority.xml
o  a description of a naming authority
o  used to register authority names in a registry.
o  uses uses VOResource and VORegistry

What's New in this Release

The primary change is the way extensions are handled: we have dropped the use of substitution groups and replaced them with the use of xsi:type. What looked like this in release v0.9...

&lt;!-- the old way --&gt;
&lt;VOResource xmlns="..." &gt;
   &lt;vs:SkyService&gt;
      ...

...now looks like this...

&lt;!-- the new way --&gt;
&lt;resource xsi:type="vs:SkyService" xmlns="..." &gt;
      ...

That is, you now see both specific type (SkyService) and the base concept it extends (resource) in the same element.

Here's an abridged list of changes made. (A more complete description can be found here.)

  • only global types are defined (anonymous types are avoided).
  • no global elements are defined; an application that uses VOResource can define its own global element(s) to use as a root element as necessary.
  • references to other resources has been simplified
  • the logical ID element has been dropped
  • the generic Capabilities element has been dropped; specific standard services (e.g. ConeSearch, SimpleImageAccess) define these in their extensions.

About the root element

As mentioned above, VOResource defines no global elements. The proper root element is expected to be defined by the application, as necessary, via its own application schema. For example, a particular application might define the following schema:

&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;xs:schema targetNamespace="http://astroservices.org/ResourceApplication"
           xmlns:xs="http://www.w3.org/2001/XMLSchema" 
           xmlns:vr="http://www.ivoa.net/xml/VOResource/v0.10" 
           xmlns:ra="http://astroservices.org/ResourceApplication" 
           elementFormDefault="qualified"
           attributeFormDefault="unqualified"
           version="0.10"&gt;

   &lt;xs:annotation&gt;
      &lt;xs:documenation&gt; application schema using VOResource &lt;/xs:documenation&gt;
   &lt;/xs:annotation&gt;

   &lt;xs:import namespace="http://www.ivoa.net/xml/VOResource/v0.10" /&gt;

   &lt;xs:element name="ResourceDescription" type="vr:Resource"/&gt;

   &lt;xs:element name="Resources"&gt;
      &lt;xs:complexType&gt;
         &lt;xs:sequence&gt;
            &lt;xs:element ref="ra:ResourceDescription" maxOccurs="unbounded" /&gt;
         &lt;/xs:sequence&gt;
      &lt;/xs:complexType&gt;
   &lt;/xs:element&gt;

&lt;/xs:schema&gt;

In this example, two global elements have been defined, either which can be used as a root element. The application would use this simple schema to verify its documents.

Note that in the example instance documents listed above, an application schema is not needed. That's because the root element in each case specifies its type using an xsi:type attribute. According to the XML Schema standard, this is sufficient to verify the document.

It is expected that registry applications will use "resource" as the root element, just like in the examples listed above.

Useful Tools

Conversion Stylesheets

Background Materials

What's Ahead in Future Versions

  • If no fundemental problems are found with this release, it is expected that:
    • the next release of VOResource will be v1.0
    • each of the extensions will begin to evolve separately.
  • VORegistry will likely be updated as the standard Registry Interface is refined.




<--  
-->

META FILEATTACHMENT attr="" comment="Converts v0.9 VOResource documents to v0.10" date="1089836148" name="VOResource-v0.9-v0.10.xsl" path="VOResource-v0.9-v0.10.xsl" size="56781" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="Converts v0.10 VOResource documents to v0.9" date="1089836202" name="VOResource-v0.10-v0.9.xsl" path="VOResource-v0.10-v0.9.xsl" size="59716" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="All schemas and examples in the v0.10 release" date="1089951180" name="VOResource-v0.10.tar.gz" path="VOResource-v0.10.tar.gz" size="20854" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="All schemas and examples in the v0.10 release" date="1089951338" name="VOResource-v0.10.zip" path="VOResource-v0.10.zip" size="28928" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="Alll schemas & examples, for local disk access" date="1089951469" name="VOResource-v0.10-local.tar.gz" path="VOResource-v0.10-local.tar.gz" size="20863" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="All schemas & examples, for local disk access" date="1089951600" name="VOResource-v0.10-local.zip" path="VOResource-v0.10-local.zip" size="29105" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951746" name="authority.xml" path="authority.xml" size="1666" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951798" name="collection.xml" path="collection.xml" size="3056" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951870" name="conesearch.xml" path="conesearch.xml" size="3810" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951964" name="organisation.xml" path="organisation.xml" size="1592" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952026" name="registry.xml" path="registry.xml" size="2448" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952189" name="sia.xml" path="sia.xml" size="8248" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952320" name="webform.xml" path="webform.xml" size="2518" user="RayPlante" version="1.1"

Revision 62004-07-22 - RayPlante

 
META TOPICPARENT name="RWP03Specs"
Jumps: IvoaResReg :: registry mail archive :: ResourceMetadata :: RWP03RefBack :: RWP03Disc
Meetings: Registry19032003 :: InterOpMay2003ResReg :: InterOpMay2004ResReg

Registry Working Group WP3 (Metadata Specifications)

VOResource v0.10 and its Standard Extensions

Contents

The Schemas

VOResource, in general, refers to a family of schemas that includes the core schema (VOResource-v0.10) and a set of standard extensions. These schemas are have been released from the official IVOA schema distribution area. To validate documents compliant with this release you need each of the following schemas:

Schema Description Documentation
VOResource-v0.10.xsd requires VOResourceRelType-v0.10.xsd core resource metadata coming soon
VORegistry-v0.3.xsd extension for describing registries and naming authorities coming soon
VODataService-v0.5.xsd requires VODataServiceCoverage-v0.5.xsd extension for describing data and services coming soon

The following two extensions are extensions that define specific, standard tabular sky services.

ConeSearch-v0.3.xsd extension for describing Cone Search Services service spec.,
schema docs: coming soon
SIA-v0.7.xsd extension for describing Simple Image Access Services service spec.,
schema docs: coming soon

You can download all the schemas (with the examples) in a single bundle. Two versions are available. When these packages are unpacked, all of the files are put in the current directory.

VOResource-v0.10 (tar.gzzip)
the official schemas from the table above.

VOResource-v0.10-local (tar.gzzip)
the official schemas with "schemaLocation" set to look for imports on local disk. This version enables a verifier to look for schemas in the current directory instead from the IVOA site. Use this version when developing off-line or with tools that have trouble finding imported schemas.

Example documents

organisation.xml
o  a simple description of an organisation
o  uses only the core VOResource schema

collection.xml
o  a description of a data collection
o  uses VOResource and VODataService
o  includes a simple coverage description

webform.xml
o  a description of an archive search page used interactively with a browser
o  described as a resource of type SkyService
o  illustrates the use of the "service-for" relationship
o  uses VOResource and VODataService

conesearch.xml
o  a description of a Cone Search service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and ConeSearch

sia.xml
o  a description of a Simple Image Access service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and SIA

registry.xml
o  a description of a registry (as a service).
o  uses VOResource, VODataService, and VORegistry

authority.xml
o  a description of a naming authority
o  used to register authority names in a registry.
o  uses uses VOResource and VORegistry

What's New in this Release

The primary change is the way extensions are handled: we have dropped the use of substitution groups and replaced them with the use of xsi:type. What looked like this in release v0.9...

&lt;!-- the old way --&gt;
&lt;VOResource xmlns="..." &gt;
   &lt;vs:SkyService&gt;
      ...

...now looks like this...

&lt;!-- the new way --&gt;
&lt;resource xsi:type="vs:SkyService" xmlns="..." &gt;
      ...

That is, you now see both specific type (SkyService) and the base concept it extends (resource) in the same element.

Here's an abridged list of changes made. (A more complete description can be found here.)

  • only global types are defined (anonymous types are avoided).
  • no global elements are defined; an application that uses VOResource can define its own global element(s) to use as a root element as necessary.
  • references to other resources has been simplified
  • the logical ID element has been dropped
  • the generic Capabilities element has been dropped; specific standard services (e.g. ConeSearch, SimpleImageAccess) define these in their extensions.
Added:
>
>

About the root element

As mentioned above, VOResource defines no global elements. The proper root element is expected to be defined by the application, as necessary, via its own application schema. For example, a particular application might define the following schema:

&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;xs:schema targetNamespace="http://astroservices.org/ResourceApplication"
           xmlns:xs="http://www.w3.org/2001/XMLSchema" 
           xmlns:vr="http://www.ivoa.net/xml/VOResource/v0.10" 
           xmlns:ra="http://astroservices.org/ResourceApplication" 
           elementFormDefault="qualified"
           attributeFormDefault="unqualified"
           version="0.10"&gt;

   &lt;xs:annotation&gt;
      &lt;xs:documenation&gt; application schema using VOResource &lt;/xs:documenation&gt;
   &lt;/xs:annotation&gt;

   &lt;xs:import namespace="http://www.ivoa.net/xml/VOResource/v0.10" /&gt;

   &lt;xs:element name="ResourceDescription" type="vr:Resource"/&gt;

   &lt;xs:element name="Resources"&gt;
      &lt;xs:complexType&gt;
         &lt;xs:sequence&gt;
            &lt;xs:element ref="ra:ResourceDescription" maxOccurs="unbounded" /&gt;
         &lt;/xs:sequence&gt;
      &lt;/xs:complexType&gt;
   &lt;/xs:element&gt;

&lt;/xs:schema&gt;

In this example, two global elements have been defined, either which can be used as a root element. The application would use this simple schema to verify its documents.

Note that in the example instance documents listed above, an application schema is not needed. That's because the root element in each case specifies its type using an xsi:type attribute. According to the XML Schema standard, this is sufficient to verify the document.

It is expected that registry applications will use "resource" as the root element, just like in the examples listed above.

 

Useful Tools

Conversion Stylesheets

Background Materials

What's Ahead in Future Versions

  • If no fundemental problems are found with this release, it is expected that:
    • the next release of VOResource will be v1.0
    • each of the extensions will begin to evolve separately.
  • VORegistry will likely be updated as the standard Registry Interface is refined.




<--  
-->

META FILEATTACHMENT attr="" comment="Converts v0.9 VOResource documents to v0.10" date="1089836148" name="VOResource-v0.9-v0.10.xsl" path="VOResource-v0.9-v0.10.xsl" size="56781" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="Converts v0.10 VOResource documents to v0.9" date="1089836202" name="VOResource-v0.10-v0.9.xsl" path="VOResource-v0.10-v0.9.xsl" size="59716" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="All schemas and examples in the v0.10 release" date="1089951180" name="VOResource-v0.10.tar.gz" path="VOResource-v0.10.tar.gz" size="20854" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="All schemas and examples in the v0.10 release" date="1089951338" name="VOResource-v0.10.zip" path="VOResource-v0.10.zip" size="28928" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="Alll schemas & examples, for local disk access" date="1089951469" name="VOResource-v0.10-local.tar.gz" path="VOResource-v0.10-local.tar.gz" size="20863" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="All schemas & examples, for local disk access" date="1089951600" name="VOResource-v0.10-local.zip" path="VOResource-v0.10-local.zip" size="29105" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951746" name="authority.xml" path="authority.xml" size="1666" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951798" name="collection.xml" path="collection.xml" size="3056" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951870" name="conesearch.xml" path="conesearch.xml" size="3810" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951964" name="organisation.xml" path="organisation.xml" size="1592" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952026" name="registry.xml" path="registry.xml" size="2448" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952189" name="sia.xml" path="sia.xml" size="8248" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952320" name="webform.xml" path="webform.xml" size="2518" user="RayPlante" version="1.1"

Revision 52004-07-16 - RayPlante

 
META TOPICPARENT name="RWP03Specs"
Jumps: IvoaResReg :: registry mail archive :: ResourceMetadata :: RWP03RefBack :: RWP03Disc
Meetings: Registry19032003 :: InterOpMay2003ResReg :: InterOpMay2004ResReg

Registry Working Group WP3 (Metadata Specifications)

VOResource v0.10 and its Standard Extensions

Contents

The Schemas

VOResource, in general, refers to a family of schemas that includes the core schema (VOResource-v0.10) and a set of standard extensions. These schemas are have been released from the official IVOA schema distribution area. To validate documents compliant with this release you need each of the following schemas:

Schema Description Documentation
VOResource-v0.10.xsd requires VOResourceRelType-v0.10.xsd core resource metadata coming soon
VORegistry-v0.3.xsd extension for describing registries and naming authorities coming soon
VODataService-v0.5.xsd requires VODataServiceCoverage-v0.5.xsd extension for describing data and services coming soon

The following two extensions are extensions that define specific, standard tabular sky services.

ConeSearch-v0.3.xsd extension for describing Cone Search Services service spec.,
schema docs: coming soon
SIA-v0.7.xsd extension for describing Simple Image Access Services service spec.,
schema docs: coming soon

You can download all the schemas (with the examples) in a single bundle. Two versions are available. When these packages are unpacked, all of the files are put in the current directory.

VOResource-v0.10 (tar.gzzip)
the official schemas from the table above.

VOResource-v0.10-local (tar.gzzip)
the official schemas with "schemaLocation" set to look for imports on local disk. This version enables a verifier to look for schemas in the current directory instead from the IVOA site. Use this version when developing off-line or with tools that have trouble finding imported schemas.

Example documents

Changed:
<
<
organisation.xml
o  a simple description of an organisation
o  uses only the core VOResource schema
>
>
organisation.xml
o  a simple description of an organisation
o  uses only the core VOResource schema
 
Changed:
<
<
collection.xml
o  a description of a data collection
o  uses VOResource and VODataService
o  includes a simple coverage description
>
>
collection.xml
o  a description of a data collection
o  uses VOResource and VODataService
o  includes a simple coverage description
 
Changed:
<
<
webform.xml
o  a description of an archive search page used interactively with a browser
o  described as a resource of type SkyService
o  illustrates the use of the "service-for" relationship
o  uses VOResource and VODataService
>
>
webform.xml
o  a description of an archive search page used interactively with a browser
o  described as a resource of type SkyService
o  illustrates the use of the "service-for" relationship
o  uses VOResource and VODataService
 
Changed:
<
<
conesearch.xml
o  a description of a Cone Search service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and ConeSearch
>
>
conesearch.xml
o  a description of a Cone Search service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and ConeSearch
 
Changed:
<
<
sia.xml
o  a description of a Simple Image Access service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and SIA
>
>
sia.xml
o  a description of a Simple Image Access service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and SIA
 
Changed:
<
<
registry.xml
o  a description of a registry (as a service).
o  uses VOResource, VODataService, and VORegistry
>
>
registry.xml
o  a description of a registry (as a service).
o  uses VOResource, VODataService, and VORegistry
 
Changed:
<
<
authority.xml
o  a description of a naming authority
o  used to register authority names in a registry.
o  uses uses VOResource and VORegistry
>
>
authority.xml
o  a description of a naming authority
o  used to register authority names in a registry.
o  uses uses VOResource and VORegistry
 

What's New in this Release

The primary change is the way extensions are handled: we have dropped the use of substitution groups and replaced them with the use of xsi:type. What looked like this in release v0.9...

&lt;!-- the old way --&gt;
&lt;VOResource xmlns="..." &gt;
   &lt;vs:SkyService&gt;
      ...

...now looks like this...

&lt;!-- the new way --&gt;
&lt;resource xsi:type="vs:SkyService" xmlns="..." &gt;
      ...

That is, you now see both specific type (SkyService) and the base concept it extends (resource) in the same element.

Here's an abridged list of changes made. (A more complete description can be found here.)

  • only global types are defined (anonymous types are avoided).
  • no global elements are defined; an application that uses VOResource can define its own global element(s) to use as a root element as necessary.
  • references to other resources has been simplified
  • the logical ID element has been dropped
  • the generic Capabilities element has been dropped; specific standard services (e.g. ConeSearch, SimpleImageAccess) define these in their extensions.

Useful Tools

Conversion Stylesheets

Background Materials

What's Ahead in Future Versions

  • If no fundemental problems are found with this release, it is expected that:
    • the next release of VOResource will be v1.0
    • each of the extensions will begin to evolve separately.
  • VORegistry will likely be updated as the standard Registry Interface is refined.




<--  
-->

META FILEATTACHMENT attr="" comment="Converts v0.9 VOResource documents to v0.10" date="1089836148" name="VOResource-v0.9-v0.10.xsl" path="VOResource-v0.9-v0.10.xsl" size="56781" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="Converts v0.10 VOResource documents to v0.9" date="1089836202" name="VOResource-v0.10-v0.9.xsl" path="VOResource-v0.10-v0.9.xsl" size="59716" user="RayPlante" version="1.1"
Added:
>
>
META FILEATTACHMENT attr="" comment="All schemas and examples in the v0.10 release" date="1089951180" name="VOResource-v0.10.tar.gz" path="VOResource-v0.10.tar.gz" size="20854" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="All schemas and examples in the v0.10 release" date="1089951338" name="VOResource-v0.10.zip" path="VOResource-v0.10.zip" size="28928" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="Alll schemas & examples, for local disk access" date="1089951469" name="VOResource-v0.10-local.tar.gz" path="VOResource-v0.10-local.tar.gz" size="20863" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="All schemas & examples, for local disk access" date="1089951600" name="VOResource-v0.10-local.zip" path="VOResource-v0.10-local.zip" size="29105" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951746" name="authority.xml" path="authority.xml" size="1666" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951798" name="collection.xml" path="collection.xml" size="3056" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951870" name="conesearch.xml" path="conesearch.xml" size="3810" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089951964" name="organisation.xml" path="organisation.xml" size="1592" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952026" name="registry.xml" path="registry.xml" size="2448" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952189" name="sia.xml" path="sia.xml" size="8248" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="h" comment="" date="1089952320" name="webform.xml" path="webform.xml" size="2518" user="RayPlante" version="1.1"
 

Revision 42004-07-15 - RayPlante

 
META TOPICPARENT name="RWP03Specs"
Jumps: IvoaResReg :: registry mail archive :: ResourceMetadata :: RWP03RefBack :: RWP03Disc
Meetings: Registry19032003 :: InterOpMay2003ResReg :: InterOpMay2004ResReg
Changed:
<
<

Registry Working Group WP3 (Metadata Specifications)

VOResource v0.10 and its Standard Extensions

>
>

Registry Working Group WP3 (Metadata Specifications)

VOResource v0.10 and its Standard Extensions

 
Changed:
<
<
VOResource, in general, refers to a family of schemas that includes the core schema (VOResource-v0.9) and a set of standard extensions. The current internal Working Draft is v0.10 ("version zero-point-ten").
>
>
 
Changed:
<
<
>
>
Contents
Deleted:
<
<
    • example instance documents of each resource type
    • summary of changes
 
Changed:
<
<
>
>

The Schemas

 
Changed:
<
<

Background Materials

>
>
VOResource, in general, refers to a family of schemas that includes the core schema (VOResource-v0.10) and a set of standard extensions.
Added:
>
>
These schemas are have been released from the official IVOA schema distribution area. To validate documents compliant with this release you need each of the following schemas:
 
Changed:
<
<
>
>
Schema Description Documentation
Added:
>
>
VOResource-v0.10.xsd requires VOResourceRelType-v0.10.xsd core resource metadata coming soon
VORegistry-v0.3.xsd extension for describing registries and naming authorities coming soon
VODataService-v0.5.xsd requires VODataServiceCoverage-v0.5.xsd extension for describing data and services coming soon
 
Changed:
<
<
>
>
The following two extensions are extensions that define specific, standard tabular sky services.
 
Added:
>
>
ConeSearch-v0.3.xsd extension for describing Cone Search Services service spec.,
schema docs: coming soon
SIA-v0.7.xsd extension for describing Simple Image Access Services service spec.,
schema docs: coming soon

You can download all the schemas (with the examples) in a single bundle. Two versions are available. When these packages are unpacked, all of the files are put in the current directory.

VOResource-v0.10 (tar.gzzip)
the official schemas from the table above.

VOResource-v0.10-local (tar.gzzip)
the official schemas with "schemaLocation" set to look for imports on local disk. This version enables a verifier to look for schemas in the current directory instead from the IVOA site. Use this version when developing off-line or with tools that have trouble finding imported schemas.

Example documents

organisation.xml
o  a simple description of an organisation
o  uses only the core VOResource schema

collection.xml
o  a description of a data collection
o  uses VOResource and VODataService
o  includes a simple coverage description

webform.xml
o  a description of an archive search page used interactively with a browser
o  described as a resource of type SkyService
o  illustrates the use of the "service-for" relationship
o  uses VOResource and VODataService

conesearch.xml
o  a description of a Cone Search service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and ConeSearch

sia.xml
o  a description of a Simple Image Access service
o  interface description includes the supported input parameters
o  includes a description of the returned output table
o  uses VOResource, VODataService, and SIA

registry.xml
o  a description of a registry (as a service).
o  uses VOResource, VODataService, and VORegistry

authority.xml
o  a description of a naming authority
o  used to register authority names in a registry.
o  uses uses VOResource and VORegistry

What's New in this Release

The primary change is the way extensions are handled: we have dropped the use of substitution groups and replaced them with the use of xsi:type. What looked like this in release v0.9...

&lt;!-- the old way --&gt;
&lt;VOResource xmlns="..." &gt;
   &lt;vs:SkyService&gt;
      ...

...now looks like this...

&lt;!-- the new way --&gt;
&lt;resource xsi:type="vs:SkyService" xmlns="..." &gt;
      ...

That is, you now see both specific type (SkyService) and the base concept it extends (resource) in the same element.

Here's an abridged list of changes made. (A more complete description can be found here.)

  • only global types are defined (anonymous types are avoided).
  • no global elements are defined; an application that uses VOResource can define its own global element(s) to use as a root element as necessary.
  • references to other resources has been simplified
  • the logical ID element has been dropped
  • the generic Capabilities element has been dropped; specific standard services (e.g. ConeSearch, SimpleImageAccess) define these in their extensions.
 

Useful Tools

Added:
>
>

Conversion Stylesheets

 
Added:
>
>

Background Materials

What's Ahead in Future Versions

  • If no fundemental problems are found with this release, it is expected that:
    • the next release of VOResource will be v1.0
    • each of the extensions will begin to evolve separately.
  • VORegistry will likely be updated as the standard Registry Interface is refined.
 


<--  
-->

META FILEATTACHMENT attr="" comment="Converts v0.9 VOResource documents to v0.10" date="1089836148" name="VOResource-v0.9-v0.10.xsl" path="VOResource-v0.9-v0.10.xsl" size="56781" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="Converts v0.10 VOResource documents to v0.9" date="1089836202" name="VOResource-v0.10-v0.9.xsl" path="VOResource-v0.10-v0.9.xsl" size="59716" user="RayPlante" version="1.1"

Revision 32004-07-14 - RayPlante

 
META TOPICPARENT name="RWP03Specs"
Changed:
<
<
Jumps: IvoaResReg :: registry mail archive :: ResourceMetadata :: RWP03RefBack :: RWP03Disc
Meetings: Registry19032003 :: InterOpMay2003ResReg :: InterOpMay2004ResReg
>
>
Jumps: IvoaResReg :: registry mail archive :: ResourceMetadata :: RWP03RefBack :: RWP03Disc
Meetings: Registry19032003 :: InterOpMay2003ResReg :: InterOpMay2004ResReg
 

Registry Working Group WP3 (Metadata Specifications)

VOResource v0.10 and its Standard Extensions

VOResource, in general, refers to a family of schemas that includes the core schema (VOResource-v0.9) and a set of standard extensions. The current internal Working Draft is v0.10 ("version zero-point-ten").

  • Internal Release Page; includes...
    • Schema files
    • example instance documents of each resource type
    • summary of changes

Background Materials

Added:
>
>

Useful Tools

 


<--  
-->
Changed:
<
<
>
>
Deleted:
<
<
 
META FILEATTACHMENT attr="" comment="Converts v0.9 VOResource documents to v0.10" date="1089836148" name="VOResource-v0.9-v0.10.xsl" path="VOResource-v0.9-v0.10.xsl" size="56781" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="Converts v0.10 VOResource documents to v0.9" date="1089836202" name="VOResource-v0.10-v0.9.xsl" path="VOResource-v0.10-v0.9.xsl" size="59716" user="RayPlante" version="1.1"

Revision 22004-07-14 - RayPlante

 
META TOPICPARENT name="RWP03Specs"
Jumps: IvoaResReg :: registry mail archive :: ResourceMetadata :: RWP03RefBack :: RWP03Disc
Meetings: Registry19032003 :: InterOpMay2003ResReg :: InterOpMay2004ResReg

Registry Working Group WP3 (Metadata Specifications)

VOResource v0.10 and its Standard Extensions

VOResource, in general, refers to a family of schemas that includes the core schema (VOResource-v0.9) and a set of standard extensions. The current internal Working Draft is v0.10 ("version zero-point-ten").

  • Internal Release Page; includes...
    • Schema files
    • example instance documents of each resource type
    • summary of changes

Background Materials




<--  
-->
Added:
>
>
 
Added:
>
>

META FILEATTACHMENT attr="" comment="Converts v0.9 VOResource documents to v0.10" date="1089836148" name="VOResource-v0.9-v0.10.xsl" path="VOResource-v0.9-v0.10.xsl" size="56781" user="RayPlante" version="1.1"
META FILEATTACHMENT attr="" comment="Converts v0.10 VOResource documents to v0.9" date="1089836202" name="VOResource-v0.10-v0.9.xsl" path="VOResource-v0.10-v0.9.xsl" size="59716" user="RayPlante" version="1.1"
 

Revision 12004-06-22 - RayPlante

 
META TOPICPARENT name="RWP03Specs"
Jumps: IvoaResReg :: registry mail archive :: ResourceMetadata :: RWP03RefBack :: RWP03Disc
Meetings: Registry19032003 :: InterOpMay2003ResReg :: InterOpMay2004ResReg

Registry Working Group WP3 (Metadata Specifications)

VOResource v0.10 and its Standard Extensions

VOResource, in general, refers to a family of schemas that includes the core schema (VOResource-v0.9) and a set of standard extensions. The current internal Working Draft is v0.10 ("version zero-point-ten").

  • Internal Release Page; includes...
    • Schema files
    • example instance documents of each resource type
    • summary of changes

Background Materials




<--  
-->
 
This site is powered by the TWiki collaboration platform Powered by Perl This site is powered by the TWiki collaboration platformCopyright © 2008-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback