WebSVN – eFlore/Applications.del – Diff – /trunk/services/modules/0.1/observations/Observation.php

 <?php
 /**
- * Le web service observations récupère toutes les information pour une observation:
+ * Web service retournant toutes les infos d'une observation donnée :
  * images, votes sur image et protocole, commentaires, votes sur commentaires, ...
+ *
- * @category	php 5.2
+ * @category	DEL
+ * @package		Observations
+ * @version		0.1
  * @author		Raphaël Droz <raphael@tela-botanica.org>
+ * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
  * @copyright	Copyright (c) 2013, Tela Botanica (accueil@tela-botanica.org)
- * @license	http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
+ * @license		GPL v3 <http://www.gnu.org/licenses/gpl.txt>
- * @license	http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
+ * @license		CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
- * @see http://www.tela-botanica.org/wikini/eflore/wakka.php?wiki=ApiIdentiplante01Observations
+ * @see			http://www.tela-botanica.org/wikini/eflore/wakka.php?wiki=ApiIdentiplante01Observations
+ *
- * @config-depend: "url_image" (dans configurations/config_observations.ini)
+ * @config-depend: "url_image" (dans configurations/config_observations.ini) ex: http://www.tela-botanica.org/appli:cel-img:%09dXL.jpg
- *				   ex: http://www.tela-botanica.org/appli:cel-img:%09dXL.jpg
  */
 // http://localhost/del/services/0.1/observations/#id => une observation donnée et ses images, SANS LES propositions & nombre de commentaire
