trunk/obj/rapport_instruction.class.php

<?php
//$Id$ 
//gen openMairie le 07/01/2013 15:28

require_once ("../gen/obj/rapport_instruction.class.php");

class rapport_instruction extends rapport_instruction_gen {

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

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

    function rapport_instruction($id,&$db,$debug) {
        $this->constructeur($id,$db,$debug);
    }// fin constructeur
    
    // Modification du style de certains champs
    function setType(&$form,$maj) {
        parent::setType($form,$maj);

        $form->setType('dossier_instruction', 'hidden');
        
        if( $maj < 2 ){           
            // Select pour le proposition de décision
            $form->setType('proposition_decision', 'select');
        }

        // Modification 
        $form->setType('dossier_libelle', 'hiddenstatic');
        
        //Cache les champs pour la finalisation
        $form->setType('om_fichier_rapport_instruction', 'hidden');
        $form->setType('om_final_rapport_instruction', 'hidden');
    }
    
    // Pré-remplir les champs
    function setValsousformulaire(&$form, $maj,$validation,$idxformulaire,$retourformulaire,$typeformulaire,&$db,$DEBUG=null) {
        
        parent::setValsousformulaire($form, $maj,$validation,$idxformulaire,$retourformulaire,$typeformulaire,$db,$DEBUG);
        
        if($maj == 0) {
            
            // Analyse réglementaire
            // Choisi par l'administrateur
            $temp_analyse_reglementaire = explode("\r",$this->f->getParameter('rapport_instruction_analyse_reglementaire'));
            $analyse_reglementaire = "";
            foreach ($temp_analyse_reglementaire as $value) {
                $analyse_reglementaire .= "<p>".$value."</p>";
            }
               
            $form->setVal("analyse_reglementaire_om_html",$analyse_reglementaire);
            
            // Description du projet
            // Libellé des travaux du dossier en cours
            // Création de la requête
            $sql = "SELECT dossier_libelle, 
                        CONCAT(donnees_techniques.am_projet_desc,' ',donnees_techniques.co_projet_desc) as libelle
                    FROM 
                        ".DB_PREFIXE."dossier
                    LEFT JOIN ".DB_PREFIXE."donnees_techniques ON
                                donnees_techniques.dossier_instruction = dossier.dossier
                    WHERE 
                        dossier.dossier = '".$idxformulaire."'";
                        
            // Exécution de la requête
            $res = $db->query($sql);
            $this->f->addToLog("setVal(): db->query(\"".$sql."\");", VERBOSE_MODE);
            if ( database::isError($res)){
                die();
            }
            
            // Si le champ travaux est rempli
            while ($row=&$res->fetchrow(DB_FETCHMODE_ASSOC)){
                
                if ( $row['libelle'] != "" ){
                    
                    $description_projet = $row['libelle'];
                    
                    $form->setVal("description_projet_om_html",$description_projet);
                }

                // Ajout automatique du numéro de dossier d'instruction
                $form->setVal("dossier_libelle", $row['dossier_libelle']);
            }
            
            // Ajout automatique du numéro de dossier d'instruction
            $form->setVal("dossier_instruction",$idxformulaire);
        }
    }
    
    /*
     * Select pour le proposition_decision
     */
    function setSelect(&$form, $maj,&$db,$debug) {
        parent::setSelect($form, $maj,$db,$debug);
        
        // Lors d'un ajout ou d'une modification
        if( $maj < 2 ){
            
            // proposition_decision
            $contenu=array();

            $k = 0;
            $contenu[0][$k]="";
            $contenu[1][$k++]=_('choisir')." "._('proposition_decision');
            
            // Si le paramètre existe et a été remplie
            if ( !is_null($this->f->getParameter('rapport_instruction_proposition_decision'))){
                             
                $donnees = $this->f->getParameter('rapport_instruction_proposition_decision');
                $donnees = explode('<br />', nl2br(htmlentities($donnees)));
                
                // Pour chaque ligne du paramètre, faire une ligne dans le select
                foreach ($donnees as $value) {
                
                    $contenu[0][$k]=$value;
                    $contenu[1][$k++]=$value;
                }
            }
            $form->setSelect("proposition_decision",$contenu);
            
        }

    }


    /**
     * Récupération du numéro de dossier d'instruction à ajouter aux métadonnées
     * @return string numéro de dossier d'autorisation
     */
    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 date de la 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 du 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 de dossier 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 du document à ajouter aux métadonnées
     * @return string Type de document
     */
    protected function getTitle() {
        return "Rapport d'instruction";
    }

    /**
     * Cette méthode permet de stocker en attribut toutes les métadonnées
     * nécessaire à l'ajout d'un document.
     */
    public function getSpecificMetadata() {
        //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 = '".$this->getVal("dossier_instruction")."'";
        $res = $this->db->query($sql);
        $this->f->addToLog("getSpecificMetadata() : 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("getSpecificMetadata() :  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;
        }
    }
    
    /**
     * Surcharge du bouton retour afin de retourner sur le dossier d'instruction selon de cas
     */
    function retoursousformulaire($idxformulaire, $retourformulaire, $val,
                                  $objsf, $premiersf, $tricolsf, $validation,
                                  $idx, $maj, $retour) {
        
        // Ajout et consultation, retour dossier
        if ( ( $maj == 0 && $validation == 0 ) || 
            ( $maj == 3 && $validation == 0 ) ||
            ( $maj == 0 && $validation == 1 ) ){
         
            echo "\n<a class=\"retour\" ";
                echo "href=\"#\" ";
                echo "onclick=\"redirectPortletAction(1,'main');\" ";
                echo ">";
                echo _("Retour");
            echo "</a>\n";
        }
        //Sinon affiche un retour normal
        else {
            
            parent::retoursousformulaire($idxformulaire, $retourformulaire, $val,
                                  $objsf, $premiersf, $tricolsf, $validation,
                                  $idx, $maj, $retour);
        }
    }
                                  
