trunk/obj/document_numerise.class.php

<?php
//$Id$ 
//gen openMairie le 02/05/2013 15:03

require_once ("../gen/obj/document_numerise.class.php");
require_once("../services/outgoing/messageenqueuer.php");

class document_numerise extends document_numerise_gen {

    //Métadonnées spécifiques
    var $metadata = array(
        "uid" => array(
            "dossier" => "getDossier",
            "dossier_version" => "getDossierVersion",
            "numDemandeAutor" => "getNumDemandeAutor",
            "anneemoisDemandeAutor" => "getAnneemoisDemandeAutor",
            "typeInstruction" => "getTypeInstruction",
            "statutAutorisation" => "getStatutAutorisation",
            "typeAutorisation" => "getTypeAutorisation",
            "dateEvenementDocument" => "getDateEvenementDocument",
            "filename" => "getFilename",
            "groupeInstruction" => 'getGroupeInstruction',
            "title" => 'getTitle',
        ),
    );

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

    /** @var boolean Les nouvelles actions sont activées sur cet objet */
    var $activate_class_action;

    function document_numerise($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 - 000 - 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 - 004 - view_tab
        // Interface spécifique du tableau des pièces
        $this->class_actions[4] = array(
            "identifier" => "view_tab",
            "view" => "view_tab",
            "permission_suffix" => "tab",
        );
    }

