Subversion Repositories eFlore/Projets.eflore-projets

Rev

Rev 671 | Rev 713 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

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