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

Service XML : DONNE CLASSIFICATION


Page à appeler : donneclassification.php

Introduction

Ce service permet d'obtenir la description d'une classification ou de l'ensemble des classifications présentes sur le serveur.

Ce document décrit :

  • la façon d'appeler le service donneclassification.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)<table>
  • 2. Exemples de fiches:
  • 3. DTD

1.- Appel du service



  • 2.- Argument(s) obligatoire(s)

  • Ce service ne comporte aucun argument obligatoire. En absence de tout argument il renvoie la liste complète des classifications présentes sur le serveur.


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


Nom Contenu Fonctionnalité
numclass Le numéro de la classification dont on souhaite avoir la description. Obtenir la description d'une seule classification.


2.- Exemples de fiches


  • Exemple 1


<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
  • <FICHE_CLASSIFICATIONS version="1.0" >
    • <CLASSIFICATION numclass="1">
      • <DESCRIPTION>Classification générale</DESCRIPTION>
      • <PREMIER_TAXON numtaxo="59782">
        • <NOM_TAXON numnom="119782" rangtaxo="0" ><NOM >Embryophytes</NOM></NOM_TAXON>
      • </PREMIER_TAXON>
    • </CLASSIFICATION>
    • <CLASSIFICATION numclass="2">
      • <DESCRIPTION>Classification de la Flore de Coste générée automatiquement à partir de la BDNFF.</DESCRIPTION>
      • <PREMIER_TAXON numtaxo="59782">
        • <NOM_TAXON numnom="119782" rangtaxo="0" >
          • <NOM >Embryophytes</NOM>
        • </NOM_TAXON>
      • </PREMIER_TAXON>
    • </CLASSIFICATION>
  • </FICHE_CLASSIFICATIONS>


  • Exemple 2


<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
  • <FICHE_CLASSIFICATIONS version="1.0" numclass="2">
    • <CLASSIFICATION numclass="2">
      • <DESCRIPTION>Classification de la Flore de Coste générée automatiquement à partir de la BDNFF.</DESCRIPTION>
        • <PREMIER_TAXON numtaxo="59782">
          • <NOM_TAXON numnom="119782" rangtaxo="0" ><NOM >Embryophytes</NOM></NOM_TAXON>
        • </PREMIER_TAXON>
      • </CLASSIFICATION>
  • </FICHE_CLASSIFICATIONS>


  • Remarque :
    • Dans la balise FICHE_CLASSIFCIATIONS on retrouvera comme attribut l'argument et la valeur associée ayant été employés à l'appel du service.

3.- DTD

La DTD et la signification de chaque ligne :

  • <?xml version="1.0" encoding="UTF-8"?>

  • <!ELEMENT CLASSIFICATION (DESCRIPTION, PREMIER_TAXON)>
    • la balise CLASSIFICATION doit contenir une balise DESCRIPTION et une balise PREMIER_TAXON.

  • <!ATTLIST CLASSIFICATION numclass CDATA #REDUIRED >
    • la balise CLASSIFICATION doit comporter un attribut de nom numclass

  • <!ELEMENT DESCRIPTION (#PCDATA)>
    • la balise DESCRIPTION contient des données sans autres balises.

  • <!ELEMENT FICHE_CLASSIFICATIONS (CLASSIFICATION+)>
    • la balise FICHE_CLASSIFICATIONS doit contenir au moins une balise CLASSIFICATION ou plus d'une.

  • <!ATTLIST FICHE_CLASSIFICATIONS numclass CDATA #IMPLIED>
    • la balise FICHE_CLASSIFICATIONS peut comporter éventuellement un attribut de nom "numclass".

  • <!ELEMENT INFO_COMBINAISON (#PCDATA)>
    • la balise INFO_COMBINAISON contient des données sans autres balises.

  • <!ATTLIST BIBLIOGRAPHIE annee CDATA #IMPLIED >
    • la balise BIBLIOGRAPHIE peut comporter un attribut ayant le nom annee.

  • <!ELEMENT BIBLIOGRAPHIE (#PCDATA)>
    • la balise BIBLIOGRAPHIE contient des données sans autres balises.

  • <!ELEMENT BIBLIO_A_EXCLURE (#PCDATA)>
    • la balise BIBLIOGRAPHIE_A_EXCLURE contient des données sans autres balises.

  • <!ELEMENT NOM (#PCDATA)>
    • la balise NOM contient des données sans autres balises.

  • <!ATTLIST NOM auteur CDATA #IMPLIED type CDATA #IMPLIED >
    • la balise NOM peut comporter un attribut ayant le nom auteur et un attribut de nom type.

  • <!ELEMENT NOM_TAXON (NOM+,BIBLIOGRAPHIE?,BIBLIO_A_EXCLURE?,INFO_COMBINAISON?)>
    • la balise NOM_TAXON doit contenir au moins une balise NOM et peut contenir une balise BIBILOGRAPHIE, BIBLIO_A_EXCLURE ou encore INFO_COMBINAISON.

  • <!ATTLIST NOM_TAXON numnom CDATA #REQUIRED rangtaxo CDATA #REQUIRED tsyn CDATA #REQUIRED>
    • 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.

  • <!ELEMENT PREMIER_TAXON (NOM_TAXON)>
    • la balise PREMIER_TAXON doit contenir au moins une balise NOM_TAXON.

  • <!ATTLIST PREMIER_TAXON numtaxo CDATA #REQUIRED >
    • la balise PREMIER_TAXON doit comporter un attribut de nom numtaxo.