trunk/obj/lot.class.php

<?php
//$Id: lot.class.php 4698 2015-04-30 16:17:47Z nmeucci $ 
//gen openMairie le 08/11/2012 14:59

require_once ("../gen/obj/lot.class.php");
require_once ("../obj/lien_lot_demandeur.class.php");

class lot extends lot_gen {


    function __construct($id,&$db,$debug) {
        // On active les nouvelles actions
        $this->activate_class_action = true;
        $this->constructeur($id,$db,$debug);

    }// fin constructeur

    /**
     * Définition des actions disponibles sur la classe.
     *
     * @return void
     */
    function init_class_actions() {
        //
        parent::init_class_actions();

        // ACTION - 001 - ajouter
        //        
        $this->class_actions[0]["condition"] = "is_ajoutable";
        
        // ACTION - 001 - modifier
        // 
        $this->class_actions[1]["condition"] = "is_modifiable";
        
        // ACTION - 002 - supprimer
        //
        $this->class_actions[2]["condition"] = "is_supprimable";

        // ACTION - 100 - donnees_techniques
        // Affiche dans un overlay les données techniques
        $this->class_actions[100] = array(
            "identifier" => "donnees_techniques",
            "portlet" => array(
                "type" => "action-self",
                "libelle" => _("Données techniques"),
                "order" => 100,
                "class" => "rediger-16",
            ),
            "view" => "view_donnees_techniques",
            "permission_suffix" => "donnees_techniques_consulter",
        );

        // ACTION - 100 - transferer_lot_nouveaux_demandeurs
        // Transfert les lots de demandeur
        $this->class_actions[110] = array(
            "identifier" => "transferer_lot_nouveaux_demandeurs",
            "portlet" => array(
                "type" => "action-direct",
                "libelle" => _("Transferer ce lot aux nouveaux demandeurs"),
                "order" => 110,
                "class" => "transferer-16",
            ),
            "permission_suffix" => "transferer",
            "method" => "transferer_lot_demandeurs"
        );
    }

