New file |
0,0 → 1,299 |
<?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) { |
|
$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) { |
$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; |
} |
|
/** |
* 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) { |
|
$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) { |
$this->logger("CEL_bugs","Erreur de mise à jour d'une liste d'observations : ".$requete_modification); |
} |
|
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) { |
|
$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 = ''; |
|
foreach($resultat_ids_observations as $id_observation) { |
$chaine_ids_obs = $this->proteger($id_observation['id_obs']).', '; |
} |
|
$chaine_ids_obs = rtrim($chaine_ids_obs,', '); |
|
$requete_supression_observations = 'DELETE FROM cel_obs WHERE '. |
'ce_utilisateur = '.$this->proteger($utilisateur).' '. |
'AND ordre in ('.$this->proteger($ordre) .')'; |
|
$resultat_suppression_observations = $this->executer($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) { |
$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) { |
$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; |
} |
|
/** |
* 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']) && strlen($parametres['ce_zone_geo']) == 1) { |
$parametres['ce_zone_geo'] = '0'.$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)=split("/",$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"; |
} |
|
$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"; |
} |
|
$sous_requete .= $cle." = ".$this->proteger($valeur).", "; |
} |
|
$sous_requete .= ' date_modification = now() '; |
|
return $sous_requete; |
} |
} |
?> |