Tela-botanica Projet eFlore

Service XML : donnelistetaxons.php

Introduction

Ce service permet de recevoir une liste de taxons classés alphabétiquement.

Ce document décrit :

Table des matières

  1. Appel du service
    1. URL
    2. Argument(s) obligatoire(s)
    3. Argument(s) optionnel(s)
  2. Exemple de fiche:
  3. DTD

1 Appel du service

1 URL

L'appel de ce service se fait à partir de l'URL suivante : http://eflore.tela-botanica.org/servicesxml/donnelistetaxons.php .

2 Argument(s) obligatoire(s)

Ce service n'a pas d'arguments obligatoires. Cependant il est recommandé dans utiliser sous peine d'avoir une réponse comportant la totalité des noms de la base de données.
Exemple :http://eflore.tela-botanica.org/servicesxml/donnelistetaxons.php

3 Argument(s) optionnel(s)

NomContenuFonctionnalité
numclass L'identifiant d'une classification. Permet de ne recevoir que des taxons présents ou absents de la classification spécifiée en fonction de l'argument nomsvalides
nomsvalides Deux valeurs possibles oui valeur par défaut, non. Permet de spécifier si l'on souhaite recevoir les taxons présents (valeur oui) ou absents (valeur non) de la classification spécifiée
nommin Nom ou début de nom d'un taxon (jusqu'à l'espèce). Permet de faire commencer la liste de taxons à partir de ce nom.
nommax Nom ou début de nom d'un taxon (jusqu'à l'espèce). Permet de faire terminer la liste de taxons à partir de ce nom.
nomssespecemin Nom ou début du nom de sous-espèce d'un taxon (arguments nommin obligatoire). Permet de faire commencer la liste de taxons à partir du nommin et à partir de la sous espèce nomssespecemin.
nomssespecemax Nom ou début du nom de sous-espèce d'un taxon (arguments nommax obligatoire). Permet de faire terminer la liste de taxons à partir de nommax et à partir de la sous espèce nomssespecemax.
rangtaxomin Le rang taxonomique à ne pas dépasser. Voir domaine de valeurs RangTaxonomique Pour indiquer le rang taxonomique que l'on ne souhaite pas dépasser dans la liste. Aucun taxon ayant un rang taxonomique plus élevé ne sera présent dans la liste. Par défaut on obtiendra la totalité des taxons.
rangtaxomax Le rang taxonomique à ne pas dépasser. Voir domaine de valeurs RangTaxonomique Pour indiquer le rang taxonomique que l'on ne souhaite pas dépasser dans la liste. Aucun taxon ayant un rang taxonomique plus fin ne sera présent dans la liste. Par défaut on obtiendra la totalité des taxons.
radical Partie d'un nom de taxon à l'exception des auteurs Permet de ne recevoir que des taxons comportant ce radical.

Exemple :
http://eflore.tela-botanica.org/servicesxml/donnelistetaxons.php?numclass=1&nomsvalides=non
http://eflore.tela-botanica.org/servicesxml/donnelistetaxons.php?nommin=Oxalis&nommax=Oxalis
http://eflore.tela-botanica.org/servicesxml/donnelistetaxons.php?numclass=1&rangtaxomin=60&rangtaxomax=60

2 Exemple de fiche:

Exemple :

<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>
<FICHE_LISTE_TAXONS version="1.0" numclass="1" radical="Oxalis debilis">
<LISTE_TAXONS>
<NOM_TAXON numnom="47131" rangtaxo="100">
<NOM auteur="Kunth">Oxalis debilis</NOM>
<BIBLIOGRAPHIE annee="1822">Nov. Gen. Sp. Pl., 5 : 236, tab.</BIBLIOGRAPHIE>
</NOM_TAXON>
<NOM_TAXON numnom="47132" rangtaxo="110">
<NOM auteur="Kunth">Oxalis debilis</NOM>
<NOM type="subsp." auteur="(DC.) O.Bolos & Vigo">corymbosa</NOM>
<BIBLIOGRAPHIE annee="1990">Fl. Països Catal., 2 : 266</BIBLIOGRAPHIE>
</NOM_TAXON>
<NOM_TAXON numnom="47133" rangtaxo="110">
<NOM auteur="Kunth">Oxalis debilis</NOM>
<NOM type="subsp.">debilis</NOM>
</NOM_TAXON>
</LISTE_TAXONS>
</FICHE_LISTE_TAXONS>


3 DTD

<?xml version="1.0" encoding="UTF-8"?>
<!ELEMENT FICHE_LISTE_TAXONS (LISTE_TAXONS)>
<!ATTLIST FICHE_LISTE_TAXONS version CDATA #REQUIRED numclass CDATA #IMPLIED nomsvalides CDATA #IMPLIED nommin CDATA #IMPLIED nommax CDATA #IMPLIED nomssespecemin CDATA #IMPLIED nomssespecemax CDATA #IMPLIED rangtaxomin CDATA #IMPLIED rangtaxomax CDATA #IMPLIED>
<!ELEMENT LISTE_TAXONS(NOM_TAXON+)>
<!ELEMENT INFO_COMBINAISON (#PCDATA)>
<!ATTLIST BIBLIOGRAPHIE annee CDATA #IMPLIED >
<!ELEMENT BIBLIOGRAPHIE (#PCDATA)>
<!ELEMENT BIBLIO_A_EXCLURE (#PCDATA)>
<!ELEMENT NOM (#PCDATA)>
<!ATTLIST NOM auteur CDATA #IMPLIED type CDATA #IMPLIED >
<!ELEMENT NOM_TAXON (NOM+,BIBLIOGRAPHIE?,BIBLIO_A_EXCLURE?,INFO_COMBINAISON?)>
<!ATTLIST NOM_TAXON numnom CDATA #REQUIRED rangtaxo CDATA #REQUIRED tsyn CDATA #REQUIRED>
<!ELEMENT PREMIER_TAXON (NOM_TAXON)>
<!ATTLIST PREMIER_TAXON numtaxo CDATA #REQUIRED >

Ce qui signifie :