[tdwg-tapir] Proposal

Donald Hobern dhobern at gbif.org
Wed Jan 4 09:50:19 CET 2006


Many thanks.  That's a great help.

Donald Hobern (dhobern at gbif.org)
Programme Officer for Data Access and Database Interoperability 
Global Biodiversity Information Facility Secretariat 
Universitetsparken 15, DK-2100 Copenhagen, Denmark
Tel: +45-35321483   Mobile: +45-28751483   Fax: +45-35321480

-----Original Message-----
From: tdwg-tapir-bounces at lists.tdwg.org
[mailto:tdwg-tapir-bounces at lists.tdwg.org] On Behalf Of Renato De Giovanni
Sent: 03 January 2006 22:00
To: tdwg-tapir at lists.tdwg.org
Subject: Re: [tdwg-tapir] Proposal

Hi Donald,

> Thanks for all this hard work.  I'm afraid I now need a little help.  I'm
> longer sure exactly how a queryTemplate is defined and how the GET request
> to use one works.  Is it possible to provide a small example to help me
> it all together?

Sure it is possible, I'll try to provide some examples below (sorry I 
didn't have time to do that before).

> First (in the capabilities response) what exactly goes into the
> externalResourceType?  Is it intended to contain anything more than the
> location attribute (i.e. is there some text label in the queryTemplate
> element body)?

No, it only contains the location attribute. It's just a pointer to 
an external definition. Just as it was in the previous version: 
  <queryTemplate location="http://someUrl/mySearchTemplate.xml" />
  <queryTemplate location="http://someUrl/myInventoryTemplate.xml" />

> Secondly, what is stored at the URL indicated by the location attribute?
> assume that it is some subtree from an inventory or search request but
> is the expected form (expected root element)?  Can you provide a
> parameterised example?

The URL should point to a search or an inventory template, such as:

<?xml version="1.0"?>
  <documentation>Retrieves one or more TaxonNames by their ID 
      <concept id="TCSnamespace#Dataset/TaxonNames/TaxonName at id" />
        <parameter name="id" />
    <concept id="TCSnamespace#Dataset/TaxonNames/TaxonName/Simple" />

note: outputModelURI points to an external definition of an output 
model (no changes here - it has the same structure defined by the 
current schema).


<?xml version="1.0"?>
  <documentation>Retrieves a list of distinct Taxon Names 
    <concept id="TCSnamespace#Dataset/TaxonNames/TaxonName/Simple" />

note: no filter was used here (it is optional).

> Thirdly, what is the expected form for a GET request using a
> How is the template specified in the request?

The examples above could be invoked, respectively, with:



> Sorry to be stupid, but this would be a real help in responding
> Happy New Year and very best wishes,

No worries, it's definitely easier when we can look at concrete 
examples - I should have prepared them before.

Best Regards and a Happy New Year,

tdwg-tapir mailing list
tdwg-tapir at lists.tdwg.org

More information about the tdwg-tag mailing list