Subversion Repositories eFlore/Projets.eflore-projets

Rev

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

Rev Author Line No. Line
3 jpm 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&...
655 jpm 7 
*
3 jpm 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),
655 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),
3 jpm 10 
* masque.nn (identifiant du nom), recherche, rang, distinct, retour.format, nl.format, nl.structure, navigation.depart et navigation.limite.
655 jpm 11 
* Les différentes requetes :
3 jpm 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
655 jpm 15 
*
3 jpm 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 {
655 jpm 26 
 
3 jpm 27 
	protected $format_reponse	 = 'noms'; // Permet de stocker la requete formulée
536 gduche 28 
	protected $service 			 = 'noms';
655 jpm 29 
	protected $serviceNom		 = 'noms';
3 jpm 30 
	protected $requete_champ 	 = 'num_nom, nom_sci, num_nom_retenu';
655 jpm 31 
	protected $requete_condition = null;
3 jpm 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).*/
655 jpm 34 
	protected $limite_requete 	 = array('depart' => 0, 'limite' => 100);
536 gduche 35 
	protected $distinct		 	 = null; // Valeur du paramètre de requete distinct (=0|1)
36 
 
3 jpm 37 
	public function consulter($ressources, $parametres) {
38 
		return parent::consulter($ressources, $parametres);
39 
	}
655 jpm 40 
 
3 jpm 41 
//+----------------FONCTION D'ANALYSE DES PARAMETRES---------------------------------------------------------+
655 jpm 42 
 
3 jpm 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);
3 jpm 50 
					break;
51 
				case 'masque.sg' :
655 jpm 52 
					$this->ajouterFiltreMasque('nom_supra_generique', $val);
3 jpm 53 
					break;
655 jpm 54 
				case 'masque.gen' :
55 
					$this->ajouterFiltreMasque('genre', $val);
3 jpm 56 
					break;
655 jpm 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.prga' :
96 
					$this->ajouterFiltreMasque('presence_ga', $val);
97 
					break;
98 
				case 'masque.prco' :
99 
					$this->ajouterFiltreMasque('presence_co', $val);
100 
					break;
101 
				case 'masque.sto' :
102 
					$this->ajouterFiltreMasque('statut_origine', $val);
103 
					break;
104 
				case 'masque.sti' :
105 
					$this->ajouterFiltreMasque('statut_introduction', $val);
106 
					break;
107 
				case 'masque.stc' :
108 
					$this->ajouterFiltreMasque('statut_culture', $val);
109 
					break;
110 
				case 'masque.and' :
111 
					$this->requete_condition []= " annee >= ".$this->getBdd()->proteger($val);
112 
					break;
113 
				case 'masque.anf' :
114 
					$this->requete_condition []= " annee <= ".$this->getBdd()->proteger($val);
115 
					break;
3 jpm 116 
			}
655 jpm 117 
 
3 jpm 118 
		}
119 
	}
655 jpm 120 
 
3 jpm 121 
	public function verifierParamChamps($param, $val) {
122 
		$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
123 
		$champs_demandes = explode(',', $val);
124 
		$champs_verifies = array();
655 jpm 125 
		$champs_api = array_flip($this->champs_api);
1166 delphine 126 
		$champs_supp = array('nom_retenu_complet'=>'num_nom_retenu', 'num_basionyme_complet'=>'num_basionyme');
363 delphine 127 
		$champs_api = array_merge($champs_api, $champs_supp);
3 jpm 128 
		foreach ($champs_demandes as $champ) {
129 
			if (array_key_exists($champ, $champs_api)) {
130 
				$champs_verifies[] = $champs_api[$champ];
131 
			}
132 
		}
133 
		if (count($champs_verifies) > 0) {
134 
			$this->requete_champ .= ', '.implode(',', $champs_verifies);
135 
		}
655 jpm 136 
	}
137 
 
3 jpm 138 
	/** Permet de rajouter à la requete sql le parametre distinct. N'est utilisé qu'avec le format oss */
567 mathilde 139 
	public function ajouterNomDistinct($distinct) {
140 
		if (isset($distinct)) {
141 
			if ($distinct == 1 && $this->parametres['retour.format'] == 'oss') {
142 
				$this->distinct = ' distinct ';
143 
			} elseif ($distinct == 1 && $this->parametres['retour.format'] != 'oss') {
655 jpm 144 
				$e = 'Erreur dans votre requête </br> L\'utilisation du paramètre distinct ne se fait que sous
3 jpm 145 
					le format oss';
146 
				$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
147 
			}
148 
		}
149 
	}
655 jpm 150 
 
3 jpm 151 
//-----------------FONCTION D'ANALYSE DES RESSOURCES--------------------------------------------------------------------
152 
 
