Subversion Repositories Applications.annuaire

Rev

Rev 52 | Rev 97 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | RSS feed

<?php
// declare(encoding='UTF-8');
/**
 * Modèle d'accès à la base de données des listes
 * d'ontologies
 *
 * PHP Version 5
 *
 * @package   Framework
 * @category  Class
 * @author      aurelien <aurelien@tela-botanica.org>
 * @copyright 2009 Tela-Botanica
 * @license   http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
 * @license   http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
 * @version   SVN: $$Id: ListeAdmin.php 128 2009-09-02 12:20:55Z aurelien $$
 * @link          /doc/framework/
 *
 */
class AnnuaireModele extends Modele {

        private $config = array();

        /**
         * Charge la liste complète des annuaires gérés par l'application
         * @return array un tableau contenant des informations sur les annuaires gérés par l'application
         */
        public function chargerListeAnnuaire() {
                $requete =      'SELECT * '.
                                        'FROM  annu_annuaire '.
                                        'ORDER BY aa_id_annuaire';
                $resultat = $this->requeteTous($requete);
                $annuaires = array();
                foreach ($resultat as $ligne) {
                        $annuaires[] = $ligne;
                }
                return $annuaires;
        }

        /**
         * Charge la liste complète des champs d'un annuaire
         * @param int $identifiant l'identifiant de l'annuaire demandé
         * @param boolean $charger_liste_champs indique si l'on doit ou non charger la liste des noms des champs
         * @return array un tableau contenant des objets d'informations sur les annuaires
         */
        public function chargerAnnuaire($identifiant, $charger_liste_champs = true) {

                $requete =      'SELECT * '.
                                        'FROM  annu_annuaire '.
                                        'WHERE aa_id_annuaire = '.$identifiant.' ';
                $resultat = $this->requeteTous($requete);
                $annuaire = array();
                foreach ($resultat as $ligne) {
                        $annuaire['informations'] = $ligne;
                }

                if($charger_liste_champs) {
                        $requete = 'DESCRIBE '.$annuaire['informations']['aa_bdd'].'.'.$annuaire['informations']['aa_table'];
                        $resultat = $this->requeteTous($requete);
                        foreach ($resultat as $colonne) {
                                $annuaire['colonnes'][] = $colonne;
                        }
                }

                return $annuaire;
        }

        /**
         * Charge les champs de mappage d'un annuaire, c'est à dire les champs de metadonnées qui correspondent à un champ
         * déjà présent dans la table mappée
         * @param int $id_annuaire l'identifiant de l'annuaire
         * @return array un tableau contenant les noms de champs mappés et les ids des champs métadonnées correspondants
         */
        public function obtenirChampsMappageAnnuaire($id_annuaire) {

                $tableau_mappage = array();

                $requete_champs_mappage = 'SELECT * FROM annu_triples WHERE at_ce_annuaire = '.$this->proteger($id_annuaire).' '.
                "AND at_action IN ('champ_id', 'champ_mail', 'champ_nom', 'champ_prenom', 'champ_pass', 'champ_lettre','champ_pays', 'champ_code_postal', 'champ_ville')";

                $resultat_champs_mappage = $this->requeteTous($requete_champs_mappage);

                $tableau_mappage = array();

                if(!$resultat_champs_mappage) {
                        trigger_error('impossible de récupérer les champs de mappage de l\'annuaire '.$id_annuaire);
                }

                foreach ($resultat_champs_mappage as  $champ) {
                        $tableau_mappage[0][$champ['at_action']] = $champ['at_ressource'];
                        $tableau_mappage[1][$champ['at_action']] = $champ['at_valeur'];
                }

                //echo Debug::printr($tableau_mappage);

                // TODO faire une interface de gestion des champs de mappage

                return $tableau_mappage ;
        }

        /**
         * Charge les champs obligatoire d'un annuaire, c'est à dire les champs qui doivent être présents et remplis dans le
         * formulaire
         * @param int $id_annuaire l'identifiant de l'annuaire
         * @return un tableau contenant les ids des champs obligatoire
         */
        public function obtenirChampsObligatoires($id_annuaire) {

                $tableau_mappage = array();

                $requete_champs_obligatoire = 'SELECT * FROM annu_triples WHERE at_ce_annuaire = '.$this->proteger($id_annuaire).' '.
                "AND at_action = 'champ_obligatoire'";

                $resultat_champs_obligatoire = $this->requeteTous($requete_champs_obligatoire);

                $tableau_mappage = array();

                if(!$resultat_champs_obligatoire) {
                        trigger_error('impossible de récupérer les champs de obligatoire de l\'annuaire '.$id_annuaire);
                }

                foreach ($resultat_champs_obligatoire as  $champ) {
                        // le tableau des champs obligatoires se présente sous la forme nom_champ_metadonnee => nom_champ_annuaire
                        $tableau_obligatoire[$champ['at_valeur']] = $champ['at_ressource'];
                }

                // TODO faire une interface de gestion des champs obligatoires
                return $tableau_obligatoire ;
        }

        /**
         * Charge les champs de cartographie d'un annuaire, c'est à dire les champs utilisées pour générer la carte des inscrits
         * @param int $id_annuaire l'identifiant de l'annuaire
         * @return array un tableau contenant les identifiants ou les noms des champs cartographiques
         */
        public function obtenirChampsCartographie($id_annuaire) {

                // TODO rendre les noms de champs plus générique
                $requete_champs_carto = 'SELECT * FROM annu_triples WHERE at_ce_annuaire = '.$this->proteger($id_annuaire).' '.
                "AND at_action IN ('champ_pays', 'champ_code_postal')";

                $resultat_champs_carto = $this->requeteTous($requete_champs_carto);

                $tableau_carto = array();

                if(!$resultat_champs_carto) {
                        trigger_error('impossible de récupérer les champs cartographiques de l\'annuaire '.$id_annuaire);
                }

                foreach ($resultat_champs_carto as  $champ) {
                        // le tableau des champs carto se présente sous la forme type de champ => [0] nom_champ_annuaire [1] nomù champ metadonnées
                        $tableau_carto[$champ['at_action']][0] = $champ['at_ressource'];
                        $tableau_carto[$champ['at_action']][1] = $champ['at_valeur'];
                }

                // TODO faire une interface de gestion des champs de mappage
                return $tableau_carto ;
        }