    /**
     * TREATMENT - transferer_lot_demandeurs.
     * 
     * Permet de permet de transferer les lots aux nouveau demandeur.
     * 
     *
     * @param array $val  valeurs soumises par le formulaire
     * @param null  $dnu1 @deprecated Ancienne ressource de base de données.
     * @param null  $dnu2 @deprecated Ancien marqueur de débogage.
     *
     * @return boolean
     */
    function transferer_lot_demandeurs($val = array(), &$dnu1 = null, $dnu2 = null) {

        // Cette méthode permet d'exécuter une routine en début des méthodes
        // dites de TREATMENT.
        $this->begin_treatment(__METHOD__);


        /*Donnees*/
        $idxDossier = $this->getVal("dossier");
        //Si les liaisons n'existent pas déjà
        $sql = "SELECT 
                    lot.lot as lot, lien_lot_demandeur.demandeur as demandeur
                FROM
                    ".DB_PREFIXE."lien_dossier_demandeur
                INNER JOIN ".DB_PREFIXE."lien_lot_demandeur
                    ON
                        lien_lot_demandeur.demandeur = lien_dossier_demandeur.demandeur
                INNER JOIN ".DB_PREFIXE."lot
                    ON 
                        lot.lot = ".$this->getVal($this->clePrimaire)."
                WHERE lien_dossier_demandeur.dossier = '$idxDossier'";

        $res = $this->db->query($sql);
        $this->addToLog(__METHOD__."(): db->query(\"".$sql."\");", VERBOSE_MODE); 
        
        // Si une erreur survient
        if (database::isError($res, true)) {

            // Appel de la methode de recuperation des erreurs
            $this->erreur_db($res->getDebugInfo(), $res->getMessage(), '');
            $res->free();
            $this->correct = false;
            // Termine le traitement
            return $this->end_treatment(__METHOD__, false);
        }
        
        // Récupère la liste des demandeurs associés aux lot et dossier d'instruction
        $listDemandeurLie = array();
        if ($res->numrows() > 0) {
            
            $i = 0;        
            while($row=& $res->fetchRow(DB_FETCHMODE_ASSOC)){
                 
                 $listDemandeurLie[$i++] = $row['demandeur'];
            }
        }
        echo (" nbDossierDemandeurIJ: " . $res->numrows());
        
        $res->free();
        // Récupère les demandeurs du dossier d'instruction
        $sql = "SELECT 
                    lien_dossier_demandeur.demandeur as demandeur, 
                    lien_dossier_demandeur.petitionnaire_principal as pp
                FROM
                    ".DB_PREFIXE."lien_dossier_demandeur
                WHERE lien_dossier_demandeur.dossier = '$idxDossier'";

        $res = $this->db->query($sql);
        $this->addToLog(__METHOD__."(): db->query(\"".$sql."\");", VERBOSE_MODE);
        
        // Si une erreur survient
        if (database::isError($res, true)) {

            // Appel de la methode de recuperation des erreurs
            $this->erreur_db($res->getDebugInfo(), $res->getMessage(), '');
            $res->free();
            $this->correct = false;
            // Termine le traitement
            return $this->end_treatment(__METHOD__, false);
        }
        
        echo (" nbDossierDemandeurWD: " . $res->numrows());
        
        // Transfert des demandeurs entre le dossier et le lot
        if (count($listDemandeurLie) != $res->numrows()){
            
            //Supprime les anciens liens
            $sql = "DELETE FROM ".DB_PREFIXE."lien_lot_demandeur 
                    WHERE lien_lot_demandeur.lot = ".$this->getVal($this->clePrimaire);

            $res2 = $this->db->query($sql);

            echo (" delLotDemandeur: " . $res2);
            $this->addToLog(__METHOD__."(): db->query(\"".$sql."\");", VERBOSE_MODE);
            
        
            // Si une erreur survient
            if (database::isError($res2, true)) {

                // Appel de la methode de recuperation des erreurs
                $this->erreur_db($res2->getDebugInfo(), $res2->getMessage(), '');
                $res2->free();
                $this->correct = false;
                // Termine le traitement
                return $this->end_treatment(__METHOD__, false);
            }
            
            $ret = "";


            // Créé autant de liaisons que de demandeurs liés au dossier d'instruction
            while($row=& $res->fetchRow(DB_FETCHMODE_ASSOC)){
                
                if (!in_array($row['demandeur'], $listDemandeurLie)){
                       
                    $valLLD = array();
                    $valLLD['lien_lot_demandeur'] = NULL;
                    $valLLD['lot'] = $this->getVal($this->clePrimaire);
                    $valLLD['demandeur'] = $row['demandeur'];
                    $valLLD['petitionnaire_principal'] = $row['pp'];
                        
                    $lld = new lien_lot_demandeur("]", $this->db, DEBUG);
                    $lld->valF = "";
                                            
                    $lld->ajouter($valLLD, $this->db, DEBUG) ;
                    
                    $sql = "SELECT
                                civilite.code as code, 
                                CASE WHEN demandeur.qualite='particulier' 
                                    THEN TRIM(CONCAT(demandeur.particulier_nom, ' ', demandeur.particulier_prenom)) 
                                    ELSE TRIM(CONCAT(demandeur.personne_morale_raison_sociale, ' ', demandeur.personne_morale_denomination)) 
                                END as nom
                            FROM
                                ".DB_PREFIXE."demandeur
                            LEFT JOIN
                                ".DB_PREFIXE."civilite
                                ON
                                    demandeur.particulier_civilite = civilite.civilite OR
                                    demandeur.personne_morale_civilite = civilite.civilite
                            WHERE demandeur.demandeur = ".$row['demandeur'];
    
                    $res2 = $this->db->query($sql);
                    $this->addToLog(__METHOD__."(): db->query(\"".$sql."\");", VERBOSE_MODE);

                    // Si une erreur survient
                    if (database::isError($res2, true)) {

                        // Appel de la methode de recuperation des erreurs
                        $this->erreur_db($res2->getDebugInfo(), $res2->getMessage(), '');
                        $res2->free();
                        $this->correct = false;
                        // Termine le traitement
                        return $this->end_treatment(__METHOD__, false);
                    }

                    $row=& $res2->fetchRow(DB_FETCHMODE_ASSOC);
                    $ret .= $row['code']. " " . $row['nom'] . "<br/>" ;

                    $res2->free();
                }
            }
            $res->free();
            
            //Envoie du message de retour
            $this->addToMessage(_("Transfert effectue avec succès"));
        }
        //Sinon
        else {
            //Envoie du message de retour
            $this->addToMessage(_("Les demandeurs ont déjà été transférés"));
        }

        // Termine le traitement
        return $this->end_treatment(__METHOD__, true);
    }