153 
	public function traiterRessourcesIdentifiant() {
154 
		//on initialise la condition de la requete sql et le format de réponse
155 
		$this->requete_condition = array(); //on vide la table dans le cas de plusieurs version
156 
		$this->requete_condition[] = 'num_nom = '.$this->getBdd()->proteger($this->ressources[0]);
157 
		$this->format_reponse = $this->service.'/id';
655 jpm 158 
		if (isset($this->ressources[1]) && !empty($this->ressources[1])) {
159 
			if ($this->ressources[1] == 'relations') {
3 jpm 160 
				$this->traiterRessourceIdRelations();
161 
			} else {
162 
				$e = 'Erreur dans votre requête </br> Ressources disponibles : <br/>
163 
					 <li> noms/#id/relations </li> <li> noms/#id/#champ+#champ </li>
164 
					 <li> noms/#id/relations/synonymie </li> <li> noms/#id/relations/flores </li>
165 
					 <li> noms/#id/relations/homonymie </li>';
166 
				$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
167 
			}
168 
		} else { // requete de type noms/#id : rajout du nom_sci pour récupérer le format html par la fct mettreAuFormat()
169 
			$this->requete_champ = ' *, nom_sci ';
170 
		}
171 
	}
655 jpm 172 
 
3 jpm 173 
	public function traiterRessourceRelations() {
174 
		$this->format_reponse .= '/relations';
175 
		$projet = $this->ressources[1];
176 
		$num_nom = $this->ressources[2];
177 
		if (strrpos($num_nom, 'nn.coste') !== false) {
178 
			list($p, $nn) = explode('=', $num_nom);
179 
			$num_nom = $nn;
655 jpm 180 
		}
3 jpm 181 
		$champ = "flore_$projet"."_num";
182 
		if (isset($this->ressources[3])) {
183 
			$type = $this->ressources[3];
184 
			if (!in_array($type, array('homonymie', 'synonymie', 'flores'))) {
185 
				$e = "Les types disponibles pour les noms sont homonymie, synonymie et flores";
186 
				$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
187 
			}
655 jpm 188 
		}
3 jpm 189 
		$this->requete_champ = ' num_nom ';
190 
		$this->requete_condition = array();
191 
		$this->requete_condition[] = "$champ = ".$this->getBdd()->proteger($num_nom);
192 
	}
655 jpm 193 
 
3 jpm 194 
	public function traiterRessourceIdRelations() {
195 
		$this->format_reponse .= '/relations';
196 
		if (isset($this->ressources[2]) && !empty($this->ressources[2])) {
197 
			// requete de type noms/#id/relations/#relation
198 
			switch ($this->ressources[2]) {
655 jpm 199 
				case 'synonymie' :
3 jpm 200 
					$this->traiterRessourceIdSynonymie();
201 
					break;
202 
				case 'flores' :
203 
					$this->traiterRessourceIdFlores();
655 jpm 204 
					break;
3 jpm 205 
				case 'homonymie' :
206 
					$this->traiterRessourceIdHomonymie();
207 
					break;
655 jpm 208 
				default :
3 jpm 209 
					$e = 'Erreur dans votre requête </br> Ressources disponibles : <br/>
655 jpm 210 
					 <li> noms/#id/relations </li>  <li> noms/#id/relations/synonymie </li>
3 jpm 211 
					 <li> noms/#id/relations/flores </li> <li> noms/#id/relations/homonymie </li>';
655 jpm 212 
					$this->renvoyerErreur(RestServeur::HTTP_CODE_MAUVAISE_REQUETE, $e);
3 jpm 213 
					break;
214 
			}
655 jpm 215 
		}
3 jpm 216 
	}
655 jpm 217 
 
3 jpm 218 
	public function traiterRessourceIdSynonymie() {
1166 delphine 219 
		// SELECT num_nom, nom_sci, num_nom_retenu, num_basionyme FROM bdtfx_v2_00 WHERE num_nom = X LIMIT 0,100;
3 jpm 220 
		$this->format_reponse .= '/synonymie';
1166 delphine 221 
		if (strrpos($this->requete_champ, ', num_basionyme') === false) {
222 
			$this->requete_champ .= ', num_basionyme ';
3 jpm 223 
		}
1040 aurelien 224 
		if (strrpos($this->requete_champ, ', num_type') === false) {
225 
			$this->requete_champ .= ', num_type ';
226 
		}
1166 delphine 227 
		$this->requete_champ .= ', source_biblio ';
3 jpm 228 
		$this->requete_condition[0] = 'num_nom_retenu = '.
229 
			'(SELECT num_nom_retenu FROM '.$this->table.' WHERE '.$this->requete_condition[0].')';
230 
	}
