Subversion Repositories Applications.annuaire

Rev

Rev 59 | Rev 152 | 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 MetadonneeModele extends Modele {

        private $config = array();
        // TODO: externaliser l'identifiant de la liste des types depuis le fichier de config
        private $id_liste_liste = 0;
        private $id_liste_type = 1002;
        private $id_liste_champs = 30768;

        /**
         * Charge la liste complète des champs de métadonnées associées à un annuaire en particulier
         * return array un tableau contenant des objets d'informations sur les listes
         * @return array un tableau d'objets contenant la liste des listes
         */
        public function chargerListeMetadonneeAnnuaire($id_annuaire) {

                $requete =      'SELECT * '.
                                        'FROM annu_meta_colonne '.
                                        'WHERE amc_ce_annuaire = '.$id_annuaire ;

                $resultat = $this->requeteTous($requete);
                $annuaire = array();
                foreach ($resultat as $ligne) {
                        // On remplace l'identifiant du type d'affichage par son nom
                        $type_affichage = $this->renvoyerCorrespondanceNomId($ligne['amc_ce_type_affichage'], $this->id_liste_champs);
                        $ligne['amc_ce_nom_type_affichage']  = $type_affichage['amo_nom'];
                        $ligne['amc_ce_template_affichage'] = $type_affichage['amo_abreviation'];
                        $annuaire[$ligne['amc_id_champ']] = $ligne;
                }

                return $annuaire;
        }

        /**
         * Charge les elements d'une liste d'ontologie donnée
         * @param int $id_liste l'identifiant de la liste dont on veut les élements
         * @param Array un tableau contenant les élements de la liste
         */
        public function chargerInfosListe($id_liste) {
                $requete = 'SELECT amo_nom, amo_id_ontologie '.
                                        'FROM annu_meta_ontologie '.
                                        'WHERE amo_ce_parent = '.$id_liste.' '.
                                        'ORDER BY amo_nom';

                $resultat = $this->requeteTous($requete);
                $liste_types = array();
                foreach ($resultat as $ligne) {
                        $liste_types[] = $ligne;
                }

                return $liste_types;
        }

        /**
         * Charge la liste complète des types de champ
         * return array un tableau contenant des objets d'informations sur les types de champ
         * @return array un tableau d'objets contenant la liste des types de champs
         */
        public function chargerListeDesTypesDeChamps() {
                return $this->chargerInfosListe($this->id_liste_champs);
        }

        /**
         * Charge la liste complète des types SQL
         * return array un tableau contenant des objets d'informations sur les types SQL
         * @return array un tableau d'objets contenant la liste types de métadonnées
         */
        public function chargerListeDesTypesSQL() {
                return $this->chargerInfosListe($this->id_liste_type);
        }

        /**
         * Charge la liste complète des listes de métadonnées que l'on peut associer à un annuaire
         * return array un tableau contenant des objets d'informations sur les types de métadonnées
         * @return array un tableau d'objets contenant la liste types de métadonnées
         */
        public function chargerListeDesListes() {
                return $this->chargerInfosListe($this->id_liste_liste);
        }

        /**
         * Charge les informations d'une metadonnee
         * @param int l'identifiant de cette metadonnee
         * @return Array un tableau contenant les informations sur cette metadonnee
         */
         public function chargerInformationsMetaDonnee($id) {
                $requete = 'SELECT * '.
                                        'FROM annu_meta_colonne '.
                                        'WHERE amc_id_champ = '.$id;

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

        /**
         * Ajoute une nouvelle méta colonne à un annuaire donné
         * @param Array $valeurs les valeurs à ajouter dans la base
         * @return boolean true si la requete a réussi, false sinon
         */
        public function ajouterNouvelleMetadonnee($valeurs) {

                $ontologie_liee = $this->proteger($valeurs['amc_ce_ontologie']);
                $annuaire_lie = $this->proteger($valeurs['amc_ce_annuaire']);
                $type_sql = $this->renvoyerTypeSQLPourChamp($valeurs['amc_ce_type_affichage']);
                $longueur = $this->renvoyerLongueurPourChamp($valeurs['amc_ce_type_affichage']);
                $nom = $this->proteger($valeurs['amc_nom']);
                $abreviation = $this->proteger($valeurs['amc_abreviation']);
                $description = $this->proteger($valeurs['amc_description']);
                $type_affichage = $this->proteger($valeurs['amc_ce_type_affichage']);

                $requete = 'INSERT INTO annu_meta_colonne '.
                                        '(amc_ce_ontologie, amc_ce_annuaire, amc_ce_type, amc_longueur, amc_nom, amc_abreviation, amc_description, amc_ce_type_affichage) '.
                                        'VALUES ('.$ontologie_liee.', '.
                                                        $annuaire_lie.', '.
                                                        $type_sql.', '.
                                                        $longueur.', '.
                                                        $nom.','.
                                                        $abreviation.','.
                                                        $description.', '.
                                                        $type_affichage.')';

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

        /**
         * Modifie une meta colonne liée à un annuaire, grâce aux valeurs passées en paramètre
         * @param Array $valeurs les valeurs à modifier
         * @return boolean true si la requete a réussi, false sinon
         */
        public function modifierMetadonnee($valeurs) {

                $type_sql = $this->renvoyerTypeSQLPourChamp($valeurs['amc_ce_type_affichage']);
                $longueur = $this->renvoyerLongueurPourChamp($valeurs['amc_ce_type_affichage']);
                $nom = $this->proteger($valeurs['amc_nom']);
                $abreviation = $this->proteger($valeurs['amc_abreviation']);
                $description = $this->proteger($valeurs['amc_description']);
                $type_affichage = $this->proteger($valeurs['amc_ce_type_affichage']);

                $requete = 'UPDATE annu_meta_colonne '.
                                        'SET '.
                                        'amc_ce_type_affichage = '.$type_sql.', '.
                                        'amc_longueur = '.$longueur.', '.
                                        'amc_nom = '.$nom.', '.
                                        'amc_abreviation = '.$abreviation.', '.
                                        'amc_description = '.$description.', '.
                                        'amc_ce_type_affichage = '.$type_affichage.' '.
                                        'WHERE amc_id_champ = '.$valeurs['amc_id_champ'];

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

        /**
         * Supprime une metadonnée
         * @param int $id_metadonnee l'identifiant de l'enregistrement à supprimer
         */
        public function supprimerMetadonneeParId($id_metadonnee) {
                $requete_suppression_metadonnee = 'DELETE FROM annu_meta_colonne '.
                                        'WHERE amc_id_champ = '.$id_metadonnee;

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

        /**
         * Renvoie l'identifiant du type sql associé à un identifiant de type de champ
         * exemple champ texte => VARCHAR, champ texte long => TEXT
         * @param int $id_type_champ l'identifiant du type de champ
         * @return int l'identifiant du type sql correspondant
         */
        private function renvoyerTypeSQLPourChamp($id_type_champ) {
                // TODO: faire une vraie fonction
                return 1002 ;
        }

        /**
         * Renvoie la longueur associée à un identifiant de type de champ
         * exemple champ texte => 50, champ texte long => 1000
         * @param int $id_type_champ l'identifiant du type de champ
         * @return int la longueur du champ correspondante
         * @return int la longueur associée au champ
         */
        private function renvoyerLongueurPourChamp($id_type_champ) {
                // TODO: faire une vraie fonction
                return 255 ;
        }

        /**
         * Renvoie le nom d'une valeur de liste d'ontologie grâce à son identifiant
         * @param int $id_ontologie l'identifiant de la valeur dont on veut le nom
         * @param int $id_parent l'identifiant de la liste parente
         * @return string le nom du champ, ou false sinon
         */
        private function renvoyerCorrespondanceNomId($id_ontologie,$id_parent) {
                $requete = 'SELECT amo_nom, amo_abreviation '.
                                        'FROM annu_meta_ontologie '.
                                        'WHERE amo_ce_parent = '.$this->proteger($id_parent).' '.
                                        'AND amo_id_ontologie = '.$this->proteger($id_ontologie);

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

                /**
         * Renvoie le nom d'une valeur de liste d'ontologie grâce à son identifiant
         * @param int $id_ontologie l'identifiant de la valeur dont on veut l'abreviation
         * @return string l'abreviation, ou false sinon
         */
        public function renvoyerCorrespondanceAbreviationId($id_ontologie) {
                $requete = 'SELECT amo_abreviation '.
                                        'FROM annu_meta_ontologie '.
                                        'WHERE amo_id_ontologie = '.$this->proteger($id_ontologie);

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

                if($resultat) {
                        return $resultat['amo_abreviation'];
                } else {
                        return false;
                }
        }


        /**
         * Renvoie le nom du template associé à un champ grâce à son identifiant
         * @param int $id_ontologie l'identifiant du champ dont on veut le template
         * @return string le nom du template (qui est l'abreviation du champ), ou false sinon
         */
        public function renvoyerTypeAffichageParId($id_champ) {

                $requete = 'SELECT amo_abreviation '.
                        'FROM annu_meta_ontologie '.
                        'WHERE amo_ce_parent = '.$this->id_liste_champs.' '.
                        'AND amo_id_ontologie = '.$id_champ;

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

                return $resultat['amo_abreviation'];
        }

        /**
         * Renvoie le nom du template associé à un champ grâce à son identifiant
         * @param int $id_ontologie l'identifiant du champ dont on veut le template
         * @return string le nom du template (qui est l'abreviation du champ), ou false sinon
         */
        public function renvoyerTypeAffichagePourColonne($id_colonne) {

                $requete = 'SELECT amo_abreviation '.
                        'FROM annu_meta_ontologie '.
                        'WHERE amo_ce_parent = '.$this->id_liste_champs.' '.
                        'AND amo_id_ontologie =
                        (SELECT amc_ce_type_affichage '.
                                'FROM annu_meta_colonne '.
                                'WHERE amc_id_champ = '.$id_colonne.')';

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

                if($resultat) {
                        return $resultat['amo_abreviation'];
                } else {
                        return false;
                }
        }

        /**
         * Renvoie vrai si un utilisateur possède une valeur de metadonnées pour une colonne donnée
         */
        public function valeurExiste($id_champ, $id_enregistrement_lie) {

                $requete_existence_valeur =     'SELECT COUNT(*) as valeur_existe '.
                                        'FROM annu_meta_valeurs '.
                                        'WHERE amv_ce_colonne = '.$id_champ.' '.
                                        'AND amv_cle_ligne ='.$id_enregistrement_lie;

                $resultat = $this->requeteUn($requete_existence_valeur);

                return ($resultat['valeur_existe'] >= 1) ;
        }

        /**
         * Ajoute une nouvelle valeur à un champ de metadonnées pour une ligne dans un annuaire donné
         * @param int $id_champ l'identifiant du champ auquel on ajoute cette valeur
         * @param int $id_enregistrement_lie l'identifiant de l'enregistrement lié dans l'annuairé mappé
         * @param mixed $valeur la valeur à associer au champ (peut-être une valeur brute ou bien un identifiant de liste d'ontologie)
         * @return true ou false suivant le succès de la requête
         */
        public function ajouterNouvelleValeurMetadonnee($id_champ, $id_enregistrement_lie, $valeur) {

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

                $requete = 'INSERT INTO annu_meta_valeurs '.
                '(amv_ce_colonne, amv_cle_ligne, amv_valeur) '.
                'VALUES ('.$id_champ.','.$id_enregistrement_lie.','.$valeur.')';

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

        /**
         * Modifie une valeur d'un champ de metadonnées pour une ligne dans un annuaire donné
         * @param int $id_champ l'identifiant du champ dont on modifie la valeur
         * @param mixed $valeur la nouvelle valeur à associer au champ (peut-être une valeur brute ou bien un identifiant de liste d'ontologie)
         * @return boolean true ou false suivant le succès de la requête
         */
        public function modifierValeurMetadonnee($id_champ, $id_enregistrement_lie, $valeur) {

                $requete = 'UPDATE annu_meta_valeurs '.
                'SET amv_valeur = '.$this->proteger($valeur).' '.
                'WHERE amv_cle_ligne = '.$id_enregistrement_lie.' '.
                'AND amv_ce_colonne = '.$id_champ;

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

        /**
         * Supprime une valeur de metadonnée par son identifiant
         * @param int $id_valeur_metadonnee l'identifiant de valeur à supprimer
         * @return true ou false suivant le succès de la requete
         */
        public function supprimerValeurMetadonnee($id_valeur_metadonnee) {

                $requete = 'DELETE FROM annu_meta_valeurs '.
                'WHERE amv_id_valeur = '.$id_valeur_metadonnee;

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

        /**
         * Supprime les valeurs de metadonnées associés à un identifiant de ligne d'annuaire
         * @param int $id_enregistrement_lie l'identifiant de la ligne à laquelle sont associées les valeurs à supprimer
         */
        public function supprimerValeursMetadonneesParIdEnregistrementLie($id_enregistrement_lie) {

                $requete = 'DELETE FROM annu_meta_valeurs '.
                'WHERE amv_cle_ligne = '.$id_enregistrement_lie;

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

        /** Supprime les valeurs de metadonnées associés à un identifiant de colonne
         * @param int $id_colonne_liee l'identifiant de la colonne à laquelle sont associées les valeurs à supprimer
         */
        public function supprimerValeursMetadonneesParIdColonneLiee($id_colonne_liee) {
                $requete = 'DELETE FROM annu_meta_valeurs '.
                'WHERE amv_ce_colonne = '.$id_colonne_liee;

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

        /**
         * Charge les valeurs de metadonnées pour un identifiant de ligne donné
         * @param int $id_annuaire l'identifiant de l'annuaire sur lequel on travaille
         * @param int $id_utilisateur l'identifiant de la ligne dans l'annuaire pour laquelle on veut récupérer les valeur de metadonnées
         */
         public function chargerListeValeursMetadonneesUtilisateur($id_annuaire, $id_enregistrement_lie) {

                // première requete pour obtenir les valeurs des champs de metadonnées liées à la ligne
                $requete_valeurs_metadonnees =  'SELECT amv_ce_colonne, amv_valeur, amc_ce_ontologie, amc_abreviation, amc_ce_type_affichage FROM annu_meta_valeurs '.
                                                                                'LEFT JOIN annu_meta_colonne '.
                                                                                'ON annu_meta_colonne.amc_id_champ = annu_meta_valeurs.amv_ce_colonne '.
                                                                                'WHERE amv_cle_ligne = '.$id_enregistrement_lie.' ';

                $resultat_valeurs_metadonnees = $this->requeteTous($requete_valeurs_metadonnees);

                if(!$resultat_valeurs_metadonnees) {

                        $liste_metadonnee = array();

                } else {
                        foreach ($resultat_valeurs_metadonnees as $ligne) {

                                // pour toutes les valeurs qui sont des élements d'une liste d'ontologie
                                if($ligne['amc_ce_ontologie'] != 0) {

                                        // Si c'est un champ qui contient de multiples valeurs, alors il contient potientiellement le séparateur de métadonnées
                                        if(strpos($ligne['amv_valeur'],Config::get('separateur_metadonnee'))) {

                                                $id_valeurs_metadonnees = explode(Config::get('separateur_metadonnee'), $ligne['amv_valeur']);
                                                $ligne['amv_valeur'] = $id_valeurs_metadonnees;

                                                foreach ($id_valeurs_metadonnees as $id_valeur) {
                                                        $resultat_nom_valeur = $this->renvoyerCorrespondanceNomId($id_valeur,$ligne['amc_ce_ontologie']);
                                                        $ligne['amo_nom'][] = $resultat_nom_valeur['amo_nom'];
                                                }
                                        } else {
                                                $resultat_nom_valeur = $this->renvoyerCorrespondanceNomId($ligne['amv_valeur'],$ligne['amc_ce_ontologie']);
                                                $ligne['amo_nom'] = $resultat_nom_valeur['amo_nom'];
                                        }

                                        $nom_valeur = $resultat_nom_valeur['amo_nom'];
                                }

                                $ligne['amc_ce_type_affichage'] = $this->renvoyerTypeAffichageParId($ligne['amc_ce_type_affichage']);
                                $liste_metadonnee[$ligne['amc_abreviation']] = $ligne;
                        }
                }

                $colonnes_totales = $this->chargerListeMetadonneeAnnuaire($id_annuaire);

                foreach ($colonnes_totales as $colonne) {
                        if(!isset($liste_metadonnee[$colonne['amc_abreviation']])) {

                                if($colonne['amc_ce_ontologie'] != 0) {
                                        $valeur = array();
                                } else {
                                        $valeur = '';
                                }

                                $liste_metadonnee[$colonne['amc_abreviation']] = array('amv_ce_colonne' => $colonne['amc_id_champ'],
                        'amv_valeur' => $valeur,
                        'amo_nom' => '',
                        'amc_ce_ontologie' => $colonne['amc_ce_ontologie'],
                        'amc_abreviation' => $colonne['amc_abreviation'],
                        'amc_ce_type_affichage' => $this->renvoyerTypeAffichageParId($colonne['amc_ce_type_affichage']));
                        }
                }

                return $liste_metadonnee;

         }

        /**
         * Recherche les enregistrements correspondants au criètres donnés et renvoie une liste d'identifiants, correspondants
         * @param int $id_annuaire l'identifiant de l'annuaire dans lequel on recherche
         * @valeurs array un talbeau de valeurs à rechercher
         * $exclusive boolean indique si la recherche doit se faire avec un ET ou bien un OU sur les critèrex
         */
         public function rechercherDansValeurMetadonnees($id_annuaire, $valeurs, $exclusive = true) {

                // Définition du séparateur de requête suivant la paramètre
                if($exclusive) {
                        $separateur = ' AND ';
                } else {
                        $separateur = ' OR ';
                }

                $chaine_recherche = '';

                foreach($valeurs as $nom_champ => $valeur) {

                        if(is_array($valeur)) {
                                foreach($valeur as $cle => $valeur_multi_meta) {
                                        $chaine_recherche .= '(amv_ce_colonne = '.$this->proteger($nom_champ).' AND amv_valeur LIKE '.$this->proteger('%'.$cle.'%').')'.$separateur;
                                }
                        } else {
                                if(trim($valeur) != '') {
                                        $chaine_recherche .= '(amv_ce_colonne = '.$this->proteger($nom_champ).' AND amv_valeur = '.$this->proteger($valeur).')'.$separateur;
                                }
                        }
                }

                if(trim($chaine_recherche) == '') {
                        return array();
                }

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

                $requete_recherche = 'SELECT DISTINCT amv_cle_ligne '.
                                                        'FROM annu_meta_valeurs '.
                                                        'WHERE '.$chaine_recherche ;

                $resultat_recherche = $this->requeteTous($requete_recherche);

                if($resultat_recherche) {

                        $tableau_id = array();
                        foreach($resultat_recherche as $resultat) {
                                $tableau_id[] = $resultat['amv_cle_ligne'];
                        }
                        return $tableau_id;

                } else {
                        return array();
                }
         }

         /**
          * Renvoie les valeur d'une méta colonne pour un identifiant d'enregistrement lié et de meta colonne donnés
          * @param int $id_champ l'identifiant de champ
          * @param int $id_utilisateur l'identifiant de ligne à laquelle est associée la metadonnée
          * @return array un tableau d'informations contenant les données
          */
          public function obtenirValeurMetadonnee($id_champ, $id_enregistrement_lie) {

                $requete_valeur_metadonnee = 'SELECT * FROM annu_meta_valeurs'.
                                                                        ' WHERE amv_ce_colonne = '.$this->proteger($id_champ).
                                                                        ' AND amv_cle_ligne = '.$this->proteger($id_enregistrement_lie);

                $resultat_valeur_metadonnee = $this->requeteTous($requete_valeur_metadonnee);

                if($resultat_valeur_metadonnee) {
                        return $resultat_valeur_metadonnee;
                } else {

                        return false;
                }

          }

          /** Suivant un identifiant de champ, renvoie un tableau contenant le nombre d'enregistrement pour chaque valeur
          * @param int $id_champ l'identifiant de champ
          * @return array un tableau d'informations contenant les données
          */
          public function obtenirNombreValeurMetadonnee($id_champ) {

                $requete_valeurs_liste = 'SELECT amo_nom, amo_abreviation FROM annu_meta_ontologie '.
                                                                'WHERE amo_ce_parent = '.$this->proteger($id_champ);

                $requete_valeur_metadonnee = 'SELECT COUNT(*) as nb, amv_valeur FROM annu_meta_valeurs'.
                                                                        ' WHERE amv_ce_colonne = '.$id_champ.' '.
                                                                        ' GROUP BY amv_valeur '.
                                                                        ' ORDER BY nb DESC';

                $resultat_valeur_metadonnee = $this->requeteTous($requete_valeur_metadonnee);

                if($resultat_valeur_metadonnee) {
                        return $resultat_valeur_metadonnee;
                } else {

                        return false;
                }

          }
}
?>