Subversion Repositories eFlore/Applications.del

<?php
// declare(encoding='UTF-8');
/**
 * Le web service récupére un identifiant de proposition et appelle un service web externe
 * (du CEL) afin de modifier le nom de l'observation associée par celui de la proposition.
 *
 * @category   DEL
 * @package    Services
 * @subpackage Determinations
 * @version    0.1
 * @author     Mathias CHOUET <mathias@tela-botanica.org>
 * @author     Jean-Pascal MILCENT <jpm@tela-botanica.org>
 * @author     Aurelien PERONNET <aurelien@tela-botanica.org>
 * @license    GPL v3 <http://www.gnu.org/licenses/gpl.txt>
 * @license    CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
 * @copyright  1999-2014 Tela Botanica <accueil@tela-botanica.org>
 */

class ValiderDetermination {

        private $conteneur;
        private $bdd;
        private $idObs = null;
        private $idProposition = null;
        private $idAuteurObs = null;
        private $idValidateurObs = null;

        public function __construct(Conteneur $conteneur = null) {
                $this->conteneur = $conteneur == null ? new Conteneur() : $conteneur;
                $this->bdd = $this->conteneur->getBdd();
        }

        public function modifier($ressources, $parametres) {
                $this->verifierParametres($ressources, $parametres);
                $this->idProposition = $ressources[1];
                $this->idValidateurObs = $this->validateurEstPresent($parametres) ? $parametres['validateur.id'] : $parametres['auteur.id'] ;
                $retourCel = $this->modifierObservationParDetermination();

                if (preg_match('/^(OK|Not Modified)$/i', $retourCel) == false) {
                        $msg = "Erreur: le web service du CEL a retourné : $retourCel";
                        $code = RestServeur::HTTP_CODE_ERREUR;
                        throw new Exception($msg, $code);
                }
                return 'OK';
        }

        private function validateurEstPresent($parametres) {
                return isset($parametres['validateur.id']) && is_numeric($parametres['validateur.id']) && $parametres['validateur.id'] != 0;
        }

        private function verifierParametres($ressources, $parametres) {
                $erreurs = array();
                if (!is_numeric($ressources[1])) {
                        $erreurs[] = "La ressource indiquant l'identifiant de la proposition doit être numérique.";
                }

                // Le paramètre auteur.id (id de l'auteur de la détermination)
                // est là pour éviter que le $_POST ne soit vide
                if (!isset($parametres['auteur.id'])) {
                        $erreurs[] = "Le paramètre 'auteur.id' est manquant.";
                }
                // Le paramètre validateur.id (id de la personne validant la détemrinatiuon)
                // est là pour éviter que le $_POST ne soit vide
                if (isset($parametres['validateur.id']) && !is_numeric($parametres['validateur.id'])) {
                        $erreurs[] = "Le paramètre 'validateur.id' doit être un entier.";
                }

                if ($erreurs) {
                        $msg = "Erreur dans les paramètres d'appel au web service :\n\n" . implode("\n", $erreurs);
                        throw new Exception($msg, RestServeur::HTTP_CODE_ERREUR);
                }
        }

        /**
         * 1) récupère l'observation, autrement échec
         * 2) récupère et l'id auteur de l'obs et vérifie qu'il correspond à l'id de l'utilisateur actuel
         * 3) prépare les nouvelles valeurs à transférer au service CEL
         * 4) effectue la mise à jour
         * 5) si tout s'est passé comme convenu, marque la proposition comme "retenue"
         */
        private function modifierObservationParDetermination() {
                $propositionInfos = $this->getInfosProposition();
                $this->idObs = $propositionInfos['ce_observation'];
                $this->idAuteurObs = $this->getIdAuteurObs();
                $this->verifierDroitUtilisateur();

                $parametres = array(
                                'id_observation' => $this->idObs,
                                'nom_sel_nn' => $propositionInfos['nom_sel_nn'],
                                'nom_referentiel' => $propositionInfos['nom_referentiel']
                        );

                $urlBase = $this->conteneur->getParametre('urlServiceCelObs');
                $url = $urlBase.$this->idObs;
                $retour = $this->conteneur->getRestClient()->modifier($url, $parametres);

                // TODO: check sur HTTP code == 200, plutôt que sur texte
                if ($retour == 'ok' || $retour == 'OK') {
                        $this->mettreAJourPropositionRetenue();
                        if($this->idAuteurObs != $this->idValidateurObs) {
                                $this->avertirAuteurObservation();
                        }
                }
                return $retour;
        }