655 jpm 231 
 
3 jpm 232 
	public function traiterRessourceIdHomonymie() {
233 
		// 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);
234 
		$this->format_reponse 	 .=  '/homonymie';
235 
		$this->requete_condition[0] =  'nom_sci = (SELECT nom_sci FROM '.$this->table
236 
									.' WHERE '.$this->requete_condition[0].')';
237 
	}
655 jpm 238 
 
3 jpm 239 
	public function traiterRessourceIdFlores() {
240 
		$champ_flores = '';
241 
		foreach ($this->champs_table as $champ) {
242 
			if (preg_match('/^flore_.*$/', $champ)) {
243 
				$champ_flores .= ', '.$champ;
244 
			}
245 
		}
246 
		$this->format_reponse .=  '/flores';
1166 delphine 247 
		$this->requete_champ   = 'num_nom,num_nom_retenu,nom_sci,flores'.$champ_flores;
248 
		$this->requete_condition = null;
249 
		$this->requete_condition[] = "num_nom_retenu = ".$this->ressources[0]." OR num_nom = ".$this->ressources[0];
3 jpm 250 
	}
655 jpm 251 
 
3 jpm 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';
655 jpm 255 
		$this->requete_champ 	 = 'count(*) as nombre, rang ';
3 jpm 256 
		$this->requete_group_by  = ' GROUP BY rang ORDER BY rang ';
257 
	}
655 jpm 258 
 
3 jpm 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;
655 jpm 264 
		$this->requete_group_by  = ' GROUP BY annee ORDER BY annee ';
3 jpm 265 
	}
655 jpm 266 
 
3 jpm 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';
655 jpm 270 
		$this->requete_champ   = 'count(left( nom_sci, 2 )) as nb, rang, left(nom_sci, 2) as lettre ';
3 jpm 271 
		$this->requete_group_by  = ' GROUP BY rang, left(nom_sci, 2)';
272 
	}
655 jpm 273 
 
274 
 
275 
 
3 jpm 276 
//-----------------------------FONCTIONS DASSEMBLAGE DE LA REQUETE-----------------------------------------------------
655 jpm 277 
 
3 jpm 278 
	public function assemblerLaRequete() {
279 
		if ( strrpos($this->format_reponse, 'noms/stats/') === false ) {
280 
			$this->mettreAuFormat(); //Ds CommunNomsTaxons.php
281 
		}
660 jpm 282 
		$requete = 'SELECT '.$this->retournerChamps().' '.
283 
			"FROM {$this->table} ".
284 
			$this->retournerRequeteCondition().' '.
285 
			$this->requete_group_by.' '.
286 
			$this->retournerOrderBy().' '.
740 raphael 287 
			$this->formerRequeteLimite() .
288 
			' -- ' . __FILE__ . ':' . __LINE__ ;
655 jpm 289 
		return $requete;
660 jpm 290 
	}
655 jpm 291 
 
660 jpm 292 
	public function retournerChamps() {
293 
		$sql = '';
294 
		if ($this->distinct) {
295 
			$sql .= $this->distinct.' ';
296 
		}
297 
		if ($this->requete_champ) {
298 
			$sql .= $this->requete_champ.' ';
299 
		}
300 
 
301 
		// Champs "virtuels" pour tier sur l'ensemble des résultats
302 
		if (isset($this->parametres['retour.tri'])) {
303 
			list($champ, $ordre) = $this->decouperParametreRetourTri();
304 
			if ($champ == 'retenu') {
305 
				$sql .= ", IF(num_nom = num_nom_retenu, '0', '1') AS nom_retenu_tri ";
306 
			}
307 
		}
308 
 
309 
		return $sql;
3 jpm 310 
	}
311 
 
660 jpm 312 
	public function decouperParametreRetourTri() {
313 
		$tri = array('', '');
314 
		if (isset($this->parametres['retour.tri'])) {
315 
			if (preg_match('/^(retenu)(?:,(ASC|DESC)|)$/', $this->parametres['retour.tri'], $match))
316 
			$tri[0] = $match[1];
317 
			$tri[1] = isset($match[2]) ? $match[2] : '';
318 
		}
319 
		return $tri;
320 
	}
321 
 
322 
	public function retournerRequeteCondition() {
323 
		$condition = '';
324 
		if ($this->requete_condition) {
325 
			$condition = ' WHERE '.implode(' AND ', $this->requete_condition);
326 
		}
327 
		return $condition;
328 
	}
329 
 
