Subversion Repositories eFlore/Projets.eflore-projets

Rev

Rev 1175 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
707 aurelien 1 
<?php
2 
// declare(encoding='UTF-8');
3 
/**
4 
* Classe permettant de fournir des informations sur les noms scientifiques.
5 
* Si l'url finit par /noms on retourne une liste de noms latin et leurs identifiants (seulement les 100 premeiers noms par défaut).
6 
* L'url peut contenir des paramètres optionnels passés après le ? : /noms?param1=val1&param2=val2&...
7 
*
8 
* Les paramètres de requête disponibles sont : masque, masque.gen (nom de genre), masque.sp (épithète d'espèce), masque.ssp (épithète infra-spécifique),
9 
* masque.au (auteur du nom), masque.an (année de publication du nom), masque.bib (réf biblio de la publi d'origine du nom), masque.ad (nomen addendum),
10 
* masque.nn (identifiant du nom), recherche, rang, distinct, retour.format, nl.format, nl.structure, navigation.depart et navigation.limite.
11 
* Les différentes requetes :
12 
*   - noms | noms/relations/#projet/#id_projet | noms/#id | noms/#id/#champ+#champ
13 
*   - noms/#id/relations | noms/#id/relations/synonymie | noms/#id/relations/homonymie | noms/#id/relations/flores
14 
*   - noms/stats/rangs | noms/stats/annees | noms/stats/initiales
15 
*
16 
* @package bdtfx
17 
* @author Jennifer Dhé <jennifer.dhe@tela-botanica.org>
18 
* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
19 
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
20 
* @version $Id$
21 
* @copyright 1999-2011 Tela Botanica (accueil@tela-botanica.org)
22 
* @see http://www.tela-botanica.org/wikini/eflore/wakka.php?wiki=EfloreApi01Noms
23 
*/
24 
 
