VOSpace-2_1-Erratum-1 < IVOA

IVOA Web>IvoaGridAndWebServices>VOSpace21Errata>VOSpace-2_1-Erratum-1 (2020-06-03, GiulianoTaffoni) (raw view)

---+ VOSpace version 2.1 Proposed Erratum 1: Example incorrect §6.3.1 (fix example)

Author: Brian Major, Gregory Mantelet

Date last changed: 2020-05-19

<!-- Date accepted|rejected: 20NN-MM-DD -->

---+ Rationale

In the process of developing a new VOSpace implementation, it has been found an error in the example in §6.3.1 (pp 53-54) (see [[https://github.com/ivoa-std/VOSpace/issues/1][VOSpace issue #1]]). The error consists in the fact that in the example the XML elements &lt;vos:properties&gt;, &lt;vos:accepts&gt;, &lt;vos:provides&gt; and &lt;vos:capabilities&gt; should not be returned when =detail=min= is specified. Moreover, the XML element is not correctly terminated.

---++ Erratum Content

This Erratum proposes to replace, in §6.3.1 of [[http://www.ivoa.net/documents/VOSpace/20180620/index.html][VOSpace - Version 2.1]] the response part of the example:
<verbatim>
> GET /vospace/nodes/mydir?detail=min&uri=vos://example.com!vospace/mydir/file3401 HTTP/1.1
>
< HTTP/1.1 200 OK
< Content-Type: text/xml
<
<?xml version="1.0" encoding="UTF-8"?>
<vos:node xmlns:vos="http://www.ivoa.net/xml/VOSpace/v2.0" version="2.1" xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" uri="vos://example.com!vospace/mydir" xsi:type="vos:ContainerNode">
  <vos:properties>
    <vos:property uri="ivo://ivoa.net/vospace/core#description">My award winning images</property>
  </vos:properties>
  <vos:accepts>
    <vos:view uri="ivo://ivoa.net/vospace/core#anyview"/>
  </vos:accepts>
  <vos:provides>
    <vos:view uri="ivo://ivoa/net/vospace/core#defaultview"/>
  </vos:provides>
  <vos:capabilities/>
  <vos:nodes>
    <vos:node uri="vos://example.com!vospace/mydir/file3401" xsi:type="vos:DataNode"/>
    <vos:node uri="vos://example.com!vospace/mydir/file3406" xsi:type="vos:DataNode"/>
    <vos:node uri="vos://example.com!vospace/mydir/file3532" xsi:type="vos:DataNode"/>
  </vos:nodes>
</verbatim>

with the following one:
<verbatim>
> GET /vospace/nodes/mydir?detail=min&uri=vos://example.com!vospace/mydir/file3401 HTTP/1.1
>
< HTTP/1.1 200 OK
< Content-Type: text/xml
<
<?xml version="1.0" encoding="UTF-8"?>
<vos:node xmlns:vos="http://www.ivoa.net/xml/VOSpace/v2.0" version="2.1" xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" uri="vos://example.com!vospace/mydir" xsi:type="vos:ContainerNode">
  <vos:nodes>
    <vos:node uri="vos://example.com!vospace/mydir/file3401" xsi:type="vos:DataNode"/>
    <vos:node uri="vos://example.com!vospace/mydir/file3406" xsi:type="vos:DataNode"/>
    <vos:node uri="vos://example.com!vospace/mydir/file3532" xsi:type="vos:DataNode"/>
  </vos:nodes>
</vos:node>
</verbatim>

---++ Impact Assessment

The proposed change doesn't impact any part of VOSpace implementations since it simply amends an example fixing it.

<br /> <!--
      * Set ALLOWTOPICRENAME = IVOA.TWikiAdminGroup
-->

Topic revision: r2 - 2020-06-03 - GiulianoTaffoni

IVOA

Log in or Register

IVOA.net
Wiki Home
WebChanges
WebTopicList
WebStatistics

Twiki Meta & Help
IVOA
Know
Main
Sandbox
TWiki

TWiki intro
TWiki tutorial
User registration
Notify me

Working Groups

Interest Groups

Time Domain

Committees

Stds&Procs

www.ivoa.net
Documents
Events
Members
XML Schema