trunk/obj/consultation.class.php

<?php
//$Id$ 
//gen openMairie le 10/02/2011 20:32 
require_once ("../gen/obj/consultation.class.php");
require_once("../services/outgoing/messageenqueuer.php");

class consultation extends consultation_gen {

    var $abstract_type = array(
        "fichier" => "file",
    );

    var $metadata = array(
        "om_fichier_consultation" => array(
            "dossier" => "getDossier",
            "dossier_version" => "getDossierVersion",
            "numDemandeAutor" => "getNumDemandeAutor",
            "anneemoisDemandeAutor" => "getAnneemoisDemandeAutor",
            "typeInstruction" => "getTypeInstruction",
            "statutAutorisation" => "getStatutAutorisation",
            "typeAutorisation" => "getTypeAutorisation",
            "dateEvenementDocument" => "getDateEvenementDocument",
            "groupeInstruction" => 'getGroupeInstruction',
            "title" => 'getTitle',
        ),
        "fichier" => array(
            "filename" => "getFichierFilename",
            "dossier" => "getDossier",
            "dossier_version" => "getDossierVersion",
            "numDemandeAutor" => "getNumDemandeAutor",
            "anneemoisDemandeAutor" => "getAnneemoisDemandeAutor",
            "typeInstruction" => "getTypeInstruction",
            "statutAutorisation" => "getStatutAutorisation",
            "typeAutorisation" => "getTypeAutorisation",
            "dateEvenementDocument" => "getDateEvenementDocument",
            "groupeInstruction" => 'getGroupeInstruction',
            "title" => 'getTitle',
        ),
    );

    function consultation($id,&$db,$debug) {
        $this->constructeur($id,$db,$debug);
    }// fin constructeur

    // {{{ Gestion de la confidentialité des données spécifiques

    /**
     * Surcharge pour gérer les actions disponibles dans le portlet
     */
    function checkAccessibility() {
        //
        parent::checkAccessibility();
        // Si l'utilisateur est un intructeur qui en correspond pas à la
        // division du dossier
        if ($this->f->isUserInstructeur()
            && isset($this->f->om_utilisateur["division"])
            && $this->f->om_utilisateur["division"] != $this->getDivisionFromDossier()) {
            //
            $this->parameters["actions"]["modifier"] = NULL;
            $this->parameters["actions"]["supprimer"] = NULL;
            $this->actions_sup["finalisation"] = NULL;
            $this->actions_sup["definalisation"] = NULL;
            $this->actions_sup["lu"] = NULL;
        }
        // Si une action 'lu' est présente et que le champ lu est à true
        // on supprime l'action
        if (isset($this->actions_sup["lu"])
            && isset($this->val[array_search("lu", $this->champs)])
            && $this->val[array_search("lu", $this->champs)]== "t") {
            unset($this->actions_sup["lu"]);
        }
        
        //Si le document est déjà finalisé, le lien de l'édition est celui du stockage
        $om_final_consultation = $this->getVal("om_final_consultation");
        if ( $om_final_consultation== "t" ){
            
            //On affiche le bon lien pour l'édition
            $this->actions_sup["pdfetat"]["lien"] = "../spg/file.php?id=";
            $this->actions_sup["pdfetat"]["id"] = 
                "&amp;obj=consultation&amp;champ=om_fichier_consultation";
            //On cache les liens d'action
            $this->parameters["actions"]["modifier"] = NULL;
            $this->parameters["actions"]["supprimer"] = NULL;
            $this->actions_sup["finalisation"] = NULL;
        }
        //Si le document n'est pas finalisé, le lien de l'édition est le lien de 
        //génération à la volée 
        if ( $om_final_consultation!= "t" ){
                
            //On affiche le bon lien pour l'édition
            $this->actions_sup["pdfetat"]["lien"] = "../app/pdf_consultation.php?idx=";
            $this->actions_sup["pdfetat"]["id"] = "&obj=consultation";
            $this->actions_sup["definalisation"] = NULL;
            if( $this->f->isUserInstructeur() ){
                $this->parameters["actions"]["modifier"] = NULL;
            }
        }
        
        $idxformulaire = $this->getParameter("idxformulaire");
        $retourformulaire = $this->getParameter("retourformulaire");
        //Si le dossier d'instruction auquel est rattachée la consultation est 
        //cloturé, on affiche pas les liens du portlet
        if ( $idxformulaire != '' && 
            (
                $retourformulaire == 'dossier' ||
                $retourformulaire == 'dossier_instruction' ||
                $retourformulaire == 'dossier_instruction_mes_encours' ||
                $retourformulaire == 'dossier_instruction_tous_encours' ||
                $retourformulaire == 'dossier_instruction_mes_clotures' ||
                $retourformulaire == 'dossier_instruction_tous_clotures'
            )){
                
            //On récuppère le statut du dossier d'instruction        
            $statut = $this->f->getStatutDossier($idxformulaire);
            if ( $this->f->isUserInstructeur() && $statut == "cloture" ){
                
                //On cache le lien de modification
                $this->parameters["actions"]["modifier"] = NULL;
                $this->parameters["actions"]["supprimer"] = NULL;
                $this->actions_sup["finalisation"] = NULL;
                $this->actions_sup["definalisation"] = NULL;
                
                // On affiche l'action "marquer comme lu" uniquement si la 
                // consultation n'a pas été lue
                if ($this->getVal("lu")== "t"){
                    $this->actions_sup["lu"] = NULL;
                }
            }
        }
    }