25 
class Noms extends CommunNomsTaxons {
26 
 
27 
	protected $format_reponse	 = 'noms'; // Permet de stocker la requete formulée
28 
	protected $service 			 = 'noms';
29 
	protected $serviceNom		 = 'noms';
30 
	protected $requete_champ 	 = 'num_nom, nom_sci, num_nom_retenu';
1285 killian 31 
	protected $requete_condition = [];
707 aurelien 32 
	protected $requete_group_by  = '';
33 
	/** Permet de stocker les limite de la requete SQL (par défaut seul les 100 premiers résultats seront retournés).*/
34 
	protected $limite_requete 	 = array('depart' => 0, 'limite' => 100);
35 
	protected $distinct		 	 = null; // Valeur du paramètre de requete distinct (=0|1)
36 
 
37 
	public function consulter($ressources, $parametres) {
38 
		return parent::consulter($ressources, $parametres);
39 
	}
40 
 
41 
//+----------------FONCTION D'ANALYSE DES PARAMETRES---------------------------------------------------------+
42 
 
43 
	public function traiterParametresSpecifiques() {
44 
		foreach ($this->parametres as $param => $val) {
45 
			switch ($param) {
46 
				case 'masque' :
1130 aurelien 47 
					$champ = isset($this->parametres['recherche']) && ($this->parametres['recherche'] == 'etendue') ?
48 
							'CONCAT(nom_sci," ",auteur)' : 'nom_sci';
49 
					$this->ajouterFiltreMasque($champ, $val);
707 aurelien 50 
					break;
51 
				case 'masque.sg' :
52 
					$this->ajouterFiltreMasque('nom_supra_generique', $val);
53 
					break;
54 
				case 'masque.gen' :
55 
					$this->ajouterFiltreMasque('genre', $val);
56 
					break;
57 
				case 'masque.sp' :
58 
					$this->ajouterFiltreMasque('epithete_sp', $val);
59 
					break;
60 
				case 'masque.ssp' :
61 
					$this->ajouterFiltreMasque('epithete_infra_sp',$val);
62 
					break;
63 
				case 'masque.au' :
64 
					$this->ajouterFiltreMasque('auteur', $val);
65 
					break;
66 
				case 'masque.an' :
67 
					$this->ajouterFiltreMasque('annee', $val);
68 
					break;
69 
				case 'masque.bib' :
70 
					$this->ajouterFiltreMasque('biblio_origine',$val);
71 
					break;
72 
				case 'masque.ad' :
73 
					$this->ajouterFiltreMasque('nom_addendum', $val);
74 
					break;
75 
				case 'masque.nn' :
76 
					$this->requete_condition []= 'num_nom IN ('.$val.')';
77 
					$this->masque['num_nom'] = "num_nom=$val";
78 
					break;
79 
				case 'masque.nt' :
80 
					$this->requete_condition []= 'num_taxonomique IN ('.$val.')';
81 
					$this->masque['num_tax'] = "num_taxonomique=$val";
82 
					break;
83 
				case 'masque.rg' :
84 
					$this->ajouterFiltreMasque('rang', $val);
85 
					break;
86 
				case 'retour.champs' :
87 
					$this->verifierParamChamps($param, $val);
88 
					break;
89 
				case 'distinct' :
90 
					$this->ajouterNomDistinct($val);
91 
					break;
92 
				case 'masque.fam' :
93 
					$this->ajouterFiltreMasque('famille', $val);
94 
					break;
95 
				case 'masque.sto' :
96 
					$this->ajouterFiltreMasque('statut_origine', $val);
97 
					break;
98 
				case 'masque.sti' :
99 
					$this->ajouterFiltreMasque('statut_introduction', $val);
100 
					break;
101 
				case 'masque.stc' :
102 
					$this->ajouterFiltreMasque('statut_culture', $val);
103 
					break;
104 
				case 'masque.and' :
105 
					$this->requete_condition []= " annee >= ".$this->getBdd()->proteger($val);
106 
					break;
107 
				case 'masque.anf' :
108 
					$this->requete_condition []= " annee <= ".$this->getBdd()->proteger($val);
109 
					break;
110 
				case 'masque.prgua' :
111 
					$this->ajouterFiltreMasque('presence_Guadeloupe', $val);
112 
					break;
113 
				case 'masque.prmar' :
114 
					$this->ajouterFiltreMasque('presence_Martinique', $val);
115 
					break;
116 
				case 'masque.prstm' :
117 
					$this->ajouterFiltreMasque('presence_Saint_Martin', $val);
118 
					break;
119 
				case 'masque.prdes' :
120 
					$this->ajouterFiltreMasque('presence_La_Desirade', $val);
121 
					break;
122 
 
123 
				case 'masque.prstb' :
124 
					$this->ajouterFiltreMasque('presence_Saint_Barthelemy', $val);
125 
					break;
126 
 
127 
				case 'masque.prmga' :
128 
					$this->ajouterFiltreMasque('presence_Marie_Galante', $val);
129 
					break;
130 
 
131 
				case 'masque.prsai' :
132 
					$this->ajouterFiltreMasque('`presence_Les-Saintes`', $val);
133 
					break;
134 
			}
135 
		}
136 
	}
137 
 
138 
	public function verifierParamChamps($param, $val) {
139 
		$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
140 
		$champs_demandes = explode(',', $val);
141 
		$champs_verifies = array();
142 
		$champs_api = array_flip($this->champs_api);
143 
		$champs_supp = array('nom_retenu_complet'=>'num_nom_retenu', 'basionyme_complet'=>'basionyme');
144 
		$champs_api = array_merge($champs_api, $champs_supp);
145 
		foreach ($champs_demandes as $champ) {
146 
			if (array_key_exists($champ, $champs_api)) {
147 
				$champs_verifies[] = $champs_api[$champ];
148 
			}
149 
		}
150 
		if (count($champs_verifies) > 0) {
151 
			$this->requete_champ .= ', '.implode(',', $champs_verifies);
152 
		}
153 
	}
154 
 
155 
	/** Permet de rajouter à la requete sql le parametre distinct. N'est utilisé qu'avec le format oss */
156 
	public function ajouterNomDistinct($distinct) {
157 
		if (isset($distinct)) {
158 
			if ($distinct == 1 && $this->parametres['retour.format'] == 'oss') {
159 
				$this->distinct = ' distinct ';
160 
			} elseif ($distinct == 1 && $this->parametres['retour.format'] != 'oss') {
161 
				$e = 'Erreur dans votre requête </br> L\'utilisation du paramètre distinct ne se fait que sous
162 
					le format oss';
163 
				$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
164 
			}
165 
		}
166 
	}
167 
 
168 
//-----------------FONCTION D'ANALYSE DES RESSOURCES--------------------------------------------------------------------
169 
 
170 
	public function traiterRessourcesIdentifiant() {
171 
		//on initialise la condition de la requete sql et le format de réponse
172 
		$this->requete_condition = array(); //on vide la table dans le cas de plusieurs version
173 
		$this->requete_condition[] = 'num_nom = '.$this->getBdd()->proteger($this->ressources[0]);
174 
		$this->format_reponse = $this->service.'/id';
175 
		if (isset($this->ressources[1]) && !empty($this->ressources[1])) {
176 
			if ($this->ressources[1] == 'relations') {
177 
				$this->traiterRessourceIdRelations();
178 
			} else {
179 
				$e = 'Erreur dans votre requête </br> Ressources disponibles : <br/>
180 
					 <li> noms/#id/relations </li> <li> noms/#id/#champ+#champ </li>
709 aurelien 181 
					 <li> noms/#id/relations/synonymie </li>
707 aurelien 182 
					 <li> noms/#id/relations/homonymie </li>';
183 
				$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
184 
			}
185 
		} else { // requete de type noms/#id : rajout du nom_sci pour récupérer le format html par la fct mettreAuFormat()
186 
			$this->requete_champ = ' *, nom_sci ';
187 
		}
188 
	}
189 
 
190 
	public function traiterRessourceRelations() {
191 
		$this->format_reponse .= '/relations';
192 
		$projet = $this->ressources[1];
193 
		$num_nom = $this->ressources[2];
194 
		if (strrpos($num_nom, 'nn.coste') !== false) {
195 
			list($p, $nn) = explode('=', $num_nom);
196 
			$num_nom = $nn;
197 
		}
198 
		$champ = "flore_$projet"."_num";
199 
		if (isset($this->ressources[3])) {
200 
			$type = $this->ressources[3];
709 aurelien 201 
			if (!in_array($type, array('homonymie', 'synonymie'))) {
202 
				$e = "Les types disponibles pour les noms sont homonymie, synonymie";
707 aurelien 203 
				$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
204 
			}
205 
		}
206 
		$this->requete_champ = ' num_nom ';
207 
		$this->requete_condition = array();
208 
		$this->requete_condition[] = "$champ = ".$this->getBdd()->proteger($num_nom);
209 
	}
210 
 
211 
	public function traiterRessourceIdRelations() {
212 
		$this->format_reponse .= '/relations';
213 
		if (isset($this->ressources[2]) && !empty($this->ressources[2])) {
214 
			// requete de type noms/#id/relations/#relation
215 
			switch ($this->ressources[2]) {
216 
				case 'synonymie' :
217 
					$this->traiterRessourceIdSynonymie();
218 
					break;
219 
				case 'homonymie' :
220 
					$this->traiterRessourceIdHomonymie();
221 
					break;
222 
				default :
223 
					$e = 'Erreur dans votre requête </br> Ressources disponibles : <br/>
224 
					 <li> noms/#id/relations </li>  <li> noms/#id/relations/synonymie </li>
709 aurelien 225 
					 <li> noms/#id/relations/homonymie </li>';
707 aurelien 226 
					$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
227 
					break;
228 
			}
229 
		}
230 
	}
231 
 
232 
	public function traiterRessourceIdSynonymie() {
233 
		// SELECT num_nom, nom_sci, num_nom_retenu, basionyme FROM bdtfx_v2_00 WHERE num_nom = X LIMIT 0,100;
234 
		$this->format_reponse .= '/synonymie';
235 
		if (strrpos($this->requete_champ, ', basionyme') === false) {
236 
			$this->requete_champ .= ', basionyme ';
237 
		}
1040 aurelien 238 
		if (strrpos($this->requete_champ, ', num_type') === false) {
239 
			$this->requete_champ .= ', num_type ';
240 
		}
707 aurelien 241 
		$this->requete_condition[0] = 'num_nom_retenu = '.
242 
			'(SELECT num_nom_retenu FROM '.$this->table.' WHERE '.$this->requete_condition[0].')';
243 
	}
244 
 
245 
	public function traiterRessourceIdHomonymie() {
246 
		// SELECT num_nom, nom_sci, num_nom_retenu FROM bdtfx_v2_00 WHERE nom_sci = (SELECT nom_sci FROM bdtfx_v2_00 WHERE num_nom = X);
247 
		$this->format_reponse 	 .=  '/homonymie';
248 
		$this->requete_condition[0] =  'nom_sci = (SELECT nom_sci FROM '.$this->table
249 
									.' WHERE '.$this->requete_condition[0].')';
250 
	}
251 
 
252 
	public function traiterRessourceStatsRangs() {
253 
		// SELECT count(*) as nombre, rang FROM bdtfx_v2_00 [WHERE rang = 290] GROUP BY rang ORDER BY rang;
254 
		$this->format_reponse   .= '/rangs';
255 
		$this->requete_champ 	 = 'count(*) as nombre, rang ';
256 
		$this->requete_group_by  = ' GROUP BY rang ORDER BY rang ';
257 
	}
258 
 
259 
	public function traiterRessourceStatsAnnees() {
260 
		// SELECT count(*) as nombre, annee FROM bdtfx_v2_00 GROUP BY annee ORDER BY annee;
261 
		$this->format_reponse   .= '/annees';
262 
		$this->requete_champ   	 = 'count(*) as nombre, annee ';
263 
		$this->requete_condition = null;
264 
		$this->requete_group_by  = ' GROUP BY annee ORDER BY annee ';
265 
	}
266 
 
267 
	public function traiterRessourceStatsInitiales() {
268 
		// SELECT count(left( nom_sci, 2 )) as nb, rang, left(nom_sci, 2) as lettre GROUP BY rang, left(nom_sci, 2);
269 
		$this->format_reponse .= '/initiales';
270 
		$this->requete_champ   = 'count(left( nom_sci, 2 )) as nb, rang, left(nom_sci, 2) as lettre ';
271 
		$this->requete_group_by  = ' GROUP BY rang, left(nom_sci, 2)';
272 
	}
273 
 
274 
//-----------------------------FONCTIONS DASSEMBLAGE DE LA REQUETE-----------------------------------------------------
275 
 
276 
	public function assemblerLaRequete() {
277 
		if ( strrpos($this->format_reponse, 'noms/stats/') === false ) {
278 
			$this->mettreAuFormat(); //Ds CommunNomsTaxons.php
279 
		}
280 
		$requete = 'SELECT '.$this->retournerChamps().' '.
281 
			"FROM {$this->table} ".
282 
			$this->retournerRequeteCondition().' '.
283 
			$this->requete_group_by.' '.
284 
			$this->retournerOrderBy().' '.
285 
			$this->formerRequeteLimite();
286 
		return $requete;
287 
	}
288 
 
289 
	public function retournerChamps() {
290 
		$sql = '';
291 
		if ($this->distinct) {
292 
			$sql .= $this->distinct.' ';
293 
		}
294 
		if ($this->requete_champ) {
295 
			$sql .= $this->requete_champ.' ';
296 
		}
297 
 
298 
		// Champs "virtuels" pour tier sur l'ensemble des résultats
299 
		if (isset($this->parametres['retour.tri'])) {
300 
			list($champ, $ordre) = $this->decouperParametreRetourTri();
301 
			if ($champ == 'retenu') {
302 
				$sql .= ", IF(num_nom = num_nom_retenu, '0', '1') AS nom_retenu_tri ";
303 
			}
304 
		}
305 
 
306 
		return $sql;
307 
	}
308 
 
309 
	public function decouperParametreRetourTri() {
310 
		$tri = array('', '');
311 
		if (isset($this->parametres['retour.tri'])) {
312 
			if (preg_match('/^(retenu)(?:,(ASC|DESC)|)$/', $this->parametres['retour.tri'], $match))
313 
				$tri[0] = $match[1];
314 
			$tri[1] = isset($match[2]) ? $match[2] : '';
315 
		}
316 
		return $tri;
317 
	}
318 
 
319 
	public function retournerRequeteCondition() {
320 
		$condition = '';
321 
		if ($this->requete_condition) {
322 
			$condition = ' WHERE '.implode(' AND ', $this->requete_condition);
323 
		}
324 
		return $condition;
325 
	}
326 
 
327 
	public function retournerOrderBy() {
328 
		$orderBy = array();
329 
 
330 
		// Tri sur l'ensemble des résultats
331 
		if (isset($this->parametres['retour.tri'])) {
332 
			list($champ, $ordre) = $this->decouperParametreRetourTri();
333 
			if ($champ == 'retenu') {
334 
				$orderBy[] = "nom_retenu_tri $ordre";
335 
			}
336 
		}
337 
		// Tri par défaut
338 
		if ($this->format_reponse == 'noms') {
339 
			$orderBy[] = 'nom_sci ASC';
340 
		}
341 
 
342 
		$sql = '';
343 
		if (count($orderBy) > 0) {
344 
			$sql = 'ORDER BY '.implode(', ', $orderBy).' ';
345 
		}
346 
		return $sql;
347 
	}
348 
 
349 
	public function formerRequeteLimite() {
350 
		if ($this->format_reponse != 'noms' && $this->format_reponse != 'noms/id/relations/synonymie'
351 
			&& $this->format_reponse != 'noms/id/relations/homonymie') {
352 
			$this->requete_limite = '';
353 
		} elseif (($depart = $this->limite_requete['depart']) > ($this->total_resultat = $this->recupererTotalResultat())) {
354 
			$this->limite_requete['depart'] =
355 
				(($this->total_resultat - $this->limite_requete['limite']) < 0) ? 0 : ($this->total_resultat - $this->limite_requete['limite']);
356 
			$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite'];
357 
		} else {
358 
			$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite'];
359 
		}
360 
		return $this->requete_limite;
361 
	}
362 
 
363 
	/** Recupere le nombre total de résultat d'une requete lancée. */
364 
	public function recupererTotalResultat() {
365 
		$total = null;
366 
		$requete = 'SELECT count(*) as nombre FROM '.$this->table.$this->retournerRequeteCondition().$this->requete_group_by;
367 
		$res = $this->getBdd()->recuperer($requete);
368 
		if ($res) {
369 
			$total = $res['nombre'];
370 
		} else {
371 
			$e = 'Fct recupererTotalResultat() : <br/>Données introuvables dans la base';
372 
			$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $e);
373 
		}
374 
		return $total;
375 
	}
