Subversion Repositories eFlore/Applications.cel

Rev

Go to most recent revision | Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
1582 jpm 1
<?php
2
// declare(encoding='UTF-8');
3
/**
2461 jpm 4
 * Service générique de modification des observations.
1582 jpm 5
 *
6
 * Cas d'utilisation :
7
 * GET /CelObs/[id] : oû id est l'identifiant d'une observation publique
2461 jpm 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)
1582 jpm 14
 *
2461 jpm 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>
21
 * @author     Jean-Pascal MILCENT <jpm@tela-botanica.org>
22
 * @author     Aurelien PERONNET <aurelien@tela-botanica.org>
23
 * @license    GPL v3 <http://www.gnu.org/licenses/gpl.txt>
24
 * @license    CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
25
 * @copyright  1999-2014 Tela Botanica <accueil@tela-botanica.org>
1582 jpm 26
 */
27
class CelObs extends Cel {
28
	private $rechercheObs = null;
29
	private $chpsEtendus = null;
2143 jpm 30
	private $donnees = null;
1582 jpm 31
 
32
	public function __construct($config) {
33
		parent::__construct($config);
3507 delphine 34
		$this->rechercheObs = new RechercheObservationExport($config, array("standard"=>"0"));
1582 jpm 35
		$this->chpsEtendus = new GestionChampsEtendus($config, 'obs');
2152 jpm 36
 
37
		$this->chargerNomsTablesReferentiels();
1582 jpm 38
	}
39
 
2152 jpm 40
	private function chargerNomsTablesReferentiels() {
2155 mathias 41
		// Créé des attributs avec le code du référentiel : bdtfx, bdtxa, apd, isfan
2152 jpm 42
		foreach ( $this->config['referentiels'] as $referentiel => $table) {
43
			$this->$referentiel = $table;
44
		}
45
	}
46
 
2461 jpm 47
	public function getElement($ressources){
1582 jpm 48
		$retour = false;
49
		$idObs = $ressources[0];
50
		if (isset($idObs) && preg_match('/^[0-9]+$/', $idObs)) {
51
 
3507 delphine 52
			$criteres = array('id_observation' => $idObs, 'transmission' => 1, 'standard' => 0);
1631 raphael 53
			$obsTrouvee = $this->rechercheObs->rechercherObservations(null, $criteres, 0, 1)->get();
1582 jpm 54
 
55
			$observation = array();
56
			if (is_array($obsTrouvee) && count($obsTrouvee) > 0) {
57
				$observation = $obsTrouvee[0];
58
			}
59
			$observation = $this->preparerChamps($observation);
60
			$observation = $this->selectionnerChamps($observation);
61
			$observation = $this->formaterClePourJs($observation);
62
 
63
			$champsEtendus = $this->chpsEtendus->consulter($idObs);
64
			if (is_array($champsEtendus) && count($champsEtendus) > 0) {
65
				$champsEtendus = $this->preparerChampsEtendus($champsEtendus);
66
				$observation['extension'] = $champsEtendus;
67
			}
68
 
69
			$this->envoyerJson($observation);
70
			$retour = true;
71
		}
72
		return $retour;
73
	}
74
 
75
	private function preparerChamps($champs) {
76
		if (isset($champs['date_observation'])) {
77
			$date = explode(' ', $champs['date_observation']);
78
			$champs['date_observation'] = $date[0];
79
		}
80
		return $champs;
81
	}
82
 
83
	private function selectionnerChamps($observation) {
84
		$champs = array('id_observation', 'nom_sel', 'nom_ret', 'nom_ret_nn', 'nt', 'famille',
85
			'nom_referentiel', 'ce_zone_geo', 'zone_geo', 'lieudit', 'station', 'milieu', 'latitude', 'longitude',
86
			'geodatum', 'date_observation', 'mots_cles_texte', 'commentaire', 'date_creation', 'date_modification',
87
			'date_transmission', 'code_insee_calcule', 'abondance', 'certitude', 'phenologie', 'altitude');
88
		$selection = array();
89
		foreach ($champs as $chp) {
90
			if (isset($observation[$chp])) {
91
				$selection[$chp] = $observation[$chp];
92
			}
93
		}
94
		return $selection;
95
	}
96
 
97
	private function formaterClePourJs(Array $tableau) {
98
		$tableauJs = array();
99
		foreach ($tableau as $cle => $valeur) {
100
			if ($cle == 'ce_zone_geo') {
101
				$cle = 'codeZoneGeo';
102
			} else {
103
				$cle = str_replace(' ', '', ucwords(str_replace('_', ' ', $cle)));
104
				$cle{0} = strtolower($cle{0});
105
			}
106
			$tableauJs[$cle] = $valeur;
107
		}
108
		return $tableauJs;
109
	}
110
 
111
	private function preparerChampsEtendus($champs) {
112
		$retour = array();
113
		foreach ($champs as $chp) {
2394 aurelien 114
			$retour[$chp['cle']] = array('valeur' => $chp['valeur']);
1582 jpm 115
		}
116
		return $retour;
117
	}
2143 jpm 118
 
119
	/**
120
	 * Méthode appelée avec une requête de type POST et un identifiant d'observation.
121
	 * Modifie une observation en fonction des informations envoyées en POST.
122
	 * Utilisé par:
123
	 * - service:del:0.1/determinations/ : ValiderDetermination.php::modifierObservationParDetermination()
124
	 * - service:del:0.1/observations/#idObs [POST] : pour dépublier une observation
125
	 *
126
	 * @param $uid array	$uid[0] (int) : identifiant observation
127
	 * @param pairs array	tableau contenant les champs à modifier sous la forme : nom_du_champ=nouvelle_valeur
128
	 */
129
	public function updateElement($ressources, $donnees) {
130
		$this->donnees = $donnees;
131
		if ($this->controlerAccessibiliteWs()) {
132
			if ($this->controleAppelIpAutorisee()) {
133
				$idObs = isset($ressources[0]) ? $ressources[0] : '';
134
				$this->verifierIdentifiantObs($idObs);
135
 
2152 jpm 136
				if (count($this->donnees) == 1) {
137
					$donneesObligatoires = array('transmission');
138
					if ($this->verifierDonneesObligatoires($donneesObligatoires)) {
139
						$this->depublierObs($idObs);
2143 jpm 140
					}
2205 aurelien 141
				} else if (count($this->donnees) == 3) {
142
					$donneesObligatoires = array('id_observation', 'nom_sel_nn', 'nom_referentiel');
2143 jpm 143
					if ($this->verifierDonneesObligatoires($donneesObligatoires)) {
2152 jpm 144
						$this->accepterPropositionDEL($idObs);
2143 jpm 145
					}
146
				} else {
2152 jpm 147
					$msg = "La modification complète d'une observation n'est pas implémentée.";
2143 jpm 148
					$this->envoyerMessageErreur(501, $msg);
149
				}
150
 
2152 jpm 151
				$this->envoyer('ok');
2143 jpm 152
			}
153
		}
2156 jpm 154
		return true;
2143 jpm 155
	}
156
 
157
	private function verifierIdentifiantObs($chaine) {
2152 jpm 158
		$ok = preg_match('/^[0-9]+$/', $chaine);
2143 jpm 159
		if ($ok == false) {
2152 jpm 160
			$msg = "Indiquer un seul identifiant numérique d'observation.";
2143 jpm 161
			$this->envoyerMessageErreur(412, $msg);
162
		}
163
		return $ok;
164
	}
165
 
166
	private function verifierDonneesObligatoires($champsObligatoires) {
167
		foreach ($champsObligatoires as $param) {
168
			if (! isset($this->donnees[$param])) {
169
				$msg = sprintf("Paramètre %s manquant (parmi %s)", $param, implode(', ', $champsObligatoires));
170
				$this->envoyerMessageErreur(412, $msg);
171
			}
172
		}
2152 jpm 173
		return true;
2143 jpm 174
	}
175
 
2152 jpm 176
	private function depublierObs($idObs) {
177
		$gestionnaireObs = new GestionObservation($this->config);
178
		$depublication = $gestionnaireObs->modifierTransmissionObservation($idObs, false);
179
		if ($depublication === false) {
2461 jpm 180
			$msg = "Un problème est survenu (voir log). L'observation « $idObs » n'a pas pu être dépubliée.";
2152 jpm 181
			$this->envoyerMessageErreur(304, $msg);
2143 jpm 182
		}
183
	}
184
 
2461 jpm 185
 
3505 delphine 186
 
2152 jpm 187
	/**
188
	 * Modifie une observation aveec les infos d'une proposition :
189
	 * Nous complétons les données de la proposition acceptée ici car:
190
	 * 1) la table tb_del.del_commentaire ne contient pas toutes les informations nécessaires
191
	 * 2) la table tb_del.del_commentaire ne *devrait* pas contenir beaucoup plus que nom_sel et nom_sel_nn
192
	 * 3) la génération de ces données ici, au moment de l'UPDATE, est le meilleur garant de leur fiabilité
193
	 */
194
	private function accepterPropositionDEL($idObs) {
195
		$gestion_observation = new GestionObservation($this->config);
196
		$donnees = array_map('trim', $this->donnees);
197
		$donneesAModifier = array(
198
			'certitude' => 'Certaine',
199
			'nom_referentiel' => $donnees['nom_referentiel'],
2793 aurelien 200
			'nom_sel_nn' => $donnees['nom_sel_nn'],
2152 jpm 201
		);
2143 jpm 202
 
2152 jpm 203
		$modification = $gestion_observation->modifierObservationPublique($idObs, $donneesAModifier);
204
 
205
		if ($modification) {
2205 aurelien 206
			// TODO: en modifiant bien la classe de gestion mots clés, on aurait peut être pas besoin de l'id
2461 jpm 207
			// utilisateur (car l'id de l'obs est déjà sans ambiguité)
2205 aurelien 208
			$idUtilisateur = $this->rechercheObs->obtenirIdUtilisateurPourIdObs($idObs);
2461 jpm 209
 
2152 jpm 210
			// supression des éventuelles liaison de l'obs avec le mot clé contenu dans obsKeywordDelete
3505 delphine 211
			$gestionMotsClesObs = new GestionMotsClesChemin($this->config, 'obs');
212
			$supp_liaison_mot_cle = $gestionMotsClesObs->supprimerLiaisonPourMotCleEtIdElementLie('aDeterminer', $idObs, $idUtilisateur);
2152 jpm 213
		} else {
214
			$msg = "Impossible de modifier l'observation associée à cet identifiant. Erreur mysql : " . mysql_error();
215
			$this->envoyerMessageErreur(500, $msg);// Internal Server Error
216
		}
217
	}
1582 jpm 218
}