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