    /**
     * Ouvre le sous-formulaire passé en paramètre en overlay
     * en mode ajout si aucun n'existe sinon en mode modifier.
     *
     * @return void
     */
    function display_overlay($idx = "", $obj = "") {
        // Seulement si le numéro de dossier est fourni
        if (isset($idx) && !empty($idx) 
            && isset($obj) && !empty($obj)){

            // Vérifie que l'objet n'existe pas
            $sql = "SELECT donnees_techniques
            FROM ".DB_PREFIXE."donnees_techniques
            WHERE donnees_techniques.lot = ".$idx;
            // Ajout au log
            $this->f->addToLog($obj.".php: db->query(\"".$sql."\");", VERBOSE_MODE);
            // Exécution de la requête 
            $res = $this->db->query($sql);
            $this->f->isDatabaseError($res);

            // S'il n'y en a pas, afficher le formulaire d'ajout
            if ($res->numrows() == 0) {
                //
                echo '
                    <script type="text/javascript" >
                        overlayIt(\''.$obj.'\',\'sousform.php?obj=donnees_techniques'. 
                            '&retourformulaire=lot&action=0&idxformulaire='. $idx. '\', 1);
                    </script>
                ';
            }
            // Sinon afficher l'objet en consultation
            else {
                //
                $row = & $res->fetchRow(DB_FETCHMODE_ASSOC);
                //
                echo '
                    <script type="text/javascript" >
                        overlayIt(\''.$obj.'\',\'sousform.php?obj=donnees_techniques'. 
                            '&retourformulaire=lot&action=3&idxformulaire='. $idx. '&idx=' . $row['donnees_techniques'] .'&objsf='.$obj.'\', 1);
                    </script>
                ';
            }
        }
    }

    /**
     * CONDITION - is_ajoutable.
     *
     * Condition pour pouvoir ajouter
     *
     * @return boolean
     */
    function is_ajoutable() {
        // Test du bypass
        if ($this->f->isAccredited("lot_ajouter_bypass")) {
            return true;
        }
        // Test des autres conditions
        return $this->is_ajoutable_or_modifiable_or_supprimable();
    }

    /**
     * CONDITION - is_modifiable.
     *
     * Condition pour afficher le bouton modifier
     *
     * @return boolean
     */
    function is_modifiable() {
        // Test du bypass
        if ($this->f->isAccredited("lot_modifier_bypass")) {
            return true;
        }
        // Test des autres conditions
        return $this->is_ajoutable_or_modifiable_or_supprimable();
    }

    /**
     * CONDITION - is_supprimable.
     *
     * Condition pour afficher le bouton supprimer
     * @return boolean
     */
    function is_supprimable() {
        // Test du bypass
        if ($this->f->isAccredited("lot_supprimer_bypass")) {
            return true;
        }
        // Test des autres conditions
        return $this->is_ajoutable_or_modifiable_or_supprimable();
    }


    /**
     * Conditions pour afficher les boutons modifier et supprimer
     *
     * @return boolean
     */
    function is_ajoutable_or_modifiable_or_supprimable() {
        //
        $dossier = $this->getVal("dossier");
        /**
         * Tester si le dossier est cloturé , de la meme division, instructeur, admin (?)
         */
        if($this->f->isUserInstructeur() === true
            && isset($this->f->om_utilisateur["division"])
            && $this->f->om_utilisateur["division"] != $this->getDivisionFromDossier()){
            return false;
        }
        //
        if ($this->f->isUserInstructeur() && $this->f->getStatutDossier($dossier) == "cloture"){
            return false;
        }
        return true;
    }


    /**
     * VIEW - view_donnees_techniques.
     *
     * Ouvre le sous-formulaire en ajaxIt dans un overlay.
     * Cette action est bindée pour utiliser la fonction popUpIt.
     *
     * @return void
     */
    function view_donnees_techniques() {
        $dossier = $this->getVal("dossier");
        // Vérification de l'accessibilité sur l'élément
        $this->checkAccessibility();
        //
        $this->display_overlay(
            $this->getVal($this->clePrimaire),
            "donnees_techniques"
        );
    }

    /**
     * Méthode qui effectue les requêtes de configuration des champs.
     *
     * @param object  &$form Formulaire.
     * @param integer $maj   Mode du formulaire.
     *
     * @return void
     */
    public function setSelect(&$form,$maj) {
        // Le parent n'est pas appelé délibérament pour cause de performance.
        // En effet, celui-ci charge toutes les données de la table dossier et
        // de la table dossier_autorisation.
    }


    function triggerAjouterApres($id, &$db, $val, $DEBUG) {
        parent::triggerAjouterApres($id, $db, $val, $DEBUG);

        // Si en sous-formulaire
        if($this->getParameter("idxformulaire") != "") {

            // Insertion du lien demandeur/lot
            require_once ("../obj/lien_lot_demandeur.class.php");
            $lld = new lien_lot_demandeur("]", $db, $DEBUG);
            $sqlDemandeur = "SELECT * FROM ".DB_PREFIXE."lien_dossier_demandeur 
                                WHERE dossier='".$this->getParameter("idxformulaire")."'";
            $res = $db->query($sqlDemandeur);
            $this->f->addToLog("triggerAjouterApres() : db->query(\"".$sqlDemandeur."\");", VERBOSE_MODE);
            if ( database::isError($res)){
                die();
            }
            while($row = $res->fetchRow(DB_FETCHMODE_ASSOC)) {
                unset($row['lien_dossier_demandeur']);
                unset($row['dossier']);
                $row['lien_lot_demandeur'] = "";
                $row['lot'] = $this->valF["lot"];
                $lld->ajouter($row, $db, $DEBUG);
            }

            // Ajoute une ligne dans les données techniques
            $add_dt = $this->add_donnees_techniques();
            //
            if ($add_dt === false) {
                //
                $this->addToMessage(_("Impossible d'associer des données techniques au lot.")." "._("Veuillez contacter votre administrateur."));
                return false;
            }
        }

        //
        return true;
    }

    /**
     * Cache le champ dossier_autorisation
     */
    function setType(&$form,$maj) {
        parent::setType($form,$maj);
        
        $form->setType('dossier_autorisation', 'hidden');
        $form->setType('dossier','hidden');
        
        if($maj == "110") {
            $form->setType('lot', 'hidden');
            $form->setType('libelle', 'hidden');
            $form->setType('dossier_autorisation', 'hidden');
            $form->setType('dossie', 'hidden');
        }
    }


    /**
     * Permet d'affecter des valeurs aux champs de sous formulaires
     */
    function setValsousformulaire(&$form,$maj,$validation,$idxformulaire,$retourformulaire,$typeformulaire,&$db,$DEBUG=null) {
        //
        if($validation == 0) {
            //
            $is_in_context_of_di = $this->is_in_context_of_foreign_key("dossier", $this->getParameter('retourformulaire'));
            //
            $is_in_context_of_da = $this->is_in_context_of_foreign_key("dossier_autorisation", $this->getParameter('retourformulaire'));

            //
            if($is_in_context_of_di === true) {
                //
                $form->setVal('dossier', $this->getParameter('idxformulaire'));
                // Instancie le dossier
                $inst_di = $this->get_inst_dossier($this->getParameter('idxformulaire'));
                // Récupère la valeur du dossier d'autorisation
                $form->setVal('dossier_autorisation', $inst_di->getVal('dossier_autorisation'));
            }

            //
            if($is_in_context_of_da === true) {
                //
                $form->setVal('dossier_autorisation', $this->getParameter('idxformulaire'));
            }
        }// fin validation
    }// fin setValsousformulaire
    
    /**
     * Ajout de la liste des demandeurs
     */
    function sousformSpecificContent($maj) {

        //En consultation
        if ( $maj == 3 ){
            
            //Récupère la liste des demandeurs
            $sql = "SELECT
                        civilite.code as code, 
                        CASE WHEN demandeur.qualite='particulier' 
                            THEN TRIM(CONCAT(demandeur.particulier_nom, ' ', demandeur.particulier_prenom)) 
                            ELSE TRIM(CONCAT(demandeur.personne_morale_raison_sociale, ' ', demandeur.personne_morale_denomination)) 
                        END as nom,
                        lien_lot_demandeur.petitionnaire_principal as petitionnaire_principal,
                        demandeur.type_demandeur as type_demandeur
                    FROM
                        ".DB_PREFIXE."lien_lot_demandeur
                    LEFT JOIN
                        ".DB_PREFIXE."demandeur
                        ON
                            lien_lot_demandeur.demandeur = demandeur.demandeur
                    LEFT JOIN
                        ".DB_PREFIXE."civilite
                        ON
                            demandeur.particulier_civilite = civilite.civilite OR
                            demandeur.personne_morale_civilite = civilite.civilite
                    WHERE lien_lot_demandeur.lot = ".$this->val[array_search('lot', $this->champs)]."
                    ORDER BY demandeur.type_demandeur DESC";
                    
            $res = $this->f->db->query($sql);
            $this->f->addToLog("sousformSpecificContent() : db->query(\"".$sql."\")");
            if ( database::isError($res)){
                die();
            }
            
            //Affichage des données
            echo "<div class=\"field field-type-static\">";
                echo "<div class=\"form-libelle\">";
                    echo "<label id=\"lib-libelle\" class=\"libelle-demandeur\" for=\"demandeur\">";
                        echo _("demandeur");
                    echo "</label>";
                echo "</div>";
                echo "<div class=\"form-content\">";
                    echo "<span id=\"demandeur\" class=\"field_value\">";
            
                        $listDemandeur = "";
                        //La liste des demandeurs
                        while($row=& $res->fetchRow(DB_FETCHMODE_ASSOC)){
                     
                            //Ordonne l'affichage des demandeur
                            if ( $row['petitionnaire_principal'] == 't' ){
                                
                                $listDemandeur =  $row['code']. " " . $row['nom'] . ", " . _("petitionnaire principal") . "<br/>".$listDemandeur;
                            }
                            else {
                                
                                $listDemandeur .=  $row['code']. " " . $row['nom'] . ", " . $row['type_demandeur'] . "<br/>";
                            }
                        }
                        echo $listDemandeur;
                    echo "</span>";
                echo "</div>";
            echo "</div>";
        }
    }

    /**
     * Surcharge pour gérer les actions disponibles dans le portlet
     */
    function checkAccessibility() {
        //
        parent::checkAccessibility();
        
        $idxformulaire = $this->getParameter("idxformulaire");
        $retourformulaire = $this->getParameter("retourformulaire");
        //Si le dossier d'instruction auquel est rattaché le lot 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["transferer"] = NULL;
                
                //Si le dossier lié n'a pas de données techniques
                if ( !$this->hasDonneesTechniquesDossier($idxformulaire) ){
                    $this->actions_sup["editer_donnees"] = NULL;
                }
            }
        }

        /*
         * Si l'utilisateur est un instructeur sans bypass sur l'action et si
         * sa division ne correspond pas à celle du dossier alors on n'affiche
         * pas cette action dans le portlet.
         */

        $instr_with_different_div = false;
        if ($this->f->isUserInstructeur()
            && isset($this->f->om_utilisateur["division"])
            && $this->f->om_utilisateur["division"] != $this->getDivisionFromDossier()) {
            $instr_with_different_div = true;
        }

        // MODIFIER
        if ($this->f->can_bypass("lot", "modifier") == false
            && $instr_with_different_div == true) {
            //
            $this->parameters["actions"]["modifier"] = NULL;
        }
        // SUPPRIMER
        if ($this->f->can_bypass("lot", "supprimer") == false
            && $instr_with_different_div == true) {
            //
            $this->parameters["actions"]["supprimer"] = NULL;
        }
        // TRANSFERER
        if ($this->f->can_bypass("lot", "transferer") == false
            && $instr_with_different_div == true) {
            //
            unset($this->actions_sup["transferer"]);
        }
        // EDITER DONNEES TECHNIQUES
        if ($this->f->can_bypass("lot", "editer_donnees") == false
            && $instr_with_different_div == true) {
            //
            unset($this->actions_sup["editer_donnees"]);
        }
    }
    
