WebSVN – eFlore/Projets.eflore-projets – Diff – /trunk/services/modules/0.1/nvjfl/NomsVernaculaires.php

 */
 // Un caractère de concaténation entre le projet et le service.
 // Ce caractère ne doit pas faire partie d'aucun des noms de service ou projet
+define('RES_VAL_SEP', '@');
-define('RES_VAL_SEP', '@');
+define('SPE_INDEX_NVJFL', '_result_ontologies' . RES_VAL_SEP . 'nvjfl');
+class NomsVernaculaires extends Commun {
-class NomsVernaculaires extends Commun {
+	static $onto_multi_support = array('conseil_emploi', 'genre');
-	protected $champ_infos = array(
+	static $champ_infos = array(
 		'taxon' => array('service' => 'taxons', 'ressource' => 'nt:', 'projet' => 'bdtfx', 'nom' => 'nom_sci',
 						 // utilisés par ajouterChampsOntologieLigneResultat()
 						 'intitule' => 'taxon.code', // intitulé du champ tel qu'il sera renvoyé en JSON
 		return $table_retour_json;
+	}
 	/**
 	 * Ajoute les champs d'ontologie supplémentaires si necéssaire
+	 * en faisant appels aux web services associés.
+	 * Les appels peuvent être fait individuellement (pour un couple <ontologie:valeur>) ou bien
+	 * regroupés, **si le webservice correspondant le supporte**.
+	 *
+	 * Nous disposons à ce jour de 3 (trois) webservices d'ontologies correspondant aux noms vernaculaires (cf $champ_infos)
+	 * Mais 2 d'entre eux sont identiques, il s'agit de /nvjfl/ontologies/. Or ce webservice supporte le multi-critère.
+	 * Nous pouvons donc factorisé l'appel pour "conseil_emploi" et "genre", mais pas pour "taxon".
 	 * en faisant appels aux web services associés
 	 * @param array in/out $resultats: tous les résultats
 	 */
-	public function ajouterChampsOntologieLigneTousResultats(&$resultats) {
-		foreach($this->champ_infos as $cle => $champs_supplementaires) {
+	public function ajouterChampsOntologieLigneTousResultats(&$resultats) {
-			if(!in_array($cle, $this->champs_supp)) continue;
-			// TODO: n'activer QUE lorsque le webservice ontologie Nvjfl supportera le multi-critère
-			// cf: services/modules/0.1/commun/Ontologies.php
-			if($cle == 'conseil_emploi') {
-				// la factorisation des toutes les valeurs recherchées (pour tous les
-				// résultats, peut [potentiellement] être effectuée ci-dessous)
-				$ontologieParamPending = self::NvjflOntologieIndex($resultats, $champs_supplementaires);
-				$this->NvjflOntologieExpand($ontologieParamPending);
-				self::NvjflOntologieCombine($resultats, $champs_supplementaires);
-				continue;
+		$champs_sup = array_intersect($this->champs_supp, array_keys(self::$champ_infos));
+		// La regroupement des toutes les valeurs recherchées (pour tous les
+		// résultats), pour "les" onotologies supportant le multi-critère est effectué ci-dessous.
+		// Dans les faits ce n'est le cas que pour nvjfl.
+		$ontologieParamPending = self::NvjflOntologieIndex($resultats, $champs_sup);
+		$this->NvjflOntologieExpand($ontologieParamPending);
+		self::NvjflOntologieCombine($resultats);
+		// pour les ontologies multi-critères, on vient de le régler ci-dessus
+		$champs_sup = array_diff($champs_sup, self::$onto_multi_support);
+		// ici, $champs_sup ne peut contenir, au plus, que "taxon".
+		// code historique:
 		foreach($champs_sup as $cle) {
 			$champs_supplementaires = self::$champ_infos[$cle];
 			// extrait, depuis un élément de $champ_infos:
 			// $service, $ressource, $projet, $nom, $intitule, $bdd_champ
 	/* Récupère les valeurs recherchées pour une liste de résultats, (plus ou moins)
 	   spécifiquement au service d'Ontologies de NVJFL.
 	   Aggrège les valeurs dans le tableau retourné.
 	   Une référence vers l'index du tableau (NULL pour l'instant) est laissée dans
 	   un élément du résultat. */
-	static function NvjflOntologieIndex(&$resultats, $champs_infos) {
+	static function NvjflOntologieIndex(&$resultats, $champs_sup) {
+		// nous ne supportons le multi-critère que sur les ontologies nvjfl, et nous
+		// avons précisé celles qui sont concernées dans self::$onto_multi_support
+		$champs_sup = array_intersect($champs_sup, self::$onto_multi_support);
 		$ontologieParamPending = Array();
-		extract($champs_infos);
 		foreach($resultats as &$resultat) {
+			foreach($champs_sup as $v) {
-			$valeur_recherche = $resultat[$bdd_champ]; // NvjflOntologieIndex uniquement pour "conseil_emploi", donc $bdd_champ = 'num_statut'
+				// de cet extract() nous n'utilisons que $bdd_champ et $ressource
+				extract(self::$champ_infos[$v]);
+				if(!isset($resultat[$bdd_champ])) continue;
+				$valeur_recherche = $resultat[$bdd_champ];
-			if(!trim($valeur_recherche)) continue;
+				if(!trim($valeur_recherche)) continue;
+				// XXX: $ressource contient déjà ':' comme suffixe
+				$critere = $ressource . $valeur_recherche;
-			$ontologieParamPending[$ressource . $valeur_recherche] = NULL;
+				$ontologieParamPending[$critere] = NULL;
-			// placeholder pour le résultat
+				// placeholder pour le résultat
-			$resultat['_result_ontologies' . RES_VAL_SEP . 'nvjfl'] =
+				$resultat[SPE_INDEX_NVJFL][$v][$critere] =
-				&$ontologieParamPending[$ressource . $valeur_recherche];
+					&$ontologieParamPending[$critere];
+			}
+		}
 		return $ontologieParamPending;
+	}
 	// TODO: switch to static si il peut en être de même pour ajouterHrefAutreProjet()
 	/* À partir d'un aggrégat des critère de requêtes d'ontologies, spécifiques à NVJFL,
 	   créé une URL multi-critère.
 	   Celle-ci, dans ce cas précis, n'est que la concaténation, par des virgules,
-	   des couples <ressource - valeur recherchée>.
+	   des couples <ressource:ValeurRecherchée>.
-	   L'URL est appelée et la valeur correspondante, dans $criteres_requete, remplacée.
+	   L'URL est appelée et la valeur correspondante est remplacée dans $criteres_requete.
 	   Note: dans le cadre du tryptique index/expand/combine pour lequel cette fonction existe,
-	   la valeur est référencée par une élément d'une ou plusieurs lignes de $resultat correspondantes.
+	   la valeur est référencée par un élément d'une ou plusieurs lignes de $resultat correspondantes.
 	   Celle(s)-ci sera[ont] donc changée(s) dans la foulée. */
 	public function NvjflOntologieExpand(&$criteres_requete) {
+		// équivalent spécifique de ajouterHrefAutreProjet()
-		// équivalent spécifique de ajouterHrefAutreProjet()
+		$valeurs_requises = implode(',', array_keys($criteres_requete));
-		$valeurs_requises = implode(',', array_keys($criteres_requete));
+		// en vérité, nous ne supportons ceci ici que pour nvjfl et non n'importe quel url_service
 		$url = Config::get('url_service').'/ontologies/'.$valeurs_requises;
 		$val = $this->consulterHref($url);
 			$k = key($criteres_requete);
 			$criteres_requete[$k] = $val;
 			return;
+		}
+		// subtilité, cette affectation modifie par conséquent les valeurs dans
-		// subtilité, cette affectation modifie par conséquent $resultats[X]['_result_ontologies' . RES_VAL_SEP . 'nvjfl']
+		// $resultats[X][SPE_INDEX_NVJFL]
 		// dont la référence pointe toujours sur $v
 		foreach($val as $k => $v) $criteres_requete[$k] = $val->$k;
+	}
+	/* Fonction finale du tryptique: réordonne les valeurs obtenues auprès du web-service
-	/* Fonction finale du tryptique: réordonne les valeurs obtenues auprès du web-service
+	   NVJFL en adéquation avec les champs attendus en sortie.
+	   Dès l'indexation des critères, nous avons associé une (ou plusieurs) référence(s) du
+	   tableau de résultats vers le tableau de retour des ontologies à l'aide d'un index
+	   particulier l'index SPE_INDEX_NVJFL qui contient comme élément(s)
-	   NVJFL en adéquation avec les champs attendus en sortie. Pour ce faire, $champs_infos
+	   un ou plusieurs ontologies (les indexes de self::$champ_infos) qui elles-mêmes contiennent
+	   une ou plusieurs valeurs représentant les valeurs recherchées appartement à cette ontologies.
+	   Celui-ci est supprimé après avoir été correctement copié. */
+	/**
+	 * @param array in/out $resultats: tous les résultats
-	   est nécessaire. D'autre part, l'index spécifique '_result_ontologies' . RES_VAL_SEP . 'nvjfl'
+	 * @param array in $critere: tableau des ontologies:valeur demandées, de la forme [ numStatut:1, genreNombre:11, ... ]
-	   est supprimé après avoir été correctement copié. */
-	static function NvjflOntologieCombine(&$resultats, $champs_infos) {
+	 */
-		extract($champs_infos);
+	static function NvjflOntologieCombine(&$resultats, $criteres) {
+		foreach($resultats as &$resultat) {
+			if(!array_key_exists(SPE_INDEX_NVJFL, $resultat)) continue;
+			/* Note: la complétude d'un résultat peut dépendre de plusieurs ontologies différentes,
+			   d'où cette boucle. Cependant une seule valeur sera demandé pour cette ontologie, c'est pourquoi
+			   $resultat[SPE_INDEX_NVJFL][$onto_name], s'il existe, ne contiendra toujours qu'un seul élément.
+			   Puisque par définition un résultat contenant des valeurs d'ontologie n'aura jamais qu'un seul et unique
+			   attribut num_genre (ou num_statut, ou autre) */
+			foreach(self::$onto_multi_support as $onto_name) {
+				/* $onto_name est un nom d'ontologie (l'une des clefs, parmi conseil_emploi et genre,
+				   cf la boucle sur $champs_sup dans  NvjflOntologieIndex()
+				   de cet extract() nous n'utilisons que $intitule et $nom */
-		foreach($resultats as &$resultat) {
+				extract(self::$champ_infos[$onto_name]);
-			if(!array_key_exists('_result_ontologies' . RES_VAL_SEP . 'nvjfl', $resultat)) continue;
+				// equivalent de l'affectation finale de chercherSignificationCode()
+				// (utilisé lors de recherches d'ontologies en mono-critère)
+				// XXX: PHP-5.3 pas de récupération d'attribut sur fonction
+				$r = current($resultat[SPE_INDEX_NVJFL][$onto_name]);
+				$resultat[$intitule] = $r->$nom;
-			// equivalent de chercher signification
+				// XXX: certes nous pourrions nous contenter du unset() final
+				unset($resultat[SPE_INDEX_NVJFL][$onto_name]);
 			$resultat[$intitule] = $resultat['_result_ontologies' . RES_VAL_SEP . 'nvjfl']->$nom;
-			unset($resultat['_result_ontologies' . RES_VAL_SEP . 'nvjfl']);
+			unset($resultat[SPE_INDEX_NVJFL]);
+		}
+	}
 	 * @param array $ligne_resultat
+	 *
 	 * @return array la ligne modifiée
 	 */
 	public function ajouterChampsOntologieLigneResultat($ligne_resultat) {
-		foreach($this->champ_infos as $cle => $champs_supplementaires) {
+		foreach(self::$champ_infos as $cle => $champs_supplementaires) {
 			if(!in_array($cle, $this->champs_supp)) continue;
 			// extrait, depuis un élément de $champ_infos:
 			// $service, $ressource, $projet, $nom, $intitule, $bdd_champ
 			extract($champs_supplementaires);
 			$valeur_recherche = $ligne_resultat[$bdd_champ];
 			$this->table_retour[$champ] = $valeur;
+		}
+	}
 	public function afficherPointCode($nomChamp, $langue, $num_nom, $valeur) {
-		if (isset($this->champ_infos[$nomChamp])) {
+		if (isset(self::$champ_infos[$nomChamp])) {
-			extract($this->champ_infos[$nomChamp]);
+			extract(self::$champ_infos[$nomChamp]);
+		}
 		if ($this->retour_format == 'max') {
+	}
 	public function afficherPoint($champ, $valeur, $langue, $num_nom) {
 		preg_match('/^(.*)\.code$/', $champ, $match);
 		$champ = $match[1];
-		if (isset($this->champ_infos[$champ])) {
+		if (isset(self::$champ_infos[$champ])) {
-			extract($this->champ_infos[$champ]);
+			extract(self::$champ_infos[$champ]);
 			$url = $this->ajouterHrefAutreProjet($service, $ressource, $valeur, $projet);
 			$projet .= '.';
+		}

Subversion Repositories eFlore/Projets.eflore-projets

(root)/trunk/services/modules/0.1/nvjfl/NomsVernaculaires.php – Rev 831 → 832