Subversion Repositories eFlore/Applications.cel

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

					}

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

		}

	}

	/**

	 * 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'],

			'nom_sel_nn' => $donnees['nom_sel_nn'],

		);

		$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

		}

	}

}