        /**
         * Renvoie l'identifiant du champ associé à l'image de profil (Avatar) dans un annuaire donné
         * @param int $id_annuaire l'identifiant de l'annuaire
         * @return string l'identifiant du champ avatar dans l'annuaire donné ou false s'il n'en existe pas
         */
        public function obtenirChampAvatar($id_annuaire) {

                $requete_champs_avatar = 'SELECT * FROM annu_triples WHERE at_ce_annuaire = '.$this->proteger($id_annuaire).' '.
                "AND at_action = 'champ_avatar'";

                $resultat_champs_avatar = $this->requeteUn($requete_champs_avatar);

                $champ_avatar = false;

                if(!$resultat_champs_avatar) {
                        trigger_error('impossible de récupérer le champ avatar de l\'annuaire '.$id_annuaire);
                }

                $champ_avatar = $resultat_champs_avatar['at_valeur'];

                // TODO faire une interface de gestion des champs de mappage
                return $champ_avatar ;
        }

         /** Renvoie l'identifiant du champ associé à l'image de profil (Avatar) dans un annuaire donné
         * @param int $id_annuaire l'identifiant de l'annuaire
         * @return string l'identifiant du champ date inscription dans l'annuaire donné ou false s'il n'en existe pas
         */
        /*public function obtenirChampDate($id_annuaire) {

                $requete_champs_avatar = 'SELECT * FROM annu_triples WHERE at_ce_annuaire = '.$this->proteger($id_annuaire).' '.
                "AND at_action = 'champ_avatar'";

                $champ_avatar = $resultat_champs_avatar['at_valeur'];

                // TODO faire une interface de gestion des champs de mappage
                return $champ_avatar ;
        }*/

        /**
         * Charge tous les champs de description de l'annuaire
         * @param int $id_annuaire l'identifiant de l'annuaire
         * @return array un tableau contenant les noms de champs mappés et les ids des champs métadonnées correspondants
         */
        public function obtenirChampsDescriptionAnnuaire($id_annuaire) {

                $tableau_mappage = array();

                $requete_champs_mappage = 'SELECT * FROM annu_triples WHERE at_ce_annuaire = '.$this->proteger($id_annuaire);

                $resultat_champs_mappage = $this->requeteTous($requete_champs_mappage);

                $tableau_mappage = array();

                if(!$resultat_champs_mappage) {
                        trigger_error('impossible de récupérer les champs décrivant l\'annuaire '.$id_annuaire);
                }

                foreach ($resultat_champs_mappage as  $champ) {
                        $tableau_mappage[0][$champ['at_action']] = $champ['at_ressource'];
                        $tableau_mappage[1][$champ['at_action']] = $champ['at_valeur'];
                }

                // TODO faire une interface de gestion des champs de mappage

                return $tableau_mappage ;
        }

        /** Charge le nombre d'inscrits d'une table annuaire mappée
         * @param int $identifiant l'identifiant de l'annuaire mappé
         * @return int le nombre d'inscrits à un annuaire donné
         *
         */
        public function chargerNombreAnnuaireListeInscrits($identifiant) {

                $requete_informations_annuaire =        'SELECT aa_bdd, aa_table '.
                                        'FROM  annu_annuaire '.
                                        'WHERE aa_id_annuaire = '.$identifiant.' ';
                $resultat_informations_annuaire = $this->requeteUn($requete_informations_annuaire);

                if(!$resultat_informations_annuaire) {
                        trigger_error('impossible de récupérer les informations de la table '.$identifiant);
                }

                $requete_nombre_inscrits = 'SELECT COUNT(*) as nom_inscrits'.
                                ' FROM '.$resultat_informations_annuaire['aa_bdd'].'.'.$resultat_informations_annuaire['aa_table'];

                if(!$resultat_informations_annuaire) {
                        trigger_error('impossible de récupérer le nombre d\'inscrits de la table '.$resultat_informations_annuaire['aa_bdd'].'.'.$resultat_informations_annuaire['aa_table']);
                }

                $resultat_nombre_inscrits = $this->requeteUn($requete_nombre_inscrits);
                return $resultat_nombre_inscrits['nom_inscrits'] ;
        }