330 
	public function retournerOrderBy() {
331 
		$orderBy = array();
332 
 
333 
		// Tri sur l'ensemble des résultats
334 
		if (isset($this->parametres['retour.tri'])) {
335 
			list($champ, $ordre) = $this->decouperParametreRetourTri();
336 
			if ($champ == 'retenu') {
337 
				$orderBy[] = "nom_retenu_tri $ordre";
338 
			}
339 
		}
340 
		// Tri par défaut
341 
		if ($this->format_reponse == 'noms') {
342 
			$orderBy[] = 'nom_sci ASC';
343 
		}
344 
 
345 
		$sql = '';
672 jpm 346 
		if (count($orderBy) > 0) {
660 jpm 347 
			$sql = 'ORDER BY '.implode(', ', $orderBy).' ';
348 
		}
349 
		return $sql;
350 
	}
351 
 
3 jpm 352 
	public function formerRequeteLimite() {
655 jpm 353 
		if ($this->format_reponse != 'noms' && $this->format_reponse != 'noms/id/relations/synonymie'
660 jpm 354 
				&& $this->format_reponse != 'noms/id/relations/homonymie') {
655 jpm 355 
			$this->requete_limite = '';
3 jpm 356 
		} elseif (($depart = $this->limite_requete['depart']) > ($this->total_resultat = $this->recupererTotalResultat())) {
655 jpm 357 
			$this->limite_requete['depart'] =
660 jpm 358 
			(($this->total_resultat - $this->limite_requete['limite']) < 0) ? 0 : ($this->total_resultat - $this->limite_requete['limite']);
655 jpm 359 
			$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite'];
3 jpm 360 
		} else {
655 jpm 361 
			$this->requete_limite = ' LIMIT '.$this->limite_requete['depart'].', '.$this->limite_requete['limite'];
3 jpm 362 
		}
363 
		return $this->requete_limite;
364 
	}
655 jpm 365 
 
3 jpm 366 
	/** Recupere le nombre total de résultat d'une requete lancée. */
367 
	public function recupererTotalResultat() {
368 
		$total = null;
369 
		$requete = 'SELECT count(*) as nombre FROM '.$this->table.$this->retournerRequeteCondition().$this->requete_group_by;
370 
		$res = $this->getBdd()->recuperer($requete);
371 
		if ($res) {
372 
			$total = $res['nombre'];
373 
		} else {
374 
			$e = 'Fct recupererTotalResultat() : <br/>Données introuvables dans la base';
375 
			$this->renvoyerErreur(RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE, $e);
376 
		}
377 
		return $total;
378 
	}
655 jpm 379 
 
380 
 
3 jpm 381 
//-------------------FONCTIONS POUR LE FORMATAGE EN JSON----------------------------------------------------------------
655 jpm 382 
 
272 delphine 383 
	public function retournerResultatFormate($resultat) {
740 raphael 384 
 
3 jpm 385 
		switch ($this->format_reponse) {
386 
			case 'noms/relations' :
387 
				$reponse = $this->formaterRelations($resultat[0]);
388 
				break;
389 
			case 'noms/id' : //ds CommunNomsTaxons
390 
				$reponse = $this->formaterId($resultat[0]);
391 
				break;
392 
			case 'noms/id/relations' :
393 
				$reponse = $this->formaterIdRelations($resultat[0]);
655 jpm 394 
				break;
3 jpm 395 
			case 'noms/id/relations/synonymie' :
396 
				$reponse = $this->formaterIdSynonymie($resultat);
397 
				break;
398 
			case 'noms/id/relations/homonymie' :
399 
				$reponse = $this->formaterIdHomonymie($resultat);
400 
				break;
401 
			case 'noms/id/relations/flores' : //ds CommunsNomsTaxons
1166 delphine 402 
				$reponse = $this->formaterIdFlores($resultat);
3 jpm 403 
				break;
404 
			case 'noms/stats/annees' : //ds CommunNomsTaxons
405 
				$reponse = $this->formaterStatsAnnee($resultat);
406 
				break;
407 
			case 'noms/stats/rangs' : //ds CommunNomsTaxons
408 
				$reponse = $this->formaterStatsRang($resultat);
409 
				break;
410 
			case 'noms/stats/initiales' : //ds CommunNomsTaxons
411 
				$reponse = $this->formaterStatsInitiales($resultat);
412 
				break;
413 
			case 'noms' :
414 
				$reponse = $this->formaterNoms($resultat);
415 
				break;
416 
		}
417 
		return $reponse;
418 
	}
655 jpm 419 
 
3 jpm 420 
//+---------------------concerne les resultats pour des requetes de type noms/id-----------------------------+
655 jpm 421 
 