    /**
     * Cette methode est à surcharger elle permet de tester dans chaque classe
     * des droits spécifiques en fonction des données
     */
    function canAccess() {

        $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;
        }

        // Récupération du bypass adéquat
        // XXX - actions spécifiques non testées
        $bypass = false;
        if (($this->f->can_bypass("lot", "ajouter") == true && $this->getParameter("maj") == 0)
            || ($this->f->can_bypass("lot", "modifier") == true && $this->getParameter("maj") == 1)
            || ($this->f->can_bypass("lot", "supprimer") == true && $this->getParameter("maj") == 2)) {
            $bypass = true;
        }
        // Si, hors mode consulter, l'utilisateur est un instructeur sans bypass
        // dont la division ne correspond pas à celle du dossier
        if ($this->getParameter("maj") != 3 && $bypass == false && $this->f->isUserInstructeur()
            && $this->f->om_utilisateur["division"] != $this->getDivisionFromDossier()) {
            //
            return false;
        }
        //
        return true;
    }
    
    /**
     * Retourne true s'il y a des données techniques lié au dossier d'instruction
     * @param string $idx Identifiant du dossier d'instruction
     * @return boolean S'il y a des données techniques
     */
    function hasDonneesTechniquesDossier($idx){
        
        //Si l'identifiant du dossier d'instruction founi est correct
        if ( $idx != '' ){
            
            //On récupère le statut de l'état du dossier d'instruction à partir de 
            //l'identifiant du dossier
            $sql = "SELECT donnees_techniques.donnees_techniques
                FROM ".DB_PREFIXE."donnees_techniques
                LEFT JOIN
                    ".DB_PREFIXE."dossier
                    ON
                        donnees_techniques.dossier_instruction = dossier.dossier
                WHERE dossier.dossier = '".$idx."'";
            $donnees_techniques = $this->db->query($sql);
            $this->f->addToLog("hasDonneesTechniquesDossier() : db->query(\"".$sql."\")", VERBOSE_MODE);
            if ( database::isError($donnees_techniques)){
                die();
            }
            
            if ( $donnees_techniques->numRows() > 0 ){
                return TRUE;
            }
        }
        return FALSE;
    }

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

    }


    /**
     * Cette méthode est appelée lors de la suppression d’un objet, elle permet
     * de vérifier si l’objet supprimé n’est pas lié à une autre table pour en
     * empêcher la suppression.
     *
     * @param mixed $id Identifiant de l'objet.
     *
     * @return boolean
     */
    public function cleSecondaire($id) {
        // Surcharge pour éviter les contrôles sur les tables liées en cas
        // de suppression
        return true;
    }


    /**
     * Supprime le lien entre le lot et les demandeurs.
     *
     * @param integer $lot Identifiant de l'objet.
     *
     * @return boolean
     */
    protected function delete_lien_lot_demandeur($lot) {

        // SQL
        $sql = "DELETE FROM ".DB_PREFIXE."lien_lot_demandeur
                WHERE lot = ".$lot;
        // Résultat
        $res = $this->f->db->query($sql);
        // Log
        $this->f->addToLog(__METHOD__."() : db->query(\"".$sql."\")");
        //
        if ($this->f->isDatabaseError($res, true)) {
            return false;
        }

        //
        return true;
    }


    /**
     * Supprime les données techniques liées.
     *
     * @param integer $lot Identifiant de l'objet.
     *
     * @return boolean
     */
    protected function delete_donnees_techniques($lot) {

        // SQL
        $sql = "DELETE FROM ".DB_PREFIXE."donnees_techniques
                WHERE lot = ".$lot;
        // Résultat
        $res = $this->f->db->query($sql);
        // Log
        $this->f->addToLog(__METHOD__."() : db->query(\"".$sql."\")");
        //
        if ($this->f->isDatabaseError($res, true)) {
            return false;
        }

        //
        return true;
    }


    /**
     * Permet d’effectuer des actions avant la modification des données dans la
     * base.
     *
     * @param mixed  $id    Identifiant de l'objet.
     * @param object &$db   Instance BDD.
     * @param array  $val   Liste des valeurs.
     * @param mixed  $DEBUG Mode du debug.
     *
     * @return boolean
     */
    public function triggersupprimer($id, &$db, $val, $DEBUG) {

        // Suppression du lien entre le lot et les demandeurs
        $delete_lien_lot_demandeur = $this->delete_lien_lot_demandeur($id);
        //
        if ($delete_lien_lot_demandeur === false) {
            //
            return false;
        }

        // Suppression des données techniques lié au lot
        $delete_donnees_techniques = $this->delete_donnees_techniques($id);
        //
        if ($delete_donnees_techniques === false) {
            //
            return false;
        }

        //
        return true;
    }


    /**
     * Ajout les données techniques au lot.
     *
     * @return boolean
     */
    protected function add_donnees_techniques() {

        // Instancie la classe donnees_techniques en ajout
        require_once '../obj/donnees_techniques.class.php';
        $inst_dt = new donnees_techniques("]", $this->f->db, DEBUG);

        // Toutes les valeurs sont mis à null
        foreach($inst_dt->champs as $value) {
            //
            $valF[$value] = null;
        }

        // Ajout de l'identifiant du lot
        $valF['lot'] = $this->valF[$this->clePrimaire];
        // Identifiant du CERFA
        $valF['cerfa'] = $this->get_cerfa_id_by_dossier_autorisation($this->valF['dossier_autorisation']);
        // Si aucun CERFA n'est identifié
        if ($valF['cerfa'] === '' || $valF['cerfa'] === null) {
            //
            $this->f->addToLog(__METHOD__."() : ERROR - "._("Aucun CERFA paramétré."), DEBUG_MODE);
            return false;
        }

        // Ajoute l'enregistrement dans la table donnees_techniques
        $add = $inst_dt->ajouter($valF, $this->f->db, DEBUG);
        //
        if ($add === false) {
            //
            $this->f->addToLog(__METHOD__."() : ERROR - "._("Impossible d'ajouter les données techniques du lot."), DEBUG_MODE);
            return false;
        }

        //
        return true;
    }


    /**
     * Récupère l'instance du dossier.
     *
     * @param string $dossier Identifiant de l'objet.
     *
     * @return object
     */
    public function get_inst_dossier($dossier = null) {
        //
        return $this->get_inst_common("dossier", $dossier);
    }


    /**
     * Récupère l'instance du dossier.
     *
     * @param string $dossier_autorisation Identifiant de l'objet.
     *
     * @return object
     */
    public function get_inst_dossier_autorisation($dossier_autorisation = null) {
        //
        return $this->get_inst_common("dossier_autorisation", $dossier_autorisation);
    }


    /**
     * Récupère l'instance du dossier.
     *
     * @param integer $dossier_autorisation_type_detaille Identifiant de l'objet.
     *
     * @return object
     */
    public function get_inst_dossier_autorisation_type_detaille($dossier_autorisation_type_detaille) {
        //
        return $this->get_inst_common("dossier_autorisation_type_detaille", $dossier_autorisation_type_detaille);
    }


    /**
     * Récupère le cerfa des lots pour afficher les bonnes données techniques.
     *
     * @param string $da Identifiant de l'objet.
     *
     * @return integer
     */
    public function get_cerfa_id_by_dossier_autorisation($da) {

        // Instancie le dossier d'autorisation
        $inst_da = $this->get_inst_dossier_autorisation($da);

        // Instancie le type détaillé du dossier d'autorisation
        $inst_datd = $this->get_inst_dossier_autorisation_type_detaille($inst_da->getVal('dossier_autorisation_type_detaille'));

        //
        return $inst_datd->getVal('cerfa_lot');

    }


}// fin classe
?>