GetTaxa
org.ecoinformatics.seek.taxon.GetTaxa

The GetTaxa actor provides access to taxonomic data via the Taxonomic Object Service. (TOS).

The Taxonomic Object Service is a web services enabled product that allows user to query taxonomic data in a variety of ways, for example, name to concept resolution, walking a classification tree and finding concepts related to one another.

This actor uses several of the API methods defined within the TOS WSDL (@todo URL to WSDL) to find all syunonymous names defined within a particular authority at a user specified rank where each of those names are descendants of a specified concept. For example, this actor can be used to find all names at the species level associated with the ITIS, 2006 concept of Mammalia.

The user of the actor must provide the authority, root concept's name and the target level. After execution, the return will be a two-dimensional array containing with the following structure: [ ['guid1', 'name1', name2', ...], ['guid2', 'name1', 'name2', ...]...] The first element of each row contains the GUID of the concept to which the following names are associated. This data will presented to downstream actors on the synonymousNames port.

Any errors that take place during configuration or execution of the actor will be concatenated into a single string and presented on the clientExecErrors port.



Author(s):
Version: