VOSpace-2_1-Erratum-1 < IVOA

---+ 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
-->
This topic: IVOA > WebHome > IvoaGridAndWebServices > VOSpace21Errata > VOSpace-2_1-Erratum-1
Topic revision: r2 - 2020-06-03 - GiulianoTaffoni