WebSVN – eFlore/Applications.cel – Diff – /branches/v2.0-elagueuse/jrest/lib/GestionObservation.php

+ *
  * TODO: $sous_requete .= ' date_modification = now() '
  * devrait être une clause ON UPDATE ou un TRIGGER
  * afin de mettre à jour la date de modification uniquement lorsqu'une modification a effectivement eu lieu
+ *
  */
 class GestionObservation extends Cel {
     static $cel_obs = array(
         "id_observation", "ordre", "ce_utilisateur", "prenom_utilisateur", "nom_utilisateur", "courriel_utilisateur", "nom_sel", "nom_sel_nn", "nom_ret", "nom_ret_nn", "nt", "famille", "nom_referentiel",
         "ce_zone_geo", "zone_geo", "lieudit", "station", "milieu", "latitude", "longitude", "altitude", "geodatum", "date_observation", "mots_cles_texte", "commentaire", "transmission",
         "date_creation", "date_modification", "date_transmission", "abondance", "certitude", "phenologie", "code_insee_calcul");
 	/**
 	* 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) {
 							'nom_referentiel' => NULL);
 		$parametres = array_merge($base_param, $parametres);
 		$retour = true;
 		$parametres['ordre'] = $this->renvoyerDernierOrdreUtilisePlusUn($utilisateur);
 		$this->traiterEspece($parametres);
 		// si la détermination à échoué, alors:
 		$this->ajoutInfoUtilisateurARequete($parametres);
         self::formaterParametresObservation($parametres);
         $requete_insertion_observation = 'INSERT INTO cel_obs ';
         $sous_requete_colonnes = $this->traiterParametresObservationEtConstruireSousRequeteAjout($parametres);
         $requete_insertion_observation = $requete_insertion_observation.$sous_requete_colonnes;
         // important ! ne pas utiliser la fonction executerRequete qui renvoie une erreur si la requete contient des | (pipes)
         // ce qui peut arriver dans les commentaires
         // TODO: corriger la fonction ou bien continuer à utiliser executerRequeteSimple
         	$retour = $this->renvoyerIdPourOrdre($utilisateur ,$parametres['ordre']);
+        }
         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 = ".Cel::db()->proteger($utilisateur);
 	    $dernier_ordre = Cel::db()->executerRequete($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;
+	}
 	/**
 	* Renvoie l'id d'observation associé à l'utilisateur et l'ordre donné
+	*
 	* @param int $utilisateur id utilisateur
 	* @return int le numero d'ordre relatif à l'utilisateur
 	*/
 	public function renvoyerIdPourOrdre($utilisateur, $ordre) {
 		$requete_selection_dernier_id = "SELECT id_observation FROM cel_obs ".
 	       									   "WHERE ce_utilisateur = ".Cel::db()->proteger($utilisateur)." ".
 	       									   "AND ordre = ".Cel::db()->proteger($ordre)." ";
 		$dernier_id = Cel::db()->executerRequete($requete_selection_dernier_id);
 		if(!$dernier_id) return NULL;
 		return $dernier_id[0]['id_observation'];
+	}
 	/**
 	* 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) {
         self::formaterParametresObservation($parametres);
         $champ_maj = self::traiterParametresObservationEtConstruireSousRequeteMaj($parametres);
         $champ_maj[] = "date_modification = now()";
 		$requete_modification .=
             implode(', ', $champ_maj)
 			. " WHERE ordre IN (".$ordre.") AND ce_utilisateur = ".Cel::db()->proteger($utilisateur);
 		// important ! ne pas utiliser la fonction executerRequete qui renvoie une erreur si la requete contient des | (pipes)
 		// ce qui peut arriver dans les commentaires
 		// TODO: corriger la fonction ou bien continuer à utiliser executerRequeteSimple
     	$resultat_modification = Cel::db()->executerRequeteSimple($requete_modification . ' -- ' . __FILE__ . ':' . __LINE__);
         if ($resultat_modification === false) {
         	$retour = false;
         	$this->logger("CEL_bugs","Erreur de mise à jour d'une liste d'observations : ".$requete_modification);
+        }
         if($nb_upd === FALSE) return FALSE;
         return $nb_upd;
         // TODO: return json_encode(updated_rows());
+   }
 	/**
 	* Modifie une observation publique dont l'id et l'utilisateur sont passé en paramètre
+	*
 	* @param int $utilisateur id utilisateur du proprietaire de l'observation
 	* @param int $id identifiant 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
 	*/
 		$resultat_modification = Cel::db()->executerRequeteSimple($requete_modification . ' -- ' . __FILE__ . ':' . __LINE__);
 		if ($resultat_modification === false) {
 			$this->logger("CEL_bugs","Erreur de mise à jour de l\'observation : ".$id);
 		}
 		return $resultat_modification;
 	}
 	/**
 	* 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) {
 	    // TODO changer le systeme pour n'utiliser plus que les id
 	    $retour = false;
 	    $tableau_ordre = explode(',', $ordre);
 	    $tableau_ordre = array_map(array(Cel::db(),'proteger'), $tableau_ordre);
 	    $ordre = implode(',', $tableau_ordre);
 	    if(is_array($resultat_ids_observations) && count($resultat_ids_observations) > 0) {
 		foreach($resultat_ids_observations as $id_observation) {
 		    $ids_obs[] = Cel::db()->proteger($id_observation['id_obs']);
 		    $ids_obs_non_protegees[] = $id_observation['id_obs'];
+		}
 		$chaine_ids_obs = implode(',', $ids_obs);
 		$requete_supression_observations = 'DELETE FROM cel_obs WHERE '.
 		    'ce_utilisateur = '.Cel::db()->proteger($utilisateur).' '.
 		    'AND id_observation IN ('.$chaine_ids_obs.')';
 		$resultat_suppression_observations = Cel::db()->executerRequeteSimple($requete_supression_observations);
 		// TODO: Faire la suppression des mots clés
 		// et des liaisons obs images dans une ou des fonctions à part
 		if ($resultat_suppression_observations === false) {
 		    $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_observation IN ('.$chaine_ids_obs.')';
 		    $resultat_suppression_liens = Cel::db()->executerRequeteSimple($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;
 		    }
 		    $gestion_mots_cles = new GestionMotsClesChemin($this->config, 'obs');
 		    $resultat_suppression_mots_cles = $gestion_mots_cles->supprimerToutesLiaisonsPourIdsElementsLies($ids_obs_non_protegees);
+		    }
+		}
 	    } 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 = '.Cel::db()->proteger($ancien_id).' ORDER BY ordre';
 		$resultat_releves_temporaires = Cel::db()->executerRequete($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 = '.Cel::db()->proteger($id_utilisateur).', '.
 											'ordre = '.$nouvel_ordre.' '.
 											'WHERE ce_utilisateur = '.$ancien_id.' '.
 											'AND ordre = '.$releve_temporaire['ordre'];
 	   		    $migration_releve = Cel::db()->executerRequeteSimple($requete_migration_releve);
 	   		    //TODO: meilleure vérification
 	   		    if($migration_releve === false) {
 	   		    	$reussite = false;
+	   		    }
         	    $nouvel_ordre++;
 			}
 		}
 		return $reussite;
+	}
 	/**
 	* Fonction utilisée pour importer les anciennes observations saisie dans les widget dans un compte identifié
 	* Dans ce cas là, le widget remplit la case id_utilisateur par le mail indiqué lors de la saisie
 	* @param string $mail_utilisateur
 	* @param string $id_utilisateur
 	*/
 	public function migrerObservationsMailVersId($mail_utilisateur, $infos_utilisateur) {
 		// ATTENTION : cette fonction suppose que l'utilisateur n'ai pas déjà d'observations dans le CEL
 		// avec l'identifiant $id_utilisateur ce qui est normalement le cas
 		$requete_migration_releve = 'UPDATE cel_obs SET '.
 												'ce_utilisateur = '.Cel::db()->proteger($infos_utilisateur['id_utilisateur']).', '.
 												'prenom_utilisateur = '.Cel::db()->proteger($infos_utilisateur['prenom']).', '.
 												'nom_utilisateur = '.Cel::db()->proteger($infos_utilisateur['nom']).', '.
 												'courriel_utilisateur = '.Cel::db()->proteger($infos_utilisateur['courriel']).' '.
 												'WHERE ce_utilisateur = '.Cel::db()->proteger($mail_utilisateur).' ';
 		$migration_releve = Cel::db()->executerRequeteSimple($requete_migration_releve);
 		return $migration_releve;
 	}
 	private function traiterEspece(&$parametres) {
 		if(!$parametres['nom_referentiel']) {
 			$parametres['nom_referentiel'] = Cel::$default_referentiel;
+		}
 		// mise à jour du référentiel utilisé, sans n° de version
 		$parametres['nom_referentiel'] = $code_referentiel;
+	}
     // uniquement nécessaire lors de l'ajout
 	private function ajoutInfoUtilisateurARequete(&$parametres) {
 		if(! isset($parametres['ce_utilisateur'])) return;
         $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'];
+    }
 	/**
 	* 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
 	*/
 	static function formaterParametresObservation(&$parametres) {
 		// 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($parametres['ce_zone_geo'] == 'null' || trim($parametres['ce_zone_geo']) == "") {
         		$parametres['ce_zone_geo'] = "";
         	} else {
 	        	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'] = Cel::obtenirCodeInseeCommunePourNomEtDepartement($parametres['zone_geo'], $parametres['ce_zone_geo']);
 	        	} else {
 	        	 	$parametres['ce_zone_geo'] = 'INSEE-C:'. $parametres['ce_zone_geo'];
+	        	}
         		list($jour,$mois,$annee)=explode("/",$parametres['date_observation']);
         		$parametres['date_observation']=$annee."-".$mois."-".$jour." 0:0:0";
+        	}
+        }
+	}
 	/**
 	* 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 = '';
 		$champs = '';
 		$valeurs = '';
 		// Nullifiage ...
 		// TODO: code dupliqué, en faire une fonction à mettre à la place appropriée
 		foreach($parametres as $cle => $valeur) {
 			$valeur = self::renvoyerValeurDenullifiee($valeur);
 			$champs .= $cle.', ';
 			$valeurs .= $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
 	 */
 	static function traiterParametresObservationEtConstruireSousRequeteMaj($parametres) {
 		$champs = array();
 			$valeur = self::renvoyerValeurDenullifiee($valeur);
         	$champs[] = $cle." = ".$valeur;
+		}
         return $champs;
+	}
 	private static function renvoyerValeurDenullifiee($valeur) {
 		if (trim($valeur) == "" || trim($valeur) == "null" || trim($valeur) == "000null") {
 			$valeur = "NULL";
 		} else {
 			$valeur = Cel::db()->proteger($valeur);

Subversion Repositories eFlore/Applications.cel

(root)/branches/v2.0-elagueuse/jrest/lib/GestionObservation.php – Rev 2079 → 2113