TAP Examples - TAPNotes

A /examples endpoint is an RDFa document. Basically, it is an XHTML document whose some nodes have specific attributes. These attributes aim to help client automatic processing. Thus, clients like TOPCAT are able to retrieve the list of examples that a TAP service provides (see TOPCAT documentation for a more specific illustration).

TAPNotes syntax

UML diagram of the structure described by TAPNotes1.0.

(see TAPNotes 1.0 for more details)

Example

Here is a simple example of a such examples list. This list is actually included hidden in this XHTML page ; so, if a client like TOPCAT can read this document and extract this example.

<div vocab="ivo://ivoa.net/std/DALI-examples">
	<div typeof="example" id="Example1" resource="#Example1">
		<h2 property="name">List all tables</h2>
		<span property="table">TAP_SCHEMA.tables</span>
		<pre property="query">SELECT *
FROM TAP_SCHEMA.tables
WHERE schema_name <> 'TAP_SCHEMA'</pre>
	</div>
</div>

Note that you can set the vocab attribute to any XHTML node that can have children, including body.

You should also note that since the ADQL query is written in an XHTML document, any < and > should be encoded as the XML entities: &lt; and &gt;.

List all tables

TAP_SCHEMA.tables
SELECT *
FROM TAP_SCHEMA.tables
WHERE schema_name <> 'TAP_SCHEMA'