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);
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
 
43
    	$resultat_ajout_observation = $this->executer($requete_insertion_observation);
44
 
1305 aurelien 45
        if ($resultat_ajout_observation === false) {
46
        	$retour = false;
918 aurelien 47
        	$this->logger("CEL_bugs","Erreur de creation d'une observation : ".$resultat_ajout_observation);
48
        }
49
 
50
		// TODO: retourner l'id ou le numero d'ordre nouvellement créé ?
1305 aurelien 51
        return $retour;
918 aurelien 52
	}
53
 
54
	/**
55
	* Renvoie le prochain numero d'ordre relatif à un utilisateur (i.e. dernier ordre + 1)
56
	*
57
	* @param int $utilisateur id utilisateur
58
	*
59
	* @return int le nouveau numero d'ordre relatif à l'utilisateur ou bien 0 s'il n'a jamais créé d'observations
60
	*/
61
	public function renvoyerDernierOrdreUtilisePlusUn($utilisateur) {
62
 
63
       	$requete_selection_dernier_ordre = "SELECT max(ordre) AS ordre FROM cel_obs ".
64
       									   "WHERE ce_utilisateur = ".$this->proteger($utilisateur);
65
 
66
	    $dernier_ordre = $this->requeter($requete_selection_dernier_ordre);
67
    	$nouvel_ordre = 0;
68
 
69
		if (is_array($dernier_ordre) && count($dernier_ordre) > 0 && trim($dernier_ordre[0]['ordre']) != '') {
70
			$nouvel_ordre = $dernier_ordre[0]['ordre'] + 1;
71
		}
72
        return $nouvel_ordre;
73
	}
74
 
75
	/**
76
	* Modifie une ou plusieurs observations grâce aux paramètres fournis
77
	*
78
	* @param int $utilisateur id utilisateur du proprietaire de l'observation
79
	* @param mixed $ordre ordre(s) observation(s) relatif(s) à l'utilisateur: un seul ordre ou bien "ordre1,ordre2,ordre3" etc...
80
	* @param array $parametres tableau indexé avec les mêmes noms de champs que la bdd
81
	*
82
	* @return true ou false suivant le succès de l'opération
83
	*/
84
	public function modifierObservation($utilisateur, $ordre, $parametres) {
85
 
1305 aurelien 86
		$retour = true;
918 aurelien 87
		$requete_modification = "UPDATE cel_obs SET " ;
88
 
89
		$sous_requete_modification = $this->traiterParametresObservationEtConstruireSousRequeteMaj($parametres);
90
		$requete_modification .= $sous_requete_modification;
91
 
92
		$requete_modification .= " WHERE ordre IN (".$ordre.") AND ce_utilisateur = ".$this->proteger($utilisateur);
93
 
94
    	$resultat_modification = $this->executer($requete_modification);
95
 
1305 aurelien 96
        if ($resultat_modification === false) {
97
        	$retour = false;
918 aurelien 98
        	$this->logger("CEL_bugs","Erreur de mise à jour d'une liste d'observations : ".$requete_modification);
99
        }
100
 
1305 aurelien 101
		return $retour;
918 aurelien 102
	}
103
 
104
	/**
105
	* Supprime une ou plusieurs observations grâce aux paramètres fournis
106
	*
107
	* @param int $utilisateur id utilisateur du proprietaire de l'observation
108
	* @param mixed $ordre ordre(s) observation(s) relatif(s) à l'utilisateur: un seul ordre ou bien "ordre1,ordre2,ordre3" etc...
109
	*
110
	* @return true ou false suivant le succès de l'opération
111
	*/
