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 configprivate $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 fonctionreturn 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 fonctionreturn 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'ontologieif($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éesif(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ètreif($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;}}}?>