3 jpm 422 
	public function formaterRelations($resultat) {
423 
		$num_nom = $resultat['num_nom'];
424 
		if (isset($this->ressources[3])) {
425 
			$url = Config::get('url_service').$this->service."/$num_nom/relations";
426 
		} else {
427 
			$type = $this->ressources[3];
428 
			$url = Config::get('url_service')."/$this->service/$num_nom/relations/$type";
429 
		}
430 
		$res = $this->consulterHref($url);
431 
		return $res;
655 jpm 432 
	}
433 
 
3 jpm 434 
	public function formaterIdRelations($resultat) {
435 
		$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
655 jpm 436 
		$this->resultat_req = $resultat;
3 jpm 437 
		$retour_id_rel = array ('entete' => array()); //on initialise pr que l'entete apparaisse en premier lors de l'affichage
655 jpm 438 
 
3 jpm 439 
		//on recupère le resultat de chaque relation (appel du WS correspondant)
272 delphine 440 
		$flores = $this->ajouterRelations('flores');
3 jpm 441 
		if (isset($flores)) $retour_id_rel['resultat']['flores'] = $flores;
272 delphine 442 
		$homonymes = $this->ajouterRelations('homonymie');
3 jpm 443 
		if (isset($homonymes)) $retour_id_rel['resultat']['homonymes'] = $homonymes;
272 delphine 444 
		$synonymes = $this->ajouterRelations('synonymie');
3 jpm 445 
		if (isset($synonymes)) $retour_id_rel['resultat']['synonymes'] = $synonymes;
655 jpm 446 
 
3 jpm 447 
		//on renvoit null si il n'existe aucune relations (on efface l'entete en premier lieu)
448 
		if (!isset($retour_id_rel['resultat']))	{
655 jpm 449 
			$retour_id_rel = null;
3 jpm 450 
		} else { //on rajoute l'entete si des relations existent
655 jpm 451 
			$this->afficherDonnees('num_nom', $this->ressources[0]);
3 jpm 452 
			$retour_id_rel['entete'] = $this->table_retour;
453 
			$this->table_retour = array();
454 
		}
455 
		return $retour_id_rel;
456 
	}
655 jpm 457 
 
3 jpm 458 
	/**
655 jpm 459 
	 * Recupere les relations (type de la relation passée en paramètres :[type_relation] = synonymie, homonymie ou
3 jpm 460 
	 * flores) par l'appel du web service [version]/noms/#id/relations/[type_relation]
461 
	 */
272 delphine 462 
	public function ajouterRelations($relation) {
463 
		$version = str_replace(Config::get('bdd_table').'_', '', $this->table);
3 jpm 464 
		$res = null;
465 
		$parametres_url = '';
466 
		if ($this->parametres != array()) $parametres_url = '?'.http_build_query($this->parametres, '', '&');
272 delphine 467 
		$url = Config::get('url_service').'/'.$this->service.'/'
3 jpm 468 
									.$this->ressources[0].'/relations/'
272 delphine 469 
									.$relation.$parametres_url;	Debug::printr($url);
655 jpm 470 
 
3 jpm 471 
		$relation = $this->consulterHref($url);
655 jpm 472 
 
3 jpm 473 
		$res = $relation->resultat;
474 
		return $res;
475 
	}
655 jpm 476 
 
477 
 
3 jpm 478 
	public function formaterIdSynonymie($resultat) {
479 
		$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
480 
		$retour_id_syn = array();
963 raphael 481 
		if ($resultat[0]['num_nom_retenu'] == '') return array('nom_retenu N.D.');
482 
 
483 
        // 1 ou + résultat(s)
484 
        $retour_id_syn['entete'] = $this->afficherEnteteResultat('/'.$this->service.'/'.$this->ressources[0].'/relations/synonymie');
485 
        $retour_id_syn['entete']['id'] = $this->ressources[0];
486 
        $retour_id_syn['resultat'] = array();
487 
 
488 
        // résultat contient aussi l'original
489 
        if(count($resultat) > 1) {
655 jpm 490 
			//on remplit d'abord l'entete du resultat
1166 delphine 491 
			$this->table_retour['id'] = $this->ressources[0];
492 
			$this->afficherEnteteResultat('/'.$this->service.'/'.$this->ressources[0].'/relations/synonymie');
493 
			$retour_id_syn['entete'] = $this->table_retour;
494 
			$this->table_retour = array();
3 jpm 495 
			foreach ($resultat as $tab) {
1166 delphine 496 
				//pour chaque basionyme, on recupère le résultat : num_nom, nom_sci, num_basionyme et num_nom_retenu :
655 jpm 497 
				$this->resultat_req = $tab;
3 jpm 498 
				$num = $tab['num_nom'];
499 
				$this->afficherNomHrefRetenu($tab, $num);
1166 delphine 500 
				$this->afficherDonnees('num_basionyme', $tab['num_basionyme']);
1040 aurelien 501 
				$this->afficherDonnees('num_type', $tab['num_type']);
1166 delphine 502 
				$this->afficherDonnees('source_biblio', $tab['source_biblio']);
3 jpm 503 
				$retour_id_syn['resultat'][$num] = $this->table_retour;
504 
				$this->table_retour = array();
505 
			}
506 
			if (!isset($retour_id_syn['resultat']) && !in_array('nom_retenu N.D.', $retour_id_syn)) {
507 
				$retour_id_syn = null; //on initialise le resultat à null
655 jpm 508 
			}
3 jpm 509 
		}
510 
		return $retour_id_syn;
511 
	}