112
	public function supprimerObservation($utilisateur, $ordre) {
113
 
1305 aurelien 114
		$retour = false;
918 aurelien 115
		$requete_ids_observations = 'SELECT id_observation as id_obs FROM cel_obs '.
116
									'WHERE ce_utilisateur = '.$this->proteger($utilisateur).' '.
117
									'AND ordre in ('.$this->proteger($ordre) .')';
118
		$resultat_ids_observations = $this->requeter($requete_ids_observations);
119
 
120
		$chaine_ids_obs = '';
1305 aurelien 121
		if(is_array($resultat_ids_observations) && count($resultat_ids_observations) > 0) {
122
			foreach($resultat_ids_observations as $id_observation) {
123
				$chaine_ids_obs = $this->proteger($id_observation['id_obs']).', ';
124
			}
125
 
126
			$chaine_ids_obs = rtrim($chaine_ids_obs,', ');
127
 
128
		    $requete_supression_observations = 'DELETE FROM cel_obs WHERE '.
129
		                                       'ce_utilisateur = '.$this->proteger($utilisateur).' '.
130
		                                       'AND ordre in ('.$this->proteger($ordre) .')';
131
 
132
			$resultat_suppression_observations = $this->executer($requete_supression_observations);
133
 
134
			// TODO: Faire la suppression des mots clés
135
			// et des liaisons obs images dans une ou des fonctions à part
136
			if ($resultat_suppression_observations === false) {
137
				$this->logger("CEL_bugs","Erreur de suppression d'une liste d'observations : ".$resultat_suppression_observations);
138
			}
139
			else
140
			{
141
	            $requete_supression_lien_obs_images = 'DELETE FROM cel_obs_images WHERE '.
142
	                                                  'id_utilisateur = '.$this->proteger($utilisateur).' '.
143
											  		  'AND id_observation in ('.$chaine_ids_obs.')';
144
 
145
	            $resultat_suppression_liens = $this->executer($requete_supression_lien_obs_images);
146
 
147
	            if ($resultat_suppression_liens === false) {
148
	            	$this->logger("CEL_bugs","Erreur de suppression d'une liste de liaison entre observations et images : ".$requete_supression_lien_obs_images);
149
	            }
150
	            else
151
	            {
152
					$retour = true;
153
	    		}
154
 
155
	    		$requete_supression_lien_mots_cles = 'DELETE FROM cel_obs_mots_cles WHERE '.
156
											  		  'id_observation in ('.$chaine_ids_obs.')';
157
 
158
	            $resultat_suppression_mots_cles = $this->executer($requete_supression_lien_mots_cles);
159
	            if ($resultat_suppression_mots_cles === false) {
160
	            	$this->logger("CEL_bugs","Erreur de suppression d'une liste de mots clés d'observation(s) : ".$resultat_suppression_mots_cles);
161
	            }
162
	            else
163
	            {
164
					$retour = true;
165
	    		}
166
	        }
167
		} else {
168
			$retour = true;
918 aurelien 169
		}
170
 
171
        return $retour;
172
	}
173
 
1163 aurelien 174
	/**
175
	 * Fonction utilisée pour importer les observations faites avec des comptes anonymes vers un
176
	 * utilisateur identifié
177
	 * @param string $ancien_id
178
	 * @param string $id_utilisateur
179
	 */
931 aurelien 180
	public function migrerObservations($ancien_id, $id_utilisateur) {
181
 
182
		//TODO faire une fonction plus complexe qui déplace, images, observations, mots-clés etc... d'un utilisateur à l'autre
1163 aurelien 183
		// qui pourrait servir pour fusionner des comptes
931 aurelien 184
		$nouvel_ordre = $this->renvoyerDernierOrdreUtilisePlusUn($id_utilisateur);
185
 
186
		// Recuperation relevés associés a la session
187
		$requete_selection_releves_temporaires = 'SELECT ordre FROM cel_obs WHERE ce_utilisateur = '.$this->proteger($ancien_id).' ORDER BY ordre';
188
		$resultat_releves_temporaires = $this->requeter($requete_selection_releves_temporaires);
189
 
190
		$reussite = true;
191
		if(is_array($resultat_releves_temporaires)) {
192
			foreach($resultat_releves_temporaires as $releve_temporaire) {
193
 
194
				$requete_migration_releve = 'UPDATE cel_obs SET '.
961 aurelien 195
											'ce_utilisateur = '.$this->proteger($id_utilisateur).', '.
931 aurelien 196
											'ordre = '.$nouvel_ordre.' '.
961 aurelien 197
											'WHERE ce_utilisateur = '.$ancien_id.' '.
931 aurelien 198
											'AND ordre = '.$releve_temporaire['ordre'];
199
	   		    $migration_releve = $this->executer($requete_migration_releve);
200
 
201
	   		    //TODO: meilleure vérification
1305 aurelien 202
	   		    if($migration_releve === false) {
931 aurelien 203
	   		    	$reussite = false;
204
	   		    }
205
        	    $nouvel_ordre++;
206
			}
207
		}
208
 
209
		return $reussite;
210
	}
