VOSpace-1.0 WSDL and schemaThis is a discussion page for the WSDL and schema for the VOSpace-1.0 service. This is somewhere where we can post proposals for schema and WSDL to enable interested parties to discuss the different versions. For each version there is a Change request section - please add to this and vote on other suggestions
News
Core schemaThis is the main section for schema and WSDL files. | |||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||
< < | The files for the 1.0 VOSpace release are | ||||||||||||||||||||||||
> > | Version 1.0rc5 | ||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||
< < |
| ||||||||||||||||||||||||
> > |
| ||||||||||||||||||||||||
Deleted: | |||||||||||||||||||||||||
< < |
| ||||||||||||||||||||||||
Added: | |||||||||||||||||||||||||
> > |
| ||||||||||||||||||||||||
Version 1.0rc4
| |||||||||||||||||||||||||
Deleted: | |||||||||||||||||||||||||
< < | |||||||||||||||||||||||||
There is a known problem with the rc4 schema.
In rc3 we changed Protocol and View params from
<xsd:element name="param" xsi:type="vos:ParamType">to use the same type as Node properties <xsd:element name="param" xsi:type="vos:PropertyType">This meant that params were identified by uri rather than a string name. The original intention was that we would use the fragment symbol '#' to reference the param description within the resource document for the protocol or view. <protocol uri="ivo://net.ivoa.vospace/protocols/ftp-get"> <param uri="#name"> .... </param> </protocol>In this example, the param uri refers to the definition of the name param within the ftp-get protocol resource.
The full uri of the param would be ivo://net.ivoa.vospace/protocols/ftp-get#name
However, the latest metadata schema allows more than one protocol or view to be defined in a single resource document.
<vor:Resource xsi:type="vsp:VOSpaceProtocol"> .... <protocol id="http-get"> .... </protocol> <protocol id="ftp-get"> <param id="name"> .... </param> </protocol> .... </vor:Resource>This uses one resource document to register all of the vospace protocols as a set, and using the '#' fragment identifier to resolve one protocol within the set. For example, the full uri for the ftp-get protocol would be ivo://net.ivoa.vospace/protocols#ftp-get
However, this means that we can't use the '#' fragment identifier to refer to a specific parameter within a protocol without overloading its meaning and using it twice. e.g. ivo://net.ivoa.vospace/protocols#ftp-get#name .
I can't see a strong use case for registering params as separate entities outside protocols and views, so we probably don't need a full uri to identifiy a param. In which case, to solve the above problems we might as well change back to using a string key to identify params within protocols and views.
So, next version of the schema will revert to using ParamType for protocol and view params, identified by a string key rather than a uri.
<xsd:element name="param" xsi:type="vos:ParamType">Note also that allowing more than one protocol description within one resource document means that we can end up with more than one element with the same id attribute.
<vor:Resource xsi:type="vsp:VOSpaceProtocol"> .... <protocol id="ftp-get"> <param id="name"> .... </param> <param id="pass"> .... </param> </protocol> <protocol id="ftp-put"> <param id="name"> .... </param> <param id="pass"> .... </param> </protocol> .... </vor:Resource>In this example, we have two param elements with id="name" and two param elements with id="pass" .
Ideally, the id attributes should be unique within an XML document, so the identifying attribute on param elements should probably be changed to key , matching the way they are used in the main schema.
Version 1.0rc3vospace-interface-1.0rc3.zip This matches v0.22 of the specification document.Version 1.0rc2
Changes from previous version
Change RequestsKeep Transports/Formats as separate opertation-- PaulHarrison - 13 Jun 2006 I agree with adding the new methods. However, this should be changed in the specification first, not the WSDL. Move this to the specification change page. -- DaveMorris - 16 Jun 2006Votes
Refactor use of
This construct was there principally to get round difficulties in specifying the use-case "create a file with a server generated name" before the vos: URI scheme was approved. Not needed any more.
-- PaulHarrison - 16 Jun 2006
Needs to be much clearer what this represents.
-- DaveMorris - 16 Jun 2006
|
name | vote | comment |
---|---|---|
DaveMorris | -1 | Change the specification document first |
GuyRixon | -1 | Don't see the need: we have faults for errors conditions |
name | vote | comment |
---|---|---|
PaulHarrison | +1 | proposer |
<--
META FILEATTACHMENT | attr="" comment="vospace-interface-1.0rc1.zip" date="1150212841" name="vospace-interface-1.0rc1.zip" path="vospace-interface-1.0rc1.zip" size="7450" user="PaulHarrison" version="1.1" |
---|---|
META FILEATTACHMENT | attr="" comment="1.0rc2 interface" date="1150814386" name="vospace-interface-1.0rc2.zip" path="vospace-interface-1.0rc2.zip" size="6232" user="PaulHarrison" version="1.1" |
META FILEATTACHMENT | attr="" comment="Matches v0.22 of the specification document" date="1153215532" name="vospace-1.0-rc3.zip" path="vospace-1.0-rc3.zip" size="6248" user="GuyRixon" version="1.1" |
META FILEATTACHMENT | attr="" comment="Updated to rc4" date="1153402371" name="VOSpace-v1.0rc4.zip" path="VOSpace-v1.0rc4.zip" size="7350" user="GuyRixon" version="1.1" |
META FILEATTACHMENT | attr="" comment="VOSpace registry schema 1.0rc4" date="1153478231" name="VOSpaceResource-v1.0rc4.xsd" path="VOSpaceResource-v1.0rc4.xsd" size="11243" user="PaulHarrison" version="1.1" |
META FILEATTACHMENT | attr="" comment="registry instance document 1.0rc4" date="1153478294" name="vospace-1.0rc4.xml" path="vospace-1.0rc4.xml" size="9424" user="PaulHarrison" version="1.1" |
META FILEATTACHMENT | attr="" comment="Service WSDL V1.0rc5" date="1154123906" name="VOSpaceContract-v1.0rc5.wsdl" path="VOSpaceContract-v1.0rc5.wsdl" size="46055" user="DaveMorris" version="1.1" |
META FILEATTACHMENT | attr="" comment="XML Schema V1.0rc5" date="1154123941" name="VOSpaceTypes-v1.0rc5.xsd" path="VOSpaceTypes-v1.0rc5.xsd" size="39252" user="DaveMorris" version="1.1" |