        /** Charge le nombre d'inscrits d'une table annuaire mappée en les groupant par départements
         * @param int $identifiant l'identifiant de l'annuaire mappé
         * @return array un tableau indexé par les numéros de departement contenant le nombre d'inscrits à chacun
         *
         */
        public function chargerNombreAnnuaireListeInscritsParDepartement($identifiant) {

                $requete_informations_annuaire =        'SELECT aa_bdd, aa_table '.
                                        'FROM  annu_annuaire '.
                                        'WHERE aa_id_annuaire = '.$identifiant.' ';
                $resultat_informations_annuaire = $this->requeteUn($requete_informations_annuaire);

                if(!$resultat_informations_annuaire) {
                        trigger_error('impossible de récupérer les informations de la table '.$identifiant);
                }

                $tableau_mappage = $this->obtenirChampsMappageAnnuaire($identifiant);
                $champ_code_postal = $tableau_mappage[0]['champ_code_postal'];

                $requete_nombre_inscrits = 'SELECT IF ( SUBSTRING( '.$champ_code_postal.' FROM 1 FOR 2 ) >= 96, '.
                                                '               SUBSTRING( '.$champ_code_postal.' FROM 1 FOR 3 ), '.
                                                '               SUBSTRING( '.$champ_code_postal.' FROM 1 FOR 2 ) ) AS id, '.
                                                '       COUNT(*) AS nbre '.
                                                'FROM '.$resultat_informations_annuaire['aa_bdd'].'.'.$resultat_informations_annuaire['aa_table'].' '.
                                                'GROUP BY IF ( SUBSTRING( '.$champ_code_postal.' FROM 1 FOR 2 ) >= 96, '.
                                                '       SUBSTRING( '.$champ_code_postal.' FROM 1 FOR 3 ), '.
                                                '       SUBSTRING( '.$champ_code_postal.' FROM 1 FOR 2 ) ) '.
                                                'ORDER BY id ASC ';

                        // Récupération des résultats
                        try {
                                $donnees = $this->requeteTous($requete_nombre_inscrits);
                                if ($donnees === false) {
                                        $this->messages[] = "La requête n'a retourné aucun résultat.";
                                } else {
                                        foreach ($donnees as $donnee) {
                                                $resultat_nombre_inscrits[$donnee['id']] = $donnee['nbre'];
                                        }
                                }
                        } catch (Exception $e) {
                                $this->messages[] = sprintf($this->getTxt('sql_erreur'), $e->getFile(), $e->getLine(), $e->getMessage());
                        }

                if(!$resultat_informations_annuaire) {
                        trigger_error('impossible de récupérer le nombre d\'inscrits de la table '.$resultat_informations_annuaire['aa_bdd'].'.'.$resultat_informations_annuaire['aa_table']);
                }

                return $resultat_nombre_inscrits;
        }

        /** Charge le nombre d'inscrits d'une table annuaire mappée en les groupant par pays
         * @param int $identifiant l'identifiant de l'annuaire mappé
         * @param array $id_recherchees un tableau contenant les codes de pays à rechercher
         * @return array un tableau indexé par les numéros de departement contenant le nombre d'inscrits à chacun
         *
         */
        public function chargerNombreAnnuaireListeInscritsParPays($id_annuaire, $ids_recherchees) {

                $requete_informations_annuaire =        'SELECT aa_bdd, aa_table '.
                                        'FROM  annu_annuaire '.
                                        'WHERE aa_id_annuaire = '.$id_annuaire.' ';
                $resultat_informations_annuaire = $this->requeteUn($requete_informations_annuaire);

                if(!$resultat_informations_annuaire) {
                        trigger_error('impossible de récupérer les informations de la table '.$id_annuaire);
                }

                $tableau_mappage = $this->obtenirChampsCartographie($id_annuaire);
                $champ_pays = $tableau_mappage['champ_pays'][0];

                $resultat_nombre_inscrits = array();

                $requete_nombre_inscrits = 'SELECT '.$champ_pays.', COUNT(*) AS nbre '.
                                                'FROM '.$resultat_informations_annuaire['aa_bdd'].'.'.$resultat_informations_annuaire['aa_table'].' '.
                                                ' WHERE '.$champ_pays.' IN '.
                                                '('.implode(',',$ids_recherchees).') '.
                                                'GROUP BY '.$champ_pays.' '.
                                                'ORDER BY '.$champ_pays.' ASC ';

                // Récupération des résultats
                try {
                        $donnees = $this->requeteTous($requete_nombre_inscrits);
                        if ($donnees === false) {
                                $this->messages[] = "La requête n'a retourné aucun résultat.";
                        } else {
                                foreach ($donnees as $donnee) {
                                        $resultat_nombre_inscrits[$donnee[$champ_pays]] = $donnee['nbre'];
                                }
                        }
                } catch (Exception $e) {
                        $this->messages[] = sprintf($this->getTxt('sql_erreur'), $e->getFile(), $e->getLine(), $e->getMessage());
                }

                if(!$resultat_informations_annuaire) {
                        trigger_error('impossible de récupérer le nombre d\'inscrits de la table '.$resultat_informations_annuaire['aa_bdd'].'.'.$resultat_informations_annuaire['aa_table']);
                }

                return $resultat_nombre_inscrits;
        }

        /**
         * Recherche selon une valeur d'un champ qui peut être une valeur approximative (avec des %) dans un champ d'annuaire donné
         * @param int $id_annuaire l'identifiant de l'annuaire
         * @param string $champ_critere le champ qui servira de filtre
         * @param string $valeur la valeur à rechercher
         * @param boolean $modele indique si l'on veut recherche la valeur exacte ou non
         * @return array un tableau contenant la liste des inscrits dans l'annuaire donné, correspondants à ce critère
         */
        public function rechercherInscritDansAnnuaireMappeParChamp($id_annuaire, $champ_critere, $valeur, $modele = false) {

                $sep = '';

                if($modele) {
                        $sep = '%';
                }

                $valeurs = array($champ_critere => $valeur.$sep);

                return $this->rechercherInscritDansAnnuaireMappe($id_annuaire, $valeurs, array(), true);
        }

        /**
         * Charge les inscrits d'une table annuaire mappée, en ne conservant que les champs de mappage indiqués
         * @param int $identifiant l'identifiant de l'annuaire mappé
         * @param Array $champs_mappage les champs de mappage à retenir
         * @param int $numero_page le numéro de la page demandée
         * @param int $taille_page la taille de la page demandée
         *
         */
        public function chargerAnnuaireListeInscrits($identifiant, $champs_mappage, $numero_page = 1, $taille_page = 50) {

                $requete =      'SELECT * '.
                                        'FROM  annu_annuaire '.
                                        'WHERE aa_id_annuaire = '.$identifiant.' ';
                $resultat = $this->requeteTous($requete);
                $annuaire = array();
                foreach ($resultat as $ligne) {
                        $annuaire['informations'] = $ligne;
                }

                $annuaire['colonnes'] = $champs_mappage;

                $string_champs_mappage = implode(",", $champs_mappage);

                $requete = 'SELECT '.$string_champs_mappage.
                                ' FROM '.$annuaire['informations']['aa_bdd'].'.'.$annuaire['informations']['aa_table'].
                                ' ORDER BY '.$champs_mappage['champ_id'].
                                ' LIMIT '.(($numero_page-1)*$taille_page).','.($taille_page);

                $resultat = $this->requeteTous($requete);
                foreach ($resultat as $colonne) {
                        $annuaire['inscrits'][] = $colonne;
                }

                return $annuaire;
        }