211
 
918 aurelien 212
	/**
213
	* Formate les paramètres fournis en ajoutant des infos complementaires
214
	*
215
	* @param array $parametres tableau indexé avec les mêmes noms de champs que la bdd
216
	*
217
	* @return $parametres le tableau modifié selon ce qu'il contenait
218
	*/
219
	private function formaterParametresObservation($parametres) {
220
 
221
		if (($parametres['nom_sel_nn'] == '' || $parametres['nom_sel_nn'] == 0) && $parametres['nom_sel'] != '') {
222
 
223
			$chercheur_infos_complementaires = new RechercheInfosTaxon($this->config);
224
			// Utilisation d'un nom sans numéro nomenclatural, recherche d'une correspondance sur le nom
225
			$complement = $chercheur_infos_complementaires->rechercherInformationsComplementairesSurNom($parametres['nom_sel']);
226
 
227
			// Si l'on a trouvé un résultat sur la recherche, il s'agit vraisemblablement d'un copié-collé
228
			// de nom de taxon qui n'a pas été validé par la selection
229
			if(count($complement) > 0) {
230
				$parametres['nom_sel_nn'] = $complement[0][0];
231
			}
232
 
233
			$parametres['nom_referentiel'] = 'bdtfx_v1';
234
		}
235
 
236
		if ($parametres['nom_sel_nn'] != '') {
237
			// Utilisation d'un nom faisant parti du referentiel : recherche du nom valide correspondant
238
			$chercheur_infos_complementaires = new RechercheInfosTaxon($this->config);
239
			$complement = $chercheur_infos_complementaires->rechercherInformationsComplementairesSurNumNom($parametres['nom_sel_nn']);
240
 
241
			$parametres['nom_ret']=$complement['Nom_Retenu'];
242
	        $parametres['nom_ret_nn']=$complement['Num_Nom_Retenu'];
243
	        $parametres['nt']=$complement['Num_Taxon'];
244
	        $parametres['famille']=$complement['Famille'];
245
 
246
	        $parametres['nom_referentiel'] = 'bdtfx_v1';
247
		}
248
 
249
		if(isset($parametres['ce_utilisateur'])) {
250
 
251
			$infos_utilisateur = $this->getInfosComplementairesUtilisateur($parametres['ce_utilisateur']);
252
 
253
			$parametres['courriel_utilisateur'] = $infos_utilisateur['courriel'];
254
			$parametres['nom_utilisateur'] = $infos_utilisateur['nom'];
255
			$parametres['prenom_utilisateur'] = $infos_utilisateur['prenom'];
256
		}
257
 
258
		// Pour empecher que des numéros de département de 1 à 9 soient saisis sans 0
259
		// TODO: décider quoi faire pour les zones géo plus générales
961 aurelien 260
        if (isset($parametres['ce_zone_geo'])) {
261
 
262
        	if (strlen($parametres['ce_zone_geo']) == 4) {
263
            	$parametres['ce_zone_geo'] = '0'.$parametres['ce_zone_geo'];
264
        	}
265
 
266
        	if (strlen($parametres['ce_zone_geo']) > 0 && strlen($parametres['ce_zone_geo']) <= 2) {
267
            	$parametres['ce_zone_geo'] = $this->obtenirCodeInseeCommunePourNomEtDepartement($parametres['zone_geo'], $parametres['ce_zone_geo']);
268
        	} else {
269
        	 	$parametres['ce_zone_geo'] = $this->convertirCodeInseeVersCodeZoneGeo($parametres['ce_zone_geo']);
270
        	}
271
        }
918 aurelien 272
 
273
        // TODO : voir si l'on peut utiliser un des fonctions de la classe cel
274
        if (isset($parametres['date_observation']) && $parametres['date_observation']!="null") {
995 aurelien 275
        	list($jour,$mois,$annee)=explode("/",$parametres['date_observation']);
918 aurelien 276
        	$parametres['date_observation']=$annee."-".$mois."-".$jour." 0:0:0";
277
        }
278
 
279
       return $parametres;
280
	}