    /**
     * VIEW - view_tab
     * 
     * Cette vue permet d'afficher l'interface spécifique du tableau
     * des pièces (liste et bouton d'ajout).
     *
     * @return void
     */
    function view_tab() {
        // Vérification de l'accessibilité sur l'élément
        $this->checkAccessibility();
        //
        echo "\n<div id=\"sousform-document_numerise\">\n";
        echo "\n<!-- ########## START FORMULAIRE ########## -->\n";
        echo "<div class=\"formEntete ui-corner-all\">\n";
        //
        ($this->f->get_submitted_get_value('idxformulaire')!==null ? $idxformulaire = $this->f->get_submitted_get_value('idxformulaire') : $idxformulaire = "");
        ($this->f->get_submitted_get_value('retourformulaire')!==null ? $retourformulaire = $this->f->get_submitted_get_value('retourformulaire') : $retourformulaire = "");

        //L'identifiant du dossier est $idxformualire de base pour les objets dossier_instruction
        //Depuis l'objet dossier_autorisation $dossier posséderas le numéros du dossier d'autorisation
        $dossier = $idxformulaire;

        //Si le formulaire est demande_avis_encours ou demande_avis_passee
        if ($retourformulaire == 'demande_avis_encours' || $retourformulaire == 'demande_avis_passee') {

            // Récupération du dossier en fonction du numéro de consultation
            $sql = "SELECT dossier 
                    FROM ".DB_PREFIXE."consultation 
                    WHERE consultation=$idxformulaire";
            $dossier = $this->f->db->getone($sql);
            $this->f->addToLog(__METHOD__."() : db->getone(\"".$sql."\");", VERBOSE_MODE);
            $this->f->isDatabaseError($dossier);
        }

        // Récupération des documents numérisés
        $select = "SELECT  document_numerise.document_numerise as document_numerise,
                        document_numerise.date_creation as date_creation,
                        document_numerise_type_categorie.libelle as categorie,
                        document_numerise.nom_fichier as nom_fichier,
                        document_numerise_type.libelle as type_document,
                        document_numerise.uid as uid ";

        //table de la requête
        $from = "FROM ".DB_PREFIXE."document_numerise 
                    LEFT JOIN ".DB_PREFIXE."document_numerise_type
                        ON document_numerise.document_numerise_type = document_numerise_type.document_numerise_type
                    LEFT JOIN ".DB_PREFIXE."document_numerise_type_categorie
                        ON document_numerise_type.document_numerise_type_categorie = document_numerise_type_categorie.document_numerise_type_categorie ";
        if ($retourformulaire == 'dossier_autorisation') {
            $select .= ", dossier.dossier as dossier ";
            $from .= " LEFT JOIN ".DB_PREFIXE."dossier 
                            ON document_numerise.dossier = dossier.dossier 
                        LEFT JOIN ".DB_PREFIXE."dossier_autorisation
                            ON dossier.dossier_autorisation = dossier_autorisation.dossier_autorisation ";
        }

        // La condition de la requête
        $where = " WHERE document_numerise.dossier = '$dossier' ";
        // Si le formulaire est celui des dossiers d'autorisations
        if ($retourformulaire == 'dossier_autorisation') {
            $where = " WHERE dossier_autorisation.dossier_autorisation = '$dossier' 
                    AND (document_numerise_type.code = 'ART' 
                        OR document_numerise_type.code = 'AVIS' 
                        OR document_numerise_type.code = 'DOC' 
                        OR document_numerise_type.code = 'DAACT' 
                        OR document_numerise_type.code = 'DOS01' 
                        OR document_numerise_type.code = 'DOS02' )";
        }

        // Le tri sur la requête
        $tri = " ORDER BY document_numerise.date_creation, document_numerise.nom_fichier";

        // Concaténation des morceaux de la requête
        $sql = $select.$from.$where.$tri;
        $res = $this->f->db->query($sql);
        $this->f->addToLog(__METHOD__."() : db->query(\"".$sql."\");", VERBOSE_MODE);
        $this->f->isDatabaseError($res);

        // Requête sql pour recupèrere la division de l'instructeur en session
        $sql_instr_division = "SELECT division.division
                FROM ".DB_PREFIXE."instructeur 
                    LEFT JOIN ".DB_PREFIXE."division 
                        ON division.division=instructeur.division 
                    LEFT JOIN ".DB_PREFIXE."om_utilisateur 
                        ON instructeur.om_utilisateur=om_utilisateur.om_utilisateur 
                WHERE om_utilisateur.login = '".$_SESSION['login']."'";
        $division = $this->f->db->getOne($sql_instr_division);
        $this->f->addToLog(__METHOD__."() : db->getOne(\"".$sql_instr_division."\");", VERBOSE_MODE);
        $this->f->isDatabaseError($division);

        //En-tête de tableau pour afficher la date et la catégorie des documents
        $header  = 
                "
                <thead>
                    <tr class='ui-tabs-nav ui-accordion ui-state-default tab-title'>
                        <th class='title col-0 firstcol %s' colspan=2>
                            <span class='name'>
                                %s
                            </span>
                        </th>
                    </tr>
                </thead>
                ";

        //Lien permettant d'ouvrir le document en pdf
        $link = "
                <a class='lienTable'
                    href=\"../spg/file.php?obj=document_numerise&champ=uid&id=%s\" target='_blank'>
                    %s
                </a>";
        if ($retourformulaire == "dossier_instruction" 
            && $this->f->isUserAdministrateur()) {
            // l'administrateur à la permission d'accéder à la fiche du document
            $link = "<a class='lienTable' 
                    onclick=\"ajaxIt('document_numerise','../scr/sousform.php?obj=document_numerise&action=3&idx=%s&tri=&premier=0&recherche=&objsf=document_numerise&premiersf=0&retourformulaire=$retourformulaire&idxformulaire=$dossier&trisf=&retour=tab');\"
                    href=\"#\">
                    %s
                </a>";
        }

        //Récupère le statut du dossier d'instruction
        $sql = "SELECT etat.statut
            FROM ".DB_PREFIXE."etat
            LEFT JOIN
                ".DB_PREFIXE."dossier
                ON
                    etat.etat = dossier.etat
            WHERE dossier.dossier = '".$idxformulaire."'";
        $statut = $this->f->db->getOne($sql);
        $this->f->addToLog(__METHOD__."() : db->getOne(\"".$sql."\");", VERBOSE_MODE);
        $this->f->isDatabaseError($statut);

        // Seul un administrateur peut ajouter des pièces
        if (($retourformulaire == 'dossier'
            OR $retourformulaire == 'dossier_instruction'
            OR $retourformulaire == 'dossier_instruction_mes_encours'
            OR $retourformulaire == 'dossier_instruction_tous_encours'
            OR $retourformulaire == 'dossier_instruction_mes_clotures'
            OR $retourformulaire == 'dossier_instruction_tous_clotures')
            && $this->f->isAccredited('document_numerise_add')) {

            //Affiche bouton ajouter
            echo "<p><a onclick=\"ajaxIt('document_numerise','../scr/sousform.php?obj=document_numerise&action=0&tri=&objsf=document_numerise&premiersf=0&retourformulaire=$retourformulaire&idxformulaire=$dossier&trisf=&retour=tab');\" href='#'>
                    <span class='om-icon om-icon-16 om-icon-fix add-16' title='Ajouter'>Ajouter</span>
                    Ajouter un document
                </a></p>";
        }

        //
        $i = 1;

        //Résultat à $i - 1 pour tester la date et catégorie des documents
        $lastRes = array();
        $lastRes['date_creation'][0] = "";
        $lastRes['categorie'][0] = "";

        //Tant qu'il y a des résultats
        while( $row = &$res->fetchRow(DB_FETCHMODE_ASSOC) ) {

            $lastRes['date_creation'][$i] = $row['date_creation'];
            $lastRes['categorie'][$i] = $row['categorie'];

            //Si la date de création est différente de celle du résultat juste avant
            if ($row['date_creation'] != $lastRes['date_creation'][$i-1]) {
                //Si ce n'est pas le premier résultat on ferme la table
                if($i != 1) {
                    echo "</table>";
                } 

                //Affiche la table 
                echo "<table class='tab-tab document_numerise'>";
                //Affiche le header de la date
                printf($header, 'headerDate', $this->f->formatDate($row['date_creation']));
                //Affiche le header de la catégorie
                printf($header,'headerCat', $row['categorie']);

                //Style des lignes
                $style = 'odd';

            }
            
            //Si la date de création est identique à celle du résultat juste avant
            //et la catégorie est différente de celle du résultat juste avant
            if ($row['date_creation'] == $lastRes['date_creation'][$i-1] && $row['categorie'] != $lastRes['categorie'][$i-1]) {
                //Affiche le header de la catégorie
                printf($header,'headerCat', $row['categorie']);

                //Style des lignes
                $style = 'odd';
            }

            //Si toujours dans la catégorie on change le style de la ligne
            if ($row['categorie'] == $lastRes['categorie'][$i-1] && $row['date_creation'] == $lastRes['date_creation'][$i-1]) {
                $style = ($style=='even')?'odd':'even';
            }

            //
            echo '<tr class="tab-data '.$style.'">';
            
            echo '<td class="col-0 firstcol">';
            //Si on est dans la visualisation du DA, on affiche le numéro du dossier 
            //d'instruction auquel est rataché la pièce et le nom du fichier
            if ($retourformulaire === 'dossier_autorisation'){
                printf ($link, $row['document_numerise'], $row['dossier']." - ".$row['nom_fichier']);
            }
            else {
                //On affiche que le nom du fichier
                printf ($link, $row['document_numerise'], $row['nom_fichier']);
                
            }
            echo '</td>';

            // Libelle du type du document
            echo '<td class="col-1">';
            printf ($link, $row['document_numerise'], $row['type_document']);
            echo '</td>';

            echo "</tr>";

            //
            $i++;

        }

        //On ferme la table
        echo "</table>";

        //S'il n'y a pas de résultat on affiche "Aucun enregistrements"
        if ($res->numrows() == 0) {
            echo "<p class='noData'>"._("Aucun enregistrements")."<p>";
        }
    }