    /**
     * Cette methode est à surcharger elle permet de tester dans chaque classe
     * des droits des droits spécifiques en fonction des données
     */
    function canAccess() {
        // Si l'utilisateur est un utilisateur de service externe
        // on vérifie qu'il peut accéder à la consultation
        if ($this->f->isUserService()) {
            // On compare l'id du service de la consultation
            // aux id des services de utilisateur connecté
            foreach($this->f->om_utilisateur['service'] as $service) {
                if($this->val[array_search("service",$this->champs)]===$service['service']) {
                    return true;
                }
            }
                //
            $this->f->addToLog("canAccess(): utilisateur de service sur une consultation d'un autre service", EXTRA_VERBOSE_MODE);
            return false;
        }
        // Si l'utilisateur est un intructeur qui ne correspond pas à la
        // division du dossier
        if ($this->f->isUserInstructeur()
            && $this->f->om_utilisateur["division"] != $this->getDivisionFromDossier()
            && $this->getParameter("maj") != 3) {
            //
            $this->f->addToLog("canAccess(): utilisateur instructeur sur un dossier d'une autre division", EXTRA_VERBOSE_MODE);
            return false;
        }
        
        $retourformulaire = $this->getParameter("retourformulaire");
        // Si l'utilisateur est un instructeur et que le dossier est cloturé
        if ( $this->f->isUserInstructeur() && 
            $this->f->getStatutDossier($this->getParameter("idxformulaire")) == "cloture" && 
            (
                $retourformulaire == 'dossier' ||
                $retourformulaire == 'dossier_instruction' ||
                $retourformulaire == 'dossier_instruction_mes_encours' ||
                $retourformulaire == 'dossier_instruction_tous_encours' ||
                $retourformulaire == 'dossier_instruction_mes_clotures' ||
                $retourformulaire == 'dossier_instruction_tous_clotures'
            ) && 
            $this->getParameter("maj") != 3) {
            
            return false;
        }
        //
        return true;
    }

    /**
     * Cette variable permet de stocker le résultat de la méthode
     * getDivisionFromDossier() afin de ne pas effectuer le recalcul à chacun de
     * ces appels.
     * @var string Code de la division du dossier en cours
     */
    var $_division_from_dossier = NULL;

    /**
     * Cette méthode permet de récupérer le code de division correspondant
     * au dossier sur lequel on se trouve.
     *
     * @return string Code de la division du dossier en cours
     */
    function getDivisionFromDossier() {

        // Cette méthode peut être appelée plusieurs fois lors d'une requête.
        // Pour éviter de refaire le traitement de recherche de la division
        // alors on vérifie si nous ne l'avons pas déjà calculé.
        if ($this->_division_from_dossier != NULL) {
            // Logger
            $this->addToLog("getDivisionFromDossier(): retour de la valeur déjà calculée - '".$this->_division_from_dossier."'", EXTRA_VERBOSE_MODE);
            // On retourne la valeur déjà calculée
            return $this->_division_from_dossier;
        }

        // Par défaut, on définit la valeur du dossier à NULL
        $dossier = NULL;
        // Test sur le mode et le contexte du formulaire
        if ($this->getParameter("maj") == 0
            && ($this->getParameter("retourformulaire") == "dossier"
                || $this->getParameter("retourformulaire") == "dossier_instruction"
                || $this->getParameter("retourformulaire") == "dossier_instruction_mes_encours"
                || $this->getParameter("retourformulaire") == "dossier_instruction_tous_encours"
                || $this->getParameter("retourformulaire") == "dossier_instruction_mes_clotures"
                || $this->getParameter("retourformulaire") == "dossier_instruction_tous_clotures")) {
            // Si on se trouve en mode AJOUT (seul mode où l'enregistrement
            // n'existe pas en base de données) ET que nous nous trouvons
            // dans le contexte d'un dossier d'instruction alors on récupère
            // le numéro de dossier depuis le paramètre 'idxformulaire'
            $dossier = $this->getParameter("idxformulaire");
        } else {
            // Sinon on récupère le numéro de dossier dans le champs dossier de
            // l'enregistrement (en base de données)
            $dossier = $this->getVal("dossier");
        }

        // On appelle la méthode de la classe utils qui renvoi le code de la
        // division d'un dossier, on la stocke pour ne pas refaire le calcul au
        // prochain appel de cette méthode
        $this->_division_from_dossier = $this->f->getDivisionFromDossier($dossier);
        // Logger
        $this->addToLog("getDivisionFromDossier(): retour de la valeur nouvellement calculée - '".$this->_division_from_dossier."'", EXTRA_VERBOSE_MODE);
        // On retourne la valeur retournée
        return $this->_division_from_dossier;

    }

    // }}}

    function setValsousformulaire(&$form,$maj,$validation,$idxformulaire,$retourformulaire,$typeformulaire){
        // ajout du retourformulaire aux attributs de l'objet
        $this->retourformulaire = $retourformulaire;
        if ($validation==0) {
            if ($maj == 0){
                $form->setVal("dossier", $idxformulaire);
                $form->setVal("date_envoi",date('d/m/Y'));
            }
            if($maj == 1) {
                if($this->f->isAccredited('consultation_retour_avis_suivi') OR 
                    $this->f->isAccredited('consultation_retour_avis_service')) {
                    $form->setVal("date_retour",date('d/m/Y'));
                }
            }
        }
    }
    
    function setVal(&$form, $maj, $validation, &$db) {
        if($maj == 1) {
             $form->setVal("date_retour",date('d/m/Y'));
        }
    }

    function setvalF($val) {
        //
        parent::setValF($val);
        //
        if ($this->getParameter('maj') == 0) {
            //
            if (isset($this->valF["date_envoi"])) {
                $this->valF["date_reception"] = $this->valF["date_envoi"];
            }
            //
            $this->valF["lu"] = true;
        }

        // Si un retour d'avis est modifie on passe "lu" a false
        if($this->getParameter('maj')==1 AND (
            $this->val[array_search("avis_consultation",$this->champs)] != $val["avis_consultation"] OR
            $this->val[array_search("date_retour",$this->champs)] != $val["date_retour"] OR
            $this->val[array_search("motivation",$this->champs)] != $val["motivation"] OR
            $this->val[array_search("fichier",$this->champs)] != $val["fichier"])
        ) {
            $this->valF["lu"]=false;
        }
    }

    function setLib(&$form, $maj) {
        //
        parent::setLib($form, $maj);
        //
        $form->setLib($this->clePrimaire, _("id"));
    }

