DataLink-1_0-Erratum-4 < IVOA

---+ !DataLink version 1.0 Proposed Erratum 4: Self-Describing Service example fix

Author: Mark Taylor, François Bonnarel

Date last changed: 2020-05-11

Date accepted: 2020-06-11

---++ Rationale

In the process of moving the [[http://ivoa.net/documents/DataLink/20150617/index.html][DataLink-1.0]]
into the ivoa-std !GitHub repo, it has been found an error in the example in §4.6 (page 26)
(see [[https://github.com/ivoa-std/DataLink/issues/3][DataLink issue #3]]).
The error consists in a wrong =ref="primaryID"= attribute linking a service descriptor =PARAM=
to a results table =FIELD=.
This erratum proposes to suppress the wrong =ref= attribute.

---++ Erratum Content

This Erratum proposes to replace, in §4.6 of [[http://ivoa.net/documents/DataLink/20150617/index.html][DataLink - Version 1.0]] the first =RESOURCE= element of the example:
<verbatim>
<RESOURCE type=”meta” utype=”adhoc:service” name=”this”>
	<PARAM name="standardID" datatype="char" arraysize="*"
		value="ivo://ivoa.net/std/DataLink#links-1.0" />
	<PARAM name="accessURL" datatype="char" arraysize="*"
		value="http://example.com/mylinks" />
	<GROUP name=”inputParams”>
		<PARAM name=”ID” datatype=”char” arraysize=”*”
			value=”” ref=”primaryID”/>
	</GROUP>
</RESOURCE>
</verbatim>

with the following one:
<verbatim>
<RESOURCE type=”meta” utype=”adhoc:service” name=”this”>
	<PARAM name="standardID" datatype="char" arraysize="*"
		value="ivo://ivoa.net/std/DataLink#links-1.0" />
	<PARAM name="accessURL" datatype="char" arraysize="*"
		value="http://example.com/mylinks" />
	<GROUP name=”inputParams”>
		<PARAM name=”ID” datatype=”char” arraysize=”*” value=”” />
	</GROUP>
</RESOURCE>
</verbatim>

That is, removing the =ref= attribute and its value, that refer to a non-existent =FIELD= in the example itself.

---++ Impact Assessment

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

<!--
      * Set ALLOWTOPICRENAME = IVOA.TWikiAdminGroup
-->
This topic: IVOA > WebHome > IvoaDAL > DataLink10Errata > DataLink-1_0-Erratum-4
Topic revision: r5 - 2020-06-12 - MarcoMolinaro