    function setType(&$form,$maj) {
        parent::setType($form,$maj);

        //type
        $form->setType('document_numerise','hidden');
        $form->setType('dossier','hidden');
        $form->setType('nom_fichier','hidden');

        if ($maj==0){ //ajout
            $form->setType('nom_fichier','hidden');
            if($this->retourformulaire == "") {
                $form->setType('uid','upload');
            } else {
                $form->setType('uid','upload2');
            }
        }// fin ajout

        if ($maj==1){ //modifier
            $form->setType('nom_fichier','hiddenstatic');
            if($this->retourformulaire == "") {
                $form->setType('uid','upload');
            } else {
                $form->setType('uid','upload2');
            }
        }// fin modifier

        if ($maj==2){ //supprimer
            $form->setType('uid','filestatic');
            $form->setType('date_creation','datestatic');
        }// fin supprimer

        if ($maj==3){ //consulter
            $form->setType('uid','file');
        }// fin consulter
    }

    function setValsousformulaire(&$form,$maj,$validation,$idxformulaire,$retourformulaire,$typeformulaire,&$db,$DEBUG=null){
        parent::setValsousformulaire($form,$maj,$validation,$idxformulaire,$retourformulaire,$typeformulaire,$db,$DEBUG);
        
        $this->retourformulaire = $retourformulaire;

        if($maj == 0 && 
            ($retourformulaire =='dossier' 
              || $retourformulaire =='dossier_instruction'
              || $retourformulaire=='dossier_instruction_tous_clotures'
              || $retourformulaire=='dossier_instruction_mes_clotures'
              || $retourformulaire=='dossier_instruction_tous_encours'
              || $retourformulaire=='dossier_instruction_mes_encours')) {
            $form->setVal('dossier', $idxformulaire);
            $form->setVal('date_creation', date("d/m/Y"));
        }

    }// fin setValsousformulaire

