WebSVN – eFlore/Applications.cel – Diff – /trunk/jrest/services/CelObs.php


<?php
// declare(encoding='UTF-8');
/**
 * Service générique de modification des observations.
 
 
 *
 * Cas d'utilisation :
 * GET /CelObs/[id] : oû id est l'identifiant d'une observation publique
 * POST /CelObs/[id] : oû id est l'identifiant d'une observation publique
 * si les data du POST contienent :
 *   - 1 données :
 *     - 'transmission' : publier ou dépublier une obs
 *   - 3 données :
 *     - 'id_observation', 'nom_sel_nn', 'nom_referentiel' : permet d'accepter une proposition (DEL)
 *
 * @internal   Mininum PHP version : 5.2
 * @category   CEL
 * @package    Services
 * @subpackage Observations
 * @version    0.1
 * @author     Mathias CHOUET <mathias@tela-botanica.org>
 * @author     Jean-Pascal MILCENT <jpm@tela-botanica.org>
 * @author     Aurelien PERONNET <aurelien@tela-botanica.org>
 * @license    GPL v3 <http://www.gnu.org/licenses/gpl.txt>
 * @license    CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
 
 * @copyright  1999-2014 Tela Botanica <accueil@tela-botanica.org>
 */
class CelObs extends Cel {
	private $rechercheObs = null;
	private $chpsEtendus = null;
	private $donnees = null;
 
	public function __construct($config) {
		parent::__construct($config);
		$this->rechercheObs = new RechercheObservation($config);
		$this->chpsEtendus = new GestionChampsEtendus($config, 'obs');
 
		$this->chargerNomsTablesReferentiels();
	}
 
	private function chargerNomsTablesReferentiels() {
		// Créé des attributs avec le code du référentiel : bdtfx, bdtxa, apd, isfan
		foreach ( $this->config['referentiels'] as $referentiel => $table) {
			$this->$referentiel = $table;
		}
	}
 
	public function getElement($ressources){
		$retour = false;
		$idObs = $ressources[0];
		if (isset($idObs) && preg_match('/^[0-9]+$/', $idObs)) {
 
			$criteres = array('id_observation' => $idObs, 'transmission' => 1);
			$obsTrouvee = $this->rechercheObs->rechercherObservations(null, $criteres, 0, 1)->get();
 
			$observation = array();
			if (is_array($obsTrouvee) && count($obsTrouvee) > 0) {
				$observation = $obsTrouvee[0];
			}
			$observation = $this->preparerChamps($observation);
			$observation = $this->selectionnerChamps($observation);
			$observation = $this->formaterClePourJs($observation);
 
			$champsEtendus = $this->chpsEtendus->consulter($idObs);
			if (is_array($champsEtendus) && count($champsEtendus) > 0) {
				$champsEtendus = $this->preparerChampsEtendus($champsEtendus);
				$observation['extension'] = $champsEtendus;
			}
 
			$this->envoyerJson($observation);
			$retour = true;
		}
		return $retour;
	}
 
	private function preparerChamps($champs) {
		if (isset($champs['date_observation'])) {
			$date = explode(' ', $champs['date_observation']);
			$champs['date_observation'] = $date[0];
		}
		return $champs;
	}
 
	private function selectionnerChamps($observation) {
		$champs = array('id_observation', 'nom_sel', 'nom_ret', 'nom_ret_nn', 'nt', 'famille',
			'nom_referentiel', 'ce_zone_geo', 'zone_geo', 'lieudit', 'station', 'milieu', 'latitude', 'longitude',
			'geodatum', 'date_observation', 'mots_cles_texte', 'commentaire', 'date_creation', 'date_modification',
			'date_transmission', 'code_insee_calcule', 'abondance', 'certitude', 'phenologie', 'altitude');
		$selection = array();
		foreach ($champs as $chp) {
			if (isset($observation[$chp])) {
				$selection[$chp] = $observation[$chp];
			}
		}
		return $selection;
	}
 
	private function formaterClePourJs(Array $tableau) {
		$tableauJs = array();
		foreach ($tableau as $cle => $valeur) {
			if ($cle == 'ce_zone_geo') {
				$cle = 'codeZoneGeo';
			} else {
				$cle = str_replace(' ', '', ucwords(str_replace('_', ' ', $cle)));
				$cle{0} = strtolower($cle{0});
			}
			$tableauJs[$cle] = $valeur;
		}
		return $tableauJs;
	}
 
