Subversion Repositories eFlore/Applications.cel

Rev

Rev 2394 | Rev 2793 | Go to most recent revision | Details | Compare with Previous | 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);
34 
		$this->rechercheObs = new RechercheObservation($config);
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 
 
52 
			$criteres = array('id_observation' => $idObs, 'transmission' => 1);
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);
2461 jpm 140 
						$this->depublierImg($idObs);
2143 jpm 141 
					}
2205 aurelien 142 
				} else if (count($this->donnees) == 3) {
143 
					$donneesObligatoires = array('id_observation', 'nom_sel_nn', 'nom_referentiel');
2143 jpm 144 
					if ($this->verifierDonneesObligatoires($donneesObligatoires)) {
2152 jpm 145 
						$this->accepterPropositionDEL($idObs);
2143 jpm 146 
					}
147 
				} else {
2152 jpm 148 
					$msg = "La modification complète d'une observation n'est pas implémentée.";
2143 jpm 149 
					$this->envoyerMessageErreur(501, $msg);
150 
				}
151 
 
2152 jpm 152 
				$this->envoyer('ok');
2143 jpm 153 
			}
154 
		}
2156 jpm 155 
		return true;
2143 jpm 156 
	}
157 
 
158 
	private function verifierIdentifiantObs($chaine) {
2152 jpm 159 
		$ok = preg_match('/^[0-9]+$/', $chaine);
2143 jpm 160 
		if ($ok == false) {
2152 jpm 161 
			$msg = "Indiquer un seul identifiant numérique d'observation.";
2143 jpm 162 
			$this->envoyerMessageErreur(412, $msg);
163 
		}
164 
		return $ok;
165 
	}
166 
 
167 
	private function verifierDonneesObligatoires($champsObligatoires) {
168 
		foreach ($champsObligatoires as $param) {
169 
			if (! isset($this->donnees[$param])) {
170 
				$msg = sprintf("Paramètre %s manquant (parmi %s)", $param, implode(', ', $champsObligatoires));
171 
				$this->envoyerMessageErreur(412, $msg);
172 
			}
173 
		}
2152 jpm 174 
		return true;
2143 jpm 175 
	}
176 
 
2152 jpm 177 
	private function depublierObs($idObs) {
178 
		$gestionnaireObs = new GestionObservation($this->config);
179 
		$depublication = $gestionnaireObs->modifierTransmissionObservation($idObs, false);
180 
		if ($depublication === false) {
2461 jpm 181 
			$msg = "Un problème est survenu (voir log). L'observation « $idObs » n'a pas pu être dépubliée.";
2152 jpm 182 
			$this->envoyerMessageErreur(304, $msg);
2143 jpm 183 
		}
184 
	}
185 
 
2461 jpm 186 
	private function depublierImg($idObs) {
187 
		$gestionnaireImg = new GestionImage($this->config);
188 
		$depublication = $gestionnaireImg->modifierTransmissionParObs($idObs, false);
189 
		if ($depublication === false) {
190 
			$msg = "Un problème est survenu (voir log). Les images liées à l'obs « $idObs » n'ont pas pu être dépubliées.";
191 
			$this->envoyerMessageErreur(304, $msg);
192 
		}
193 
	}
194 
 
2152 jpm 195 
	/**
196 
	 * Modifie une observation aveec les infos d'une proposition :
197 
	 * Nous complétons les données de la proposition acceptée ici car:
198 
	 * 1) la table tb_del.del_commentaire ne contient pas toutes les informations nécessaires
199 
	 * 2) la table tb_del.del_commentaire ne *devrait* pas contenir beaucoup plus que nom_sel et nom_sel_nn
200 
	 * 3) la génération de ces données ici, au moment de l'UPDATE, est le meilleur garant de leur fiabilité
201 
	 */
202 
	private function accepterPropositionDEL($idObs) {
203 
		$gestion_observation = new GestionObservation($this->config);
204 
		$donnees = array_map('trim', $this->donnees);
205 
		$donneesAModifier = array(
206 
			'certitude' => 'Certaine',
207 
			'nom_referentiel' => $donnees['nom_referentiel'],
208 
		);
209 
		// TODO : la récupération des infos du nom est aussi effectué par la suite voir ce qu'il faut garder
210 
		$infosNoms = $this->getNomInfos($donnees['nom_sel_nn'], $donnees['nom_referentiel']);
211 
		if ($infosNoms) {
212 
			$donneesAModifier = array_merge($donneesAModifier, $infosNoms);
213 
		}
2143 jpm 214 
 
2152 jpm 215 
		$modification = $gestion_observation->modifierObservationPublique($idObs, $donneesAModifier);
216 
 
217 
		if ($modification) {
2205 aurelien 218 
			// TODO: en modifiant bien la classe de gestion mots clés, on aurait peut être pas besoin de l'id
2461 jpm 219 
			// utilisateur (car l'id de l'obs est déjà sans ambiguité)
2205 aurelien 220 
			$idUtilisateur = $this->rechercheObs->obtenirIdUtilisateurPourIdObs($idObs);
2461 jpm 221 
 
2152 jpm 222 
			// supression des éventuelles liaison de l'obs avec le mot clé contenu dans obsKeywordDelete
223 
			$gestionMotsClesObs = new GestionMotsClesChemin($this->config, 'obs');
224 
			$supp_liaison_mot_cle = $gestionMotsClesObs->supprimerLiaisonPourMotCleEtIdElementLie('aDeterminer', $idObs, $idUtilisateur);
225 
		} else {
226 
			$msg = "Impossible de modifier l'observation associée à cet identifiant. Erreur mysql : " . mysql_error();
227 
			$this->envoyerMessageErreur(500, $msg);// Internal Server Error
228 
		}
229 
	}