376 
 
377 
 
378 
//-------------------FONCTIONS POUR LE FORMATAGE EN JSON----------------------------------------------------------------
379 
 
380 
	public function retournerResultatFormate($resultat) {
381 
		switch ($this->format_reponse) {
382 
			case 'noms/relations' :
383 
				$reponse = $this->formaterRelations($resultat[0]);
384 
				break;
385 
			case 'noms/id' : //ds CommunNomsTaxons
386 
				$reponse = $this->formaterId($resultat[0]);
387 
				break;
388 
			case 'noms/id/relations' :
389 
				$reponse = $this->formaterIdRelations($resultat[0]);
390 
				break;
391 
			case 'noms/id/relations/synonymie' :
392 
				$reponse = $this->formaterIdSynonymie($resultat);
393 
				break;
394 
			case 'noms/id/relations/homonymie' :
395 
				$reponse = $this->formaterIdHomonymie($resultat);
396 
				break;
397 
			case 'noms/stats/annees' : //ds CommunNomsTaxons
398 
				$reponse = $this->formaterStatsAnnee($resultat);
399 
				break;
400 
			case 'noms/stats/rangs' : //ds CommunNomsTaxons
401 
				$reponse = $this->formaterStatsRang($resultat);
402 
				break;
403 
			case 'noms/stats/initiales' : //ds CommunNomsTaxons
404 
				$reponse = $this->formaterStatsInitiales($resultat);
405 
				break;
406 
			case 'noms' :
407 
				$reponse = $this->formaterNoms($resultat);
408 
				break;
409 
		}
410 
		return $reponse;
411 
	}