	private function preparerChampsEtendus($champs) {
		$retour = array();
		foreach ($champs as $chp) {
			$retour[$chp['cle']] = array('valeur' => $chp['valeur']);
		}
		return $retour;
	}
 
	/**
	 * Méthode appelée avec une requête de type POST et un identifiant d'observation.
	 * Modifie une observation en fonction des informations envoyées en POST.
	 * Utilisé par:
	 * - service:del:0.1/determinations/ : ValiderDetermination.php::modifierObservationParDetermination()
	 * - service:del:0.1/observations/#idObs [POST] : pour dépublier une observation
	 *
	 * @param $uid array	$uid[0] (int) : identifiant observation
	 * @param pairs array	tableau contenant les champs à modifier sous la forme : nom_du_champ=nouvelle_valeur
	 */
	public function updateElement($ressources, $donnees) {
		$this->donnees = $donnees;
		if ($this->controlerAccessibiliteWs()) {
			if ($this->controleAppelIpAutorisee()) {
				$idObs = isset($ressources[0]) ? $ressources[0] : '';
				$this->verifierIdentifiantObs($idObs);
 
				if (count($this->donnees) == 1) {
					$donneesObligatoires = array('transmission');
					if ($this->verifierDonneesObligatoires($donneesObligatoires)) {
						$this->depublierObs($idObs);
						$this->depublierImg($idObs);
					}
				} else if (count($this->donnees) == 3) {
					$donneesObligatoires = array('id_observation', 'nom_sel_nn', 'nom_referentiel');
					if ($this->verifierDonneesObligatoires($donneesObligatoires)) {
						$this->accepterPropositionDEL($idObs);
					}
				} else {
					$msg = "La modification complète d'une observation n'est pas implémentée.";
					$this->envoyerMessageErreur(501, $msg);
				}
 
				$this->envoyer('ok');
			}
		}
		return true;
	}
 
	private function verifierIdentifiantObs($chaine) {
		$ok = preg_match('/^[0-9]+$/', $chaine);
		if ($ok == false) {
			$msg = "Indiquer un seul identifiant numérique d'observation.";
			$this->envoyerMessageErreur(412, $msg);
		}
		return $ok;
	}
 
	private function verifierDonneesObligatoires($champsObligatoires) {
		foreach ($champsObligatoires as $param) {
			if (! isset($this->donnees[$param])) {
				$msg = sprintf("Paramètre %s manquant (parmi %s)", $param, implode(', ', $champsObligatoires));
				$this->envoyerMessageErreur(412, $msg);
			}
		}
		return true;
	}
 
	private function depublierObs($idObs) {
		$gestionnaireObs = new GestionObservation($this->config);
		$depublication = $gestionnaireObs->modifierTransmissionObservation($idObs, false);
		if ($depublication === false) {
			$msg = "Un problème est survenu (voir log). L'observation « $idObs » n'a pas pu être dépubliée.";
			$this->envoyerMessageErreur(304, $msg);
		}
	}
 
	private function depublierImg($idObs) {
		$gestionnaireImg = new GestionImage($this->config);
		$depublication = $gestionnaireImg->modifierTransmissionParObs($idObs, false);
		if ($depublication === false) {
			$msg = "Un problème est survenu (voir log). Les images liées à l'obs « $idObs » n'ont pas pu être dépubliées.";
			$this->envoyerMessageErreur(304, $msg);
		}
	}
 