    /**
     * [setLib description]
     * @param [type] $form [description]
     * @param [type] $maj  [description]
     */
    function setLib(&$form, $maj) {
        parent::setLib($form, $maj);

        //
        $form->setLib("uid", _("fichier"));
    }


    /**
     * Méthode de traitement des données retournées par le formulaire
     */
    function setvalF($val) {
        parent::setvalF($val);

        //Si le type est renseigné
        if ($val['document_numerise_type'] != "") {
          //Recupère le code du type du document
          $document_numerise_type = $this->get_document_numerise_type_code_by_id($val["document_numerise_type"]);

        } else {
          $document_numerise_type = "";
        }

        if ($val["date_creation"] == "") {
            $this->valF["date_creation"] = "";
        }

        //Génération automatique nom du fichier
        //var_dump($this);
        if ($val["nom_fichier"] == "" || $this->getParameter("maj") != 0) {
            $this->valF['nom_fichier'] = $this->generateFilename($this->valF["date_creation"], $document_numerise_type);
        }
    }

    /**
     * Permet de mettre à jour un champs dans la table instruction sans passer par ses triggers
     * @param   string $document_numerise Identifiant du fichier
     * @param   integer $instruction L'identifiant de l'instruction à mettre à jour
     */
    private function updateInstructionAutoExecute($document_numerise, $instruction) {

      // valeurs à mettre à jour
      $val = array("document_numerise"=>$document_numerise);
      // met à jour la table instruction sans passer par ses triggers
      $res = $this->db->autoExecute(DB_PREFIXE."instruction", $val, DB_AUTOQUERY_UPDATE,"instruction=".$instruction);
      // Exécution du traitement
      $this->f->addToLog("updateInstructionDocumentArrete() : db->autoExecute(".$res.")", VERBOSE_MODE);
      if (database::isError($res)) {
          die();
      }
    }

