Subversion Repositories eFlore/Applications.cel

Rev

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