	/**
	 * Modifie une observation aveec les infos d'une proposition :
	 * Nous complétons les données de la proposition acceptée ici car:
	 * 1) la table tb_del.del_commentaire ne contient pas toutes les informations nécessaires
	 * 2) la table tb_del.del_commentaire ne *devrait* pas contenir beaucoup plus que nom_sel et nom_sel_nn
	 * 3) la génération de ces données ici, au moment de l'UPDATE, est le meilleur garant de leur fiabilité
	 */
	private function accepterPropositionDEL($idObs) {
		$gestion_observation = new GestionObservation($this->config);
		$donnees = array_map('trim', $this->donnees);
		$donneesAModifier = array(
			'certitude' => 'Certaine',
			'nom_referentiel' => $donnees['nom_referentiel'],
		);
		// TODO : la récupération des infos du nom est aussi effectué par la suite voir ce qu'il faut garder
		$infosNoms = $this->getNomInfos($donnees['nom_sel_nn'], $donnees['nom_referentiel']);
		if ($infosNoms) {
			$donneesAModifier = array_merge($donneesAModifier, $infosNoms);
		}
 
		$modification = $gestion_observation->modifierObservationPublique($idObs, $donneesAModifier);
 
		if ($modification) {
			// TODO: en modifiant bien la classe de gestion mots clés, on aurait peut être pas besoin de l'id
			// utilisateur (car l'id de l'obs est déjà sans ambiguité)
			$idUtilisateur = $this->rechercheObs->obtenirIdUtilisateurPourIdObs($idObs);
 
			// supression des éventuelles liaison de l'obs avec le mot clé contenu dans obsKeywordDelete
			$gestionMotsClesObs = new GestionMotsClesChemin($this->config, 'obs');
			$supp_liaison_mot_cle = $gestionMotsClesObs->supprimerLiaisonPourMotCleEtIdElementLie('aDeterminer', $idObs, $idUtilisateur);
		} else {
			$msg = "Impossible de modifier l'observation associée à cet identifiant. Erreur mysql : " . mysql_error();
			$this->envoyerMessageErreur(500, $msg);// Internal Server Error
		}
	}
 
	// TODO : cette méthode et celles qui en dépendent sont peut être inutiles au vue de la méthode traiterEspece() de GestionObservation
	private function getNomInfos($id_nom, $code_referentiel) {
		$retour = false;
		if ($id_nom && $code_referentiel) {
			switch ($code_referentiel) {
				case 'bdtfx' :
					$retour = $this->getInfosBdtfx($id_nom);
					break;
				case 'bdtxa' :
					$retour = $this->getInfosBdtxa($id_nom);
					break;
				case 'isfan' :
					$retour = $this->getInfosIsfan($id_nom);
					break;
				case 'apd' :
					$retour = $this->getInfosApd($id_nom);
					break;
			}
		}
		return $retour;
	}
 
	private function getInfosBdtfx($id_nom) {
		$idNomP = CEL::db()->proteger($id_nom);
		$requete = "SELECT o.num_nom_retenu AS nom_ret_nn, o.num_taxonomique AS nt, o.famille, ".
			"	CONCAT(o.nom_sci, ' ', o.auteur) AS nom_sel, ".
			"	CONCAT(ret.nom_sci, ' ', ret.auteur) AS nom_ret ".
			"FROM {$this->bdtfx} AS o ".
			"	LEFT JOIN {$this->bdtfx} AS ret ON (o.num_nom_retenu != 0 AND o.num_nom_retenu = ret.num_nom) ".
			"WHERE o.num_nom = $idNomP ".
			' -- '.__FILE__.' : '.__LINE__;
		$resultat = Cel::db()->requeterLigne($requete);
		return $resultat;
	}
 
	private function getInfosBdtxa($id_nom) {
		$idNomP = CEL::db()->proteger($id_nom);
		// Champ "num_tax" au lieu de "num_taxonomique"
		$requete = "SELECT o.num_nom_retenu AS nom_ret_nn, o.num_tax AS nt, o.famille, ".
			"	CONCAT(o.nom_sci, ' ', o.auteur) AS nom_sel, ".
			"	CONCAT(ret.nom_sci, ' ', ret.auteur) AS nom_ret ".
			"FROM {$this->bdtxa} AS o ".
			"	LEFT JOIN {$this->bdtxa} AS ret ON (o.num_nom_retenu != 0 AND o.num_nom_retenu = ret.num_nom) ".
			"WHERE o.num_nom = $idNomP ".
			' -- '.__FILE__.' : '.__LINE__;
		$resultat = Cel::db()->requeterLigne($requete);
		return $resultat;
	}
 
	private function getInfosIsfan($id_nom) {
		$idNomP = CEL::db()->proteger($id_nom);
		// Champ "num_tax" au lieu de "num_taxonomique"
		$requete = "SELECT o.num_nom_retenu AS nom_ret_nn, o.num_taxonomique AS nt, o.famille, ".
			"	CONCAT(o.nom_sci, ' ', o.auteur) AS nom_sel, ".
			"	CONCAT(ret.nom_sci, ' ', ret.auteur) AS nom_ret ".
			"FROM {$this->isfan} AS o ".
			"	LEFT JOIN {$this->isfan} AS ret ON (o.num_nom_retenu != 0 AND o.num_nom_retenu = ret.num_nom) ".
			"WHERE o.num_nom = $idNomP ".
			' -- '.__FILE__.' : '.__LINE__;
		$resultat = Cel::db()->requeterLigne($requete);
		return $resultat;
	}
 