    function setType(&$form,$maj) {
        // Appel du parent
        parent::setType($form,$maj);
        $form->setType('dossier', 'hidden');
        // MODE - AJOUTER
        if ($maj == 0) {
            // On cache alors tous les champs que nous ne voulons pas voir
            // apparaître dans le formulaire d'ajout (principalement les
            // informations sur le retour d'avis)
            $form->setType('date_retour', 'hiddendate');
            $form->setType('date_reception', 'hiddendate');
            $form->setType('date_limite', 'hiddendate');
            $form->setType('avis_consultation', 'hidden');
            $form->setType('motivation', 'hidden');
            $form->setType('fichier', 'hidden');
            $form->setType('lu', 'hidden');
            // On permet la modification de certains champs
            $form->setType('dossier_libelle', 'hiddenstatic');
            $form->setType('service', 'select');
            $form->setType('date_envoi', 'date2');
        }
        // MODE - MODIFIER
        if ($maj == 1) {

            // On affiche en statique les informations qui ne sont plus
            // modifiables
            $form->setType('dossier_libelle', 'hiddenstatic');
            $form->setType('date_envoi', 'hiddenstaticdate');
            $form->setType('date_limite', 'hiddenstaticdate');
            $form->setType('service', 'selecthiddenstatic');
            
            // La date de réception ne peut être modifiée que par un
            // utilisateur en ayant spécifiquement la permission
            if($this->f->isAccredited('consultation_modifier_date_reception')) {
                $form->setType('date_reception', 'date2');
            } else {
                $form->setType('date_reception', 'hiddenstaticdate');
            }

            // Le marqueur lu/non lu ne peut être modifié que par un
            // utilisateur en ayant spécifiquement la permission
            if ($this->f->isAccredited('consultation_modifier_lu')) {
                $form->setType('lu', 'checkbox');
            } else {
                $form->setType('lu', 'hidden');
            }

            // Gestion du type du widget sur le champ fichier
            if($this->getVal("fichier") == "" OR
               $this->f->isAccredited('consultation_modifier_fichier')) {
                // Si il n'y a jamais eu de fichier enregistré ou que
                // l'utilisateur a spécifiquement les droits pour modifier
                // un fichier déjà enregistré alors on positionne un type
                // de widget modifiable
                if ($this->retourformulaire == "demande_avis_encours"
                    || $this->retourformulaire == "dossier_qualifier"
                    || $this->retourformulaire == "dossier"
                    || $this->retourformulaire == "dossier_instruction"
                    || $this->retourformulaire == "dossier_instruction_mes_encours"
                    || $this->retourformulaire == "dossier_instruction_tous_encours"
                    || $this->retourformulaire == "dossier_instruction_mes_clotures"
                    || $this->retourformulaire == "dossier_instruction_tous_clotures") {
                    $form->setType('fichier', 'upload2');
                } else {
                    $form->setType('fichier', 'upload');
                }
            } else {
                // Si non on affiche uniquement le nom du fichier 
                $form->setType('fichier', 'file');
            }

            // Modification layout : écran de retour d'avis permettant
            // uniquement la saisie des trois champs : avis, motivation et fichier
            if (!$this->f->isAccredited('consultation_consulter_autre_que_retour_avis')) {

                // On cache alors tous les champs que nous ne voulons pas voir
                $form->setType('dossier_libelle', 'hidden');
                $form->setType('service', 'hidden');
                $form->setType('date_envoi', 'hiddendate');
                $form->setType('date_retour', 'hiddendate');
                $form->setType('date_reception', 'hiddendate');
                $form->setType('date_limite', 'hiddendate');
                $form->setType('lu', 'hidden');

            }
            
        }
        // Mode supprimer
        if ($maj == 2) {
            $form->setType('fichier', 'filestatic');
        }
        // MODE - CONSULTER
        if ( $maj == 3 ) {
            $form->setType('fichier', 'file');
        }
        //// On cache la clé primaire
        //$form->setType('consultation', 'hidden');
        //
        if ($this->getParameter("retourformulaire") == "dossier"
            || $this->getParameter("retourformulaire") == "dossier_instruction"
            || $this->getParameter("retourformulaire") == "dossier_instruction_mes_encours"
            || $this->getParameter("retourformulaire") == "dossier_instruction_tous_encours"
            || $this->getParameter("retourformulaire") == "dossier_instruction_mes_clotures"
            || $this->getParameter("retourformulaire") == "dossier_instruction_tous_clotures") {
            //
            $form->setType('dossier_libelle', 'hidden');
        }
            
        $form->setType('code_barres', 'hidden');
        
        //Cache les champs pour la finalisation
        $form->setType('om_fichier_consultation', 'hidden');
        $form->setType('om_final_consultation', 'hidden');
    }

    // Cette méthode permet de calculer la date limite en fonction de la date
    // de réception et du délai de consultation du service consulté
    function calculDateLimite() {
        // mise a jour instruction avec evenement [return delay]
        if ($this->valF["date_reception"] != "") {
            //
            $sql = " select delai from ".DB_PREFIXE."service ";
            $sql .= " where service='".$this->valF["service"]."' ";
            //
            $delai = $this->db->getOne($sql);
            $this->addToLog("triggerajouter(): db->getone(\"".$sql."\")", VERBOSE_MODE);
            //
            $this->valF["date_limite"] = $this->f->mois_date($this->valF["date_reception"], $delai);
            //
            $this->addToMessage(_("delai")." ".
               _("retour")." ".$delai." "._("mois")." -> ".
               _("retour")." ".date("d/m/Y", strtotime($this->valF["date_limite"])));
        }
    }

    // TRIGGER AVANT MODIFICATION DE DONNEES
    // trigger before modification data
    function triggerajouter($id,&$db,$val,$DEBUG) {
        //
        $this->calculDateLimite();
        
        // Identifiant du type de courrier
        $idTypeCourrier = '12';
        $idCourrier = str_pad($this->valF["consultation"], 10, "0", STR_PAD_LEFT);
        // Code barres
        $this->valF["code_barres"] = $idTypeCourrier . $idCourrier;
    }

    //
    function triggermodifier($id,&$db,$val,$DEBUG) {
        //
        $this->calculDateLimite();
    }