    /**
     * Surcharge pour gérer les actions disponibles dans le portlet
     */
    function checkAccessibility() {
        //
        parent::checkAccessibility();
                
        //Si le document est déjà finalisé, on affiche uniquement le lien de 
        //dé-finalisation
        $om_final_rapport_instruction = $this->getVal("om_final_rapport_instruction");
        if ( isset($this->actions_sup["finalisation"]) &&
            $om_final_rapport_instruction== "t" ){
            
            //On cache le lien d'action
            $this->parameters["actions"]["modifier"] = NULL;
            //On cache le lien de finalisation et on affiche le bon lien pour l'édition
            unset($this->actions_sup["finalisation"]);
            $this->actions_sup["edition"]["lien"] = "../spg/file.php?id=";
            $this->actions_sup["edition"]["id"] = 
                "&amp;obj=rapport_instruction&amp;champ=om_fichier_rapport_instruction";
        }
        //Si le document n'est pas finalisé, on affiche uniquement le lien de 
        //finalisation
        if ( isset($this->actions_sup["definalisation"]) &&
            $om_final_rapport_instruction!= "t" ){
            
            //On cache le lien de finalisation et on affiche le bon lien pour l'édition    
            unset($this->actions_sup["definalisation"]);
            $this->actions_sup["edition"]["lien"] = "../pdf/pdfetat.php?idx=";
            $this->actions_sup["edition"]["id"] = "&amp;obj=rapport_instruction";
        }
        
        $idxformulaire = $this->getParameter("idxformulaire");
        //Si le dossier d'instruction auquel sont rattachées les données techniques
        //est cloturé, on affiche pas les liens du portlet
        if ( $idxformulaire != '' ){
                
            //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->actions_sup["finalisation"] = NULL;
                $this->actions_sup["definalisation"] = NULL;
            }
        }
        
        // 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->actions_sup["finalisation"] = NULL;
            $this->actions_sup["definalisation"] = 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 instructeur et que le dossier est cloturé
        if ( $this->f->isUserInstructeur() && 
            $this->f->getStatutDossier($this->getVal("idxformulaire")) == "cloture" 
            && $this->getParameter("maj") != 3) {

            return false;
        }
        //
        return true;
    }
    
    /**
     * 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 '../pdf/pdfetat.php';
            
            //Métadonnées du document
            $metadata = array(
                'filename' => 'rapport_instruction_'.$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_rapport_instruction");

            $metadata = array_merge($metadata, $spe_metadata);
            //Si le document a déjà été finalisé
            //on met à jour le document mais pas son uid
            if ( $this->getVal("om_fichier_rapport_instruction") != '' ){
                $uid = $this->f->storage->update(
                    $this->getVal("om_fichier_rapport_instruction"), $pdf_output, $metadata);
            }
            //Sinon, on joute le document et on 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_rapport_instruction");
            
            //On dé-finalise avant de finaliser
            if ( $uid == '' || $uid == 'OP_FAILURE' ){
                // Message d'echec (saut d'une ligne supplementaire avant le
                // message pour qu'il soit mis en evidence)
                $this->addToLog(
                    _("Finalisation non enregistree")." - ".
                    _("id rapport_instruction")." = ".$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 = '../pdf/pdfetat.php?obj=rapport_instruction&idx='.$id;
                
                //Ajout des actions
                //Si l'utilisateur a le droit de modifier l'objet
                if ( $this->f->isAccredited('instruction') || 
                    $this->f->isAccredited('instruction_modifier') ){
                        
                    $actions["modifier"] = ($sousform!='')?
                        '<li><a href="#" onclick="ajaxIt(\'instruction\',
                        \'../scr/sousform.php?obj=rapport_instruction&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=rapport_instruction&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('instruction') || 
                    $this->f->isAccredited('instruction_supprimer') ){
                        
                    $actions["supprimer"] = ($sousform!='')?
                        '<li><a href="#" onclick="ajaxIt(\'instruction\',
                        \'../scr/sousform.php?obj=rapport_instruction&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=rapport_instruction&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 = '../spg/file.php?obj=rapport_instruction&'.
                    'champ=om_fichier_rapport_instruction&id='.$id;
            }

            
            $retour = array(
                "portlet"=> "<a href=\"#\" onclick=\"finalizeDocument(".
                    $id.", 'rapport_instruction', '".$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
            );
            
            //Modifie uniquement les valeurs des champs concernant la finalisation 
            //du document
            $this->valF = '';
            $this->valF["om_final_rapport_instruction"] = ($status==1)?TRUE:FALSE;
            $this->valF["om_fichier_rapport_instruction"] = $uid;
            
            // 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);
                    
                // 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, $this->valF, 
                    DB_AUTOQUERY_UPDATE, $this->getCle($id));
                // 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 rapport_instruction")." = ".$id." - ".
                    _("uid fichier")." = ".$uid
                );
                return -1;
            }
        }
        // Si le document n'a pas été stocké
        else{
            $this->addToLog(
                _("Finalisation non enregistree")." - ".
                _("id rapport_instruction")." = ".$id." - ".
                _("uid fichier")." = ".$uid
            );
            return -1;
        }
    }

    /**
     * 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_instruction");
        }

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

    }
}// fin classe
?>