+require_once(dirname(__FILE__) . '/../DelTk.php');
+class Observation {
 require_once(dirname(__FILE__) . '/../DelTk.php');
 	private $conteneur;
-class Observation {
+	private $gestionBdd;
 	private $bdd;
 	/* Map les champs MySQL vers les champs utilisés dans le JSON pour les clients pour
 			"nom_ret_nn" => 1,
 			"nom_referentiel" => 1,
 			"proposition_initiale" => 1),
 	);
-	private $conteneur;
-	private $gestionBdd;
-	private $bdd;
 	public function __construct(Conteneur $conteneur = null) {
 		$this->conteneur = $conteneur == null ? new Conteneur() : $conteneur;
 		$this->conteneur->chargerConfiguration('config_votes.ini');
 		$this->conteneur->chargerConfiguration('config_mapping_votes.ini');
 		// d'observations (... convergence avec ListeObservations & DelTk)
 		$observation = array_pop($observations);
 		// 3) charge les données de votes et protocoles associés aux images
-		if($observation['images']) {
+		if ($observation['images']) {
 			$votes = self::chargerVotesImage($this->bdd, $observation['images'], $protocole);
-			// 3") merge/reformate les données retournées
-			self::mapVotesToImages($votes,
+			// 3") merge/reformate les données retournées
-								   $observation['images']);
+			self::mapVotesToImages($votes, $observation['images']);
+		}
-		// 4) charge les commentaires et les votes associés
-		// modifie/créé $observation['commentaires']
+		// 4) charge les commentaires et les votes associés
-		self::chargerCommentaires($this->bdd, $observation);
+		// modifie/créé $observation['commentaires']
 		self::chargerCommentaires($this->bdd, $observation);
 		// désindexe le tableau (tel qu'apparement attendu par les applis), c'est une exception
+		// corriger l'appli cliente pour utiliser les index puis supprimer cette ligne
+		$observation['images'] = array_values($observation['images']);
+		// autre élément de post-processing: le ce_utilisateur de l'observation non-numeric...
-		// corriger l'appli cliente pour utiliser les index puis supprimer cette ligne
+		if (!is_numeric($observation['auteur.id'])) {
-		$observation['images'] = array_values($observation['images']);
+			$observation['auteur.id'] = "0";
-		// autre élément de post-processing: le ce_utilisateur de l'observation non-numeric...
+		}
+		if (!isset($observation['auteur.nom'])) {
+			$observation['auteur.nom'] = '[inconnu]';
 		if(!is_numeric($observation['auteur.id'])) $observation['auteur.id'] = "0";
 		if(!isset($observation['auteur.nom'])) $observation['auteur.nom'] = '[inconnu]';
 		if (isset($parametres['justthrow'])) {
 			return $observation;
+	}
 	// Charger les images et leurs votes associés
 	static function chargerVotesImage($db, $images, $protocole = NULL) {
-		if(!$images) return NULL;
+		if (!$images) return NULL;
  		$select = array('votes' =>
 			($where ? implode(' AND ', $where) : 1),
 			$ordreDesIdsRecus,
 			__FILE__ . ':' . __LINE__);
-		//echo "REQUETE: $req"; exit;
 		//echo "REQUETE: $req"; exit;
 		return $db->recupererTous($req);
+	}
 	 * descriptif = protocole.descriptif, valeur = vote
 	 * Alors $retour[ contient:
+	 *
 	 * */
 	static function mapVotesToImages($votes, &$images) {
-		if(!$votes) return;
+		if (!$votes) return;
 		// pour chaque vote
 		foreach ($votes as $vote) {
 			$imgid = $vote['image.id'];
 			" WHERE ce_observation = %d -- %s",
 			$comment_fields, $vote_fields,
 			$observation['id_observation'],
 			__FILE__ . ':' . __LINE__));
-		if(!$commentaires) return;
+		if (!$commentaires) return;
 		// les commentaires réunifiées et dont les votes sont mergés
 		$ret = array();
 		foreach ($commentaires as $comment) {
 			$commentid = $comment['id_commentaire'];
 			$voteid = $comment['vote.id'];
-			if(!array_key_exists($commentid, $ret)) {
+			if (!array_key_exists($commentid, $ret)) {
 				$comment_extract = array_intersect_key($comment, array_flip(self::$mappings['commentaires']));
 				// cas particulier: conflit d'aliases avec del_commentaire_vote
 				// toujours un éléments "votes", quand bien même il n'y en aurait pas
 				$comment_extract['votes'] = array();
 				$ret[$commentid] = $comment_extract;
+			}
-			if(!$comment['nom_sel'] || ! $voteid) continue;
+			if (!$comment['nom_sel'] || ! $voteid) continue;
 			$vote = array_intersect_key($comment, array_flip(self::$mappings['votes']));
 			$ret[$commentid]['votes'][$voteid] = $vote;
+		}
 		$observation['commentaires'] = $ret;
+	}
 	// cf ListeObservation::reformateObservation() et ListeImages2::reformateImagesDoubleIndex()
-    // (trop de variétés de formatage, à unifier côté client pour unifier côté backend ...)
+	// (trop de variétés de formatage, à unifier côté client pour unifier côté backend ...)
 	static function reformateObservationSimpleIndex($obs, $url_pattern = '') {
 		// XXX: cf Observation.php::consulter(), nous pourriouns ici
 		// conserver les valeurs vides (pour les phptests notamment, ou non)
 		$obs = array_map('array_filter', $obs);
 		$obs_merged = array();
-		foreach($obs as $o) {
+		foreach ($obs as $o) {
 			$id = $o['id_observation'];
 			$image = array_intersect_key($o, array_flip(array('id_image', 'date', 'hauteur' , 'largeur', 'nom_original')));
 			$image['binaire.href'] = sprintf($url_pattern, $image['id_image']);
 			unset($o['id_image'], $o['date'], $o['hauteur'], $o['largeur'], $o['nom_original']);
 			if(!isset($obs_merged[$id])) $obs_merged[$id] = $o;
 			$obs_merged[$id]['images'][$image['id_image']] = $image;
+		}
+		return $obs_merged;
+	}
+	/**
+	 * Modifie une observation directement dans le CEL en faisant un appel à un web service du CEL.
+	 * Utilisé uniquement par les admins.
+	 * Permet de dépublier une observation.
+	 *
+	 * @param array		$ressources tableau des informations contenues dans l'url après le nom du service
+	 * @param array		$parametres contenu du post
+	 * @return mixed	Chaine "OK" en cas de succès, booléen "false" en cas d'échec
+	 */
+	public function modifier($ressources, $parametres) {
+		$retour = false;
+		if (isset($parametres['transmission'])) {
+			$idObs = $ressources[0];
+			$clientRest = $this->conteneur->getRestClient();
+			$urlTpl = $this->conteneur->getParametre('urlServiceCelObs');
+			$url = $urlTpl.$idObs;
+			$retour = $clientRest->modifier($url, $parametres);
 		return $obs_merged;
 		return $retour;

Subversion Repositories eFlore/Applications.del

(root)/trunk/services/modules/0.1/observations/Observation.php @ 1684 – Rev 1666 → 1684