655 jpm 512 
 
3 jpm 513 
	public function formaterIdHomonymie($resultat) {
514 
		$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
272 delphine 515 
		if (count($resultat) != 1) {
3 jpm 516 
			$this->table_retour['id'] = $this->ressources[0];
517 
			$this->afficherEnteteResultat($resultat, '/'.$this->service.'/'.$this->ressources[0].'/relations/homonymie');
518 
			$retour_id_hom['entete'] = $this->table_retour;
519 
			$this->table_retour = array();
520 
			foreach ($resultat as $homonyme) {
521 
				$this->resultat_req = $homonyme;
522 
				$id = $homonyme['num_nom'];
523 
				$this->afficherDonnees('num_nom', $id);
524 
				if ($homonyme['num_nom_retenu'] != '') {
562 delphine 525 
					$retenu = ($id == $homonyme['num_nom_retenu']) ? 'true' : 'false';
526 
				} else {
527 
					$retenu = 'absent';
528 
				}
655 jpm 529 
				$this->table_retour['retenu'] = $retenu;
3 jpm 530 
				$retour_id_hom['resultat'][$id] = $this->table_retour;
531 
				unset($retour_id_hom['resultat'][$id]['id']);
532 
				$this->table_retour = array();
533 
			}
533 gduche 534 
		} else {
655 jpm 535 
			$retour_id_hom = null;
3 jpm 536 
		}
537 
		return $retour_id_hom;
538 
	}
655 jpm 539 
 
540 
 
1166 delphine 541 
	public function formaterIdFlores($synonymes_flores) {//print_r($resultat);
542 
		$this->recupererTableSignification('noms_projets');
543 
		if (is_array($synonymes_flores)) {//print_r($synonymes_flores);
306 aurelien 544 
			foreach ($synonymes_flores as $synonyme) {
1166 delphine 545 
				if ($synonyme['num_nom'] === $synonyme['num_nom_retenu']) {
546 
					$reponse['entete']['id'] = $synonyme['num_nom'];
547 
				}
548 
				foreach ($this->noms_projets as $flore => $valeur) {
549 
					if (isset($synonyme[$flore.'_num']) && $synonyme[$flore.'_num'] != '') {
550 
						$presence[$valeur] = $flore;
551 
						$this->table_retour[$flore]['type'] = "code";
552 
						$this->afficherInfosFlore($synonyme, $flore, $valeur, '_num');
553 
					} else if (isset($synonyme[$flore.'_page']) && $synonyme[$flore.'_page'] != '') {
554 
						$this->table_retour[$flore]['type'] = "page";
555 
						$this->afficherInfosFlore($synonyme, $flore, $valeur, '_page');
556 
					} else if (isset($synonyme[$flore]) && $synonyme[$flore] != '') {
557 
						$this->table_retour[$flore]['type'] = "page";
558 
						$this->afficherInfosFlore($synonyme, $flore, $valeur, 'page');
306 aurelien 559 
					}
560 
				}
1166 delphine 561 
				if ($synonyme['flores'] != "") {
562 
					$this->recupererTableSignification('correspondance_flores');
563 
					$flores = explode(',', $synonyme['flores']);
564 
					$projet = array_flip($this->noms_projets);
565 
					foreach ($flores as $b =>$code) {
566 
						$code = trim($code);
567 
						if (isset($this->correspondance_flores[$code]) && !isset($presence[$this->correspondance_flores[$code]])) {
568 
							$this->table_retour[$projet[$this->correspondance_flores[$code]]]['nom_flore'] = $this->correspondance_flores[$code];
569 
						}
570 
 
571 
					}
572 
				}
3 jpm 573 
			}
574 
		}
306 aurelien 575 
 
3 jpm 576 
		if ($this->table_retour != array()) {
577 
			$reponse['resultat'] = $this->table_retour;
578 
			$this->table_retour = array();
655 jpm 579 
		} else {
580 
			$reponse = null;
3 jpm 581 
		}
582 
		return $reponse;
583 
	}