        /**
         * Insère une nouvelle ligne dans la table d'inscription temporaire, contenant
         * les données sérialisées d'un utilisateur
         * @param string $identifiant l'identifiant de cette tentative
         * @param string $donnees les données d'inscription (une variable sérialisée))
         * @return PdoStatement en cas de succès, false sinon
         */
        public function ajouterNouvelleInscriptionTemporaire($identifiant, $donnees) {

                // on protège et on sérialise les données
                $identifiant = $this->proteger($identifiant);
                $donnees = base64_encode(serialize($donnees));
                $donnees = $this->proteger($donnees);

                //echo $donnees ;

                // FIXME: les accents sautent alors que l'encodage est le bon ! Pourquoi ?
                $requete =      'INSERT INTO annu_inscription_temp '.
                                        'VALUES '.
                                        '('.$identifiant.','.$donnees.', NOW())';

                return $this->requete($requete);
        }

        /**
         * Récupère une ligne dans la table d'inscription temporaire, contenant
         * les données sérialisées d'un utilisateur
         * @param string $identifiant l'identifiant de la tentative
         * @return Array en cas de succès, false sinon
         */
        public function chargerDonneesInscriptionTemporaire($identifiant) {

                $identifiant = $this->proteger($identifiant);

                $requete =      'SELECT * FROM annu_inscription_temp '.
                                        'WHERE '.
                                        'ait_id = '.$identifiant;

                $donnees_inscription = $this->requeteUn($requete);

                if($donnees_inscription) {
                        return unserialize(base64_decode($donnees_inscription['ait_donnees']));
                }

                return false;
        }

        /**
         * Supprime une ligne dans la table d'inscription temporaire, contenant
         * les données sérialisées d'un utilisateur
         * @param string $identifiant l'identifiant de la tentative
         * @return PDOStatement en cas de succès, false sinon
         */
        public function supprimerDonneesInscriptionTemporaire($identifiant) {

                $identifiant = $this->proteger($identifiant);

                $requete =      'DELETE FROM annu_inscription_temp '.
                                        'WHERE '.
                                        'ait_id = '.$identifiant;

                return $this->requete($requete);

                //return true;
        }

        /**
         * Ajoute les valeurs données dans l'annuaire indiqué
         * @param int $id_annuaire      l'identifiant de l'annuaire dans lequel on va travailler
         * @param Array $valeurs_mappees un tableau de valeurs à ajouter
         * @param string $nom_champs les noms des champs dans lesquels on va ajouter les données
         * @return int l'identifiant du nouvel enregistrement
         */
        public function ajouterInscriptionDansAnnuaireMappe($id_annuaire, $valeurs_mappees, $nom_champs) {

                $requete_infos_annuaire = 'SELECT * '.
                                        'FROM  annu_annuaire '.
                                        'WHERE aa_id_annuaire = '.$id_annuaire.' ';

                $resultat = $this->requeteUn($requete_infos_annuaire);
                $annuaire = array();

                //en cas d'erreur on renvoie false
                //TODO: lever une exception
                if(!$resultat) {
                        return false;
                }

                $annuaire = $resultat;

                $valeurs_prot = array_map(array($this,'proteger'),$valeurs_mappees);

                $valeurs = implode(',',$valeurs_prot);
                $champs = implode(',',array_keys($valeurs_mappees));

                $requete_insertion_annuaire = 'INSERT INTO '.$annuaire['aa_bdd'].'.'.$annuaire['aa_table'].' '.
                        '('.$champs.') '.
                        'VALUES ('.$valeurs.')';

                $id_nouvel_enregistrement = false;

                //en cas d'erreur on renvoie false
                //TODO: lever une exception
                if(!$this->requete($requete_insertion_annuaire)) {
                        return $id_nouvel_enregistrement;
                }

                // le mail est censé être unique donc on l'utilise pour faire une selection pour retrouver l'enregistrement
                // (Les requetes du style SELECT MAX(id)... ne garantissent pas qu'on récupère le bon id
                // si une autre insertion a eu lieu entre temps)
                // TODO utiliser du PDO pur et utiliser les fonctions last_insert_id générique
                $requete_nouvel_id =    'SELECT '.$nom_champs['champ_id'].' '.
                                                                'FROM '.$annuaire['aa_bdd'].'.'.$annuaire['aa_table'].' '.
                                                                'WHERE '.
                                                                $nom_champs['champ_mail'].' = '.$this->proteger($valeurs_mappees[$nom_champs['champ_mail']]);

                $resultat_nouvel_id = $this->requeteUn($requete_nouvel_id);

                // en cas d'erreur on renvoie false
                // TODO: lever une exception
                if(!$resultat_nouvel_id) {
                        return $id_nouvel_enregistrement;
                }

                $id_nouvel_enregistrement = $resultat_nouvel_id[$nom_champs['champ_id']];

                return $id_nouvel_enregistrement;
        }

