Retour : page principale > sommaire eFlore v0 > liste services XML

Service XML : DONNE LISTE TAXONS


Page à appeler : donnelistetaxons.php

Introduction

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

Ce document décrit :

  • la façon d'appeler le service donnelistetaxons.php
  • le format de la réponse donnée par ce service XML.

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.


  • 3.- Argument(s) optionnel(s)


Nom Contenu Fonctionnalité
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.




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 :

  • * que la balise FICHE_LISTE_TAXONS doit contenir une balise LISTE_TAXONs.
  • * que la balise FICHE_LISTE_TAXONS doit comporter un attribut de nom version éventuellement accompagné par les attributs numclas, nomsvalides, nommin, nommax, nomssespecemin, nomssespecemax, rangtaxomin, rangtaxomax.
  • * que la balise NOM_TAXON doit contenir au moins une balise NOM et peut contenir une balise BIBILOGRAPHIE, BIBLIO_A_EXCLURE ou encore INFO_COMBINAISON.
  • * que la balise NOM_TAXON doit comporter deux attributs le premier ayant pour nom numnom l'autre ayant pour nom rangtaxo et éventuellement un attribut tsyn.
  • * que la balise NOM contient des données sans autres balises.
  • * que la balise NOM peut comporter un attribut ayant le nom auteur et un attribut de nom type.
  • * que la balise LISTE_TAXONS peut contenir une ou plusieurs balises NOM_TAXON.
  • * que la balise BIBLIOGRAPHIE contient des données sans autres balises.
  • * que la balise BIBLIOGRAPHIE peut comporter un attribut ayant le nom annee.
  • * que la balise BIBLIOGRAPHIE_A_EXCLURE contient des données sans autres balises.
  • * que la balise INFO_COMBINAISON contient des données sans autres balises.