    /**
     * Permet d’effectuer des actions après l’insertion des données dans la base
     */
    function triggerajouterapres($id,&$db,$val,$DEBUG) {
        
        //Si l'option ERP est activée
        if ($this->f->getParameter('option_erp') === 'true') {
            
            //Envoi d'un message au référentiel ERP si on ajoute une piece sur 
            //un dossier de type AT
            if ($this->f->getDATDCode($this->valF['dossier']) === 'AT') {
                //On initialise la queue de message
                $msgenque = new MessageEnqueuer();
                //On initialise le dossier d'instruction
                $msgenque->setDossierInstructionIdentifier($this->valF['dossier']);
                
                //On récupère l'état du dossier d'instruction
                $etat = $this->getEtatDossier($this->valF['dossier']);
                
                //On calcule le type de pièce        
                $msgenque->setTypePiece(($etat==='incomplet')?_("complementaire"):_("supplementaire"));
                $return = $msgenque->enqueueMessage($msgenque::$ERP_AJOUT_PIECE);
                //Si une erreur s'est produite on arrête le traitement et on 
                //retourne une erreur
                if ($return !== 0){
                    
                    $this->addToMessage(_("Une erreur s'est produite lors de ".
                        "l'envoi du message au referentiel ERP. Merci de ".
                        "contacter votre administrateur"));
                    //On ne valide pas le formulaire
                    $this->addToMessage("<br/>"._("SAISIE NON ENREGISTREE")."<br/>");
                    $this->correct = false;
                    return false;
                }
                else {
                    $this->addToMessage(_("Le message a ete transmis au ".
                        "referentiel ERP."));
                }
            }
        }
    }

    /**
     * Permet d’effectuer des actions avant la modification des données dans la base
     */
    function triggermodifier($id,&$db,$val,$DEBUG) {

      // si le fichier n'a pas été déjà modifié
      if (stripos($val['uid'], 'tmp') === false) {
        // récupération du fichier et de ses métadonnées
        $file = $this->f->storage->get($val['uid']);
        // créé un fichier temporaire
        $tmp_file = $this->f->storage->create_temporary($file['file_content'], $file['metadata'], "from_content");
        // remplace le fichier par le temporaire pour obliger la modification du fichier
        $this->valF['uid'] = 'tmp|'.$tmp_file;
      }
    }

    /**
     * Surcharge du bouton retour des sous-formulaire
     */
    function retoursousformulaire($idxformulaire, $retourformulaire, $val,
                                  $objsf, $premiersf, $tricolsf, $validation,
                                  $idx, $maj, $retour) {

        if(($maj == 0 || $maj == 3 || $maj == 2) && ($retourformulaire === "dossier_instruction"
          || $retourformulaire==='dossier_instruction_tous_clotures'
          || $retourformulaire==='dossier_instruction_mes_clotures'
          || $retourformulaire==='dossier_instruction_tous_encours'
          || $retourformulaire==='dossier_instruction_mes_encours')) {
            
            echo "\n<a class=\"retour\" ";
            echo "href=\"#\" ";
            
            echo "onclick=\"ajaxIt('".$objsf."', '"; 
            echo "../scr/sousform.php?obj=document_numerise"
                ."&idx=$idxformulaire"
                ."&action=4"
                ."&retourformulaire=$retourformulaire"
                ."&idxformulaire=$idxformulaire"
                ."&retour=form');\"";
            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);
        // Inclusion du fichier de requêtes
        if (file_exists("../sql/".OM_DB_PHPTYPE."/".$this->table.".form.inc.php")) {
            include "../sql/".OM_DB_PHPTYPE."/".$this->table.".form.inc.php";
        } elseif (file_exists("../sql/".OM_DB_PHPTYPE."/".$this->table.".form.inc")) {
            include "../sql/".OM_DB_PHPTYPE."/".$this->table.".form.inc";
        }
        // document_numerise_type
        $this->init_select($form, $this->f->db, $maj, null, "document_numerise_type", $sql_document_numerise_type, $sql_document_numerise_type_by_id, false);
        
        //Seulement dans le cas d'un dossier d'instruction
        if($this->retourformulaire =='dossier_instruction'
              || $this->retourformulaire=='dossier_instruction_tous_clotures'
              || $this->retourformulaire=='dossier_instruction_mes_clotures'
              || $this->retourformulaire=='dossier_instruction_tous_encours'
              || $this->retourformulaire=='dossier_instruction_mes_encours') {
            
            //Tableau des contraintes
            $params = array(
                "constraint" => array(
                    "extension" => ".pdf"
                ),
            );
            
            $form->setSelect("uid", $params);
        }
    }

