Subversion Repositories eFlore/Applications.cel

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
918 aurelien 1
<?php
2
// ATTENTION ! Classe compatible uniquement avec nouveau format de bdd du cel //
3
 
4
/**
5
* PHP Version 5
6
*
7
* @category  PHP
8
* @package   jrest
9
* @author    Aurelien Peronnet <aurelien@tela-botanica.org>
10
* @copyright 2010 Tela-Botanica
11
* @license   http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
12
* @version   SVN: <svn_id>
13
* @link      /doc/jrest/
14
*/
15
 
16
/**
17
* Classe de gestion de l'ajout, modification et suppression des observations
18
*
19
* in=utf8
20
* out=utf8
21
*
22
*/
23
class GestionObservation extends Cel {
24
 
25
	/**
26
	* Ajoute une observation grâce aux paramètres fournis
27
	*
28
	* @param int $utilisateur id utilisateur du proprietaire de l'observation
29
	* @param array $parametres tableau indexé avec les mêmes noms de champs que la bdd
30
	*
31
	* @return true ou false suivant le succès de l'opération
32
	*/
33
	public function ajouterObservation($utilisateur, $parametres) {
34
 
1305 aurelien 35
		$retour = true;
918 aurelien 36
		$parametres['ordre'] = $this->renvoyerDernierOrdreUtilisePlusUn($utilisateur);
1548 aurelien 37
 
918 aurelien 38
        $requete_insertion_observation = 'INSERT INTO cel_obs ';
39
        $sous_requete_colonnes = $this->traiterParametresObservationEtConstruireSousRequeteAjout($parametres);
40
 
41
        $requete_insertion_observation = $requete_insertion_observation.$sous_requete_colonnes;
42
 
1386 aurelien 43
        // important ! ne pas utiliser la fonction executerRequete qui renvoie une erreur si la requete contient des | (pipes)
44
        // ce qui peut arriver dans les commentaires
45
        // TODO: corriger la fonction ou bien continuer à utiliser executerRequeteSimple
46
    	$resultat_ajout_observation = $this->executerRequeteSimple($requete_insertion_observation);
918 aurelien 47
 
1305 aurelien 48
        if ($resultat_ajout_observation === false) {
49
        	$retour = false;
918 aurelien 50
        	$this->logger("CEL_bugs","Erreur de creation d'une observation : ".$resultat_ajout_observation);
1548 aurelien 51
        } else {
52
        	$retour = $this->renvoyerIdPourOrdre($utilisateur ,$parametres['ordre']);
918 aurelien 53
        }
54
 
1305 aurelien 55
        return $retour;
918 aurelien 56
	}
57
 
58
	/**
59
	* Renvoie le prochain numero d'ordre relatif à un utilisateur (i.e. dernier ordre + 1)
60
	*
61
	* @param int $utilisateur id utilisateur
62
	*
63
	* @return int le nouveau numero d'ordre relatif à l'utilisateur ou bien 0 s'il n'a jamais créé d'observations
64
	*/
65
	public function renvoyerDernierOrdreUtilisePlusUn($utilisateur) {
66
 
67
       	$requete_selection_dernier_ordre = "SELECT max(ordre) AS ordre FROM cel_obs ".
68
       									   "WHERE ce_utilisateur = ".$this->proteger($utilisateur);
69
 
1386 aurelien 70
	    $dernier_ordre = $this->executerRequete($requete_selection_dernier_ordre);
918 aurelien 71
    	$nouvel_ordre = 0;
72
 
73
		if (is_array($dernier_ordre) && count($dernier_ordre) > 0 && trim($dernier_ordre[0]['ordre']) != '') {
74
			$nouvel_ordre = $dernier_ordre[0]['ordre'] + 1;
75
		}
76
        return $nouvel_ordre;
77
	}
78
 
79
	/**
1548 aurelien 80
	* Renvoie l'id d'observation associé à l'utilisateur et l'ordre donné
81
	*
82
	* @param int $utilisateur id utilisateur
83
	* @return int le numero d'ordre relatif à l'utilisateur
84
	*/
85
	public function renvoyerIdPourOrdre($utilisateur, $ordre) {
86
 
87
		$requete_selection_dernier_id = "SELECT id_observation FROM cel_obs ".
88
	       									   "WHERE ce_utilisateur = ".$this->proteger($utilisateur)." ".
89
	       									   "AND ordre = ".$this->proteger($ordre)." ";
90
 
91
		$dernier_id = $this->executerRequete($requete_selection_dernier_id);
92
		return $dernier_id[0]['id_observation'];
93
	}
94
 
95
	/**
918 aurelien 96
	* Modifie une ou plusieurs observations grâce aux paramètres fournis
97
	*
98
	* @param int $utilisateur id utilisateur du proprietaire de l'observation
99
	* @param mixed $ordre ordre(s) observation(s) relatif(s) à l'utilisateur: un seul ordre ou bien "ordre1,ordre2,ordre3" etc...
100
	* @param array $parametres tableau indexé avec les mêmes noms de champs que la bdd
101
	*
102
	* @return true ou false suivant le succès de l'opération
103
	*/
104
	public function modifierObservation($utilisateur, $ordre, $parametres) {
105
 
1305 aurelien 106
		$retour = true;
918 aurelien 107
		$requete_modification = "UPDATE cel_obs SET " ;
108
 
109
		$sous_requete_modification = $this->traiterParametresObservationEtConstruireSousRequeteMaj($parametres);
110
		$requete_modification .= $sous_requete_modification;
111
 
112
		$requete_modification .= " WHERE ordre IN (".$ordre.") AND ce_utilisateur = ".$this->proteger($utilisateur);
113
 
1386 aurelien 114
		// important ! ne pas utiliser la fonction executerRequete qui renvoie une erreur si la requete contient des | (pipes)
115
		// ce qui peut arriver dans les commentaires
116
		// TODO: corriger la fonction ou bien continuer à utiliser executerRequeteSimple
117
    	$resultat_modification = $this->executerRequeteSimple($requete_modification);
918 aurelien 118
 
1305 aurelien 119
        if ($resultat_modification === false) {
120
        	$retour = false;
918 aurelien 121
        	$this->logger("CEL_bugs","Erreur de mise à jour d'une liste d'observations : ".$requete_modification);
122
        }
123
 
1305 aurelien 124
		return $retour;
918 aurelien 125
	}
126
 
127
	/**
1527 aurelien 128
	* Modifie une observation publique dont l'id et l'utilisateur sont passé en paramètre
129
	*
130
	* @param int $utilisateur id utilisateur du proprietaire de l'observation
131
	* @param int $id identifiant de l'observation
132
	* @param array $parametres tableau indexé avec les mêmes noms de champs que la bdd
133
	*
134
	* @return true ou false suivant le succès de l'opération
135
	*/
136
	public function modifierObservationPublique($utilisateur, $id, $parametres) {
137
 
138
		$retour = true;
139
		$requete_modification = "UPDATE cel_obs SET " ;
140
 
141
		$sous_requete_modification = $this->traiterParametresObservationEtConstruireSousRequeteMaj($parametres);
142
		$requete_modification .= $sous_requete_modification;
143
 
144
		$requete_modification .= " WHERE id_observation = ".$this->proteger($id).
145
								 " AND ce_utilisateur = ".$this->proteger($utilisateur)." ".
146
								 " AND transmission = 1";
147
		// important ! ne pas utiliser la fonction executerRequete qui renvoie une erreur si la requete contient des | (pipes)
148
		// ce qui peut arriver dans les commentaires
149
		// TODO: corriger la fonction ou bien continuer à utiliser executerRequeteSimple
150
		$resultat_modification = $this->executerRequeteSimple($requete_modification);
151
 
152
		if ($resultat_modification === false) {
153
			$retour = false;
154
			$this->logger("CEL_bugs","Erreur de mise à jour de l\'observation : ".$id);
155
		}
156
 
157
		return $retour;
158
	}
159
 
160
	/**
918 aurelien 161
	* Supprime une ou plusieurs observations grâce aux paramètres fournis
162
	*
163
	* @param int $utilisateur id utilisateur du proprietaire de l'observation
164
	* @param mixed $ordre ordre(s) observation(s) relatif(s) à l'utilisateur: un seul ordre ou bien "ordre1,ordre2,ordre3" etc...
165
	*
166
	* @return true ou false suivant le succès de l'opération
167
	*/
168
	public function supprimerObservation($utilisateur, $ordre) {
1318 aurelien 169
		// TODO changer le systeme pour n'utiliser plus que les id
1305 aurelien 170
		$retour = false;
1318 aurelien 171
		$tableau_ordre = explode(',', $ordre);
172
		$tableau_ordre = array_map(array($this, 'proteger'), $tableau_ordre);
173
		$ordre = implode(',', $tableau_ordre);
174
 
918 aurelien 175
		$requete_ids_observations = 'SELECT id_observation as id_obs FROM cel_obs '.
176
									'WHERE ce_utilisateur = '.$this->proteger($utilisateur).' '.
1318 aurelien 177
									'AND ordre IN ('.$ordre.')';
918 aurelien 178
		$resultat_ids_observations = $this->requeter($requete_ids_observations);
1318 aurelien 179
 
180
		$ids_obs = array();
1305 aurelien 181
		if(is_array($resultat_ids_observations) && count($resultat_ids_observations) > 0) {
182
			foreach($resultat_ids_observations as $id_observation) {
1318 aurelien 183
				$ids_obs[] = $this->proteger($id_observation['id_obs']);
1305 aurelien 184
			}
185
 
1318 aurelien 186
			$chaine_ids_obs = implode(',', $ids_obs);
1305 aurelien 187
		    $requete_supression_observations = 'DELETE FROM cel_obs WHERE '.
188
		                                       'ce_utilisateur = '.$this->proteger($utilisateur).' '.
1318 aurelien 189
		                                       'AND id_observation IN ('.$chaine_ids_obs.')';
190
 
1386 aurelien 191
			$resultat_suppression_observations = $this->executerRequeteSimple($requete_supression_observations);
1305 aurelien 192
 
193
			// TODO: Faire la suppression des mots clés
194
			// et des liaisons obs images dans une ou des fonctions à part
195
			if ($resultat_suppression_observations === false) {
196
				$this->logger("CEL_bugs","Erreur de suppression d'une liste d'observations : ".$resultat_suppression_observations);
197
			}
198
			else
199
			{
200
	            $requete_supression_lien_obs_images = 'DELETE FROM cel_obs_images WHERE '.
201
	                                                  'id_utilisateur = '.$this->proteger($utilisateur).' '.
1318 aurelien 202
											  		  'AND id_observation IN ('.$chaine_ids_obs.')';
1305 aurelien 203
 
1386 aurelien 204
	            $resultat_suppression_liens = $this->executerRequeteSimple($requete_supression_lien_obs_images);
1305 aurelien 205
 
206
	            if ($resultat_suppression_liens === false) {
207
	            	$this->logger("CEL_bugs","Erreur de suppression d'une liste de liaison entre observations et images : ".$requete_supression_lien_obs_images);
208
	            }
209
	            else
210
	            {
211
					$retour = true;
212
	    		}
213
 
214
	    		$requete_supression_lien_mots_cles = 'DELETE FROM cel_obs_mots_cles WHERE '.
215
											  		  'id_observation in ('.$chaine_ids_obs.')';
216
 
1386 aurelien 217
	            $resultat_suppression_mots_cles = $this->executerRequeteSimple($requete_supression_lien_mots_cles);
1305 aurelien 218
	            if ($resultat_suppression_mots_cles === false) {
219
	            	$this->logger("CEL_bugs","Erreur de suppression d'une liste de mots clés d'observation(s) : ".$resultat_suppression_mots_cles);
220
	            }
221
	            else
222
	            {
223
					$retour = true;
224
	    		}
225
	        }
226
		} else {
227
			$retour = true;
918 aurelien 228
		}
229
 
230
        return $retour;
231
	}
232
 
1163 aurelien 233
	/**
234
	 * Fonction utilisée pour importer les observations faites avec des comptes anonymes vers un
235
	 * utilisateur identifié
236
	 * @param string $ancien_id
237
	 * @param string $id_utilisateur
238
	 */
931 aurelien 239
	public function migrerObservations($ancien_id, $id_utilisateur) {
240
 
241
		//TODO faire une fonction plus complexe qui déplace, images, observations, mots-clés etc... d'un utilisateur à l'autre
1163 aurelien 242
		// qui pourrait servir pour fusionner des comptes
931 aurelien 243
		$nouvel_ordre = $this->renvoyerDernierOrdreUtilisePlusUn($id_utilisateur);
244
 
245
		// Recuperation relevés associés a la session
246
		$requete_selection_releves_temporaires = 'SELECT ordre FROM cel_obs WHERE ce_utilisateur = '.$this->proteger($ancien_id).' ORDER BY ordre';
1386 aurelien 247
		$resultat_releves_temporaires = $this->executerRequete($requete_selection_releves_temporaires);
931 aurelien 248
 
249
		$reussite = true;
250
		if(is_array($resultat_releves_temporaires)) {
251
			foreach($resultat_releves_temporaires as $releve_temporaire) {
252
 
253
				$requete_migration_releve = 'UPDATE cel_obs SET '.
961 aurelien 254
											'ce_utilisateur = '.$this->proteger($id_utilisateur).', '.
931 aurelien 255
											'ordre = '.$nouvel_ordre.' '.
961 aurelien 256
											'WHERE ce_utilisateur = '.$ancien_id.' '.
931 aurelien 257
											'AND ordre = '.$releve_temporaire['ordre'];
1386 aurelien 258
	   		    $migration_releve = $this->executerRequeteSimple($requete_migration_releve);
931 aurelien 259
 
260
	   		    //TODO: meilleure vérification
1305 aurelien 261
	   		    if($migration_releve === false) {
931 aurelien 262
	   		    	$reussite = false;
263
	   		    }
264
        	    $nouvel_ordre++;
265
			}
266
		}
267
 
268
		return $reussite;
269
	}
270
 
918 aurelien 271
	/**
1470 aurelien 272
	* Fonction utilisée pour importer les anciennes observations saisie dans les widget dans un compte identifié
273
	* Dans ce cas là, le widget remplit la case id_utilisateur par le mail indiqué lors de la saisie
274
	* @param string $mail_utilisateur
275
	* @param string $id_utilisateur
276
	*/
277
	public function migrerObservationsMailVersId($mail_utilisateur, $infos_utilisateur) {
278
		// ATTENTION : cette fonction suppose que l'utilisateur n'ai pas déjà d'observations dans le CEL
279
		// avec l'identifiant $id_utilisateur ce qui est normalement le cas
280
		$requete_migration_releve = 'UPDATE cel_obs SET '.
281
												'ce_utilisateur = '.$this->proteger($infos_utilisateur['id_utilisateur']).', '.
282
												'prenom_utilisateur = '.$this->proteger($infos_utilisateur['prenom']).', '.
283
												'nom_utilisateur = '.$this->proteger($infos_utilisateur['nom']).', '.
284
												'courriel_utilisateur = '.$this->proteger($infos_utilisateur['courriel']).' '.
285
												'WHERE ce_utilisateur = '.$this->proteger($mail_utilisateur).' ';
286
 
287
		$migration_releve = $this->executerRequeteSimple($requete_migration_releve);
288
 
289
		return $migration_releve;
290
	}
291
 
292
	/**
918 aurelien 293
	* Formate les paramètres fournis en ajoutant des infos complementaires
294
	*
295
	* @param array $parametres tableau indexé avec les mêmes noms de champs que la bdd
296
	*
297
	* @return $parametres le tableau modifié selon ce qu'il contenait
298
	*/
299
	private function formaterParametresObservation($parametres) {
1527 aurelien 300
 
301
		$code_referentiel = 'bdtfx';
302
		if(!isset($parametres['nom_referentiel'])) {
303
			$parametres['nom_referentiel'] = 'bdtfx:v1.01';
304
		}
305
		$code_referentiel = substr($parametres['nom_referentiel'], 0, 5);
306
		if ($this->estUnNomSolitaire($parametres)) {
918 aurelien 307
 
1527 aurelien 308
			$chercheur_infos_complementaires = new RechercheInfosTaxonBeta($this->config, $code_referentiel);
918 aurelien 309
			// Utilisation d'un nom sans numéro nomenclatural, recherche d'une correspondance sur le nom
310
			$complement = $chercheur_infos_complementaires->rechercherInformationsComplementairesSurNom($parametres['nom_sel']);
311
 
312
			// Si l'on a trouvé un résultat sur la recherche, il s'agit vraisemblablement d'un copié-collé
313
			// de nom de taxon qui n'a pas été validé par la selection
314
			if(count($complement) > 0) {
315
				$parametres['nom_sel_nn'] = $complement[0][0];
316
			}
317
		}
1425 aurelien 318
 
1527 aurelien 319
		if ($this->parametreNumNomEstPresent($parametres)) {
918 aurelien 320
			// Utilisation d'un nom faisant parti du referentiel : recherche du nom valide correspondant
1527 aurelien 321
			$chercheur_infos_complementaires = new RechercheInfosTaxonBeta($this->config , $code_referentiel);
918 aurelien 322
			$complement = $chercheur_infos_complementaires->rechercherInformationsComplementairesSurNumNom($parametres['nom_sel_nn']);
1541 aurelien 323
 
918 aurelien 324
			$parametres['nom_ret']=$complement['Nom_Retenu'];
325
	        $parametres['nom_ret_nn']=$complement['Num_Nom_Retenu'];
326
	        $parametres['nt']=$complement['Num_Taxon'];
327
	        $parametres['famille']=$complement['Famille'];
328
		}
329
 
330
		if(isset($parametres['ce_utilisateur'])) {
331
 
332
			$infos_utilisateur = $this->getInfosComplementairesUtilisateur($parametres['ce_utilisateur']);
333
 
334
			$parametres['courriel_utilisateur'] = $infos_utilisateur['courriel'];
335
			$parametres['nom_utilisateur'] = $infos_utilisateur['nom'];
336
			$parametres['prenom_utilisateur'] = $infos_utilisateur['prenom'];
337
		}
338
 
339
		// Pour empecher que des numéros de département de 1 à 9 soient saisis sans 0
340
		// TODO: décider quoi faire pour les zones géo plus générales
961 aurelien 341
        if (isset($parametres['ce_zone_geo'])) {
342
 
1332 aurelien 343
        	if($parametres['ce_zone_geo'] == 'null' || trim($parametres['ce_zone_geo']) == "") {
344
        		$parametres['ce_zone_geo'] = "";
345
        	} else {
346
	        	if (strlen($parametres['ce_zone_geo']) == 4) {
347
	            	$parametres['ce_zone_geo'] = '0'.$parametres['ce_zone_geo'];
348
	        	}
349
 
350
	        	if (strlen($parametres['ce_zone_geo']) > 0 && strlen($parametres['ce_zone_geo']) <= 2) {
351
	            	$parametres['ce_zone_geo'] = $this->obtenirCodeInseeCommunePourNomEtDepartement($parametres['zone_geo'], $parametres['ce_zone_geo']);
352
	        	} else {
353
	        	 	$parametres['ce_zone_geo'] = $this->convertirCodeInseeVersCodeZoneGeo($parametres['ce_zone_geo']);
354
	        	}
961 aurelien 355
        	}
1425 aurelien 356
        }
918 aurelien 357
 
358
        // TODO : voir si l'on peut utiliser un des fonctions de la classe cel
359
        if (isset($parametres['date_observation']) && $parametres['date_observation']!="null") {
1556 aurelien 360
        	//TODO: prendre en compte des dates incomplètes ?
361
        	list($jour,$mois,$annee)=explode("/",$parametres['date_observation']);
362
        	$parametres['date_observation']=$annee."-".$mois."-".$jour." 0:0:0";
918 aurelien 363
        }
364
 
365
       return $parametres;
366
	}
367
 
1527 aurelien 368
	private function estUnNomSolitaire($parametres) {
369
		return $this->parametreNumNomPasPresent($parametres) && $parametres['nom_sel'] != '';
370
	}
371
 
372
	private function parametreNumNomEstPresent($parametres) {
373
		return !$this->parametreNumNomPasPresent($parametres);
374
	}
375
 
376
	private function parametreNumNomPasPresent($parametres) {
377
		return (!isset($parametres['nom_sel_nn']) ||
378
				$parametres['nom_sel_nn'] == null ||
379
				$parametres['nom_sel_nn'] == '' ||
380
				$parametres['nom_sel_nn'] == 0);
381
	}
382
 
918 aurelien 383
	/**
384
	* Assemble une sous requete pour un ajout, tout en formatant les paramètres et en recherchant
385
	* les infos complémentaires
386
	*
387
	* @param array $parametres un tableau avec les index correspondant aux champs de la bdd
388
	*
389
	* @return string une sous requete utilisable pour l'ajout d'une observation
390
	*/
391
	private function traiterParametresObservationEtConstruireSousRequeteAjout($parametres) {
392
 
393
		$sous_requete = '';
394
 
395
		$parametres = $this->formaterParametresObservation(&$parametres);
396
 
397
		$champs = '';
398
		$valeurs = '';
399
 
400
		// Nullifiage ...
401
		// TODO: code dupliqué, en faire une fonction à mettre à la place appropriée
402
		foreach($parametres as $cle => $valeur) {
403
 
404
			// Pour apparaitre le premier dans les tris ...
405
			if (trim($valeur) == "" || trim($valeur) == "null") {
1305 aurelien 406
				$valeur = "NULL";
1332 aurelien 407
			} else {
408
				$valeur = $this->proteger($valeur);
918 aurelien 409
			}
410
 
411
			$champs .= $cle.', ';
1332 aurelien 412
			$valeurs .= $valeur.', ';
918 aurelien 413
		}
414
 
415
		$champs = '('.$champs.'mots_cles_texte, transmission, date_creation, date_modification, date_transmission)';
416
		$valeurs = '('.$valeurs.'"", 0, now(), now(), "0000-00-00 00:00:00")';
417
 
418
		$sous_requete .= $champs.' VALUES '.$valeurs;
419
 
420
		return $sous_requete;
421
	}
422
 
423
	/**
424
	 * Assemble une sous requete pour une mise à jour, tout en formatant les paramètres et en recherchant
425
	 * les infos complémentaires
426
	 *
427
	 * @param array $parametres un tableau avec les index correspondant aux champs de la bdd
428
	 *
429
	 * @return string une sous requete utilisable pour la modification d'une observation
430
	 * selon la syntaxe UPDATE table SET colonne1 = valeur1, colonne2 = valeur2 WHERE condition
431
	 */
432
	private function traiterParametresObservationEtConstruireSousRequeteMAJ($parametres) {
433
 
434
		$sous_requete = '';
435
 
436
		$parametres = $this->formaterParametresObservation(&$parametres);
437
 
438
		// Nullifiage ...
439
		// TODO: code dupliqué, en faire une fonction à mettre à la place appropriée
440
		foreach($parametres as $cle => $valeur) {
441
 
442
			// Pour apparaitre le premier dans les tris ...
1332 aurelien 443
			if (trim($valeur) == "" || trim($valeur) == "null") {
444
				$valeur = "NULL";
445
			} else {
446
				$valeur = $this->proteger($valeur);
918 aurelien 447
			}
448
 
1332 aurelien 449
        	$sous_requete .= $cle." = ".$valeur.", ";
918 aurelien 450
		}
451
 
452
		$sous_requete .= ' date_modification = now() ';
453
 
454
		return $sous_requete;
455
	}
456
}
457
?>