	private function getInfosApd($id_nom) {
		$idNomP = CEL::db()->proteger($id_nom);
		// Champ "num_tax" au lieu de "num_taxonomique"
		$requete = "SELECT o.num_nom_retenu AS nom_ret_nn, o.num_taxonomique AS nt, o.famille, ".
			"	CONCAT(o.nom_sci, ' ', o.auteur) AS nom_sel, ".
			"	CONCAT(ret.nom_sci, ' ', ret.auteur) AS nom_ret ".
			"FROM {$this->apd} AS o ".
			"	LEFT JOIN {$this->apd} AS ret ON (o.num_nom_retenu != 0 AND o.num_nom_retenu = ret.num_nom) ".
			"WHERE o.num_nom = $idNomP ".
			' -- '.__FILE__.' : '.__LINE__;
		$resultat = Cel::db()->requeterLigne($requete);
		return $resultat;
	}
}

Subversion Repositories eFlore/Applications.cel

(root)/trunk/jrest/services/CelObs.php – Rev 2394 → 2461

Rev 2394		Rev 2461
1	`<?php`	1	`<?php`
2	`// declare(encoding='UTF-8');`	2	`// declare(encoding='UTF-8');`
3	`/**`	3	`/**`
4	`* Service permettant de récupérer toutes les informations d'une observation publique.`	4	`* Service générique de modification des observations.`
5	`* Encodage en entrée : utf8`	-
6	`* Encodage en sortie : utf8`	-
7	`*`	5	`*`
8	`* Cas d'utilisation :`	6	`* Cas d'utilisation :`
9	`* GET /CelObs/[id] : oû id est l'identifiant d'une observation publique`	7	`* GET /CelObs/[id] : oû id est l'identifiant d'une observation publique`
-		8	`* POST /CelObs/[id] : oû id est l'identifiant d'une observation publique`
-		9	`* si les data du POST contienent :`
-		10	`* - 1 données :`
-		11	`* - 'transmission' : publier ou dépublier une obs`
-		12	`* - 3 données :`
-		13	`* - 'id_observation', 'nom_sel_nn', 'nom_referentiel' : permet d'accepter une proposition (DEL)`
10	`*`	14	`*`
-		15	`* @internal Mininum PHP version : 5.2`
-		16	`* @category CEL`
-		17	`* @package Services`
-		18	`* @subpackage Observations`
-		19	`* @version 0.1`
-		20	`* @author Mathias CHOUET <mathias@tela-botanica.org>`
11	`* @author Jean-Pascal MILCENT <jpm@clapas.org>`	21	`* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>`
-		22	`* @author Aurelien PERONNET <aurelien@tela-botanica.org>`
12	`* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>`	23	`* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>`
13	`* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>`	24	`* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>`
14	`* @version $Id$`	-
15	`* @copyright © 2013, Jean-Pascal MILCENT`	25	`* @copyright 1999-2014 Tela Botanica <accueil@tela-botanica.org>`
16	`*/`	26	`*/`
17	`class CelObs extends Cel {`	27	`class CelObs extends Cel {`
18	`private $rechercheObs = null;`	28	`private $rechercheObs = null;`
19	`private $chpsEtendus = null;`	29	`private $chpsEtendus = null;`
20	`private $donnees = null;`	30	`private $donnees = null;`
21		31
22	`public function __construct($config) {`	32	`public function __construct($config) {`
23	`parent::__construct($config);`	33	`parent::__construct($config);`
24	`$this->rechercheObs = new RechercheObservation($config);`	34	`$this->rechercheObs = new RechercheObservation($config);`
25	`$this->chpsEtendus = new GestionChampsEtendus($config, 'obs');`	35	`$this->chpsEtendus = new GestionChampsEtendus($config, 'obs');`
26		36
27	`$this->chargerNomsTablesReferentiels();`	37	`$this->chargerNomsTablesReferentiels();`