    // {{{ 
    // Méthodes de récupération des métadonnées document
    /**
     * Récupération du numéro de dossier d'instruction à ajouter aux métadonnées
     * @return [type] [description]
     */
    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 [type] [description]
     */
    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 [type] [description]
     */
    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 [type] [description]
     */
    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 [type] [description]
     */
    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 [type] [description]
     */
    protected function getTypeAutorisation() {
        if(empty($this->specificMetadata)) {
            $this->getSpecificMetadata();
        }
        return $this->specificMetadata->dossier_autorisation_type;
    }
    /**
     * Récupération nom du fichier à ajouter aux métadonnées
     * @return [type] [description]
     */
    protected function getFilename() {
        return $this->valF["nom_fichier"];
    }
    /**
     * Récupération de la date d'ajout de document à ajouter aux métadonnées
     * @return [type] [description]
     */
    protected function getDateEvenementDocument() {
        return date("Y-m-d", strtotime($this->valF["date_creation"]));
    }
    /**
     * 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 libellé du type du document à ajouter aux métadonnées
     * @return string Groupe d'instruction
     */
    protected function getTitle() {
        //Requête sql
        $sql = "SELECT libelle
                FROM ".DB_PREFIXE."document_numerise_type
                WHERE document_numerise_type = ".$this->valF["document_numerise_type"];
        $document_numerise_type_libelle = $this->db->getOne($sql);
        $this->addToLog("db->getone(\"".$sql."\");", VERBOSE_MODE);
        $this->f->addToLog("getTitle() : db->getOne(".$sql.")", VERBOSE_MODE);
        if (database::isError($document_numerise_type_libelle)) {
            die();
        }

        //Retourne le code du type de document
        return $document_numerise_type_libelle;
    }
    // Fin des méthodes de récupération des métadonnées
    // }}}

    /**
     * Génère le nom du fichier avec les information du formulaire
     * @param  string $date    Date de création du document
     * @param  string $codeDoc Code du type de document
     * @return string          Nom du fichier
     */
    private function generateFilename($date, $codeDoc) {

        //Change le format de la date
        $date = date("Ymd", strtotime($date));
        //Compose le nom du fichier date + code document + extension
        $filename = $date.$codeDoc.'.pdf';

        //Retourne le nom du fichier
        return $filename;
    }

    /**
     * Permet de recupérer le code du type de document par la clé primaire
     * @param  int $document_numerise_type Clé primaire d'un donnée de document_numerise_type
     * @return string                      Code du type de document 
     */
    private function get_document_numerise_type_code_by_id($document_numerise_type) {

        //Requête sql
        $sql = "SELECT code
                FROM ".DB_PREFIXE."document_numerise_type
                WHERE document_numerise_type = ".$document_numerise_type;
        $document_numerise_type_code = $this->db->getOne($sql);
        $this->addToLog("db->getone(\"".$sql."\");", VERBOSE_MODE);
        $this->f->addToLog("obj/document_numerise.class.php : db->getOne(".$sql.")", VERBOSE_MODE);
        if (database::isError($document_numerise_type_code)) {
            die();
        }

        //Retourne le code du type de document
        return $document_numerise_type_code;
    }

    /**
     * Permet de récupérer le libellé de la catégorie du type de document
     * @param  int $document_numerise_type    Clé primaire d'un donnée de document_numerise_type
     * @return string                         Libellé de la catégorie du type de document
     */
    private function get_document_numerise_type_categorie_libelle($document_numerise_type) {

      // Requête sql
      $sql = "SELECT document_numerise_type_categorie.libelle 
              FROM ".DB_PREFIXE."document_numerise_type
                LEFT JOIN ".DB_PREFIXE."document_numerise_type_categorie 
                  ON document_numerise_type.document_numerise_type_categorie = document_numerise_type_categorie.document_numerise_type_categorie
              WHERE document_numerise_type.document_numerise_type = ".$document_numerise_type;
      $document_numerise_type_categorie_libelle = $this->db->getOne($sql);
      $this->addToLog("db->getone(\"".$sql."\");", VERBOSE_MODE);
      $this->f->addToLog("obj/document_numerise.class.php : db->getOne(".$sql.")", VERBOSE_MODE);
      if (database::isError($document_numerise_type_categorie_libelle)) {
          die();
      }

      //Retourne le code du type de document
      return $document_numerise_type_categorie_libelle;
    }


