WebSVN – eFlore/Applications.cel – Diff – /trunk/jrest/lib/GestionObservation.php

 <?php
 // ATTENTION ! Classe compatible uniquement avec nouveau format de bdd du cel //
 /**
 * PHP Version 5
+*
 * @category  PHP
 * @package   jrest
 * @author    Aurelien Peronnet <aurelien@tela-botanica.org>
 * @copyright 2010 Tela-Botanica
 * @license   http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
 * @version   SVN: <svn_id>
 * @link      /doc/jrest/
 */
 /**
 * Classe de gestion de l'ajout, modification et suppression des observations
+*
 * in=utf8
 * out=utf8
+*
 */
 class GestionObservation extends Cel {
 	/**
 	* Ajoute une observation grâce aux paramètres fournis
+	*
 	* @param int $utilisateur id utilisateur du proprietaire de l'observation
 	* @param array $parametres tableau indexé avec les mêmes noms de champs que la bdd
+	*
 	* @return true ou false suivant le succès de l'opération
 	*/
 	public function ajouterObservation($utilisateur, $parametres) {
 		$retour = true;
 		$parametres['ordre'] = $this->renvoyerDernierOrdreUtilisePlusUn($utilisateur);
         $requete_insertion_observation = 'INSERT INTO cel_obs ';
         $sous_requete_colonnes = $this->traiterParametresObservationEtConstruireSousRequeteAjout($parametres);
         $requete_insertion_observation = $requete_insertion_observation.$sous_requete_colonnes;
     	$resultat_ajout_observation = $this->executer($requete_insertion_observation);
+        if ($resultat_ajout_observation === false) {
-        if (!$resultat_ajout_observation) {
+        	$retour = false;
         	$this->logger("CEL_bugs","Erreur de creation d'une observation : ".$resultat_ajout_observation);
+        }
 		// TODO: retourner l'id ou le numero d'ordre nouvellement créé ?
-        return $resultat_ajout_observation;
+        return $retour;
+	}
 	/**
 	* Renvoie le prochain numero d'ordre relatif à un utilisateur (i.e. dernier ordre + 1)
+	*
 	* @param int $utilisateur id utilisateur
+	*
 	* @return int le nouveau numero d'ordre relatif à l'utilisateur ou bien 0 s'il n'a jamais créé d'observations
 	*/
 	public function renvoyerDernierOrdreUtilisePlusUn($utilisateur) {
        	$requete_selection_dernier_ordre = "SELECT max(ordre) AS ordre FROM cel_obs ".
        									   "WHERE ce_utilisateur = ".$this->proteger($utilisateur);
 	    $dernier_ordre = $this->requeter($requete_selection_dernier_ordre);
     	$nouvel_ordre = 0;
 		if (is_array($dernier_ordre) && count($dernier_ordre) > 0 && trim($dernier_ordre[0]['ordre']) != '') {
 			$nouvel_ordre = $dernier_ordre[0]['ordre'] + 1;
+		}
         return $nouvel_ordre;
+	}
 	/**
 	* Modifie une ou plusieurs observations grâce aux paramètres fournis
+	*
 	* @param int $utilisateur id utilisateur du proprietaire de l'observation
 	* @param mixed $ordre ordre(s) observation(s) relatif(s) à l'utilisateur: un seul ordre ou bien "ordre1,ordre2,ordre3" etc...
 	* @param array $parametres tableau indexé avec les mêmes noms de champs que la bdd
+	*
 	* @return true ou false suivant le succès de l'opération
 	*/
 	public function modifierObservation($utilisateur, $ordre, $parametres) {
 		$retour = true;
 		$requete_modification = "UPDATE cel_obs SET " ;
 		$sous_requete_modification = $this->traiterParametresObservationEtConstruireSousRequeteMaj($parametres);
 		$requete_modification .= $sous_requete_modification;
 		$requete_modification .= " WHERE ordre IN (".$ordre.") AND ce_utilisateur = ".$this->proteger($utilisateur);
     	$resultat_modification = $this->executer($requete_modification);
+        if ($resultat_modification === false) {
-        if (!$resultat_modification) {
+        	$retour = false;
         	$this->logger("CEL_bugs","Erreur de mise à jour d'une liste d'observations : ".$requete_modification);
+        }
-		return $resultat_modification;
+		return $retour;
+	}
 	/**
 	* Supprime une ou plusieurs observations grâce aux paramètres fournis
+	*
 	* @param int $utilisateur id utilisateur du proprietaire de l'observation
 	* @param mixed $ordre ordre(s) observation(s) relatif(s) à l'utilisateur: un seul ordre ou bien "ordre1,ordre2,ordre3" etc...
+	*
 	* @return true ou false suivant le succès de l'opération
 	*/
 	public function supprimerObservation($utilisateur, $ordre) {
-		$retour = false;
 		$retour = false;
 		$requete_ids_observations = 'SELECT id_observation as id_obs FROM cel_obs '.
 									'WHERE ce_utilisateur = '.$this->proteger($utilisateur).' '.
 									'AND ordre in ('.$this->proteger($ordre) .')';
 		$resultat_ids_observations = $this->requeter($requete_ids_observations);
 		$chaine_ids_obs = '';
+		if(is_array($resultat_ids_observations) && count($resultat_ids_observations) > 0) {
-		foreach($resultat_ids_observations as $id_observation) {
+			foreach($resultat_ids_observations as $id_observation) {
-			$chaine_ids_obs = $this->proteger($id_observation['id_obs']).', ';
+				$chaine_ids_obs = $this->proteger($id_observation['id_obs']).', ';
-		}
+			}
-		$chaine_ids_obs = rtrim($chaine_ids_obs,', ');
+			$chaine_ids_obs = rtrim($chaine_ids_obs,', ');
-	    $requete_supression_observations = 'DELETE FROM cel_obs WHERE '.
+		    $requete_supression_observations = 'DELETE FROM cel_obs WHERE '.
-	                                       'ce_utilisateur = '.$this->proteger($utilisateur).' '.
+		                                       'ce_utilisateur = '.$this->proteger($utilisateur).' '.
-	                                       'AND ordre in ('.$this->proteger($ordre) .')';
+		                                       'AND ordre in ('.$this->proteger($ordre) .')';
-		$resultat_suppression_observations = $this->executer($requete_supression_observations);
+			$resultat_suppression_observations = $this->executer($requete_supression_observations);
-		// TODO: Faire la suppression des mots clés
+			// TODO: Faire la suppression des mots clés
-		// et des liaisons obs images dans une ou des fonctions à part
+			// et des liaisons obs images dans une ou des fonctions à part
-		if (!$resultat_suppression_observations) {
+			if ($resultat_suppression_observations === false) {
-			$this->logger("CEL_bugs","Erreur de suppression d'une liste d'observations : ".$resultat_suppression_observations);
+				$this->logger("CEL_bugs","Erreur de suppression d'une liste d'observations : ".$resultat_suppression_observations);
+			}
+			else
+			{
+	            $requete_supression_lien_obs_images = 'DELETE FROM cel_obs_images WHERE '.
+	                                                  'id_utilisateur = '.$this->proteger($utilisateur).' '.
+											  		  'AND id_observation in ('.$chaine_ids_obs.')';
+	            $resultat_suppression_liens = $this->executer($requete_supression_lien_obs_images);
+	            if ($resultat_suppression_liens === false) {
+	            	$this->logger("CEL_bugs","Erreur de suppression d'une liste de liaison entre observations et images : ".$requete_supression_lien_obs_images);
+	            }
+	            else
+	            {
+					$retour = true;
+	    		}
+	    		$requete_supression_lien_mots_cles = 'DELETE FROM cel_obs_mots_cles WHERE '.
+											  		  'id_observation in ('.$chaine_ids_obs.')';
+	            $resultat_suppression_mots_cles = $this->executer($requete_supression_lien_mots_cles);
+	            if ($resultat_suppression_mots_cles === false) {
+	            	$this->logger("CEL_bugs","Erreur de suppression d'une liste de mots clés d'observation(s) : ".$resultat_suppression_mots_cles);
+	            }
+	            else
+	            {
+					$retour = true;
+	    		}
+	        }
+		} else {
+			$retour = true;
+		}
-		else
-		{
-            $requete_supression_lien_obs_images = 'DELETE FROM cel_obs_images WHERE '.
-                                                  'id_utilisateur = '.$this->proteger($utilisateur).' '.
-										  		  'AND id_observation in ('.$chaine_ids_obs.')';
-            $resultat_suppression_liens = $this->executer($requete_supression_lien_obs_images);
-            if (!$resultat_suppression_liens) {
-            	$this->logger("CEL_bugs","Erreur de suppression d'une liste de liaison entre observations et images : ".$requete_supression_lien_obs_images);
-            }
-            else
-            {
-				$retour = true;
-    		}
-    		$requete_supression_lien_mots_cles = 'DELETE FROM cel_obs_mots_cles WHERE '.
-										  		  'id_observation in ('.$chaine_ids_obs.')';
-            $resultat_suppression_mots_cles = $this->executer($requete_supression_lien_mots_cles);
-            if (!$resultat_suppression_mots_cles) {
-            	$this->logger("CEL_bugs","Erreur de suppression d'une liste de mots clés d'observation(s) : ".$resultat_suppression_mots_cles);
-            }
-            else
-            {
-				$retour = true;
-    		}
-        }
         return $retour;
+	}
 	/**
 	 * Fonction utilisée pour importer les observations faites avec des comptes anonymes vers un
 	 * utilisateur identifié
 	 * @param string $ancien_id
 	 * @param string $id_utilisateur
 	 */
 	public function migrerObservations($ancien_id, $id_utilisateur) {
 		//TODO faire une fonction plus complexe qui déplace, images, observations, mots-clés etc... d'un utilisateur à l'autre
 		// qui pourrait servir pour fusionner des comptes
 		$nouvel_ordre = $this->renvoyerDernierOrdreUtilisePlusUn($id_utilisateur);
 		// Recuperation relevés associés a la session
 		$requete_selection_releves_temporaires = 'SELECT ordre FROM cel_obs WHERE ce_utilisateur = '.$this->proteger($ancien_id).' ORDER BY ordre';
 		$resultat_releves_temporaires = $this->requeter($requete_selection_releves_temporaires);
 		$reussite = true;
 		if(is_array($resultat_releves_temporaires)) {
 			foreach($resultat_releves_temporaires as $releve_temporaire) {
 				$requete_migration_releve = 'UPDATE cel_obs SET '.
 											'ce_utilisateur = '.$this->proteger($id_utilisateur).', '.
 											'ordre = '.$nouvel_ordre.' '.
 											'WHERE ce_utilisateur = '.$ancien_id.' '.
 											'AND ordre = '.$releve_temporaire['ordre'];
 	   		    $migration_releve = $this->executer($requete_migration_releve);
 	   		    //TODO: meilleure vérification
-	   		    if(!$migration_releve) {
+	   		    if($migration_releve === false) {
 	   		    	$reussite = false;
+	   		    }
         	    $nouvel_ordre++;
+			}
+		}
 		return $reussite;
+	}
 	/**
 	* Formate les paramètres fournis en ajoutant des infos complementaires
+	*
 	* @param array $parametres tableau indexé avec les mêmes noms de champs que la bdd
+	*
 	* @return $parametres le tableau modifié selon ce qu'il contenait
 	*/
 	private function formaterParametresObservation($parametres) {
 		if (($parametres['nom_sel_nn'] == '' || $parametres['nom_sel_nn'] == 0) && $parametres['nom_sel'] != '') {
 			$chercheur_infos_complementaires = new RechercheInfosTaxon($this->config);
 			// Utilisation d'un nom sans numéro nomenclatural, recherche d'une correspondance sur le nom
 			$complement = $chercheur_infos_complementaires->rechercherInformationsComplementairesSurNom($parametres['nom_sel']);
 			// Si l'on a trouvé un résultat sur la recherche, il s'agit vraisemblablement d'un copié-collé
 			// de nom de taxon qui n'a pas été validé par la selection
 			if(count($complement) > 0) {
 				$parametres['nom_sel_nn'] = $complement[0][0];
+			}
 			$parametres['nom_referentiel'] = 'bdtfx_v1';
+		}
 		if ($parametres['nom_sel_nn'] != '') {
 			// Utilisation d'un nom faisant parti du referentiel : recherche du nom valide correspondant
 			$chercheur_infos_complementaires = new RechercheInfosTaxon($this->config);
 			$complement = $chercheur_infos_complementaires->rechercherInformationsComplementairesSurNumNom($parametres['nom_sel_nn']);
 			$parametres['nom_ret']=$complement['Nom_Retenu'];
 	        $parametres['nom_ret_nn']=$complement['Num_Nom_Retenu'];
 	        $parametres['nt']=$complement['Num_Taxon'];
 	        $parametres['famille']=$complement['Famille'];
 	        $parametres['nom_referentiel'] = 'bdtfx_v1';
+		}
 		if(isset($parametres['ce_utilisateur'])) {
 			$infos_utilisateur = $this->getInfosComplementairesUtilisateur($parametres['ce_utilisateur']);
 			$parametres['courriel_utilisateur'] = $infos_utilisateur['courriel'];
 			$parametres['nom_utilisateur'] = $infos_utilisateur['nom'];
 			$parametres['prenom_utilisateur'] = $infos_utilisateur['prenom'];
+		}
 		// Pour empecher que des numéros de département de 1 à 9 soient saisis sans 0
 		// TODO: décider quoi faire pour les zones géo plus générales
         if (isset($parametres['ce_zone_geo'])) {
         	if (strlen($parametres['ce_zone_geo']) == 4) {
             	$parametres['ce_zone_geo'] = '0'.$parametres['ce_zone_geo'];
+        	}
         	if (strlen($parametres['ce_zone_geo']) > 0 && strlen($parametres['ce_zone_geo']) <= 2) {
             	$parametres['ce_zone_geo'] = $this->obtenirCodeInseeCommunePourNomEtDepartement($parametres['zone_geo'], $parametres['ce_zone_geo']);
         	} else {
         	 	$parametres['ce_zone_geo'] = $this->convertirCodeInseeVersCodeZoneGeo($parametres['ce_zone_geo']);
+        	}
+        }
         // TODO : voir si l'on peut utiliser un des fonctions de la classe cel
         if (isset($parametres['date_observation']) && $parametres['date_observation']!="null") {
         	list($jour,$mois,$annee)=explode("/",$parametres['date_observation']);
         	$parametres['date_observation']=$annee."-".$mois."-".$jour." 0:0:0";
+        }
        return $parametres;
+	}
 	/**
 	* Assemble une sous requete pour un ajout, tout en formatant les paramètres et en recherchant
 	* les infos complémentaires
+	*
 	* @param array $parametres un tableau avec les index correspondant aux champs de la bdd
+	*
 	* @return string une sous requete utilisable pour l'ajout d'une observation
 	*/
 	private function traiterParametresObservationEtConstruireSousRequeteAjout($parametres) {
 		$sous_requete = '';
 		$parametres = $this->formaterParametresObservation(&$parametres);
 		$champs = '';
 		$valeurs = '';
 		// Nullifiage ...
 		// TODO: code dupliqué, en faire une fonction à mettre à la place appropriée
 		foreach($parametres as $cle => $valeur) {
 			// Pour apparaitre le premier dans les tris ...
 			if (trim($valeur) == "" || trim($valeur) == "null") {
-				$valeur = "000null";
+				$valeur = "NULL";
+			}
 			$champs .= $cle.', ';
 			$valeurs .= $this->proteger($valeur).', ';
+		}
 		$champs = '('.$champs.'mots_cles_texte, transmission, date_creation, date_modification, date_transmission)';
 		$valeurs = '('.$valeurs.'"", 0, now(), now(), "0000-00-00 00:00:00")';
 		$sous_requete .= $champs.' VALUES '.$valeurs;
 		return $sous_requete;
+	}
 	/**
 	 * Assemble une sous requete pour une mise à jour, tout en formatant les paramètres et en recherchant
 	 * les infos complémentaires
+	 *
 	 * @param array $parametres un tableau avec les index correspondant aux champs de la bdd
+	 *
 	 * @return string une sous requete utilisable pour la modification d'une observation
 	 * selon la syntaxe UPDATE table SET colonne1 = valeur1, colonne2 = valeur2 WHERE condition
 	 */
 	private function traiterParametresObservationEtConstruireSousRequeteMAJ($parametres) {
 		$sous_requete = '';
 		$parametres = $this->formaterParametresObservation(&$parametres);
 		// Nullifiage ...
 		// TODO: code dupliqué, en faire une fonction à mettre à la place appropriée
 		foreach($parametres as $cle => $valeur) {
 			// Pour apparaitre le premier dans les tris ...
 			if (trim($valeur)=="" || trim($valeur)=="null") {
-				$parametres[$cle]="000null";
+				$parametres[$cle]="NULL";
+			}
         	$sous_requete .= $cle." = ".$this->proteger($valeur).", ";
+		}
 		$sous_requete .= ' date_modification = now() ';
 		return $sous_requete;
+	}
+}
 ?>

Subversion Repositories eFlore/Applications.cel

(root)/trunk/jrest/lib/GestionObservation.php @ 1655 – Rev 1163 → 1305