230 
 
231 
	// TODO : cette méthode et celles qui en dépendent sont peut être inutiles au vue de la méthode traiterEspece() de GestionObservation
232 
	private function getNomInfos($id_nom, $code_referentiel) {
233 
		$retour = false;
234 
		if ($id_nom && $code_referentiel) {
235 
			switch ($code_referentiel) {
236 
				case 'bdtfx' :
237 
					$retour = $this->getInfosBdtfx($id_nom);
238 
					break;
239 
				case 'bdtxa' :
240 
					$retour = $this->getInfosBdtxa($id_nom);
241 
					break;
242 
				case 'isfan' :
243 
					$retour = $this->getInfosIsfan($id_nom);
244 
					break;
2155 mathias 245 
				case 'apd' :
246 
					$retour = $this->getInfosApd($id_nom);
2152 jpm 247 
					break;
248 
			}
249 
		}
250 
		return $retour;
251 
	}
252 
 
2143 jpm 253 
	private function getInfosBdtfx($id_nom) {
2152 jpm 254 
		$idNomP = CEL::db()->proteger($id_nom);
2143 jpm 255 
		$requete = "SELECT o.num_nom_retenu AS nom_ret_nn, o.num_taxonomique AS nt, o.famille, ".
256 
			"	CONCAT(o.nom_sci, ' ', o.auteur) AS nom_sel, ".
257 
			"	CONCAT(ret.nom_sci, ' ', ret.auteur) AS nom_ret ".
2152 jpm 258 
			"FROM {$this->bdtfx} AS o ".
259 
			"	LEFT JOIN {$this->bdtfx} AS ret ON (o.num_nom_retenu != 0 AND o.num_nom_retenu = ret.num_nom) ".
2143 jpm 260 
			"WHERE o.num_nom = $idNomP ".
261 
			' -- '.__FILE__.' : '.__LINE__;
2152 jpm 262 
		$resultat = Cel::db()->requeterLigne($requete);
2143 jpm 263 
		return $resultat;
264 
	}
2152 jpm 265 
 
266 
	private function getInfosBdtxa($id_nom) {
267 
		$idNomP = CEL::db()->proteger($id_nom);
268 
		// Champ "num_tax" au lieu de "num_taxonomique"
269 
		$requete = "SELECT o.num_nom_retenu AS nom_ret_nn, o.num_tax AS nt, o.famille, ".
270 
			"	CONCAT(o.nom_sci, ' ', o.auteur) AS nom_sel, ".
271 
			"	CONCAT(ret.nom_sci, ' ', ret.auteur) AS nom_ret ".
272 
			"FROM {$this->bdtxa} AS o ".
273 
			"	LEFT JOIN {$this->bdtxa} AS ret ON (o.num_nom_retenu != 0 AND o.num_nom_retenu = ret.num_nom) ".
274 
			"WHERE o.num_nom = $idNomP ".
275 
			' -- '.__FILE__.' : '.__LINE__;
276 
		$resultat = Cel::db()->requeterLigne($requete);
277 
		return $resultat;
278 
	}
279 
 
280 
	private function getInfosIsfan($id_nom) {
281 
		$idNomP = CEL::db()->proteger($id_nom);
282 
		// Champ "num_tax" au lieu de "num_taxonomique"
283 
		$requete = "SELECT o.num_nom_retenu AS nom_ret_nn, o.num_taxonomique AS nt, o.famille, ".
284 
			"	CONCAT(o.nom_sci, ' ', o.auteur) AS nom_sel, ".
285 
			"	CONCAT(ret.nom_sci, ' ', ret.auteur) AS nom_ret ".
286 
			"FROM {$this->isfan} AS o ".
287 
			"	LEFT JOIN {$this->isfan} AS ret ON (o.num_nom_retenu != 0 AND o.num_nom_retenu = ret.num_nom) ".
288 
			"WHERE o.num_nom = $idNomP ".
289 
			' -- '.__FILE__.' : '.__LINE__;
290 
		$resultat = Cel::db()->requeterLigne($requete);
291 
		return $resultat;
292 
	}
293 
 
2155 mathias 294 
	private function getInfosApd($id_nom) {
2152 jpm 295 
		$idNomP = CEL::db()->proteger($id_nom);
296 
		// Champ "num_tax" au lieu de "num_taxonomique"
297 
		$requete = "SELECT o.num_nom_retenu AS nom_ret_nn, o.num_taxonomique AS nt, o.famille, ".
298 
			"	CONCAT(o.nom_sci, ' ', o.auteur) AS nom_sel, ".
299 
			"	CONCAT(ret.nom_sci, ' ', ret.auteur) AS nom_ret ".
2155 mathias 300 
			"FROM {$this->apd} AS o ".
301 
			"	LEFT JOIN {$this->apd} AS ret ON (o.num_nom_retenu != 0 AND o.num_nom_retenu = ret.num_nom) ".
2152 jpm 302 
			"WHERE o.num_nom = $idNomP ".
303 
			' -- '.__FILE__.' : '.__LINE__;
304 
		$resultat = Cel::db()->requeterLigne($requete);
305 
		return $resultat;
306 
	}
1582 jpm 307 
}