412 
 
413 
//+---------------------concerne les resultats pour des requetes de type noms/id-----------------------------+
414 
 
415 
	public function formaterRelations($resultat) {
416 
		$num_nom = $resultat['num_nom'];
417 
		if (isset($this->ressources[3])) {
418 
			$url = Config::get('url_service').$this->service."/$num_nom/relations";
419 
		} else {
420 
			$type = $this->ressources[3];
421 
			$url = Config::get('url_service')."/$this->service/$num_nom/relations/$type";
422 
		}
423 
		$res = $this->consulterHref($url);
424 
		return $res;
425 
	}
426 
 
427 
	public function formaterIdRelations($resultat) {
428 
		$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
429 
		$this->resultat_req = $resultat;
430 
		$retour_id_rel = array ('entete' => array()); //on initialise pr que l'entete apparaisse en premier lors de l'affichage
431 
 
432 
		//on recupère le resultat de chaque relation (appel du WS correspondant)
433 
		$homonymes = $this->ajouterRelations('homonymie');
434 
		if (isset($homonymes)) $retour_id_rel['resultat']['homonymes'] = $homonymes;
435 
		$synonymes = $this->ajouterRelations('synonymie');
436 
		if (isset($synonymes)) $retour_id_rel['resultat']['synonymes'] = $synonymes;
437 
 
438 
		//on renvoit null si il n'existe aucune relations (on efface l'entete en premier lieu)
439 
		if (!isset($retour_id_rel['resultat']))	{
440 
			$retour_id_rel = null;
441 
		} else { //on rajoute l'entete si des relations existent
442 
			$this->afficherDonnees('num_nom', $this->ressources[0]);
443 
			$retour_id_rel['entete'] = $this->table_retour;
444 
			$this->table_retour = array();
445 
		}
446 
		return $retour_id_rel;
447 
	}