655 jpm 584 
 
585 
 
1166 delphine 586 
	public function afficherInfosFlore($synonyme, $flore, $nom_flore, $type) {
1172 delphine 587 
				preg_match('/^([0-9]+)(.*)?$/', $synonyme[$flore.$type], $match);
1166 delphine 588 
		$this->table_retour[$flore]['nom_flore'] = $nom_flore;
589 
		$this->table_retour[$flore]['num'][$synonyme[$flore.$type]]['id'] = $match['1'];
590 
		$this->table_retour[$flore]['num'][$synonyme[$flore.$type]]['num_nom'] = $synonyme['num_nom'];
591 
		$this->table_retour[$flore]['num'][$synonyme[$flore.$type]]['nom_sci'] = $synonyme['nom_sci'];
592 
		if (isset($synonyme[$flore.'_rem']) && $synonyme[$flore.'_rem'] != '') {
593 
			$this->table_retour[$flore]['num'][$synonyme[$flore.$type]]['remarques'] = $synonyme[$flore.'_rem'];
3 jpm 594 
		}
1172 delphine 595 
		if ($flore == "flore_coste") {
596 
			$this->table_retour[$flore]['num'][$synonyme[$flore.$type]]['href'] = $this->ajouterHrefAutreProjet('textes', 'coste.nn:', $match[1], 'coste');
1166 delphine 597 
		}
1172 delphine 598 
		switch ($flore) {
599 
			case "flore_coste" : $statuts = array('syn' => 'synonyme', 'incl'=> 'taxons inclus dans', 'x' => 'correspond aux compléments en fin de tome 3',
600 
				'hyb' => 'hybride', 'sub' => 'nom apparaissant dans la clé sous');break ;
601 
			case "flore_bonnier" : break ; // champ vide
602 
			case "flore_cnrs" : $statuts = array('syn' => 'synonyme', 'incl'=> 'taxons inclus dans');break ;
603 
			case "flore_fe" : break ; // champ vide
604 
			case "flore_coste" : $statuts = array('syn' => 'synonyme', 'inc'=> 'taxons inclus dans', 'x' => 'compléments en fin de tome 3');break ;
605 
			case "flore_fh" : $statuts = array('syn' => 'synonyme', 'inc'=> 'taxons inclus dans'); break;
606 
			case "flore_fournier" : $statuts = array('syn' => 'synonyme', 'hyb'=> 'hybride', 'sub' => 'nom apparaissant dans la clé sous'); break;
607 
			case "flore_belge_ed5" : $statuts = array('R'=> 'nom retenu', 'S' => 'synonyme');break ;
608 
			case "flore_fg" : $statuts = array('r' => 'nom retenu', 'c' => 'cité hors clé',
609 
				 's' => 'synonyme d’un nom retenu', 'cs' => 'synonyme d’un nom cité hors clé',
610 
				'i' => 'nom d’un taxon inclus dans un autre', 'is' => 'syn d’un nom d’un taxon inclus dans un autre');break ;
611 
		}
612 
		/*
613 
		 * Pour CNRS :
614 
a, b, c, d = le taxon est inclus dans un autre taxon, mentionné en note
615 
 
616 
 
617 
Pour Coste :
618 
a, b,… aux taxons inclus dans
619 
		 */
1166 delphine 620 
		if (isset($statuts[trim($match[2])])) {
621 
			$this->table_retour[$flore]['num'][$synonyme[$flore.$type]]['statut'] = $statuts[trim($match[2])];
622 
		} else if(trim($match[2]) != "") {
1172 delphine 623 
			$suf = preg_split('/[\.|-|\s]/', $match[2]);
624 
			$statut = "";
625 
			foreach ($suf as $s) {
626 
				if (isset($statuts[trim($s)])) {
627 
					$statut .= $statuts[trim($s)]." ";
628 
				} else if (preg_match('/^[a-z]$/', trim($s)) === 1) {
629 
					$statut .= "taxon '".trim($s)."' inclus dans un autre taxon ";
630 
				} else {
631 
					$statut .= trim($s)." ";
632 
				}
633 
			}
634 
			$this->table_retour[$flore]['num'][$synonyme[$flore.$type]]['statut'] = trim($statut);
1166 delphine 635 
		}
655 jpm 636 
	}
637 
 
3 jpm 638 
//+---------------------concerne les resultats pour des requetes de type /noms avec ou sans paramètres-------+
639 
 