    /**
     * 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->valF["dossier"]."'";
        $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("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;

        }
    }

    /**
     * CONDITION - is_ajoutable.
     *
     * Condition pour pouvoir ajouter
     *
     * @return boolean
     */
    function is_ajoutable() {
        // Test du bypass
        if ($this->f->isAccredited("document_numerise_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("document_numerise_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("document_numerise_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->getParameter("maj")==0)?$this->getParameter("idxformulaire"):$this->getVal("dossier");
        /**
         * Tester si le dossier est cloturé , de la meme division, instructeur, admin (?)
         */
        if($this->f->isUserInstructeur()
            && 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;
    }

    /**
     * Retourne le statut du dossier d'instruction
     * @param string $idx Identifiant du dossier d'instruction
     * @return string Le statut du dossier d'instruction
     */
    function getStatutAutorisationDossier($idx){
        
        $statut = '';
        
        //Si l'identifiant du dossier d'instruction fourni est correct
        if ( $idx != '' ){
            
            //On récupère le statut de l'état du dossier d'instruction à partir de 
                        //l'identifiant du dossier d'instruction
            $sql = "SELECT etat.statut
                FROM ".DB_PREFIXE."dossier
                LEFT JOIN
                    ".DB_PREFIXE."etat
                    ON
                        dossier.etat = etat.etat
                WHERE dossier ='".$idx."'";
            $statut = $this->db->getOne($sql);
            $this->f->addToLog("getStatutAutorisationDossier() : db->getOne(\"".$sql."\")", VERBOSE_MODE);
            if ( database::isError($statut)){
                die();
            }
        }
        return $statut;
    }

    /**
     * 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 getLastInstructionArrete($dossier) {

      // On récupère la dernière instruction dont l'événement est de type "arrete"
      $sql = "SELECT max(instruction) FROM ".DB_PREFIXE."instruction
                JOIN ".DB_PREFIXE."dossier ON instruction.dossier = dossier.dossier
                LEFT JOIN ".DB_PREFIXE."evenement
                    ON instruction.evenement = evenement.evenement
                WHERE dossier.dossier='".$dossier."' AND
                evenement.type = 'arrete'";
      $lastInstruction = $this->db->getOne($sql);
      $this->f->addToLog("getStatutAutorisationDossier() : db->getOne(\"".$sql."\")", VERBOSE_MODE);
      if ( database::isError($lastInstruction)){
          die();
      }

      return $lastInstruction;
    }

    /**
     * Récupère l'état d'un dossier d'instruction
     * @param $idxDossier L'identifiant du dossier d'instruction
     * @return L'état du dossier d'instruction 
     */
    function getEtatDossier($idxDossier){
            
        $etat = "";
        
        $sql = "SELECT etat.etat 
            FROM ".DB_PREFIXE."etat
            LEFT JOIN
                ".DB_PREFIXE."dossier
                ON
                dossier.etat = etat.etat
            WHERE dossier.dossier = '".$idxDossier."'";
        $etat = $this->db->getOne($sql);
        $this->addToLog("getEtatDossier(): db->getOne(\"".$sql."\");", VERBOSE_MODE);
        // Si une erreur survient on die
        if (database::isError($etat, true)) {
            // Appel de la methode de recuperation des erreurs
            $this->erreur_db($etat->getDebugInfo(), $etat->getMessage(), 'document_numerise');
        }
        
        return $etat;
    }

}// fin classe
?>