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(
            "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_instruction = $this->getVal("om_final_consultation");
        if ( $om_final_instruction== "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;
        }
        //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_instruction!= "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";
        }
        
        $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;
                $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->isUserServiceExt()) {
            // 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', 'hidden');
            $form->setType('date_reception', 'hidden');
            $form->setType('date_limite', 'hidden');
            $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") {
                    $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', 'hidden');
                $form->setType('date_retour', 'hidden');
                $form->setType('date_reception', 'hidden');
                $form->setType('date_limite', 'hidden');
                $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->moisdate($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').
            "scr/form.php?obj=consultation&action=3&idx=".$this->valF['consultation']."' >".
            _("Lien interne (services VDM)")."</a> "._("ou")." <a href='".$this->f->getParameter('services_consultes_lien_externe').
            "scr/form.php?obj=consultation&action=3&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') != "") {
            // 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']);
                    $msgenque->enqueueMessage($msgenque::$ERP_DEMANDE_INSTRUCTION_PC);
                }
                
                // 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']);
                    $msgenque->enqueueMessage($msgenque::$ERP_CONSULTATION_CONFORMITE);                
                }
            }
        } // fin de if($this->f->getParameter('option_erp'))
        
        // 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;

    }

    // =============================================
    // calcul de date avec ajout de mois (delais)
    // [add months (delay) and calculation final date]
    // limite ? => voir fonction instruction
    // =============================================
    function moisdate($date,$delaimois) {
        // rajout de mois à une date (moins de 12)
        $temp = explode("-" , $date);
        $jour = (int) $temp[2];
        $mois = (int) $temp[1];
        $annee = (int) $temp[0];
        $mois=$mois+$delaimois;
        // calcul mois annee
        if($mois>12){
            $mois=$mois-12;
            $annee=$annee+1;
        }
         // Calcul du nombre de jours dans le mois sélectionné
         switch($mois) {
            case "2":
                if ($annee % 4 == 0 && $annee % 100 != 0 || $annee % 400 == 0)
                    $jourmax = 29;
                else
                    $jourmax = 28;
            break;
            case "4":
            case "6":
            case "9":
            case "11":
                $jourmax = 30;
                break;
            default:
                $jourmax = 31;
        }
        if ($jour > $jourmax)
            $jour = $jourmax;
        return $annee."-".$mois."-".$jour ;
    }

    // =============================================
    // 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) {
        parent::setSelect($form, $maj,$db,$debug);
        
        //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 != '' ){
            // 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);
            } 
        }
    }


    /**
     * 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;

        }
    }

    function setSubEnt($subEnt, $val = array(), $maj) {
        //$this->subEnt = $subEnt." -> "."aaaa";
    }

}// fin classe
?>