Subversion Repositories eFlore/Projets.eflore-projets

Rev

Rev 933 | Rev 948 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 933 Rev 934
Line 130... Line 130...
130
			$uri = $ressources;
130
			$uri = $ressources;
131
		}
131
		}
Line 132... Line 132...
132
 
132
 
133
		// renvoie du plain/text d'aide (cf fin de programme)
133
		// renvoie du plain/text d'aide (cf fin de programme)
134
		if (count($uri) == 1 && $uri[0] == 'aide') {
134
		if (count($uri) == 1 && $uri[0] == 'aide') {
135
			return self::aide();
135
			die(self::aide());
Line 136... Line -...
136
		}
-
 
137
 
136
		}
138
 
137
 
139
		if (is_null($parametres)) {
138
		if (is_null($parametres)) {
140
			$parametres = Array();
139
			$parametres = Array();
141
		}
140
		}
Line 455... Line 454...
455
		);
454
		);
456
	}
455
	}
Line 457... Line 456...
457
 
456
 
458
	static function aide() {
457
	static function aide() {
459
		header("Content-Type: text/plain; charset=utf-8");
-
 
460
		return sprintf("
458
		header("Content-Type: text/plain; charset=utf-8");
-
 
459
		return sprintf("Service coste/textes:
461
Service coste/textes:
460
 
462
Retourne des informations (choisies) à propos d'un taxon donné (à partir de son numéro nomenclatural
461
Retourne des informations (choisies) à propos d'un taxon donné (à partir de son numéro nomenclatural
463
Retourne des informations (choisies) à propos de taxons recherchés (à partir de divers critères)
462
Retourne des informations (choisies) à propos de taxons recherchés (à partir de divers critères)
464
Les résultats sont indexés. La clef par défaut est le num_nom d'après coste (attribut \"coste:nn\")
-
 
465
Usage:
463
Les résultats sont indexés. La clef par défaut est le num_nom d'après coste (attribut \"coste:nn\")
-
 
464
Usage:  coste/textes[/<liste-num_nom>]?<params>
466
			coste/textes/<liste-num_nom>?<params>
465
 
467
* le paramètre \"retour.indexBy\" affecte le mode d'indexation (\"bdtfx\" ou \"coste\" (defaut))
466
* le paramètre \"retour.indexBy\" affecte le mode d'indexation (\"bdtfx\" ou \"coste\" (defaut))
468
* <liste-num_nom> étant une liste de numéros nomenclaturaux de taxons séparés par des virgules au format:
467
* <liste-num_nom> étant une liste de numéros nomenclaturaux de taxons séparés par des virgules au format:
469
 - <#id>: un numéro nomenclatural dans la base coste
468
 - <#id>: un numéro nomenclatural dans la base coste
470
 - <bdtfx.nn:#id>: un numéro nomenclatural dans la base bdtfx
469
 - <bdtfx.nn:#id>: un numéro nomenclatural dans la base bdtfx
471
* retour.champs une liste de champs séparés par des virgules parmi *,%s
470
* retour.champs une liste de champs séparés par des virgules parmi *,%s
472
* les paramètres acceptés sont les suivants: %s
471
* les paramètres acceptés sont les suivants: %s
473
* les champs retournés par défaut sont les suivants: %s
472
* les champs retournés par défaut sont les suivants: %s
474
* le paramètre \"recherche\" affecte les masques \"ns\" et \"texte\"
473
* le paramètre \"recherche\" affecte les masques \"ns\" et \"texte\"
475
* le paramètre \"famille\" est traité via LIKE et accepte les caractères '_' et '%'
474
* le paramètre \"famille\" est traité via LIKE et accepte les caractères '_' et '%%'
-
 
475
* le paramètre \"retour.format\" est inutilisé pour l'instant.
-
 
476
 
-
 
477
Exemples:
-
 
478
/service:eflore:0.1/coste/textes/bdtfx.nn:182?retour.champs=titre
-
 
479
	# retourne l'Acer monspessulanum
-
 
480
/service:eflore:0.1/coste/textes/182?retour.champs=titre
-
 
481
	# retourne la Roemeria violacea (bdtfx:nn = 56272)
-
 
482
/service:eflore:0.1/coste/textes/182,bdtfx.nn:182?retour.champs=titre
-
 
483
	# retourne les deux précédents
-
 
484
/service:eflore:0.1/coste/textes?masque.titre=Cla001Thalamiflores&retour.champs=titre
-
 
485
	# retourne la section de Coste relatives aux Thalamiflores
-
 
486
/service:eflore:0.1/coste/textes?masque.titre=Thalamiflores&recherche=floue&retour.champs=titre
-
 
487
	# idem, en utilisant une recherche floue
-
 
488
/service:eflore:0.1/coste/textes?masque.titre=Cla001Thalamiflores&retour.champs=titre&retour.indexBy=bdtfx
-
 
489
	# retourne une erreur de format car cette section de coste n'est associée à aucun taxon de la BDTFX
476
* le paramètre \"retour.format\" est inutilisé pour l'instant",
490
",
477
			implode(',', array_keys(self::$allow_champs)),
491
			implode(',', array_keys(self::$allow_champs)),
478
			implode(',', self::$allow_params),
492
			implode(',', self::$allow_params),
479
			self::$default_params['retour.champs']
493
			self::$default_params['retour.champs']
480
		);
494
		);