448 
 
449 
	/**
450 
	 * Recupere les relations (type de la relation passée en paramètres :[type_relation] = synonymie, homonymie ou
709 aurelien 451 
	 * ) par l'appel du web service [version]/noms/#id/relations/[type_relation]
707 aurelien 452 
	 */
453 
	public function ajouterRelations($relation) {
454 
		$version = str_replace(Config::get('bdd_table').'_', '', $this->table);
455 
		$res = null;
456 
		$parametres_url = '';
457 
		if ($this->parametres != array()) $parametres_url = '?'.http_build_query($this->parametres, '', '&');
458 
		$url = Config::get('url_service').'/'.$this->service.'/'.
459 
			$this->ressources[0].'/relations/'.
460 
			$relation.$parametres_url;
461 
 
462 
		$relation = $this->consulterHref($url);
463 
 
464 
		$res = $relation->resultat;
465 
		return $res;
466 
	}
467 
 
468 
 
469 
	public function formaterIdSynonymie($resultat) {
470 
		$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
471 
		$retour_id_syn = array();
472 
		if ($resultat[0]['num_nom_retenu'] == '') {
473 
			$retour_id_syn[] = 'nom_retenu N.D.';
474 
		} elseif (count($resultat) != 1) {
475 
			//on remplit d'abord l'entete du resultat
476 
			$this->table_retour['id'] = $this->ressources[0];
477 
			$this->afficherEnteteResultat('/'.$this->service.'/'.$this->ressources[0].'/relations/synonymie');
478 
			$retour_id_syn['entete'] = $this->table_retour;
479 
			$this->table_retour = array();
480 
			foreach ($resultat as $tab) {
481 
				//pour chaque basionyme, on recupère le résultat : num_nom, nom_sci, basionyme et num_nom_retenu :
482 
				$this->resultat_req = $tab;
483 
				$num = $tab['num_nom'];
484 
				$this->afficherNomHrefRetenu($tab, $num);
485 
				$this->afficherDonnees('basionyme', $tab['basionyme']);
486 
				$retour_id_syn['resultat'][$num] = $this->table_retour;
487 
				$this->table_retour = array();
488 
			}
489 
			if (!isset($retour_id_syn['resultat']) && !in_array('nom_retenu N.D.', $retour_id_syn)) {
490 
				$retour_id_syn = null; //on initialise le resultat à null
491 
			}
492 
		}
493 
		return $retour_id_syn;
494 
	}