281
 
282
	/**
283
	* Assemble une sous requete pour un ajout, tout en formatant les paramètres et en recherchant
284
	* les infos complémentaires
285
	*
286
	* @param array $parametres un tableau avec les index correspondant aux champs de la bdd
287
	*
288
	* @return string une sous requete utilisable pour l'ajout d'une observation
289
	*/
290
	private function traiterParametresObservationEtConstruireSousRequeteAjout($parametres) {
291
 
292
		$sous_requete = '';
293
 
294
		$parametres = $this->formaterParametresObservation(&$parametres);
295
 
296
		$champs = '';
297
		$valeurs = '';
298
 
299
		// Nullifiage ...
300
		// TODO: code dupliqué, en faire une fonction à mettre à la place appropriée
301
		foreach($parametres as $cle => $valeur) {
302
 
303
			// Pour apparaitre le premier dans les tris ...
304
			if (trim($valeur) == "" || trim($valeur) == "null") {
1305 aurelien 305
				$valeur = "NULL";
918 aurelien 306
			}
307
 
308
			$champs .= $cle.', ';
309
			$valeurs .= $this->proteger($valeur).', ';
310
		}
311
 
312
		$champs = '('.$champs.'mots_cles_texte, transmission, date_creation, date_modification, date_transmission)';
313
		$valeurs = '('.$valeurs.'"", 0, now(), now(), "0000-00-00 00:00:00")';
314
 
315
		$sous_requete .= $champs.' VALUES '.$valeurs;
316
 
317
		return $sous_requete;
318
	}
319
 
320
	/**
321
	 * Assemble une sous requete pour une mise à jour, tout en formatant les paramètres et en recherchant
322
	 * les infos complémentaires
323
	 *
324
	 * @param array $parametres un tableau avec les index correspondant aux champs de la bdd
325
	 *
326
	 * @return string une sous requete utilisable pour la modification d'une observation
327
	 * selon la syntaxe UPDATE table SET colonne1 = valeur1, colonne2 = valeur2 WHERE condition
328
	 */
329
	private function traiterParametresObservationEtConstruireSousRequeteMAJ($parametres) {
330
 
331
		$sous_requete = '';
332
 
333
		$parametres = $this->formaterParametresObservation(&$parametres);
334
 
335
		// Nullifiage ...
336
		// TODO: code dupliqué, en faire une fonction à mettre à la place appropriée
337
		foreach($parametres as $cle => $valeur) {
338
 
339
			// Pour apparaitre le premier dans les tris ...
340
			if (trim($valeur)=="" || trim($valeur)=="null") {
1305 aurelien 341
				$parametres[$cle]="NULL";
918 aurelien 342
			}
343
 
344
        	$sous_requete .= $cle." = ".$this->proteger($valeur).", ";
345
		}
346
 
347
		$sous_requete .= ' date_modification = now() ';
348
 
349
		return $sous_requete;
350
	}
351
}
352
?>