        private function getInfosProposition() {
                $idPropositionP = $this->bdd->proteger($this->idProposition);
                $requete = "SELECT id_commentaire, ce_observation, nom_sel_nn, nom_referentiel ".
                        'FROM del_commentaire '.
                        "WHERE id_commentaire = $idPropositionP ".
                        ' -- '.__FILE__.' : '.__LINE__;
                $resultat = $this->bdd->recuperer($requete);
                if (! $resultat) {
                        throw new Exception("Cette proposition est invalide.", RestServeur::HTTP_CODE_ERREUR);
                }
                return $resultat;
        }

        private function getIdAuteurObs() {
                $obsIdP = $this->bdd->proteger($this->idObs);
                $requete = 'SELECT ce_utilisateur '.
                        'FROM del_observation '.
                        "WHERE id_observation = $obsIdP ".
                        ' -- '.__FILE__.' : '.__LINE__;
                $auteurInfo = $this->bdd->recuperer($requete);
                return $auteurInfo['ce_utilisateur'];
        }
        
        private function getInfosObs() {
                $obsIdP = $this->bdd->proteger($this->idObs);
                $requete = 'SELECT * '.
                                'FROM del_observation '.
                                "WHERE id_observation = $obsIdP ".
                                ' -- '.__FILE__.' : '.__LINE__;
                $obsInfos = $this->bdd->recuperer($requete);
                return $obsInfos;
        }

        private function verifierDroitUtilisateur() {
                $controleAcces = $this->conteneur->getControleAcces();
                $utilisateurInfos = $controleAcces->getInfosUtilisateurConnecte();
                $utilisateurId = $utilisateurInfos['id_utilisateur'];

                // si l'utilisateur connecté n'est ni auteur de l'observation, ni au moins administrateur de niveau 1
                if (($this->idAuteurObs != $utilisateurId) && $utilisateurInfos['admin'] < 1) {
                        $msg = "Seul l'utilisateur ayant saisi l'observation, un administrateur ou un validateur peut la valider : veuillez vous identifier.\n";
                        throw new Exception($msg, RestServeur::HTTP_CODE_ERREUR);
                }
        }

        /**
         * Remet à 0 le status "proposition_retenue" pour toutes les propositions faites sur cette
         * observation à l'exception de celle désormais validée (qui voit son ce_validateur et sa date validation mise à jour)
         */
        private function mettreAJourPropositionRetenue() {
                $requete = 'UPDATE del_commentaire '.
                        "SET proposition_retenue = IF(id_commentaire = {$this->idProposition}, 1, 0), ".
                        "ce_validateur = IF(id_commentaire = {$this->idProposition}, {$this->idValidateurObs} , ce_validateur), ".
                        "date_validation = IF(id_commentaire = {$this->idProposition}, NOW() , date_validation) ".
                        "WHERE ce_observation = {$this->idObs} ".
                        ' -- '.__FILE__.' : '.__LINE__;

                return $this->bdd->requeter($requete);
        }
        
        private function avertirAuteurObservation() {           
                // le validateur est forcément celui qui est actuellement connecté
                $controleAcces = $this->conteneur->getControleAcces();
                $utilisateurInfos = $controleAcces->getInfosUtilisateurConnecte();
                
                $infos_obs = $this->getInfosObs();
                        
                $donnees = array(
                                        'auteur_obs_fmt' => $infos_obs['prenom_utilisateur'].' '.$infos_obs['nom_utilisateur'],
                                        'validateur_fmt' => $utilisateurInfos['prenom']." ".$utilisateurInfos['nom'],
                                        'lien_profil'   => sprintf($this->conteneur->getParametre('message.lien_profil'), $this->idObs),
                                        'id_obs'                => $this->idObs,
                                        'lien_obs'              => sprintf($this->conteneur->getParametre('obs_fiche_tpl'), $this->idObs),
                                        'lien_wiki'             => $this->conteneur->getParametre('message.lien_wiki_validation') 
                                );
                
                $sujet = $this->conteneur->getParametre('message.titre_message_validation');
                
                $squelettePhp = $this->conteneur->getSquelettePhp();
                $squeletteHtml = dirname(__FILE__).DS.'squelettes'.DS.'validation_determination.tpl.html';
                $corpsHtml = $squelettePhp->analyser($squeletteHtml, $donnees);
                
                $squeletteTxt = dirname(__FILE__).DS.'squelettes'.DS.'validation_determination.tpl.txt';
                $corpsTxt = $squelettePhp->analyser($squeletteTxt, $donnees);
                
                $messagerie = $this->conteneur->getMessagerie();
                $messagerie->envoyerHtml($infos_obs['courriel_utilisateur'], 
                                $sujet,
                                $corpsHtml,
                                $corpsTxt);
        }
}