495 
 
496 
	public function formaterIdHomonymie($resultat) {
497 
		$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
498 
		if (count($resultat) != 1) {
499 
			$this->table_retour['id'] = $this->ressources[0];
500 
			$this->afficherEnteteResultat($resultat, '/'.$this->service.'/'.$this->ressources[0].'/relations/homonymie');
501 
			$retour_id_hom['entete'] = $this->table_retour;
502 
			$this->table_retour = array();
503 
			foreach ($resultat as $homonyme) {
504 
				$this->resultat_req = $homonyme;
505 
				$id = $homonyme['num_nom'];
506 
				$this->afficherDonnees('num_nom', $id);
507 
				if ($homonyme['num_nom_retenu'] != '') {
508 
					$retenu = ($id == $homonyme['num_nom_retenu']) ? 'true' : 'false';
509 
				} else {
510 
					$retenu = 'absent';
511 
				}
512 
				$this->table_retour['retenu'] = $retenu;
513 
				$retour_id_hom['resultat'][$id] = $this->table_retour;
514 
				unset($retour_id_hom['resultat'][$id]['id']);
515 
				$this->table_retour = array();
516 
			}
517 
		} else {
518 
			$retour_id_hom = null;
519 
		}
520 
		return $retour_id_hom;
521 
	}