566 aurelien 640 
	public function formaterNoms($resultat) {
3 jpm 641 
		if ($this->parametres['retour.format'] == 'oss') {
642 
			$reponse = $this->formaterEnOss($resultat);	 //Ds CommunNomsTaxons.php
643 
		} else {
644 
			$reponse = $this->formaterEnJsonMax($resultat);
645 
		}
646 
		return $reponse;
647 
	}
648 
 
649 
	public function formaterEnJsonMax($resultat) {
650 
		$this->recupererTableSignification('correspondance_champs,champs_api,champs_comp');
660 jpm 651 
 
952 raphael 652 
		// TODO : améliorer le tri des résultats
660 jpm 653 
		// ATTENTION : ce comportement est étrange
3 jpm 654 
		$masque = $this->recupererMasquePrincipal();
952 raphael 655 
		if ($masque && isset($this->parametres[$masque[0]] /* à éclaircir */ ) && !isset($this->parametres['retour.tri'])) {
3 jpm 656 
			$resultat = $this->trierRechercheFloue($this->parametres[$masque[0]], $resultat, $masque[1]);
657 
		}
660 jpm 658 
 
1067 mathias 659 
		// Tri à la mode du CeL : lexicographique puis noms retenus (retour.tri = "alpharet")
660 
		if (isset($this->parametres['retour.tri']) && ($this->parametres['retour.tri'] == "alpharet")) {
661 
			usort($resultat, array($this, 'genrePuisNomsRetenusEnTete'));
662 
		}
663 
 
963 raphael 664 
		$table_retour_json['entete'] = $this->afficherEnteteResultat('/'.$this->service);
655 jpm 665 
		$table_retour_json['resultat'] = $this->remplirJsonResultat($resultat);
606 mathilde 666 
		return $table_retour_json;
667 
	}
668 
 
1067 mathias 669 
	// Trie les éléments du tableau de résultats : le genre en tête, puis les noms retenus, puis le reste
670 
	// mais à partir du jeu de données retourné par SQL (indépendents du statut "retenu")
671 
	private function genrePuisNomsRetenusEnTete($a, $b) {
672 
		// On pourrait utiliser l'indice ['retenu'] mais il contient parfois "absent", qui est dur à traiter
673 
		$aEstRetenu = ($a['num_nom'] == $a['num_nom_retenu']);
674 
		$bEstRetenu = ($b['num_nom'] == $b['num_nom_retenu']);
675 
		$retour = 0;
676 
 
677 
		// les noms retenus en premier ("inférieurs")
678 
		if ($aEstRetenu) {
679 
			if (! $bEstRetenu) {
680 
				$retour = -1;
681 
			}
682 
		}  else {
683 
			if ($bEstRetenu) {
684 
				$retour = 1;
685 
			}
686 
		}
687 
 
688 
		// en cas d'égalité on conserve le tri lexicographique - devrait faire sortir le genre en première position
689 
		// car il ne contient pas le nom d'auteur
690 
		if ($retour == 0) {
691 
			$retour = strcasecmp($a['nom_sci'], $b['nom_sci']);
692 
		}
693 
 
694 
		return $retour;
695 
	}
696 
 
606 mathilde 697 
	public function remplirJsonResultat($resultat) {
3 jpm 698 
		$champs = null;
699 
		if (array_key_exists('retour.champs', $this->parametres)) {
700 
			$champs = explode(',', $this->parametres['retour.champs']);
701 
		}
660 jpm 702 
 
1113 mathias 703 
		// Structure des données: objet ou liste ?
704 
		$modeListe = false;
705 
		if (array_key_exists('retour.structure', $this->parametres)) {
706 
			$modeListe = ($this->parametres['retour.structure'] === "liste");
707 
		}
708 
 
655 jpm 709 
		$noms = array();
3 jpm 710 
		foreach ($resultat as $tab) {
711 
			$this->table_retour = array();
712 
			$num = $tab['num_nom'];
93 delphine 713 
			$this->afficherNomHrefRetenu($tab, $num); // ajoute le nom_sci, href et si le nom est retenu dans $this->table_retour
714 
			$retour = $this->table_retour;
715 
			$this->table_retour = array();
716 
			if ($champs != null) {
717 
				$reponse_id = $this->formaterId($tab);
718 
				$this->table_retour = array();
719 
				$this->ajouterChampsPersonnalises($champs, $reponse_id);
720 
				$retour = array_merge($retour, $this->table_retour);
721 
			}
1113 mathias 722 
			if ($modeListe) {
723 
				$retour['num_nom'] = intval($num);
724 
				$noms[] = $retour;
725 
			} else {
726 
				$noms[$num] = $retour;
727 
			}
3 jpm 728 
		}
655 jpm 729 
 
660 jpm 730 
		return  $noms;
3 jpm 731 
	}
732 
}
733 
?>