        /**
         * Modifie les valeurs données dans l'annuaire indiqué
         * @param int $id_annuaire      l'identifiant de l'annuaire dans lequel on va travailler
         * @param int $id_annuaire      l'identifiant de l'utilisateur à qui à modifier
         * @param Array $valeurs_mappees un tableau de valeurs à modifier
         * @param string $nom_champs les noms des champs dans lesquels on va modifier les données
         * @return boolean true ou false suivant le succès de l'operation
         */
        public function modifierInscriptionDansAnnuaireMappe($id_annuaire, $id_utilisateur, $valeurs_mappees, $champs_mappage) {

                $requete_infos_annuaire = 'SELECT * '.
                                        'FROM  annu_annuaire '.
                                        'WHERE aa_id_annuaire = '.$id_annuaire.' ';

                $resultat = $this->requeteUn($requete_infos_annuaire);
                $annuaire = array();

                unset($valeurs_mappees[$champs_mappage['champ_id']]);

                //en cas d'erreur on renvoie false
                //TODO: lever une exception
                if(!$resultat) {
                        return false;
                }

                $annuaire = $resultat;

                $requete_modification_annuaire = 'UPDATE '.$annuaire['aa_bdd'].'.'.$annuaire['aa_table'].' '.
                'SET ';
                foreach($valeurs_mappees as $cle => $valeur) {
                        $requete_modification_annuaire .= $cle.' = '.$this->proteger($valeur).', ';
                }

                $requete_modification_annuaire = rtrim($requete_modification_annuaire,', ').' ' ;

                $requete_modification_annuaire .= 'WHERE '.$champs_mappage['champ_id'].' = '.$id_utilisateur ;

                //en cas d'erreur on renvoie false
                //TODO: lever une exception
                if(!$this->requete($requete_modification_annuaire)) {
                        return false;
                } else {
                        return true;
                }

        }

        public function obtenirValeurChampAnnuaireMappe($id_annuaire, $id_utilisateur, $champ) {

                $champs_mappage = $this->obtenirChampsMappageAnnuaire($id_annuaire);
                // on ne garde que les champs de mappage correspondant au champ de l'annuaire principal
                $champs_mappage = $champs_mappage[0];

                $requete_infos_annuaire = 'SELECT * '.
                                        'FROM annu_annuaire '.
                                        'WHERE aa_id_annuaire = '.$id_annuaire.' ';

                $resultat_infos_annuaire = $this->requeteUn($requete_infos_annuaire);

                // en cas d'erreur on renvoie false
                // TODO: lever une exception
                if(!$resultat_infos_annuaire) {
                        return false;
                }

                $champs_mappage_str = implode(',',$champs_mappage);
                $id_utilisateur = $this->proteger($id_utilisateur);

                $requete_selection_valeur = 'SELECT '.$champs_mappage[$champ].' as '.$champ.' '.
                                                                                 'FROM '.$resultat_infos_annuaire['aa_bdd'].'.'.$resultat_infos_annuaire['aa_table'].' '.
                                                                                 'WHERE '.$champs_mappage['champ_id'].' = '.$id_utilisateur;

                $resultat_selection_valeur = $this->requeteUn($requete_selection_valeur);

                // en cas d'erreur on renvoie false
                // TODO: lever une exception
                if(!$resultat_selection_valeur) {
                        return false;
                } else {
                        return $resultat_selection_valeur[$champ];
                }
        }

        public function modifierValeurChampAnnuaireMappe($id_annuaire, $id_utilisateur, $champ, $valeur) {

                $champs_mappage = $this->obtenirChampsMappageAnnuaire($id_annuaire);
                // on ne garde que les champs de mappage correspondant au champ de l'annuaire principal
                $champs_mappage = $champs_mappage[0];

                $requete_infos_annuaire = 'SELECT * '.
                                        'FROM annu_annuaire '.
                                        'WHERE aa_id_annuaire = '.$id_annuaire.' ';

                $resultat_infos_annuaire = $this->requeteUn($requete_infos_annuaire);

                // en cas d'erreur on renvoie false
                // TODO: lever une exception
                if(!$resultat_infos_annuaire) {
                        return false;
                }

                $champs_mappage_str = implode(',',$champs_mappage);
                $id_utilisateur = $this->proteger($id_utilisateur);
                $valeur = $this->proteger($valeur);

                $requete_modification_valeur = 'UPDATE '.$resultat_infos_annuaire['aa_bdd'].'.'.$resultat_infos_annuaire['aa_table'].' '.
                                                                                 'SET '.$champ.' = '.$valeur.' '.
                                                                                 'WHERE '.$champs_mappage['champ_id'].' = '.$id_utilisateur;


                $resultat_modification_valeur = $this->requeteUn($requete_modification_valeur);

                // en cas d'erreur on renvoie false
                // TODO: lever une exception
                return $resultat_modification_valeur;
        }

        /**
         * Renvoie le mail associé à l'identifiant d'un utilisateur dans un annuaire donné
         * @param int $id_annuair l'identifiant de l'annuaire
         * @param int $id_utilisateur l'identifiant de l'utilisateur
         * @return string le mail associé à cet identifiant ou false si l'utilisateur n'existe pas
         */
        public function obtenirMailParId($id_annuaire, $id_utilisateur) {

                $champs_mappage = $this->obtenirChampsMappageAnnuaire($id_annuaire);
                // on ne garde que les champs de mappage correspondant au champ de l'annuaire principal
                $champs_mappage = $champs_mappage[0];

                $requete_infos_annuaire = 'SELECT * '.
                                        'FROM annu_annuaire '.
                                        'WHERE aa_id_annuaire = '.$id_annuaire.' ';

                $resultat_infos_annuaire = $this->requeteUn($requete_infos_annuaire);

                // en cas d'erreur on renvoie false
                // TODO: lever une exception
                if(!$resultat_infos_annuaire) {
                        return false;
                }

                $champs_mappage_str = implode(',',$champs_mappage);
                $id_utilisateur = $this->proteger($id_utilisateur);

                $requete_selection_utilisateur = 'SELECT '.$champs_mappage['champ_mail'].' '.
                                                                                 'FROM '.$resultat_infos_annuaire['aa_bdd'].'.'.$resultat_infos_annuaire['aa_table'].' '.
                                                                                 'WHERE '.$champs_mappage['champ_id'].' = '.$id_utilisateur;



                //echo $requete_selection_utilisateur;
                $resultat_selection_utilisateur = $this->requeteUn($requete_selection_utilisateur);

                // en cas d'erreur on renvoie false
                // TODO: lever une exception
                if(!$resultat_selection_utilisateur) {
                        return false;
                } else {
                        return $resultat_selection_utilisateur[$champs_mappage['champ_mail']];
                }

        }