522 
 
523 
	public function obtenirSynonymesParNumNomAvecInfosFlore($num_nom, $version='1_02') {
524 
 
525 
		$champs_flore = 'flore_bonnier_num, flore_bonnier_rem,'.
526 
						'flore_cnrs_num, flore_cnrs_rem '.
527 
						'flore_fe_num, flore_fe_rem '.
528 
						'flore_coste_num, flore_coste_rem '.
529 
						'flore_fh_num, flore_fh_rem '.
530 
						'flore_fournier_num, flore_fournier_rem';
531 
 
532 
		$requete = 'SELECT num_nom, nom_sci, '.$champs_flore.' '.
533 
						'FROM '.$this->table.' '.
534 
						'WHERE num_nom_retenu = '.
535 
						'('.
536 
						'SELECT num_nom_retenu FROM '.$this->table.' WHERE num_nom = "'.$num_nom.'"'.
537 
						')';
538 
 
539 
		return $this->getBdd()->recupererTous($requete);
540 
	}
541 
 
542 
//+---------------------concerne les resultats pour des requetes de type /noms avec ou sans paramètres-------+
543 
 
544 
	public function formaterNoms($resultat) {
545 
		if ($this->parametres['retour.format'] == 'oss') {
546 
			$reponse = $this->formaterEnOss($resultat);	 //Ds CommunNomsTaxons.php
547 
		} else {
548 
			$reponse = $this->formaterEnJsonMax($resultat);
549 
		}
550 
		return $reponse;
551 
	}
552 
 
