479 lines
21 KiB
Plaintext
479 lines
21 KiB
Plaintext
head 1.16;
|
|
access;
|
|
symbols;
|
|
locks; strict;
|
|
comment @# @;
|
|
|
|
|
|
1.16
|
|
date 2009.01.27.15.27.59; author RenatoDeGiovanni; state Exp;
|
|
branches;
|
|
next 1.15;
|
|
|
|
1.15
|
|
date 2007.12.27.19.07.57; author RenatoDeGiovanni; state Exp;
|
|
branches;
|
|
next 1.14;
|
|
|
|
1.14
|
|
date 2007.10.31.17.31.22; author RenatoDeGiovanni; state Exp;
|
|
branches;
|
|
next 1.13;
|
|
|
|
1.13
|
|
date 2007.10.26.18.53.38; author RenatoDeGiovanni; state Exp;
|
|
branches;
|
|
next 1.12;
|
|
|
|
1.12
|
|
date 2007.10.26.17.15.54; author RenatoDeGiovanni; state Exp;
|
|
branches;
|
|
next 1.11;
|
|
|
|
1.11
|
|
date 2007.10.25.19.19.31; author RenatoDeGiovanni; state Exp;
|
|
branches;
|
|
next 1.10;
|
|
|
|
1.10
|
|
date 2007.10.24.20.15.02; author RyanScherle; state Exp;
|
|
branches;
|
|
next 1.9;
|
|
|
|
1.9
|
|
date 2007.04.13.01.18.45; author RenatoDeGiovanni; state Exp;
|
|
branches;
|
|
next 1.8;
|
|
|
|
1.8
|
|
date 2007.02.28.00.38.44; author RenatoDeGiovanni; state Exp;
|
|
branches;
|
|
next 1.7;
|
|
|
|
1.7
|
|
date 2007.01.17.12.25.17; author RicardoPereira; state Exp;
|
|
branches;
|
|
next 1.6;
|
|
|
|
1.6
|
|
date 2007.01.09.00.00.00; author MoinMoin; state Exp;
|
|
branches;
|
|
next 1.5;
|
|
|
|
1.5
|
|
date 2007.01.09.00.00.00; author MoinMoin; state Exp;
|
|
branches;
|
|
next 1.4;
|
|
|
|
1.4
|
|
date 2007.01.09.00.00.00; author MoinMoin; state Exp;
|
|
branches;
|
|
next 1.3;
|
|
|
|
1.3
|
|
date 2007.01.09.00.00.00; author MoinMoin; state Exp;
|
|
branches;
|
|
next 1.2;
|
|
|
|
1.2
|
|
date 2007.01.09.00.00.00; author MoinMoin; state Exp;
|
|
branches;
|
|
next 1.1;
|
|
|
|
1.1
|
|
date 2007.01.09.00.00.00; author MoinMoin; state Exp;
|
|
branches;
|
|
next ;
|
|
|
|
|
|
desc
|
|
@Initial revision
|
|
@
|
|
|
|
|
|
1.16
|
|
log
|
|
@none
|
|
@
|
|
text
|
|
@%META:TOPICINFO{author="RenatoDeGiovanni" date="1233070079" format="1.1" version="1.16"}%
|
|
---+++ Frequently Asked Questions
|
|
|
|
*What is TAPIR?*
|
|
|
|
TAPIR is an XML-based protocol over HTTP to perform distributed queries on heterogeneous data sources. It was originally created within the Biodiversity Informatics community as an integration of the [[DigirProtocol][DiGIR]] and [[BiocaseProtocol][BioCASe]] protocols, and it stands for "TDWG Access Protocol for Information Retrieval".
|
|
|
|
*What is the current version of TAPIR?*
|
|
|
|
The current version is 1.0.
|
|
|
|
*Is there a specification available?*
|
|
|
|
Yes: http://www.tdwg.org/activities/tapir/specification/
|
|
|
|
*Is there an XML Schema for the protocol?*
|
|
|
|
Yes: http://rs.tdwg.org/tapir/1.0/schema/tapir.xsd
|
|
|
|
*Is there any software that implements TAPIR?*
|
|
|
|
PyWrapper, TapirLink and TapirDotNet are full TAPIR data provider implementations. TapirChirp is a free and open source client library originally developed for the TapirTester service (which was developed to check data providers' compatibility with the protocol). A more complete list can be found in TapirSoftware.
|
|
|
|
*How is the decision making process?*
|
|
|
|
Please check the DecisionMakingProcess for TAPIR.
|
|
|
|
*How can I participate in the discussions?*
|
|
|
|
You can join the TapirMailingList, contribute with the wiki, or attend the meetings that usually take place during TDWG events. To contribute to this Wiki, please use your TDWG account credentials. If you don't have a TDWG account, [[http://www.tdwg.org/membership/][register with the TDWG website]].
|
|
|
|
*What is TDWG and what is the relationship between TAPIR and TDWG?*
|
|
|
|
[[http://www.tdwg.org/][TDWG]] is an international organization dedicated to the development of standards for the Biodiversity Informatics community, and is therefore interested in protocols that could be used to enable data exchange. Although TAPIR was originated from the DiGIR and BioCASe protocols, which are mainly used by networks of Biological Collections, it is expected that TAPIR can be used as a single query protocol to search across distributed databases and retrieve results according not only to ABCD and DarwinCore, but also according to other data standards like TCS and SDD. TAPIR is a TDWG Task Group which is part of the TDWG Architecture Group.
|
|
|
|
*Is TAPIR a TDWG standard? Is it stable?*
|
|
|
|
TAPIR is still not an official TDWG standard yet. Meanwhile it may still be subject to changes, although it is already considered stable.
|
|
|
|
*What is GBIF and what is the relationship between TAPIR and GBIF?*
|
|
|
|
[[http://www.gbif.org/][GBIF]] is the biggest existing network about biodiversity data, and therefore has great interest in having a single standard protocol to search and retrieve data from different data providers. The initial integration process of the DiGIR and BioCASe protocols that resulted in TAPIR has been funded by GBIF. GBIF is also an active participant in all TAPIR discussions.
|
|
|
|
*When is the next version going to be released?*
|
|
|
|
Please check the RoadMap for future plans.
|
|
|
|
*Why did you choose to create TAPIR instead of using protocol x, y, z?*
|
|
|
|
The original study that resulted in the recommendation to define a new protocol included preliminary research about other options. At that time (2004) the alternatives that have been considered were SOAP, WFS and XQuery. Other alternatives were not considered either because they were still not available (or maybe they were being developed simultaneously) or because they were largely unknown to our community at that moment. Although a few other options were quickly investigated, analyzing every single initiative similar to what was needed would be a major task beyond the available resources and timeframe (there are lists of data integration projects worldwide like [[http://www.ifi.unizh.ch/stff/pziegler/IntegrationProjects.html][this one]]).
|
|
|
|
On the other hand, DiGIR and BioCASe were considered successful initiatives, so the main motivation of TAPIR was not to improve them, but simply to unify them and thus increase interoperability between the existing biodiversity networks. The fact that TAPIR contains some improvements was just a natural consequence of the work.
|
|
|
|
Perhaps the decision could be different if we had identified another protocol that would suit all our needs and would already offer available tools (libraries, client software and server software). Since this did not happen, it seemed to make more sense to unify DiGIR and BioCASe, keeping the possibility of easily changing and adapting the protocol as needed, and finally making the necessary changes in the tools that have already been developed and were being used by the biodiversity informatics community.
|
|
|
|
Note: The reasons for not choosing SOAP, WFS and XQuery are explained in more details in the [[http://www.cria.org.br/protocols/newprotocol.pdf][original integration document]].
|
|
|
|
*How does TAPIR relate to OAI-PMH?*
|
|
|
|
[[http://www.openarchives.org/OAI/openarchivesprotocol.html][OAI-PMH]] was designed purely for harvesting data so that data aggregators can provide value-added services on top of a cache. Although OAI-PMH allows for selective harvesting by means of "set" definitions, it does not include search capabilities like TAPIR. For TAPIR providers, it is possible to set up an OAI-PMH service on top of their service (see TapirOAIPMH).
|
|
|
|
*How does TAPIR relate to OpenSearch?*
|
|
|
|
[[http://www.opensearch.org/][OpenSearch]] allows clients to learn about the public interface of a search engine through description documents. Such documents basically contain parameterized URL templates indicating how clients should make search requests, and in which format and MIME type the responses will be returned. Responses will always come as web feeds (RSS 2.0 or Atom 1.0 augmented with OpenSearch elements). A TAPIR service is described in a more complex way through a capabilities response which may reference things like conceptual schemas, query templates and output models. This additional complexity is related to the fact that TAPIR providers may want to support more complex query options (filters using logical and comparison operators) and custom output formats.
|
|
|
|
*How does TAPIR relate to SRU?*
|
|
|
|
SRU and TAPIR have basically the same goal and are very similar to each other. SRU has been unknown to the TAPIR community until October 2007. Interestingly, SRU builds on the experience of the Z39.50 community (Z39.50 was the protocol used by one of the first biodiversity data networks - The Species Analyst - and was later replaced by DiGIR, which was mainly created by the participants of the same network). Both TAPIR and SRU have similar operations, ability to formulate complex queries, and possibility to return results in different response formats. One of the differences between them can also explain why TAPIR requests were not restricted to URLs: while SRU providers can return search results according to different response formats, these have to be previously declared in the provider capabilites, while full TAPIR providers can potentially return search results according to a new response format (output model) entirely defined in the request. This was the only reason for TAPIR to support requests in XML. A more complete comparison between the two protocols would need to reference specific details about them.
|
|
@
|
|
|
|
|
|
1.15
|
|
log
|
|
@none
|
|
@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="RenatoDeGiovanni" date="1198782477" format="1.1" version="1.15"}%
|
|
d22 1
|
|
a22 5
|
|
PyWrapper, TapirLink and TapirDotNet are full TAPIR data provider implementations. TapirChirp is a free and open source client library originally developed for the TapirTester service (which was developed to check data providers' compatibility with the protocol).
|
|
|
|
*Are there plans to have other related software?*
|
|
|
|
Yes. The [[http://bigdig.ecoforge.net/][BigDig]] service monitoring tool is being extended to support TAPIR. Two online services should soon be available to help building TAPIR output models and query templates.
|
|
@
|
|
|
|
|
|
1.14
|
|
log
|
|
@none
|
|
@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="RenatoDeGiovanni" date="1193851882" format="1.1" version="1.14"}%
|
|
d22 1
|
|
a22 1
|
|
PyWrapper, TapirLink and TapirDotNet are full TAPIR data provider implementations. Libraries and client software are still not available as generic TAPIR software, although some organizations and projects have developed their own TAPIR clients.
|
|
d26 1
|
|
a26 1
|
|
Yes. The [[http://bigdig.ecoforge.net/][BigDig]] service monitoring tool is being extended to support TAPIR, and a provider tester should also be developed to check compatibility with the protocol.
|
|
@
|
|
|
|
|
|
1.13
|
|
log
|
|
@none
|
|
@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="RenatoDeGiovanni" date="1193424818" format="1.1" version="1.13"}%
|
|
d72 1
|
|
@
|
|
|
|
|
|
1.12
|
|
log
|
|
@none
|
|
@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="RenatoDeGiovanni" date="1193418954" format="1.1" version="1.12"}%
|
|
d66 5
|
|
a70 1
|
|
*What is the relationship between TAPIR and other search standards, such as SRU and OpenSearch?*
|
|
a71 1
|
|
To be answered...
|
|
@
|
|
|
|
|
|
1.11
|
|
log
|
|
@none
|
|
@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="RenatoDeGiovanni" date="1193339971" format="1.1" reprev="1.11" version="1.11"}%
|
|
d62 4
|
|
@
|
|
|
|
|
|
1.10
|
|
log
|
|
@none
|
|
@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="RyanScherle" date="1193256902" format="1.1" version="1.10"}%
|
|
d14 1
|
|
a14 1
|
|
Yes, you can find it here: http://www.tdwg.org/activities/tapir/specification/
|
|
d18 1
|
|
a18 1
|
|
Yes, you can find it here: http://rs.tdwg.org/tapir/1.0/schema/tapir.xsd
|
|
d22 1
|
|
a22 1
|
|
PyWrapper and TapirLink are two full TAPIR data provider implementations.
|
|
d26 1
|
|
a26 1
|
|
Yes. Please check the notes about plans in the end of the TapirWorkshop2007 wiki page.
|
|
d38 1
|
|
a38 1
|
|
[[http://www.tdwg.org/][TDWG]] is an international organization dedicated to the development of standards for the Biodiversity Informatics community, and is therefore interested in protocols that could be used to enable data exchange. Although TAPIR was originated from the DiGIR and BioCASe protocols, which are mainly used by networks of Biological Collections, it is expected that TAPIR can potentially be used as a single query protocol to search across distributed databases and retrieve results according not only to ABCD and DarwinCore, but also according to other data standards like TCS and SDD. TAPIR is now in the process of becoming a TDWG Task Group.
|
|
d42 1
|
|
a42 1
|
|
TAPIR is still not an official TDWG standard. Meanwhile it may still be subject to changes, although it is already considered stable.
|
|
d52 10
|
|
d63 2
|
|
@
|
|
|
|
|
|
1.9
|
|
log
|
|
@none
|
|
@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="RenatoDeGiovanni" date="1176427125" format="1.1" version="1.9"}%
|
|
d51 2
|
|
@
|
|
|
|
|
|
1.8
|
|
log
|
|
@none
|
|
@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="RenatoDeGiovanni" date="1172623124" format="1.1" reprev="1.8" version="1.8"}%
|
|
d8 1
|
|
a8 1
|
|
*What is the current version of TAPIR? Is it stable?*
|
|
d38 1
|
|
a38 1
|
|
[[http://www.tdwg.org/][TDWG]] is an international organization dedicated to the development of standards for the Biodiversity Informatics community, and is therefore interested in protocols that could be used to enable data exchange. Although TAPIR was originated from the DiGIR and BioCASe protocols, which are mainly used by networks of Biological Collections, it is expected that TAPIR can potentially be used as a single query protocol to search across distributed databases and retrieve results according not only to ABCD and DarwinCore, but also according to other data standards like TCS and SDD. TAPIR is now a TDWG Task Group.
|
|
d42 1
|
|
a42 1
|
|
TAPIR is still not an official TDWG standard. Meanwhile it may still be subject to changes.
|
|
@
|
|
|
|
|
|
1.7
|
|
log
|
|
@none
|
|
@
|
|
text
|
|
@d1 3
|
|
a3 1
|
|
%META:TOPICINFO{author="RicardoPereira" date="1169036717" format="1.1" version="1.7"}%
|
|
d6 1
|
|
a6 1
|
|
TAPIR is an XML-based protocol over HTTP to perform distributed queries on heterogeneous data sources. It was originally created within the Biodiversity Informatics community as an integration of the DiGIR and BioCASe protocols, and it stands for "TDWG Access Protocol for Information Retrieval".
|
|
d8 1
|
|
a8 1
|
|
*What is the current version of TAPIR?*
|
|
d10 1
|
|
a10 1
|
|
TAPIR is still under development and has not released any official version yet. Meanwhile, the latest XML Schema can be retrieved from the TapirSubversionRepository.
|
|
d12 1
|
|
a12 1
|
|
*When is the next version going to be released?*
|
|
d14 1
|
|
a14 1
|
|
Please check the RoadMap for references about protocol releases.
|
|
d16 1
|
|
a16 1
|
|
*Is there any software that implements it?*
|
|
d18 1
|
|
a18 1
|
|
Currently, only the PyWrapper is known to support TAPIR. The PyWrapper is a software to be installed on data providers.
|
|
d20 1
|
|
a20 1
|
|
*Are there plans to have other related software?*
|
|
d22 1
|
|
a22 1
|
|
Yes. Another data provider software called DiGIR2 should be available by the end of the first quarter, 2006.
|
|
d24 1
|
|
a24 1
|
|
*Is there any specification available?*
|
|
d26 1
|
|
a26 1
|
|
No. That's one of the top priorities. The work should ideally start as soon as the protocol is implemented by the first two prototype data providers and gets stabilized. Meanwhile, you can check the PreliminaryProtocolNotes.
|
|
d34 1
|
|
a34 1
|
|
You can join the TapirMailingList, contribute with the wiki, or attend the meetings that usually take place during TDWG events. To contribute to this Wiki, please use your TDWG account credentials. If you don't have a TDWG account, [[http://www.tdwg.org/sign-up/][register with the TDWG website]].
|
|
d38 5
|
|
a42 1
|
|
[[http://www.tdwg.org/][TDWG]] is an international organization dedicated to the development of standards for the Biodiversity Informatics community, and is therefore interested in protocols that could be used to enable data exchange. Although TAPIR was originated from the DiGIR and BioCASe protocols, which are mainly used by networks of Biological Collections, it is expected that TAPIR can potentially be used as a single query protocol to search across distributed databases and retrieve results according not only to ABCD and DarwinCore, but also according to other standards like TCS and SDD. TAPIR is not an official TDWG subgroup yet, which is something that can happen at some point. During the last TDWG meetings, there were always discussions and presentations about TAPIR. The 2005 TAPIR developers meeting has been supported by TDWG.
|
|
d47 4
|
|
@
|
|
|
|
|
|
1.6
|
|
log
|
|
@Revision 6
|
|
@
|
|
text
|
|
@d1 40
|
|
a40 39
|
|
*What is TAPIR?*
|
|
|
|
TAPIR is an XML-based protocol over HTTP to perform distributed queries on heterogeneous data sources. It was originally created within the Biodiversity Informatics community as an integration of the DiGIR and BioCASe protocols, and it stands for "TDWG Access Protocol for Information Retrieval".
|
|
|
|
*What is the current version of TAPIR?*
|
|
|
|
TAPIR is still under development and has not released any official version yet. Meanwhile, the latest XML Schema can be retrieved from the TapirSubversionRepository.
|
|
|
|
*When is the next version going to be released?*
|
|
|
|
Please check the RoadMap for references about protocol releases.
|
|
|
|
*Is there any software that implements it?*
|
|
|
|
Currently, only the PyWrapper is known to support TAPIR. The PyWrapper is a software to be installed on data providers.
|
|
|
|
*Are there plans to have other related software?*
|
|
|
|
Yes. Another data provider software called DiGIR2 should be available by the end of the first quarter, 2006.
|
|
|
|
*Is there any specification available?*
|
|
|
|
No. That's one of the top priorities. The work should ideally start as soon as the protocol is implemented by the first two prototype data providers and gets stabilized. Meanwhile, you can check the PreliminaryProtocolNotes.
|
|
|
|
*How is the decision making process?*
|
|
|
|
Please check the DecisionMakingProcess for TAPIR.
|
|
|
|
*How can I participate in the discussions?*
|
|
|
|
You can join the TapirMailingList, contribute with the wiki, or attend the meetings that usually take place during TDWG events. To contribute to this Wiki, please RegisterFirst and then ask MarkusDoering to give you the necessary permissions.
|
|
|
|
*What is TDWG and what is the relationship between TAPIR and TDWG?*
|
|
|
|
[[http://www.tdwg.org/][TDWG]] is an international organization dedicated to the development of standards for the Biodiversity Informatics community, and is therefore interested in protocols that could be used to enable data exchange. Although TAPIR was originated from the DiGIR and BioCASe protocols, which are mainly used by networks of Biological Collections, it is expected that TAPIR can potentially be used as a single query protocol to search across distributed databases and retrieve results according not only to ABCD and DarwinCore, but also according to other standards like TCS and SDD. TAPIR is not an official TDWG subgroup yet, which is something that can happen at some point. During the last TDWG meetings, there were always discussions and presentations about TAPIR. The 2005 TAPIR developers meeting has been supported by TDWG.
|
|
|
|
*What is GBIF and what is the relationship between TAPIR and GBIF?*
|
|
|
|
[[http://www.gbif.org/][GBIF]] is the biggest existing network about biodiversity data, and therefore has great interest in having a single standard protocol to search and retrieve data from different data providers. The initial integration process of the DiGIR and BioCASe protocols that resulted in TAPIR has been funded by GBIF. GBIF is also an active participant in all TAPIR discussions.
|
|
@
|
|
|
|
|
|
1.5
|
|
log
|
|
@Revision 5
|
|
@
|
|
text
|
|
@d35 1
|
|
a35 1
|
|
TDWG is an international organization dedicated to the development of standards for the Biodiversity Informatics community, and is therefore interested in protocols that could be used to enable data exchange. Although TAPIR was originated from the DiGIR and BioCASe protocols, which are mainly used by networks of Biological Collections, it is expected that TAPIR can potentially be used as a single query protocol to search across distributed databases and retrieve results according not only to ABCD and DarwinCore, but also according to other standards like TCS and SDD. TAPIR is not an official TDWG subgroup yet, which is something that can happen at some point. During the last TDWG meetings, there were always discussions and presentations about TAPIR. The 2005 TAPIR developers meeting has been supported by TDWG.
|
|
d37 1
|
|
a37 1
|
|
*What is the relationship between TAPIR and GBIF?*
|
|
d39 1
|
|
a39 1
|
|
GBIF is the biggest existing network about biodiversity data, and therefore has great interest in having a single standard protocol to search and retrieve data from different data providers. The initial integration process of the DiGIR and BioCASe protocols that resulted in TAPIR has been funded by GBIF. GBIF is also an active participant in all TAPIR discussions.
|
|
@
|
|
|
|
|
|
1.4
|
|
log
|
|
@Revision 4
|
|
@
|
|
text
|
|
@d11 1
|
|
a11 1
|
|
The first official version for the TAPIR protocol should be available by the end of 2005.
|
|
d23 1
|
|
a23 1
|
|
No. That's one of the top priorities. The work should start as soon as the protocol is implemented by the first two prototype data providers and gets stabilized.
|
|
d27 1
|
|
a27 1
|
|
See the DecisionMakingProcess for TAPIR.
|
|
d31 1
|
|
a31 1
|
|
You can join the TapirMailingList, contribute with the wiki, or attend the meetings that usually happens during TDWG. To contribute to this Wiki, please RegisterFirst and then ask MarkusDoering to give you the necessary permissions.
|
|
@
|
|
|
|
|
|
1.3
|
|
log
|
|
@Revision 3
|
|
@
|
|
text
|
|
@d7 1
|
|
a7 1
|
|
TAPIR is still under development and has not released any official version yet. Meanwhile, the latest XML Schema can be retrieved from xxx.
|
|
d31 1
|
|
a31 1
|
|
You can join the mailing list at xxx, contribute with the wiki, or attend the meetings that usually happens during TDWG. To contribute to this Wiki, please RegisterFirst and then ask MarkusDoering to give you the necessary permissions.
|
|
@
|
|
|
|
|
|
1.2
|
|
log
|
|
@Revision 2
|
|
@
|
|
text
|
|
@d31 1
|
|
a31 1
|
|
You can join the mailing list at xxx, contribute with the wiki, or attend the meetings that usually happens during TDWG.
|
|
@
|
|
|
|
|
|
1.1
|
|
log
|
|
@Initial revision
|
|
@
|
|
text
|
|
@d19 1
|
|
a19 1
|
|
Yes. Another data provider software called DiGIR2 should be available by the end of November.
|
|
@
|