        /**
         * Renvoie les mail associés des identifiants d'utilisateur dans un annuaire donné
         * @param int $id_annuair l'identifiant de l'annuaire
         * @param array $ids_utilisateurs les identifiants des l'utilisateur
         * @return array un tableau contenant les mails associés à ces identifiant ou false si les utilisateurs n'existent pas
         */
        public function obtenirMailParTableauId($id_annuaire, $tableau_ids_utilisateurs) {

                $champs_mappage = $this->obtenirChampsMappageAnnuaire($id_annuaire);
                // on ne garde que les champs de mappage correspondant au champ de l'annuaire principal
                $champs_mappage = $champs_mappage[0];

                $requete_infos_annuaire = 'SELECT * '.
                                        'FROM annu_annuaire '.
                                        'WHERE aa_id_annuaire = '.$id_annuaire.' ';

                $resultat_infos_annuaire = $this->requeteUn($requete_infos_annuaire);

                // en cas d'erreur on renvoie false
                // TODO: lever une exception
                if(!$resultat_infos_annuaire) {
                        return false;
                }

                $champs_mappage_str = implode(',',$champs_mappage);

                $tableau_ids_utilisateurs_p = array_map(array($this, 'proteger'), $tableau_ids_utilisateurs);
                $str_ids_utilisateurs = implode(',',$tableau_ids_utilisateurs_p);

                $requete_selection_utilisateurs = 'SELECT '.$champs_mappage['champ_mail'].' '.
                                                                                 'FROM '.$resultat_infos_annuaire['aa_bdd'].'.'.$resultat_infos_annuaire['aa_table'].' '.
                                                                                 'WHERE '.$champs_mappage['champ_id'].' IN ('.$str_ids_utilisateurs.')';

                $resultat_selection_utilisateurs = $this->requeteTous($requete_selection_utilisateurs);

                $resultat_utilisateurs = array();

                foreach($resultat_selection_utilisateurs as $utilisateur) {
                         $resultat_utilisateurs[] = $utilisateur[$champs_mappage['champ_mail']];
                }

                // en cas d'erreur on renvoie false
                // TODO: lever une exception
                if(!$resultat_selection_utilisateurs) {
                        return false;
                } else {
                        return $resultat_utilisateurs;
                }

        }

        /**
         * Renvoie l'id associé au mail d'un utilisateur dans un annuaire donné
         * @param int $id_annuair l'identifiant de l'annuaire
         * @param int $mail_utilisateur le mail de l'utilisateur
         * @return string l'id associé à ce mail ou false si l'utilisateur n'existe pas
         */
        public function obtenirIdParMail($id_annuaire, $mail_utilisateur) {

                $champs_mappage = $this->obtenirChampsMappageAnnuaire($id_annuaire);
                // on ne garde que les champs de mappage correspondant au champ de l'annuaire principal
                $champs_mappage = $champs_mappage[0];

                $requete_infos_annuaire = 'SELECT * '.
                                        'FROM annu_annuaire '.
                                        'WHERE aa_id_annuaire = '.$id_annuaire.' ';

                $resultat_infos_annuaire = $this->requeteUn($requete_infos_annuaire);

                // en cas d'erreur on renvoie false
                // TODO: lever une exception
                if(!$resultat_infos_annuaire) {
                        return false;
                }

                $champs_mappage_str = implode(',',$champs_mappage);

                $requete_selection_utilisateur = 'SELECT '.$champs_mappage['champ_id'].' '.
                                                                                 'FROM '.$resultat_infos_annuaire['aa_bdd'].'.'.$resultat_infos_annuaire['aa_table'].' '.
                                                                                 'WHERE '.$champs_mappage['champ_mail'].' = '.$this->proteger($mail_utilisateur);


                //echo $requete_selection_utilisateur;
                $resultat_selection_utilisateur = $this->requeteUn($requete_selection_utilisateur);

                // en cas d'erreur on renvoie false
                // TODO: lever une exception
                if(!$resultat_selection_utilisateur) {
                        return false;
                } else {
                        return $resultat_selection_utilisateur[$champs_mappage['champ_id']];
                }

        }

        // TODO: commenter
        public function comparerIdentifiantMotDePasse($id_annuaire, $id_utilisateur, $mot_de_passe) {

                $requete_infos_annuaire = 'SELECT * '.
                                        'FROM annu_annuaire '.
                                        'WHERE aa_id_annuaire = '.$id_annuaire.' ';

                $resultat_infos_annuaire = $this->requeteUn($requete_infos_annuaire);

                // en cas d'erreur on renvoie false
                // TODO: lever une exception
                if(!$resultat_infos_annuaire) {
                        return false;
                }

                $champs_mappage = $this->obtenirChampsMappageAnnuaire($id_annuaire);
                // on ne garde que les champs de mappage correspondant au champ de l'annuaire principal
                $champs_mappage = $champs_mappage[0];

                $mot_de_passe = $this->proteger($mot_de_passe);
                $id_utilisateur = $this->proteger($id_utilisateur);

                $requete_selection_utilisateur = 'SELECT COUNT(*) as match_login_mdp '.
                                                                                 'FROM '.$resultat_infos_annuaire['aa_bdd'].'.'.$resultat_infos_annuaire['aa_table'].' '.
                                                                                 'WHERE '.$champs_mappage['champ_id'].' = '.$id_utilisateur.' '.
                                                                                 'AND '.$champs_mappage['champ_pass'].' = '.$mot_de_passe;

                $resultat_selection_utilisateur = $this->requeteUn($requete_selection_utilisateur);

                // en cas d'erreur ou bien si le login ne matche pas le mot de passe
                // on renvoie false
                if(!$resultat_selection_utilisateur || $resultat_selection_utilisateur['match_login_mdp'] <= 0) {
                        return false;
                } else {
                        return true;
                }
        }

