Subversion Repositories Applications.annuaire

<?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'];

			$annuaire[] = $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 = 'DELETE FROM annu_meta_colonne '.

					'WHERE amc_id_champ = '.$id_metadonnee;

		return $this->requete($requete);

	}

	/**

	 * 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 '.

					'FROM annu_meta_ontologie '.

					'WHERE amo_ce_parent = '.$id_parent.' '.

					'AND amo_id_ontologie = '.$id_ontologie;

		return $this->requeteUn($requete);

	}

	/**

	 * 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 renvoyerCorrespondanceNomTemplateChamp($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'];

	}

	/**

	 * 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_valeur_metadonnee, $valeur) {

		$requete = 'UPDATE annu_meta_valeurs '.

		'SET amv_valeur = '.$this->proteger($valeur).' '.

		'WHERE amv_id_valeur = '.$id_valeur_metadonnee;

		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);

	}

	/**

	 * 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) {

		// TODO: la jointure est elle la plus efficace pour ce type de requete ?

		// voir si des index bien placés peuvent résoudre le problème

		// et faire plein de tests

	 	$requete_valeurs_metadonnees = 'SELECT amv_ce_colonne, amv_valeur, amc_ce_ontologie, amc_abreviation, amo_nom FROM annu_meta_valeurs '.

	 				'LEFT JOIN annu_meta_colonne '.

	 				'ON annu_meta_colonne.amc_id_champ = annu_meta_valeurs.amv_ce_colonne '.

	 				'LEFT JOIN annu_meta_ontologie '.

	 				'ON annu_meta_ontologie.amo_ce_parent = annu_meta_colonne.amc_ce_ontologie AND '.

	 				'annu_meta_valeurs.amv_valeur = annu_meta_ontologie.amo_id_ontologie '.

	 				'WHERE amv_cle_ligne = '.$id_enregistrement_lie.' ';

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

		if(!$resultat_valeurs_metadonnees) {

			return false;

		}

	 	$liste_metadonnee = array();

	 	foreach ($resultat_valeurs_metadonnees as $ligne) {

			$liste_metadonnee[$ligne['amc_abreviation']] = $ligne;

		}

		return $liste_metadonnee;

	 }

}

?>