    //
    function triggerajouterapres($id,&$db,$val,$DEBUG) {
        
        // Verification de la demande de notif par mail
        $sql= "SELECT abrege, libelle, notification_email, email FROM ".DB_PREFIXE.
                "service WHERE service ='".$this->valF['service']."'";
        $res=$db->query($sql);
        $notif = $res->fetchrow(DB_FETCHMODE_ASSOC);
        if (database :: isError($sql))die($res->getMessage()."erreur ".$sql);
        if ($notif['notification_email']=='t') {
            
            // Recuperation des infos du dossier
            $sql= "SELECT dossier, terrain_adresse_voie_numero, terrain_adresse_voie, terrain_adresse_code_postal, terrain_adresse_localite
                    FROM ".DB_PREFIXE."dossier WHERE dossier ='".$this->valF['dossier']."'";
            $res=$db->query($sql);
            $dossier = $res->fetchrow(DB_FETCHMODE_ASSOC);
            
            // Definition des parametres d'envoi du mail
            $title=_("Consultation de services : dossier no")." ".$dossier['dossier'];
            $corps=_("Votre service est consulte concernant le dossier no")." ".$dossier['dossier']."<br/>".
            _("Il concerne le terrain situe a l'adresse :")." ".$dossier['terrain_adresse_voie_numero'].
            " ".$dossier['terrain_adresse_voie']." ".$dossier['terrain_adresse_code_postal']." ".$dossier['terrain_adresse_localite']."<br/>".
            _("Vous pouvez y acceder et rendre votre avis a l'adresse")." <a href='".$this->f->getParameter('services_consultes_lien_interne').
            // On ajoute l'idx, s'il y a besoin
            ((substr($this->f->getParameter('services_consultes_lien_interne'), -5)=="&idx=")?$this->valF['consultation']:"")."'>".
            _("Lien interne (services VDM)")."</a> "._("ou")." <a href='".$this->f->getParameter('services_consultes_lien_externe').
            // On ajoute l'idx, s'il y a besoin
            ((substr($this->f->getParameter('services_consultes_lien_externe'), -5)=="&idx=")?$this->valF['consultation']:"")."'>".
            _("Lien externe (hors VDM)")."</a>";
            // Envoi du mail avec message de retour
            if($this->f->sendMail(iconv("UTF-8", "CP1252", $title), iconv("UTF-8", "CP1252", $corps), iconv("UTF-8", "CP1252", $notif['email']))) {
                $this->addToMessage(_("Envoi d'un mail de notification au service")." \"(".$notif['abrege'].") ".$notif["libelle"]."\"");
            } else {
                $this->addToMessage(_("L'envoi du mail de notification a echoue"));
            }
        }
        
        
        // verification si envoi vers ERP est active
        if ($this->f->getParameter('option_erp') === 'true') {
            // s'il s'agit de la consultation ERP Secu, ERP Accessibilite, ou
            // deenvoie un
            // message a ERP
            $dossier_erp = $this->getFromDB("SELECT erp FROM ".DB_PREFIXE.
                            "dossier WHERE dossier = '" .$this->valF['dossier'] . "'");
            $dossier_nature = $this->getFromDB("SELECT dossier_autorisation_type_detaille.code FROM ".DB_PREFIXE.
                            "dossier
                            INNER JOIN ".DB_PREFIXE."dossier_autorisation
                                ON dossier.dossier_autorisation=dossier_autorisation.dossier_autorisation
                            INNER JOIN ".DB_PREFIXE."dossier_autorisation_type_detaille
                                ON dossier_autorisation.dossier_autorisation_type_detaille 
                                = dossier_autorisation_type_detaille.dossier_autorisation_type_detaille 
                            WHERE dossier = '" . $this->valF['dossier'] . "'");
            if ($dossier_erp == 't'
                && substr($dossier_nature, 0, 2) == $this->f->getParameter('erp_dossier_nature_pc')) {
                // envoi du message "Demande d'instruction d'un dossier PC pour un ERP"
                if (($this->valF['service'] == $this->f->getParameter('erp_service_accessibilite')
                    || $this->valF['service'] == $this->f->getParameter('erp_service_securite'))) {
                    $msgenque = new MessageEnqueuer();
                    $msgenque->setDossierInstructionIdentifier($this->valF['dossier']);
                    $msgenque->setConsultationIdentifier($this->valF['consultation']);
                    $return = $msgenque->enqueueMessage($msgenque::$ERP_DEMANDE_INSTRUCTION_PC);
                    //Si une erreur s'est produite on arrête le traitement et on 
                    //retourne une erreur
                    if ($return !== 0){
                        
                        $this->addToMessage(_("Une erreur s'est produite lors de ".
                            "l'envoi du message au referentiel ERP. Merci de ".
                            "contacter votre administrateur"));
                        //On ne valide pas le formulaire
                        $this->addToMessage("<br/>"._("SAISIE NON ENREGISTREE")."<br/>");
                        $this->correct = false;
                        return false;
                    }
                    else {
                        $this->addToMessage(_("Le message a ete transmis au ".
                            "referentiel ERP."));
                    }
                }
                
                // envoi du message "Consultation ERP pour conformite" en cas de creation de la
                // consultation du service ERP Conformite
                if ($this->valF['service'] == $this->f->getParameter('erp_service_conformite')) {
                    $msgenque = new MessageEnqueuer();
                    $msgenque->setDossierInstructionIdentifier($this->valF['dossier']);
                    $msgenque->setConsultationIdentifier($this->valF['consultation']);
                    $return = $msgenque->enqueueMessage($msgenque::$ERP_CONSULTATION_CONFORMITE);
                    //Si une erreur s'est produite on arrête le traitement et on 
                    //retourne une erreur
                    if ($return !== 0){
                        
                        $this->addToMessage(_("Une erreur s'est produite lors de ".
                            "l'envoi du message au referentiel ERP. Merci de ".
                            "contacter votre administrateur"));
                        //On ne valide pas le formulaire
                        $this->addToMessage("<br/>"._("SAISIE NON ENREGISTREE")."<br/>");
                        $this->correct = false;
                        return false;
                    }
                    else {
                        $this->addToMessage(_("Le message a ete transmis au ".
                            "referentiel ERP."));
                    }
                }
            }
        } // fin de if($this->f->getParameter('option_erp') === 'true')
        
        // Finalisation du document
        $this->finaliserAjouter();
    }
    
    /**
     * Fait une requette sql pour extraire la valeur d'un champ, et retourne
     * cette valeur
     * @param string $sql La requete sql a executer
     * @return La valeur du champs cherche, sinon NULL. En cas d'erreur de la BD
     * l'execution s'arrete.
     */
    function getFromDB($sql) {
        //$sql = "SELECT libelle FROM ".DB_PREFIXE."dossier WHERE dossier = '" . $dossier . "'";
        $res = $this->db->limitquery($sql, 0, 1);
        $this->f->addToLog("getDossierERPSpecification(): db->limitquery(\"".
                        str_replace(",",", ",$sql)."\", 0, 1);", VERBOSE_MODE);
        // Si une erreur survient on die
        if (database::isError($res, true)) {
            // Appel de la methode de recuperation des erreurs
            $this->erreur_db($res->getDebugInfo(), $res->getMessage(), 'instruction');
        }
        // retourne la nature du dossier
        while ($row =& $res->fetchRow()) {
            return $row[0];
        }
        // la nature n'etait pas trouve, ce qui ne devrait pas se passer
        return NULL;

    }

    // =============================================
    // Ajout du fielset
    // Add fieldset
    // =============================================
    function setLayout(&$form, $maj){

            // Modification layout : écran de retour d'avis permettant
            // uniquement la saisie des trois champs : avis, motivation et fichier
            if ($this->f->isAccredited('consultation_consulter_autre_que_retour_avis')) {
                
                //Champs sur lequel s'ouvre le fieldset
                $form->setBloc('dossier','D',"");
                $form->setFieldset('dossier','D',_('Consultation'));
    
                //Champs sur lequel se ferme le fieldset
                $form->setFieldset('date_envoi','F','');
                $form->setBloc('date_envoi','F');

            }
            
            // MODE - autre que AJOUTER alors on affiche un fieldset retour
            // d'avis
            if ($maj != 0) {
                
                //Champs sur lequel s'ouvre le fieldset
                $form->setBloc('date_reception','D',"");
                $form->setFieldset('date_reception','D',_('Retour d\'avis'));
    
                //Champs sur lequel se ferme le fieldset
                $form->setFieldset('lu','F','');
                $form->setBloc('lu','F');
                
            }
    }

    /** Surcharge de la methode retour afin de retourner sur la page de saisie de
    * code barre si besoin
    **/
    function retour($premier = 0, $recherche = "", $tricol = "") {
        $params ="obj=".get_class($this);
        if($this->getParameter("retour")=="form") {
            $params .= "&amp;idx=".$this->getParameter("idx");
            $params .= "&amp;action=3";
        }
        $params .= "&amp;premier=".$this->getParameter("premier");
        $params .= "&amp;tricol=".$this->getParameter("tricol");
        $params .= "&amp;recherche=".$this->getParameter("recherche");
        $params .= "&amp;selectioncol=".$this->getParameter("selectioncol");
        $params .= "&amp;advs_id=".$this->getParameter("advs_id");
        $params .= "&amp;valide=".$this->getParameter("valide");
        echo "\n<a class=\"retour\" ";
        echo "href=\"";
        //

        if($this->getParameter("retour")=="form" AND !($this->getParameter("validation")>0 AND $this->getParameter("maj")==2 AND $this->correct)) {
            echo "form.php?".$params;
        } elseif($this->getParameter("retour")=="suivi_retours_de_consultation") {
            echo "../app/suivi_retours_de_consultation.php";
        } else {
            echo "tab.php?".$params;
        }
        //
        echo "\"";
        echo ">";
        //
        echo _("Retour");
        //
        echo "</a>\n";
    }

    /**
     * Surcharge du bouton retour pour popup
     */
        function retoursousformulaire($idxformulaire, $retourformulaire, $val,
                                  $objsf, $premiersf, $tricolsf, $validation,
                                  $idx, $maj, $retour) {
        if($retourformulaire === "demande_avis_encours") {
            echo "\n<a class=\"retour\" ";
            echo "href=\"";
            echo "#";
            echo  "\" ";
            echo ">";
            //
            echo _("Retour");
            //
            echo "</a>\n";
        } else {
            parent::retoursousformulaire($idxformulaire, $retourformulaire, $val,
                                  $objsf, $premiersf, $tricolsf, $validation,
                                  $idx, $maj, $retour);
        }
    }
    
    /**
     * Ajout des contraintes spécifiques pour l'ajout d'un fichier en retour de 
     * consultation
     */
    function setSelect(&$form, $maj,&$db,$debug) {
        if(file_exists ("../sql/".OM_DB_PHPTYPE."/".$this->table.".form.inc.php"))
            include ("../sql/".OM_DB_PHPTYPE."/".$this->table.".form.inc.php");
        elseif(file_exists ("../sql/".OM_DB_PHPTYPE."/".$this->table.".form.inc"))
            include ("../sql/".OM_DB_PHPTYPE."/".$this->table.".form.inc");

        // avis_consultation
        $this->init_select($form, $db, $maj, $debug, "avis_consultation",
                           $sql_avis_consultation, $sql_avis_consultation_by_id, true);

        // service
        $this->init_select($form, $db, $maj, $debug, "service",
                           $sql_service, $sql_service_by_id, true);

        //Seulement dans le cas d'un retour d'avis
        if($this->retourformulaire == "demande_avis_encours") {
            
            //Tableau des contraintes spécifiques
            $params = array(
                "constraint" => array(
                    "size_max" => 2,
                    "extension" => ".pdf"
                ),
            );
            
            $form->setSelect("fichier", $params);
        }
    }

    /**
     * Finalisation du document lors de l'ajout d'une consultation
     */
    function finaliserAjouter(){

        //Génération du PDF
        $_GET['output'] = "string";
        $_GET['obj'] = "consultation";
        $_GET['idx'] = $this->valF[$this->clePrimaire];
        $f = $this->f;
        include '../app/pdf_consultation.php';
        
        //Métadonnées du document
        $metadata = array(
            'filename' => 'consultation_'.$idx.'.pdf',
            'mimetype' => 'application/pdf',
            'size' => strlen($pdf_output)
        );

        // Récupération des métadonnées calculées après validation
        $spe_metadata = $this->getMetadata("om_fichier_consultation");

        $metadata = array_merge($metadata, $spe_metadata);

        //On ajoute le document et on récupère son uid
        $uid = $this->f->storage->create($pdf_output, $metadata);

        //Mise à jour des données
        if ( $uid != '' && $uid != 'OP_FAILURE' ){
            // Logger
            $this->addToLog("finaliserAjouter() - begin", EXTRA_VERBOSE_MODE);

            $valF = array(
                    "om_final_consultation"=> TRUE,
                    "om_fichier_consultation"=>$uid);

            // Execution de la requête de modification des donnees de l'attribut
            // valF de l'objet dans l'attribut table de l'objet
            $res = $this->db->autoExecute(DB_PREFIXE.$this->table, $valF, 
                DB_AUTOQUERY_UPDATE, $this->getCle($idx));
             $this->addToLog("finaliserAjouter() : db->autoExecute(\"".DB_PREFIXE.$this->table."\", ".print_r($valF, true).", DB_AUTOQUERY_UPDATE, \"".$this->getCle($idx)."\")", VERBOSE_MODE);
            // Si une erreur survient
            if (database::isError($res)) {
                // Appel de la methode de recuperation des erreurs
                $this->erreur_db($res->getDebugInfo(), $res->getMessage(), '');
            } else {
                // Log
                $this->addToLog(_("Requete executee"), VERBOSE_MODE);
                // Log
                $message = _("Enregistrement")."&nbsp;".$idx."&nbsp;";
                $message .= _("de la table")."&nbsp;\"".$this->table."\"&nbsp;";
                $message .= "[&nbsp;".$this->db->affectedRows()."&nbsp;";
                $message .= _("enregistrement(s) mis a jour")."&nbsp;]";
                $this->addToLog($message, VERBOSE_MODE);
            } 
        }
    }

    /**
     * Finalisation des documents.
     * @param  string $champ    champ du fichier à finaliser
     * @param  booleen $status  permet de définir si on finalise ou définalise
     * @param  string $sousform permet de savoir si se trouve dans un sousformulaire (passé au javascript)
     */
    function finaliser($champ = '', $status, $sousform, $retourformulaire) {

                // Recuperation de la valeur de la cle primaire de l'objet
        if ($this->getVal($this->clePrimaire) != '') {
            //
            $id = $this->getVal($this->clePrimaire);
        }
        else {
            //
            $id=$this->id;
        }
                
        // Si on finalise le document
        if ($status == 1) {

            // Génération du PDF
            $_GET['output'] = "string";
            $f = $this->f;
            include '../app/pdf_consultation.php';
            
            // Métadonnées du document
            $metadata = array(
                'filename' => 'consultation_'.$idx.'.pdf',
                'mimetype' => 'application/pdf',
                'size' => strlen($pdf_output)
            );

            // Récupération des métadonnées calculées après validation
            $spe_metadata = $this->getMetadata("om_fichier_consultation");

            $metadata = array_merge($metadata, $spe_metadata);

            // Si le document a déjà été finalisé
            if ( $this->getVal("om_fichier_consultation") != '' ){

                // Met à jour le document mais pas son uid
                $uid = $this->f->storage->update(
                    $this->getVal("om_fichier_consultation"), $pdf_output, $metadata);
            }
            // Sinon, ajoute le document et récupère son uid
            else {

                // Stockage du PDF
                $uid = $this->f->storage->create($pdf_output, $metadata);
            }

        }
        //
        else {

            //Récupération de l'uid du document finalisé
            $uid = $this->getVal("om_fichier_consultation");
            
            //On dé-finalise avant de finaliser
            if ( $uid == '' || $uid == 'OP_FAILURE' ){
                $this->addToLog(
                        _("Finalisation non enregistree")." - ".
                        _("id consultation")." = ".$id." - ".
                        _("uid fichier")." = ".$uid
                    );
                return -1;
            }
        }

        
        //Mise à jour des données
        if ($uid != '' && $uid != 'OP_FAILURE') {

            // Logger
            $this->addToLog("finaliser() - begin", EXTRA_VERBOSE_MODE);

            $actions = array();

            // Tableau contenant le lien vers le PDF et lien du portlet pour la 
            // mise à jour de l'interface
            if ($status == 0) {

                // Lien pour ouvrir le PDF
                $lien = '../app/pdf_consultation.php?idx='.$id;

                //
                if ($this->f->isAccredited('consultation') || 
                    $this->f->isAccredited('consultation_modifier')) {

                    $actions["modifier"] = ($sousform!='')?
                        '<li><a href="#" onclick="ajaxIt(\'consultation\',
                        \'../scr/sousform.php?obj=consultation&amp;action=1&amp;idx='.
                        $this->getVal($this->clePrimaire).
                        '&amp;premiersf=0&amp;trisf=&amp;retourformulaire='.$retourformulaire.'&amp;idxformulaire='.
                        $this->getVal("dossier").
                        '&amp;retour=form\');">
                        <span class="om-prev-icon om-icon-16 edit-16" title="'.
                        _('Modifier').'">'.
                        _('Modifier').
                        '</span></a></li>':
                        '<li>
                        <a href="form.php?obj=consultation&amp;action=1'.'&amp;idx='.
                        $this->getVal($this->clePrimaire).
                        '&amp;premier=&amp;advs_id=&amp;recherche=&amp;tricol=&amp;selectioncol=&amp;valide=&amp;retour=form">
                        <span class="om-prev-icon om-icon-16 edit-16" title="'.
                        _('Modifier').'">'.
                        _('Modifier').
                        '</span></a></li>';
                }

                //Si l'utilisateur a le droit de supprimer l'objet
                if ( $this->f->isAccredited('consultation') || 
                    $this->f->isAccredited('consultation_supprimer') ){
                        
                    $actions["supprimer"] = ($sousform!='')?
                        '<li><a href="#" onclick="ajaxIt(\'consultation\',
                        \'../scr/sousform.php?obj=consultation&amp;action=2&amp;idx='.
                        $this->getVal($this->clePrimaire).
                        '&amp;premiersf=0&amp;trisf=&amp;retourformulaire='.$retourformulaire.'&amp;idxformulaire='.
                        $this->getVal("dossier").
                        '&amp;retour=form\');">
                        <span class="om-prev-icon om-icon-16 delete-16" title="'.
                        _('Supprimer').'">'.
                        _('Supprimer').
                        '</span></a></li>':
                        '<li>
                        <a href="form.php?obj=consultation&amp;action=1'.'&amp;idx='.
                        $this->getVal($this->clePrimaire).
                        '&amp;premier=&amp;advs_id=&amp;recherche=&amp;tricol=&amp;selectioncol=&amp;valide=&amp;retour=form">
                        <span class="om-prev-icon om-icon-16 delete-16" title="'.
                        _('Supprimer').'">'.
                        _('Supprimer').
                        '</span></a></li>';
                }
            }
            else {

                // Lien permettant d'afficher le PDF
                $lien = '../spg/file.php?obj=consultation&'.
                    'champ=om_fichier_consultation&id='.$id;
            }

            //
            $retour = array(
                "portlet"=> "<a href=\"#\" onclick=\"finalizeDocument(".
                    $id.", 'consultation', '".$sousform."', ".(($status==0)?1:0).")\">
                    <span class=\"om-prev-icon om-icon-16 om-icon-fix "
                    .(($status==1)?"de":"")."finalise\" title=\"".
                    (($status==1)?_("Reprendre la redaction du document"):_("Finaliser le document"))."\">".
                    (($status==1)?_("Reprendre la redaction du document"):_("Finaliser le document"))."</span>
                    </a>",
                "pdf" => $lien,
                "actions" => $actions
            );

            foreach ($this->champs as $key => $value) {
                //
                $val[$value] = $this->val[$key];
            }

            $this->setvalF($val);

            // Verification de la validite des donnees
            $this->verifier($this->val, $this->db, DEBUG);
            // Verification du verrou
            $this->testverrou();
            // Si les verifications precedentes sont correctes, on procede a
            // la modification, sinon on ne fait rien et on retourne une erreur
            if ($this->correct) {

                // Execution du trigger 'before' specifique au MODE 'update'
                $this->triggermodifier( $id, $this->db, $this->val, DEBUG);

                //
                $valF = '';
                $valF["om_final_consultation"] = ($status==1)?TRUE:FALSE;
                $valF["om_fichier_consultation"] = $uid;
                    
                // Execution de la requête de modification des donnees de l'attribut
                // valF de l'objet dans l'attribut table de l'objet
                $res = $this->db->autoExecute(DB_PREFIXE.$this->table, $valF, 
                    DB_AUTOQUERY_UPDATE, $this->getCle($id));
                 $this->addToLog("finaliser() : db->autoExecute(\"".DB_PREFIXE.$this->table."\", ".print_r($valF, true).", DB_AUTOQUERY_UPDATE, \"".$this->getCle($id)."\")", VERBOSE_MODE);

                // Si une erreur survient
                if (database::isError($res)) {

                    // Appel de la methode de recuperation des erreurs
                    $this->erreur_db($res->getDebugInfo(), $res->getMessage(), '');
                } else {

                    // Log
                    $this->addToLog(_("Requete executee"), VERBOSE_MODE);
                    // Log
                    $message = _("Enregistrement")."&nbsp;".$id."&nbsp;";
                    $message .= _("de la table")."&nbsp;\"".$this->table."\"&nbsp;";
                    $message .= "[&nbsp;".$this->db->affectedRows()."&nbsp;";
                    $message .= _("enregistrement(s) mis a jour")."&nbsp;]";
                    $this->addToLog($message, VERBOSE_MODE);
                    // Mise en place du verrou pour ne pas finaliser plusieurs fois
                    // le meme document
                    $this->verrouille();
                    // Execution du trigger 'after' specifique au MODE 'update'
                    $this->triggermodifierapres($id, $this->db, $this->val, DEBUG);

                    return $retour;
                }
            //
            } else {

                // Message d'echec (saut d'une ligne supplementaire avant le
                // message pour qu'il soit mis en evidence)
                $this->addToLog(
                    _("Finalisation non enregistree")." - ".
                    _("id consultation")." = ".$id." - ".
                    _("uid fichier")." = ".$uid
                );
                return -1;
            }
        }
        // Si le document n'a pas été stocké
        else{
            $this->addToLog(
                _("Finalisation non enregistree")." - ".
                _("id consultation")." = ".$id." - ".
                _("uid fichier")." = ".$uid
            );
            return -1;
        }
    }

    /**
     * Création du nom de fichier
     * @return string numéro de dossier d'instruction
     */
    protected function getFichierFilename() {
        return "consultation_avis_".$this->valF[$this->clePrimaire].".pdf";
    }

    /**
     * Récupération du numéro de dossier d'instruction à ajouter aux métadonnées
     * @return string numéro de dossier d'instruction
     */
    protected function getDossier() {
        if(empty($this->specificMetadata)) {
            $this->getSpecificMetadata();
        }
        return $this->specificMetadata->dossier;
    }
    /**
     * Récupération la version du dossier d'instruction à ajouter aux métadonnées
     * @return int Version
     */
    protected function getDossierVersion() {
        if(empty($this->specificMetadata)) {
            $this->getSpecificMetadata();
        }
        return $this->specificMetadata->version;
    }
    /**
     * Récupération du numéro de dossier d'autorisation à ajouter aux métadonnées
     * @return string numéro de dossier d'autorisation
     */
    protected function getNumDemandeAutor() {
        if(empty($this->specificMetadata)) {
            $this->getSpecificMetadata();
        }
        return $this->specificMetadata->dossier_autorisation;
    }
    /**
     * Récupération de la date de demande initiale du dossier à ajouter aux métadonnées
     * @return date demande initiale
     */
    protected function getAnneemoisDemandeAutor() {
        if(empty($this->specificMetadata)) {
            $this->getSpecificMetadata();
        }
        return $this->specificMetadata->date_demande_initiale;
    }
    /**
     * Récupération du type de dossier d'instruction à ajouter aux métadonnées
     * @return string type de dossier d'instruction
     */
    protected function getTypeInstruction() {
        if(empty($this->specificMetadata)) {
            $this->getSpecificMetadata();
        }
        return $this->specificMetadata->dossier_instruction_type;
    }
    /**
     * Récupération du statut du dossier d'autorisation à ajouter aux métadonnées
     * @return string avis
     */
    protected function getStatutAutorisation() {
        if(empty($this->specificMetadata)) {
            $this->getSpecificMetadata();
        }
        return $this->specificMetadata->statut;
    }
    /**
     * Récupération du type de dossier d'autorisation à ajouter aux métadonnées
     * @return string type d'autorisation
     */
    protected function getTypeAutorisation() {
        if(empty($this->specificMetadata)) {
            $this->getSpecificMetadata();
        }
        return $this->specificMetadata->dossier_autorisation_type;
    }
    /**
     * Récupération de la date d'ajout de document à ajouter aux métadonnées
     * @return date de l'évènement
     */
    protected function getDateEvenementDocument() {
        return date("Y-m-d");
    }
    /**
     * Récupération du groupe d'instruction à ajouter aux métadonnées
     * @return string Groupe d'instruction
     */
    protected function getGroupeInstruction() {
        if(empty($this->specificMetadata)) {
            $this->getSpecificMetadata();
        }
        return $this->specificMetadata->groupe_instruction;
    }
    /**
     * Récupération du type de document à ajouter aux métadonnées
     * @return string Type de document
     */
    protected function getTitle() {
        if ($this->retourformulaire == "demande_avis_encours") {
            return 'Retour de consultation';
        } else {
            return 'Demande de consultation';
        }
    }

    /**
     * Cette méthode permet de stocker en attribut toutes les métadonnées
     * nécessaire à l'ajout d'un document.
     */
    public function getSpecificMetadata() {
        if (isset($this->valF["dossier"]) AND $this->valF["dossier"] != "") {
            $dossier = $this->valF["dossier"];
        } else {
            $dossier = $this->getVal("dossier");
        }
        //Requête pour récupérer les informations essentiels sur le dossier d'instruction
        $sql = "SELECT dossier.dossier as dossier,
                        dossier_autorisation.dossier_autorisation as dossier_autorisation, 
                        to_char(dossier.date_demande, 'YYYY/MM') as date_demande_initiale,
                        dossier_instruction_type.code as dossier_instruction_type, 
                        etat_dossier_autorisation.libelle as statut,
                        dossier_autorisation_type.code as dossier_autorisation_type,
                        groupe.code as groupe_instruction
                FROM ".DB_PREFIXE."dossier 
                    LEFT JOIN ".DB_PREFIXE."dossier_instruction_type  
                        ON dossier.dossier_instruction_type = dossier_instruction_type.dossier_instruction_type
                    LEFT JOIN ".DB_PREFIXE."dossier_autorisation 
                        ON dossier.dossier_autorisation = dossier_autorisation.dossier_autorisation 
                    LEFT JOIN ".DB_PREFIXE."etat_dossier_autorisation
                        ON  dossier_autorisation.etat_dossier_autorisation = etat_dossier_autorisation.etat_dossier_autorisation
                    LEFT JOIN ".DB_PREFIXE."dossier_autorisation_type_detaille
                        ON dossier_autorisation.dossier_autorisation_type_detaille = dossier_autorisation_type_detaille.dossier_autorisation_type_detaille
                    LEFT JOIN ".DB_PREFIXE."dossier_autorisation_type
                        ON dossier_autorisation_type_detaille.dossier_autorisation_type = dossier_autorisation_type.dossier_autorisation_type
                    LEFT JOIN ".DB_PREFIXE."groupe
                        ON dossier_autorisation_type.groupe = groupe.groupe
                WHERE dossier.dossier = '".$dossier."'";
        $res = $this->db->query($sql);
        $this->f->addToLog("obj/document_numerise.class.php : db->query(".$sql.")", VERBOSE_MODE);
        if ( database::isError($res)){
            die();
        }
        
        //Le résultat est récupéré dans un objet
        $row =& $res->fetchRow(DB_FETCHMODE_OBJECT);

        //Si il y a un résultat
        if ($row !== null) {
                
            //Génération du numéro de version
            $sql = "SELECT 
                        count(*) 
                FROM 
                    ".DB_PREFIXE."dossier
                LEFT JOIN
                    ".DB_PREFIXE."dossier_autorisation
                    ON
                        dossier_autorisation.dossier_autorisation = dossier.dossier_autorisation
                LEFT JOIN
                    ".DB_PREFIXE."dossier_instruction_type
                    ON
                        dossier_instruction_type.dossier_instruction_type = dossier.dossier_instruction_type
                WHERE
                    dossier_autorisation.dossier_autorisation = '".$row->dossier_autorisation."'
                    AND
                    dossier_instruction_type.code = '".$row->dossier_instruction_type."'";
            $row->version = $this->db->getOne($sql);
            $this->f->addToLog("getInfosForFoldername(): db->getOne(\"".$sql."\")", VERBOSE_MODE);
            if ( database::isError($row->version)){
                $this->f->addToError("", $row->version, $row->version);
                return false;
            }
            
            //Formatage du numéro de version
            $row->version = str_pad($row->version, 2, "0", STR_PAD_LEFT);

            //Alors on créé l'objet dossier_instruction
            $this->specificMetadata = $row;

        }
    }

}// fin classe
?>