        /**
         * Récupère les champs demandé dans l'annuaire indiqué
         * @param int $id_annuaire      l'identifiant de l'annuaire dans lequel on va travailler
         * @param int $id_utilisateur l'identifiant de l'utilisateur dont on veut les informations
         * @param Array $champs_mappage les noms des champs que l'on veut récupérer
         * @return Array les informations demandées
         */
        public function obtenirValeursUtilisateur($id_annuaire, $id_utilisateur, $champs_mappage) {

                $requete_infos_annuaire = 'SELECT * '.
                                        'FROM annu_annuaire '.
                                        'WHERE aa_id_annuaire = '.$id_annuaire.' ';

                $resultat_infos_annuaire = $this->requeteUn($requete_infos_annuaire);

                // en cas d'erreur on renvoie false
                // TODO: lever une exception
                if(!$resultat_infos_annuaire) {
                        return false;
                }

                $champs_mappage_str = implode(',',$champs_mappage);
                $id_utilisateur = $this->proteger($id_utilisateur);

                $requete_selection_utilisateur = 'SELECT '.$champs_mappage_str.' '.
                                                                                 'FROM '.$resultat_infos_annuaire['aa_bdd'].'.'.$resultat_infos_annuaire['aa_table'].' '.
                                                                                 'WHERE '.$champs_mappage['champ_id'].' = '.$id_utilisateur;

                $resultat_selection_utilisateur = $this->requeteUn($requete_selection_utilisateur);

                // en cas d'erreur on renvoie false
                // TODO: lever une exception
                if(!$resultat_selection_utilisateur) {
                        return false;
                } else {
                        return $resultat_selection_utilisateur;
                }
        }

        /**
         * Supprime une inscription dans une table annuaire
         * @param int $id_annuaire l'identifiant de l'annuaire dans lequel on supprime les données
         * @param int $id_utilisateur l'identifiant de l'utilisateur à supprimer
         * @return boolean true si la suppression a réussi, false sinon
         */
        public function supprimerInscriptionDansAnnuaireMappe($id_annuaire, $id_utilisateur) {

                $champs_mappage = $this->obtenirChampsMappageAnnuaire($id_annuaire);

                $requete_infos_annuaire = 'SELECT * '.
                        'FROM annu_annuaire '.
                        'WHERE aa_id_annuaire = '.$id_annuaire.' ';

                $resultat_infos_annuaire = $this->requeteUn($requete_infos_annuaire);

                // en cas d'erreur on renvoie false
                // TODO: lever une exception
                if(!$resultat_infos_annuaire) {
                        return false;
                }

                $requete_suppression_utilisateur = 'DELETE FROM '.$resultat_infos_annuaire['aa_bdd'].'.'.$resultat_infos_annuaire['aa_table'].' '.
                                                                                 'WHERE '.$champs_mappage[0]['champ_id'].' = '.$this->proteger($id_utilisateur);

                $resultat_suppression_utilisateur = $this->requeteUn($requete_suppression_utilisateur);

                // en cas d'erreur on renvoie false
                // TODO: lever une exception
                if($this->utilisateurExisteParId($id_annuaire, $id_utilisateur, $champs_mappage)) {

                        return false;
                }

                return true;
        }

        /**
         * Renvoie vrai si un utilisateur existe suivant un id donné
         * @param int $id_annuaire l'identifiant de l'annuaire dans lequel on supprime les données
         * @param int $id_utilisateur l'identifiant de l'utilisateur à supprimer
         * @return boolean true si l'utilisateur existe, false sinon
         */
        public function utilisateurExisteParId($id_annuaire, $id_utilisateur) {

                $champs_mappage = $this->obtenirChampsMappageAnnuaire($id_annuaire);

                $requete_informations_annuaire =        'SELECT aa_bdd, aa_table '.
                                        'FROM  annu_annuaire '.
                                        'WHERE aa_id_annuaire = '.$id_annuaire.' ';
                $resultat_informations_annuaire = $this->requeteUn($requete_informations_annuaire);

                if(!$resultat_informations_annuaire) {
                        trigger_error('impossible de récupérer les informations de la table '.$id_annuaire);
                }

                $requete_nombre_inscrits = 'SELECT COUNT(*) AS est_inscrit'.
                                ' FROM '.$resultat_informations_annuaire['aa_bdd'].'.'.$resultat_informations_annuaire['aa_table'].
                                ' WHERE '.$champs_mappage[0]['champ_id'].' = '.$this->proteger($id_utilisateur);

                $resultat_nombre_inscrits = $this->requeteUn($requete_nombre_inscrits);

                if(!$resultat_nombre_inscrits) {
                        trigger_error('impossible de vérifier l\'existence de cet utilisateur ');
                }

                return ($resultat_nombre_inscrits['est_inscrit'] > 0) ;

        }

         /** Renvoie vrai si un utilisateur existe suivant un mail donné
         * @param int $id_annuaire l'identifiant de l'annuaire dans lequel recherche
         * @param int $id_utilisateur le mail de l'utilisateur à chercher
         * @return boolean true si l'utilisateur existe, false sinon
         */
        public function utilisateurExisteParMail($id_annuaire, $mail) {

                $champs_mappage = $this->obtenirChampsMappageAnnuaire($id_annuaire);

                $requete_informations_annuaire =        'SELECT aa_bdd, aa_table '.
                                        'FROM  annu_annuaire '.
                                        'WHERE aa_id_annuaire = '.$id_annuaire.' ';
                $resultat_informations_annuaire = $this->requeteUn($requete_informations_annuaire);

                if(!$resultat_informations_annuaire) {
                        trigger_error('impossible de récupérer les informations de la table '.$id_annuaire);
                }

                $requete_nombre_inscrits = 'SELECT COUNT(*) AS est_inscrit '.
                                ' FROM '.$resultat_informations_annuaire['aa_bdd'].'.'.$resultat_informations_annuaire['aa_table'].
                                ' WHERE '.$champs_mappage[0]['champ_mail'].' = '.$this->proteger($mail);

                $resultat_nombre_inscrits = $this->requeteUn($requete_nombre_inscrits);

                if(!$resultat_nombre_inscrits) {
                        trigger_error('impossible de vérifier l\'existence de cet utilisateur ');
                }

                return ($resultat_nombre_inscrits['est_inscrit'] > 0) ;

        }