553 
	public function formaterEnJsonMax($resultat) {
554 
		$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
555 
 
556 
		// TODO : améliorer le tri des résultats
557 
		// ATTENTION : ce comportement est étrange
558 
		$masque = $this->recupererMasquePrincipal();
559 
		if (isset($masque) && !isset($this->parametres['retour.tri'])) {
560 
			// fonction du pauvre pour palier aux "." remplacés accidentellement par des "_"
561 
			$index = str_replace('masque_','masque.',$masque[0]);
562 
			//$resultat = $this->trierRechercheFloue($this->parametres[$index], $resultat, $masque[1]);
563 
		}
564 
 
1067 mathias 565 
		// Tri à la mode du CeL : lexicographique puis noms retenus (retour.tri = "alpharet")
566 
		if (isset($this->parametres['retour.tri']) && ($this->parametres['retour.tri'] == "alpharet")) {
567 
			usort($resultat, array($this, 'genrePuisNomsRetenusEnTete'));
568 
		}
569 
 
707 aurelien 570 
		$table_retour_json['entete'] = $this->remplirJsonEntete();
571 
		$table_retour_json['resultat'] = $this->remplirJsonResultat($resultat);
572 
		return $table_retour_json;
573 
	}
574 
 
1067 mathias 575 
	// Trie les éléments du tableau de résultats : le genre en tête, puis les noms retenus, puis le reste
576 
	// mais à partir du jeu de données retourné par SQL (indépendents du statut "retenu")
577 
	private function genrePuisNomsRetenusEnTete($a, $b) {
578 
		// On pourrait utiliser l'indice ['retenu'] mais il contient parfois "absent", qui est dur à traiter
579 
		$aEstRetenu = ($a['num_nom'] == $a['num_nom_retenu']);
580 
		$bEstRetenu = ($b['num_nom'] == $b['num_nom_retenu']);
581 
		$retour = 0;
582 
 
583 
		// les noms retenus en premier ("inférieurs")
584 
		if ($aEstRetenu) {
585 
			if (! $bEstRetenu) {
586 
				$retour = -1;
587 
			}
588 
		}  else {
589 
			if ($bEstRetenu) {
590 
				$retour = 1;
591 
			}
592 
		}
593 
 
594 
		// en cas d'égalité on conserve le tri lexicographique - devrait faire sortir le genre en première position
595 
		// car il ne contient pas le nom d'auteur
596 
		if ($retour == 0) {
597 
			$retour = strcasecmp($a['nom_sci'], $b['nom_sci']);
598 
		}
599 
 
600 
		return $retour;
601 
	}
602 
 
707 aurelien 603 
	public function remplirJsonResultat($resultat) {
604 
		$champs = null;
605 
		if (array_key_exists('retour.champs', $this->parametres)) {
606 
			$champs = explode(',', $this->parametres['retour.champs']);
607 
		}
608 
 
1114 mathias 609 
		// Structure des données: objet ou liste ?
610 
		$modeListe = false;
611 
		if (array_key_exists('retour.structure', $this->parametres)) {
612 
			$modeListe = ($this->parametres['retour.structure'] === "liste");
613 
		}
614 
 
707 aurelien 615 
		$noms = array();
616 
		foreach ($resultat as $tab) {
617 
			$this->table_retour = array();
618 
			$num = $tab['num_nom'];
619 
			$this->afficherNomHrefRetenu($tab, $num); // ajoute le nom_sci, href et si le nom est retenu dans $this->table_retour
620 
			$retour = $this->table_retour;
621 
			$this->table_retour = array();
622 
			if ($champs != null) {
623 
				$reponse_id = $this->formaterId($tab);
624 
				$this->table_retour = array();
625 
				$this->ajouterChampsPersonnalises($champs, $reponse_id);
626 
				$retour = array_merge($retour, $this->table_retour);
627 
			}
1114 mathias 628 
			if ($modeListe) {
629 
				$retour['num_nom'] = intval($num);
630 
				$noms[] = $retour;
631 
			} else {
632 
				$noms[$num] = $retour;
633 
			}
707 aurelien 634 
		}
635 
 
636 
		return $noms;
637 
	}
638 
 
639 
	public function remplirJsonEntete() {
640 
		$entete = array();
641 
		if (isset($this->masque)) {
642 
			$this->table_retour['masque'] = implode('&', $this->masque);
643 
		}
644 
		parent::afficherEnteteResultat('/'.$this->service);
645 
		return  $this->table_retour;
646 
	}
647 
}
1285 killian 648 
?>