        /**
         * @param int $id_annuaire identifiant de l'annuaire dans lequel on recherche
         * @param array $valeurs un tableau de valeurs à rechercher
         * @param array $id_a_inclure un tableau d'identifiants à inclure (pour chainer des recherches)
         * @param boolean $exclusive indique si l'on recherche effectue une recherche exclusive ou inclusive (AND, ou OR)
         */
        public function rechercherInscritDansAnnuaireMappe($id_annuaire, $valeurs, $id_a_inclure = array(), $exclusive = true, $numero_page = 1, $taille_page = 50) {

                // Si la fonction est appelée et que tous les critères sont vides
                if(count($valeurs) == 0 && count($id_a_inclure) == 0) {
                        // on sort directement
                        return array();
                }

                $requete_informations_annuaire =        'SELECT aa_bdd, aa_table '.
                                        'FROM  annu_annuaire '.
                                        'WHERE aa_id_annuaire = '.$id_annuaire.' ';

                $resultat_informations_annuaire = $this->requeteUn($requete_informations_annuaire);

                $requete_recherche_inscrits = 'SELECT * '.
                                ' FROM '.$resultat_informations_annuaire['aa_bdd'].'.'.$resultat_informations_annuaire['aa_table'].
                                ' WHERE ';

                $champs_mappage = $this->obtenirChampsMappageAnnuaire($id_annuaire);

                $requete_conditions_inscrits = '';

                if($exclusive) {
                        $separateur = ' AND ';
                } else {
                        $separateur = ' OR ';
                }

                // on inclut les identifiants déjà trouvé par les critères de métadonnées
                if(is_array($id_a_inclure) && count($id_a_inclure) != 0) {

                        $id_inclus = implode(',',$id_a_inclure);

                        $requete_conditions_inscrits .= $champs_mappage[0]['champ_id'].' IN '.
                        '('.$id_inclus.')'.$separateur ;
                }

                // si le champ contient un % alors on ne cherche pas une valeur exacte : on utilise LIKE
                foreach($valeurs as $champ => $valeur) {
                        if(trim($valeur) != '') {
                                if(strpos($valeur,"%") != false) {
                                        $operateur = ' LIKE ';
                                } else {
                                        $operateur = ' = ';
                                }
                                $requete_conditions_inscrits .= $champ.$operateur.$this->proteger($valeur).$separateur;
                        }
                }

                $requete_conditions_inscrits = rtrim($requete_conditions_inscrits, $separateur);

                $requete_recherche_inscrits .= $requete_conditions_inscrits;

                if(trim($requete_conditions_inscrits) == '') {

                }

                $requete_nb_inscrits = 'SELECT COUNT( * ) as nb '.' FROM '.$resultat_informations_annuaire['aa_bdd'].'.'.$resultat_informations_annuaire['aa_table'].
                                ' WHERE '.$requete_conditions_inscrits;

                $resultat_nb_inscrits = $this->requeteUn($requete_nb_inscrits);

                $nb_inscrits = 0;
                if($resultat_nb_inscrits) {
                        $nb_inscrits = $resultat_nb_inscrits['nb'];
                }

                $requete_recherche_inscrits .= ' LIMIT '.(($numero_page-1)*$taille_page).','.($taille_page);

                $resultat_recherche_inscrits = $this->requeteTous($requete_recherche_inscrits);

                if(!$resultat_recherche_inscrits) {
                        $resultat_recherche_inscrits = array();
                }

                return array('total' => $nb_inscrits, 'resultat' => $resultat_recherche_inscrits) ;
        }

        /**
         * Reinitialise un mot de passe associé à un mail donné et en renvoie un nouveau,
         * généré aléatoirement
         * @param int $id_annuaire l'identifiant de l'annuaire
         * @param string $mail le mail dont on doit réinitialiser le mot de passe
         * @return string le nouveau mot de passe ou false si l'utilisateur n'existe pas
         */
        public function reinitialiserMotDePasse($id_annuaire, $mail) {

                $str = "";
                $chaine = "abcdefghkmnpqrstuvwxyzABCDEFGHKLMNPQRSTUVWXYZ23456789";

                srand((double)microtime()*1000000);
                for($i = 0; $i < 10; $i++){
                        $str .= $chaine[rand()%strlen($chaine)];
                }

                $nouveau_mdp = $str;

                $requete_informations_annuaire =        'SELECT aa_bdd, aa_table '.
                                        'FROM  annu_annuaire '.
                                        'WHERE aa_id_annuaire = '.$id_annuaire.' ';
                $resultat_informations_annuaire = $this->requeteUn($requete_informations_annuaire);

                $champs_mappage = $this->obtenirChampsMappageAnnuaire($id_annuaire);

                $requete_modification_mdp = 'UPDATE '.$resultat_informations_annuaire['aa_bdd'].'.'.$resultat_informations_annuaire['aa_table'].
                                ' SET '.$champs_mappage[0]['champ_pass'].' = '.$nouveau_mdp.
                                ' WHERE '.$champs_mappage[0]['champ_mail'].' = '.$this->proteger($mail);

                return $nouveau_mdp;

                $resultat_modification_mdp = $this->requete($requete_modification_mdp);

                if($resultat_modification_mdp) {
                        return $nouveau_mdp;
                }

                return false;
        }

}
?>