1 |
<?php
|
1 |
<?php
|
2 |
/**
|
2 |
/**
|
3 |
* Web service retournant toutes les infos d'une observation donnée :
|
3 |
* Web service retournant toutes les infos d'une observation donnée :
|
4 |
* images, votes sur image et protocole, commentaires, votes sur commentaires, ...
|
4 |
* images, votes sur image et protocole, commentaires, votes sur commentaires, ...
|
5 |
*
|
5 |
*
|
6 |
* @category DEL
|
6 |
* @category DEL
|
7 |
* @package Observations
|
7 |
* @package Observations
|
8 |
* @version 0.1
|
8 |
* @version 0.1
|
9 |
* @author Raphaël Droz <raphael@tela-botanica.org>
|
9 |
* @author Raphaël Droz <raphael@tela-botanica.org>
|
10 |
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
|
10 |
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
|
11 |
* @copyright Copyright (c) 2013, Tela Botanica (accueil@tela-botanica.org)
|
11 |
* @copyright Copyright (c) 2013, Tela Botanica (accueil@tela-botanica.org)
|
12 |
* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
|
12 |
* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
|
13 |
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
|
13 |
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
|
14 |
* @see http://www.tela-botanica.org/wikini/eflore/wakka.php?wiki=ApiIdentiplante01Observations
|
14 |
* @see http://www.tela-botanica.org/wikini/eflore/wakka.php?wiki=ApiIdentiplante01Observations
|
15 |
*
|
15 |
*
|
16 |
* @config-depend: "url_image" (dans configurations/config_observations.ini) ex: http://www.tela-botanica.org/appli:cel-img:%09dXL.jpg
|
16 |
* @config-depend: "url_image" (dans configurations/config_observations.ini) ex: http://www.tela-botanica.org/appli:cel-img:%09dXL.jpg
|
17 |
*/
|
17 |
*/
|
18 |
|
18 |
|
19 |
// http://localhost/del/services/0.1/observations/#id => une observation donnée et ses images, SANS LES propositions & nombre de commentaire
|
19 |
// http://localhost/del/services/0.1/observations/#id => une observation donnée et ses images, SANS LES propositions & nombre de commentaire
|
20 |
|
20 |
|
21 |
require_once(dirname(__FILE__) . '/../DelTk.php');
|
21 |
require_once(dirname(__FILE__) . '/../DelTk.php');
|
22 |
|
22 |
|
23 |
class Observation {
|
23 |
class Observation {
|
24 |
|
24 |
|
25 |
private $conteneur;
|
25 |
private $conteneur;
|
26 |
private $bdd;
|
26 |
private $bdd;
|
27 |
/* Map les champs MySQL vers les champs utilisés dans le JSON pour les clients pour
|
27 |
/* Map les champs MySQL vers les champs utilisés dans le JSON pour les clients pour
|
28 |
chacune des différentes tables utilisées pour le chargement de résultats ci-dessous.
|
28 |
chacune des différentes tables utilisées pour le chargement de résultats ci-dessous.
|
29 |
- chargerObservation() (v_del_image)
|
29 |
- chargerObservation() (v_del_image)
|
30 |
- chargerVotesImage() (del_image_vote, del_image_protocole)
|
30 |
- chargerVotesImage() (del_image_vote, del_image_protocole)
|
31 |
- chargerCommentaires() (del_commentaire_vote, del_commentaire).
|
31 |
- chargerCommentaires() (del_commentaire_vote, del_commentaire).
|
32 |
Si la valeur vaut 1, aucun alias ne sera défini (nom du champ d'origine), cf consulter() */
|
32 |
Si la valeur vaut 1, aucun alias ne sera défini (nom du champ d'origine), cf consulter() */
|
33 |
static $mappings = array(
|
33 |
static $mappings = array(
|
34 |
'observations' => array( // v_del_image
|
34 |
'observations' => array( // v_del_image
|
35 |
"id_observation" => 1,
|
35 |
"id_observation" => 1,
|
36 |
"date_observation" => 1,
|
36 |
"date_observation" => 1,
|
37 |
"date_transmission" => 1,
|
37 |
"date_transmission" => 1,
|
38 |
"famille" => "determination.famille",
|
38 |
"famille" => "determination.famille",
|
39 |
"nom_sel" => "determination.ns",
|
39 |
"nom_sel" => "determination.ns",
|
40 |
"nom_sel_nn" => "determination.nn",
|
40 |
"nom_sel_nn" => "determination.nn",
|
41 |
"nom_referentiel" => "determination.referentiel",
|
41 |
"nom_referentiel" => "determination.referentiel",
|
42 |
"nt" => "determination.nt",
|
42 |
"nt" => "determination.nt",
|
43 |
"ce_zone_geo" => "id_zone_geo",
|
43 |
"ce_zone_geo" => "id_zone_geo",
|
44 |
"zone_geo" => 1,
|
44 |
"zone_geo" => 1,
|
45 |
"lieudit" => 1,
|
45 |
"lieudit" => 1,
|
46 |
"station" => 1,
|
46 |
"station" => 1,
|
47 |
"milieu" => 1,
|
47 |
"milieu" => 1,
|
48 |
"ce_utilisateur" => "auteur.id",
|
48 |
"ce_utilisateur" => "auteur.id",
|
49 |
"mots_cles_texte" => "mots_cles_texte",
|
49 |
"mots_cles_texte" => "mots_cles_texte",
|
50 |
"commentaire" => 1),
|
50 |
"commentaire" => 1),
|
51 |
/* exclus car issus de la jointure annuaire:
|
51 |
/* exclus car issus de la jointure annuaire:
|
52 |
"nom" => "auteur.nom", // XXX: jointure annuaire
|
52 |
"nom" => "auteur.nom", // XXX: jointure annuaire
|
53 |
"prenom" => "auteur.prenom", // XXX: jointure annuaire
|
53 |
"prenom" => "auteur.prenom", // XXX: jointure annuaire
|
54 |
"courriel" => "observateur", // XXX: jointure annuaire */
|
54 |
"courriel" => "observateur", // XXX: jointure annuaire */
|
55 |
/* présents dans cel_obs mais exclus:
|
55 |
/* présents dans cel_obs mais exclus:
|
56 |
ordre, nom_ret, nom_ret_nn, latitude, longitude, altitude, geodatum
|
56 |
ordre, nom_ret, nom_ret_nn, latitude, longitude, altitude, geodatum
|
57 |
transmission, date_creation, date_modificationabondance, certitude, phenologie, code_insee_calcule */
|
57 |
transmission, date_creation, date_modificationabondance, certitude, phenologie, code_insee_calcule */
|
58 |
|
58 |
|
59 |
'images' => array( // v_del_image
|
59 |
'images' => array( // v_del_image
|
60 |
"id_image" => 1,
|
60 |
"id_image" => 1,
|
61 |
"hauteur" => 1,
|
61 |
"hauteur" => 1,
|
62 |
// "largeur" => 1, inutile semble-t-il
|
62 |
// "largeur" => 1, inutile semble-t-il
|
63 |
"date_prise_de_vue" => "date"),
|
63 |
"date_prise_de_vue" => "date"),
|
64 |
/* présents dans cel_images mais exclus:
|
64 |
/* présents dans cel_images mais exclus:
|
65 |
i_commentaire, nom_original, publiable_eflore, i_mots_cles_texte, i_ordre,
|
65 |
i_commentaire, nom_original, publiable_eflore, i_mots_cles_texte, i_ordre,
|
66 |
i_ce_utilisateur, i_prenom_utilisateur, i_nom_utilisateur, i_courriel_utilisateur */
|
66 |
i_ce_utilisateur, i_prenom_utilisateur, i_nom_utilisateur, i_courriel_utilisateur */
|
67 |
|
67 |
|
68 |
'protocoles' => array( // del_image_protocole
|
68 |
'protocoles' => array( // del_image_protocole
|
69 |
"ce_protocole" => "protocole.id",
|
69 |
"ce_protocole" => "protocole.id",
|
70 |
"id_protocole" => "protocole.id",
|
70 |
"id_protocole" => "protocole.id",
|
71 |
"intitule" => "protocole.intitule",
|
71 |
"intitule" => "protocole.intitule",
|
72 |
"descriptif" => "protocole.descriptif",
|
72 |
"descriptif" => "protocole.descriptif",
|
73 |
"tag" => "protocole.tag"),
|
73 |
"tag" => "protocole.tag"),
|
74 |
|
74 |
|
75 |
/* See desc del_commentaire_vote & desc del_image_vote;
|
75 |
/* See desc del_commentaire_vote & desc del_image_vote;
|
76 |
Les deux schémas sont similaires, à l'exception de ce_protocole
|
76 |
Les deux schémas sont similaires, à l'exception de ce_protocole
|
77 |
spécifique à del_image_vote et ce_proposition => ce_image */
|
77 |
spécifique à del_image_vote et ce_proposition => ce_image */
|
78 |
'votes' => array( // del_image_vote et del_commentaire_vote
|
78 |
'votes' => array( // del_image_vote et del_commentaire_vote
|
79 |
"id_vote" => "vote.id",
|
79 |
"id_vote" => "vote.id",
|
80 |
"ce_proposition" => "proposition.id",
|
80 |
"ce_proposition" => "proposition.id",
|
81 |
"ce_image" => "image.id",
|
81 |
"ce_image" => "image.id",
|
82 |
"ce_utilisateur" => "auteur.id", // attention, conflit avec commentaire, cf ci-dessous
|
82 |
"ce_utilisateur" => "auteur.id", // attention, conflit avec commentaire, cf ci-dessous
|
83 |
"valeur" => "vote",
|
83 |
"valeur" => "vote",
|
84 |
"date" => 1, // attention, conflit avec commentaire, cf ci-dessous
|
84 |
"date" => 1, // attention, conflit avec commentaire, cf ci-dessous
|
85 |
// absents du JSON, et pourtant présents dans services/configurations/config_mapping_votes.ini
|
85 |
// absents du JSON, et pourtant présents dans services/configurations/config_mapping_votes.ini
|
86 |
// (nécessiterait une propre jointure sur del_utilisateur)
|
86 |
// (nécessiterait une propre jointure sur del_utilisateur)
|
87 |
/* "nom" => "auteur.nom",
|
87 |
/* "nom" => "auteur.nom",
|
88 |
"prenom" => "auteur.prenom",
|
88 |
"prenom" => "auteur.prenom",
|
89 |
"courriel" => "auteur.courriel" */),
|
89 |
"courriel" => "auteur.courriel" */),
|
90 |
|
90 |
|
91 |
'commentaires' => array( // del_commentaire
|
91 |
'commentaires' => array( // del_commentaire
|
92 |
"id_commentaire" => 1,
|
92 |
"id_commentaire" => 1,
|
93 |
"ce_observation" => "observation",
|
93 |
"ce_observation" => "observation",
|
94 |
"ce_proposition" => "proposition",
|
94 |
"ce_proposition" => "proposition",
|
95 |
"ce_commentaire_parent" => "id_parent",
|
95 |
"ce_commentaire_parent" => "id_parent",
|
96 |
|
96 |
|
97 |
// les deux alias suivants sont particuliers afin d'éviter un conflit d'alias
|
97 |
// les deux alias suivants sont particuliers afin d'éviter un conflit d'alias
|
98 |
// lors des jointures avec del_commentaire_vote ci-dessus
|
98 |
// lors des jointures avec del_commentaire_vote ci-dessus
|
99 |
// (cf cas particulier dans la boucle de chargerCommentaires())
|
99 |
// (cf cas particulier dans la boucle de chargerCommentaires())
|
100 |
"ce_utilisateur" => "__auteur_com",
|
100 |
"ce_utilisateur" => "__auteur_com",
|
101 |
"date" => "__date_com",
|
101 |
"date" => "__date_com",
|
102 |
|
102 |
|
103 |
"texte" => 1,
|
103 |
"texte" => 1,
|
104 |
"utilisateur_nom" => "auteur.nom",
|
104 |
"utilisateur_nom" => "auteur.nom",
|
105 |
"utilisateur_prenom" => "auteur.prenom",
|
105 |
"utilisateur_prenom" => "auteur.prenom",
|
106 |
"utilisateur_courriel" => "auteur.courriel",
|
106 |
"utilisateur_courriel" => "auteur.courriel",
|
107 |
"nom_sel" => 1,
|
107 |
"nom_sel" => 1,
|
108 |
"nom_sel_nn" => 1,
|
108 |
"nom_sel_nn" => 1,
|
109 |
"nom_ret_nn" => 1,
|
109 |
"nom_ret_nn" => 1,
|
110 |
"nom_referentiel" => 1,
|
110 |
"nom_referentiel" => 1,
|
111 |
"proposition_initiale" => 1),
|
111 |
"proposition_initiale" => 1),
|
112 |
);
|
112 |
);
|
113 |
|
113 |
|
114 |
public function __construct(Conteneur $conteneur = null) {
|
114 |
public function __construct(Conteneur $conteneur = null) {
|
115 |
$this->conteneur = $conteneur == null ? new Conteneur() : $conteneur;
|
115 |
$this->conteneur = $conteneur == null ? new Conteneur() : $conteneur;
|
116 |
$this->conteneur->chargerConfiguration('config_votes.ini');
|
116 |
$this->conteneur->chargerConfiguration('config_votes.ini');
|
117 |
$this->conteneur->chargerConfiguration('config_mapping_votes.ini');
|
117 |
$this->conteneur->chargerConfiguration('config_mapping_votes.ini');
|
118 |
$this->conteneur->chargerConfiguration('config_mapping_commentaires.ini');
|
118 |
//$this->conteneur->chargerConfiguration('config_mapping_commentaires.ini');
|
119 |
$this->bdd = $this->conteneur->getBdd();
|
119 |
$this->bdd = $this->conteneur->getBdd();
|
120 |
}
|
120 |
}
|
121 |
|
121 |
|
122 |
/**
|
122 |
/**
|
123 |
* Méthode principale de la classe.
|
123 |
* Méthode principale de la classe.
|
124 |
* Lance la récupération des images dans la base et les place dans un objet ResultatService
|
124 |
* Lance la récupération des images dans la base et les place dans un objet ResultatService
|
125 |
* pour l'afficher.
|
125 |
* pour l'afficher.
|
126 |
* @param array $ressources les ressources situées après l'url de base (ex : http://url/ressource1/ressource2)
|
126 |
* @param array $ressources les ressources situées après l'url de base (ex : http://url/ressource1/ressource2)
|
127 |
* @param array $parametres les paramètres situés après le ? dans l'url
|
127 |
* @param array $parametres les paramètres situés après le ? dans l'url
|
128 |
* */
|
128 |
* */
|
129 |
public function consulter($ressources, $parametres) {
|
129 |
public function consulter($ressources, $parametres) {
|
130 |
if (!$ressources || count($ressources) != 1 ) {
|
130 |
if (!$ressources || count($ressources) != 1 ) {
|
131 |
throw new Exception("Le service observation accepte un unique identifiant d'observation", RestServeur::HTTP_CODE_ERREUR);
|
131 |
throw new Exception("Le service observation accepte un unique identifiant d'observation", RestServeur::HTTP_CODE_ERREUR);
|
132 |
}
|
132 |
}
|
133 |
|
133 |
|
134 |
// initialise les mappings:
|
134 |
// initialise les mappings:
|
135 |
// substitue les valeurs à 1 par le nom de la clef (pas d'alias de champ)
|
135 |
// substitue les valeurs à 1 par le nom de la clef (pas d'alias de champ)
|
136 |
array_walk(self::$mappings['observations'], create_function('&$val, $k', 'if($val==1) $val = $k;'));
|
136 |
array_walk(self::$mappings['observations'], create_function('&$val, $k', 'if($val==1) $val = $k;'));
|
137 |
array_walk(self::$mappings['images'], create_function('&$val, $k', 'if($val==1) $val = $k;'));
|
137 |
array_walk(self::$mappings['images'], create_function('&$val, $k', 'if($val==1) $val = $k;'));
|
138 |
array_walk(self::$mappings['protocoles'], create_function('&$val, $k', 'if($val==1) $val = $k;'));
|
138 |
array_walk(self::$mappings['protocoles'], create_function('&$val, $k', 'if($val==1) $val = $k;'));
|
139 |
array_walk(self::$mappings['votes'], create_function('&$val, $k', 'if($val==1) $val = $k;'));
|
139 |
array_walk(self::$mappings['votes'], create_function('&$val, $k', 'if($val==1) $val = $k;'));
|
140 |
array_walk(self::$mappings['commentaires'], create_function('&$val, $k', 'if($val==1) $val = $k;'));
|
140 |
array_walk(self::$mappings['commentaires'], create_function('&$val, $k', 'if($val==1) $val = $k;'));
|
141 |
|
141 |
|
142 |
|
142 |
|
143 |
// Gestion des configuration du script
|
143 |
// Gestion des configuration du script
|
144 |
$idobs = $ressources[0];
|
144 |
$idobs = $ressources[0];
|
145 |
$protocole = isset($parametres['protocole']) && is_numeric($parametres['protocole']) ?intval($parametres['protocole']) : NULL;
|
145 |
$protocole = isset($parametres['protocole']) && is_numeric($parametres['protocole']) ?intval($parametres['protocole']) : NULL;
|
146 |
|
146 |
|
147 |
// 1) récupération de l'observation (et de ses images (v_del_image est une vue utilisant des INNER JOIN))
|
147 |
// 1) récupération de l'observation (et de ses images (v_del_image est une vue utilisant des INNER JOIN))
|
148 |
$liaisons = self::chargerObservation($this->bdd, $idobs);
|
148 |
$liaisons = self::chargerObservation($this->bdd, $idobs);
|
149 |
|
149 |
|
150 |
if(!$liaisons) {
|
150 |
if(!$liaisons) {
|
151 |
header('HTTP/1.0 404 Not Found');
|
151 |
header('HTTP/1.0 404 Not Found');
|
152 |
// don't die (phpunit)
|
152 |
// don't die (phpunit)
|
153 |
throw(new Exception());
|
153 |
throw(new Exception());
|
154 |
}
|
154 |
}
|
155 |
|
155 |
|
156 |
// 2) réassocie les images "à plat" à leur observation (merge)
|
156 |
// 2) réassocie les images "à plat" à leur observation (merge)
|
157 |
// TODO: appliquer le formattage dépendant de la configuration en fin de processus
|
157 |
// TODO: appliquer le formattage dépendant de la configuration en fin de processus
|
158 |
$observations = self::reformateObservationSimpleIndex($liaisons, $this->conteneur->getParametre('url_images'));
|
158 |
$observations = self::reformateObservationSimpleIndex($liaisons, $this->conteneur->getParametre('url_images'));
|
159 |
// bien que dans notre cas il n'y ait qu'une seule observation, issue de plusieurs images
|
159 |
// bien que dans notre cas il n'y ait qu'une seule observation, issue de plusieurs images
|
160 |
// dans $liaisons, $observation est un tableau (cf reformateObservation).
|
160 |
// dans $liaisons, $observation est un tableau (cf reformateObservation).
|
161 |
// Considérons la chose comme telle au cas où le webservice doivent demain demander une paire
|
161 |
// Considérons la chose comme telle au cas où le webservice doivent demain demander une paire
|
162 |
// d'observations (... convergence avec ListeObservations & DelTk)
|
162 |
// d'observations (... convergence avec ListeObservations & DelTk)
|
163 |
|
163 |
|
164 |
$observation = array_pop($observations);
|
164 |
$observation = array_pop($observations);
|
165 |
|
165 |
|
166 |
// 3) charge les données de votes et protocoles associés aux images
|
166 |
// 3) charge les données de votes et protocoles associés aux images
|
167 |
if ($observation['images']) {
|
167 |
if ($observation['images']) {
|
168 |
$votes = self::chargerVotesImage($this->bdd, $observation['images'], $protocole);
|
168 |
$votes = self::chargerVotesImage($this->bdd, $observation['images'], $protocole);
|
169 |
// 3") merge/reformate les données retournées
|
169 |
// 3") merge/reformate les données retournées
|
170 |
self::mapVotesToImages($votes, $observation['images']);
|
170 |
self::mapVotesToImages($votes, $observation['images']);
|
171 |
}
|
171 |
}
|
172 |
|
172 |
|
173 |
// 4) charge les commentaires et les votes associés
|
173 |
// 4) charge les commentaires et les votes associés
|
174 |
// modifie/créé $observation['commentaires']
|
174 |
// modifie/créé $observation['commentaires']
|
175 |
self::chargerCommentaires($this->bdd, $observation);
|
175 |
self::chargerCommentaires($this->bdd, $observation);
|
176 |
|
176 |
|
177 |
// désindexe le tableau (tel qu'apparement attendu par les applis), c'est une exception
|
177 |
// désindexe le tableau (tel qu'apparement attendu par les applis), c'est une exception
|
178 |
// corriger l'appli cliente pour utiliser les index puis supprimer cette ligne
|
178 |
// corriger l'appli cliente pour utiliser les index puis supprimer cette ligne
|
179 |
$observation['images'] = array_values($observation['images']);
|
179 |
$observation['images'] = array_values($observation['images']);
|
180 |
// autre élément de post-processing: le ce_utilisateur de l'observation non-numeric...
|
180 |
// autre élément de post-processing: le ce_utilisateur de l'observation non-numeric...
|
181 |
if (!is_numeric($observation['auteur.id'])) {
|
181 |
if (!is_numeric($observation['auteur.id'])) {
|
182 |
$observation['auteur.id'] = "0";
|
182 |
$observation['auteur.id'] = "0";
|
183 |
}
|
183 |
}
|
184 |
if (!isset($observation['auteur.nom'])) {
|
184 |
if (!isset($observation['auteur.nom'])) {
|
185 |
$observation['auteur.nom'] = '[inconnu]';
|
185 |
$observation['auteur.nom'] = '[inconnu]';
|
186 |
}
|
186 |
}
|
187 |
|
187 |
|
188 |
if (isset($parametres['justthrow'])) {
|
188 |
if (isset($parametres['justthrow'])) {
|
189 |
return $observation;
|
189 |
return $observation;
|
190 |
}
|
190 |
}
|
191 |
|
191 |
|
192 |
// Mettre en forme le résultat et l'envoyer pour affichage
|
192 |
// Mettre en forme le résultat et l'envoyer pour affichage
|
193 |
$resultat = new ResultatService();
|
193 |
$resultat = new ResultatService();
|
194 |
$resultat->corps = $observation;
|
194 |
$resultat->corps = $observation;
|
195 |
return $resultat;
|
195 |
return $resultat;
|
196 |
}
|
196 |
}
|
197 |
|
197 |
|
198 |
static function chargerObservation($db, $idobs) {
|
198 |
static function chargerObservation($db, $idobs) {
|
199 |
// prenom_utilisateur, nom_utilisateur, courriel_utilisateur sont exclus du mapping
|
199 |
// prenom_utilisateur, nom_utilisateur, courriel_utilisateur sont exclus du mapping
|
200 |
// car nous utilisons une construction SQL élaborée pour eux (cf IFNULL ci-dessous)
|
200 |
// car nous utilisons une construction SQL élaborée pour eux (cf IFNULL ci-dessous)
|
201 |
$obs_fields = DelTk::sqlFieldsToAlias(self::$mappings['observations'], NULL, 'dob');
|
201 |
$obs_fields = DelTk::sqlFieldsToAlias(self::$mappings['observations'], NULL, 'dob');
|
202 |
|
202 |
|
203 |
$image_fields = DelTk::sqlFieldsToAlias(self::$mappings['images'], NULL, 'dob');
|
203 |
$image_fields = DelTk::sqlFieldsToAlias(self::$mappings['images'], NULL, 'dob');
|
204 |
|
204 |
|
205 |
// champs de l'annuaire (del_utilisateur): id_utilisateur prenom, nom, courriel
|
205 |
// champs de l'annuaire (del_utilisateur): id_utilisateur prenom, nom, courriel
|
206 |
$annuaire_fields = implode(', ', array("IFNULL(du.prenom, prenom_utilisateur) AS `auteur.prenom`",
|
206 |
$annuaire_fields = implode(', ', array("IFNULL(du.prenom, prenom_utilisateur) AS `auteur.prenom`",
|
207 |
"IFNULL(du.nom, nom_utilisateur) AS `auteur.nom`",
|
207 |
"IFNULL(du.nom, nom_utilisateur) AS `auteur.nom`",
|
208 |
"IFNULL(du.courriel, courriel_utilisateur) AS `auteur.courriel`"));
|
208 |
"IFNULL(du.courriel, courriel_utilisateur) AS `auteur.courriel`"));
|
209 |
return $db->recupererTous(sprintf(
|
209 |
return $db->recupererTous(sprintf(
|
210 |
'SELECT %s, %s, %s FROM v_del_image as dob'.
|
210 |
'SELECT %s, %s, %s FROM v_del_image as dob'.
|
211 |
' LEFT JOIN del_utilisateur du ON CAST(du.id_utilisateur AS CHAR) = CAST(dob.ce_utilisateur AS CHAR)'.
|
211 |
' LEFT JOIN del_utilisateur du ON CAST(du.id_utilisateur AS CHAR) = CAST(dob.ce_utilisateur AS CHAR)'.
|
212 |
' WHERE dob.id_observation = %d -- %s',
|
212 |
' WHERE dob.id_observation = %d -- %s',
|
213 |
$obs_fields, $image_fields, $annuaire_fields, $idobs, __FILE__ . ':' . __LINE__));
|
213 |
$obs_fields, $image_fields, $annuaire_fields, $idobs, __FILE__ . ':' . __LINE__));
|
214 |
}
|
214 |
}
|
215 |
|
215 |
|
216 |
|
216 |
|
217 |
// Charger les images et leurs votes associés
|
217 |
// Charger les images et leurs votes associés
|
218 |
static function chargerVotesImage($db, $images, $protocole = NULL) {
|
218 |
static function chargerVotesImage($db, $images, $protocole = NULL) {
|
219 |
if (!$images) return NULL;
|
219 |
if (!$images) return NULL;
|
220 |
|
220 |
|
221 |
$select = array('votes' =>
|
221 |
$select = array('votes' =>
|
222 |
array('id_vote', 'ce_image', 'ce_protocole', 'ce_utilisateur', 'valeur', 'date', /* del_image_vote */),
|
222 |
array('id_vote', 'ce_image', 'ce_protocole', 'ce_utilisateur', 'valeur', 'date', /* del_image_vote */),
|
223 |
'protocole' =>
|
223 |
'protocole' =>
|
224 |
array('id_protocole', 'intitule', 'descriptif', 'tag' /* del_image_protocole */ ));
|
224 |
array('id_protocole', 'intitule', 'descriptif', 'tag' /* del_image_protocole */ ));
|
225 |
$vote_fields = DelTk::sqlFieldsToAlias(self::$mappings['votes'], $select['votes'], 'v'); // "v": cf alias dans la requête
|
225 |
$vote_fields = DelTk::sqlFieldsToAlias(self::$mappings['votes'], $select['votes'], 'v'); // "v": cf alias dans la requête
|
226 |
$proto_fields = DelTk::sqlFieldsToAlias(self::$mappings['protocoles'], $select['protocole'], 'p');
|
226 |
$proto_fields = DelTk::sqlFieldsToAlias(self::$mappings['protocoles'], $select['protocole'], 'p');
|
227 |
|
227 |
|
228 |
$where = array();
|
228 |
$where = array();
|
229 |
$idsImages = array_values(array_map(create_function('$a', 'return $a["id_image"];'), $images));
|
229 |
$idsImages = array_values(array_map(create_function('$a', 'return $a["id_image"];'), $images));
|
230 |
$where[] = sprintf('v.ce_image IN (%s)',
|
230 |
$where[] = sprintf('v.ce_image IN (%s)',
|
231 |
implode(',', $idsImages));
|
231 |
implode(',', $idsImages));
|
232 |
|
232 |
|
233 |
if ($protocole) {
|
233 |
if ($protocole) {
|
234 |
$where[] = "v.ce_protocole = $protocole";
|
234 |
$where[] = "v.ce_protocole = $protocole";
|
235 |
}
|
235 |
}
|
236 |
|
236 |
|
237 |
// pour une fois, on conserve l'ordre en ne luttant pas contre les IDs reçus
|
237 |
// pour une fois, on conserve l'ordre en ne luttant pas contre les IDs reçus
|
238 |
$ordreDesIdsRecus = sprintf('FIELD(v.ce_image, %s)', implode(',', $idsImages));
|
238 |
$ordreDesIdsRecus = sprintf('FIELD(v.ce_image, %s)', implode(',', $idsImages));
|
239 |
$req = sprintf(
|
239 |
$req = sprintf(
|
240 |
'SELECT %s, %s FROM del_image_vote AS v'.
|
240 |
'SELECT %s, %s FROM del_image_vote AS v'.
|
241 |
' INNER JOIN del_image_protocole p ON v.ce_protocole = p.id_protocole'.
|
241 |
' INNER JOIN del_image_protocole p ON v.ce_protocole = p.id_protocole'.
|
242 |
' WHERE %s'.
|
242 |
' WHERE %s'.
|
243 |
' ORDER BY %s -- %s',
|
243 |
' ORDER BY %s -- %s',
|
244 |
$vote_fields,
|
244 |
$vote_fields,
|
245 |
$proto_fields,
|
245 |
$proto_fields,
|
246 |
($where ? implode(' AND ', $where) : 1),
|
246 |
($where ? implode(' AND ', $where) : 1),
|
247 |
$ordreDesIdsRecus,
|
247 |
$ordreDesIdsRecus,
|
248 |
__FILE__ . ':' . __LINE__);
|
248 |
__FILE__ . ':' . __LINE__);
|
249 |
|
249 |
|
250 |
//echo "REQUETE: $req"; exit;
|
250 |
//echo "REQUETE: $req"; exit;
|
251 |
return $db->recupererTous($req);
|
251 |
return $db->recupererTous($req);
|
252 |
}
|
252 |
}
|
253 |
|
253 |
|
254 |
/**
|
254 |
/**
|
255 |
* Formater une observation depuis une ligne liaison
|
255 |
* Formater une observation depuis une ligne liaison
|
256 |
* @param $liaison liaison issue de la recherche
|
256 |
* @param $liaison liaison issue de la recherche
|
257 |
* @return $observation l'observation mise en forme
|
257 |
* @return $observation l'observation mise en forme
|
258 |
* Exemple: vote, au sortir de MySQL contient:
|
258 |
* Exemple: vote, au sortir de MySQL contient:
|
259 |
* 'xxx' => 'blah', 'descriptif' => 'foo', 'valeur' => 3
|
259 |
* 'xxx' => 'blah', 'descriptif' => 'foo', 'valeur' => 3
|
260 |
* et le tableau de mapping contient:
|
260 |
* et le tableau de mapping contient:
|
261 |
* descriptif = protocole.descriptif, valeur = vote
|
261 |
* descriptif = protocole.descriptif, valeur = vote
|
262 |
* Alors $retour[ contient:
|
262 |
* Alors $retour[ contient:
|
263 |
*
|
263 |
*
|
264 |
* */
|
264 |
* */
|
265 |
static function mapVotesToImages($votes, &$images) {
|
265 |
static function mapVotesToImages($votes, &$images) {
|
266 |
if (!$votes) return;
|
266 |
if (!$votes) return;
|
267 |
|
267 |
|
268 |
// pour chaque vote
|
268 |
// pour chaque vote
|
269 |
foreach ($votes as $vote) {
|
269 |
foreach ($votes as $vote) {
|
270 |
$imgid = $vote['image.id'];
|
270 |
$imgid = $vote['image.id'];
|
271 |
$protoid = $vote['protocole.id'];
|
271 |
$protoid = $vote['protocole.id'];
|
272 |
|
272 |
|
273 |
// un vote sans image associée ? est-ce possible ?
|
273 |
// un vote sans image associée ? est-ce possible ?
|
274 |
// if(!isset($images[$imgid])) continue;
|
274 |
// if(!isset($images[$imgid])) continue;
|
275 |
|
275 |
|
276 |
if(!array_key_exists('protocoles_votes', $images[$imgid]) ||
|
276 |
if(!array_key_exists('protocoles_votes', $images[$imgid]) ||
|
277 |
!array_key_exists($protoid, $images[$imgid]['protocoles_votes'])) {
|
277 |
!array_key_exists($protoid, $images[$imgid]['protocoles_votes'])) {
|
278 |
// extrait les champs spécifique au protocole (le LEFT JOIN de chargerVotesImage les ramène en doublons
|
278 |
// extrait les champs spécifique au protocole (le LEFT JOIN de chargerVotesImage les ramène en doublons
|
279 |
$protocole = array_intersect_key($vote, array_flip(self::$mappings['protocoles']));
|
279 |
$protocole = array_intersect_key($vote, array_flip(self::$mappings['protocoles']));
|
280 |
$images[$imgid]['protocoles_votes'][$protoid] = $protocole;
|
280 |
$images[$imgid]['protocoles_votes'][$protoid] = $protocole;
|
281 |
}
|
281 |
}
|
282 |
|
282 |
|
283 |
$vote = array_intersect_key($vote, array_flip(self::$mappings['votes']));
|
283 |
$vote = array_intersect_key($vote, array_flip(self::$mappings['votes']));
|
284 |
$images[$imgid]['protocoles_votes'][$protoid]['votes'][$vote['vote.id']] = $vote;
|
284 |
$images[$imgid]['protocoles_votes'][$protoid]['votes'][$vote['vote.id']] = $vote;
|
285 |
}
|
285 |
}
|
286 |
}
|
286 |
}
|
287 |
|
287 |
|
288 |
// Charger les commentaires et leurs votes associés
|
288 |
// Charger les commentaires et leurs votes associés
|
289 |
static function chargerCommentaires($db, &$observation) {
|
289 |
static function chargerCommentaires($db, &$observation) {
|
290 |
$select = array('votes' =>
|
290 |
$select = array('votes' =>
|
291 |
array('id_vote', 'ce_proposition', 'ce_utilisateur', 'valeur', 'date' /* del_commentaire_vote */),
|
291 |
array('id_vote', 'ce_proposition', 'ce_utilisateur', 'valeur', 'date' /* del_commentaire_vote */),
|
292 |
'commentaires' =>
|
292 |
'commentaires' =>
|
293 |
array('id_commentaire', 'ce_observation', 'ce_proposition', 'ce_commentaire_parent', 'texte',
|
293 |
array('id_commentaire', 'ce_observation', 'ce_proposition', 'ce_commentaire_parent', 'texte',
|
294 |
'ce_utilisateur', 'utilisateur_prenom', 'utilisateur_nom', 'utilisateur_courriel',
|
294 |
'ce_utilisateur', 'utilisateur_prenom', 'utilisateur_nom', 'utilisateur_courriel',
|
295 |
'nom_sel', 'nom_sel_nn', 'nom_ret', 'nom_ret_nn', 'nt', 'famille', 'nom_referentiel', 'date',
|
295 |
'nom_sel', 'nom_sel_nn', 'nom_ret', 'nom_ret_nn', 'nt', 'famille', 'nom_referentiel', 'date',
|
296 |
'proposition_initiale'));
|
296 |
'proposition_initiale'));
|
297 |
$vote_fields = DelTk::sqlFieldsToAlias(self::$mappings['votes'], $select['votes'], 'cv'); // "v": cf alias dans la requête
|
297 |
$vote_fields = DelTk::sqlFieldsToAlias(self::$mappings['votes'], $select['votes'], 'cv'); // "v": cf alias dans la requête
|
298 |
$comment_fields = DelTk::sqlFieldsToAlias(self::$mappings['commentaires'], $select['commentaires'], 'dc');
|
298 |
$comment_fields = DelTk::sqlFieldsToAlias(self::$mappings['commentaires'], $select['commentaires'], 'dc');
|
299 |
|
299 |
|
300 |
$commentaires = $db->recupererTous(sprintf(
|
300 |
$commentaires = $db->recupererTous(sprintf(
|
301 |
"SELECT %s, %s FROM del_commentaire as dc".
|
301 |
"SELECT %s, %s FROM del_commentaire as dc".
|
302 |
// LEFT JOIN optionnel, mais explicatif:
|
302 |
// LEFT JOIN optionnel, mais explicatif:
|
303 |
// on ne récupère des infos de vote que pour les commentaires comportant un
|
303 |
// on ne récupère des infos de vote que pour les commentaires comportant un
|
304 |
// nom_sel "valide"
|
304 |
// nom_sel "valide"
|
305 |
" LEFT JOIN del_commentaire_vote cv".
|
305 |
" LEFT JOIN del_commentaire_vote cv".
|
306 |
" ON cv.ce_proposition = dc.id_commentaire AND dc.nom_sel != '' AND dc.nom_sel IS NOT NULL".
|
306 |
" ON cv.ce_proposition = dc.id_commentaire AND dc.nom_sel != '' AND dc.nom_sel IS NOT NULL".
|
307 |
" WHERE ce_observation = %d -- %s",
|
307 |
" WHERE ce_observation = %d -- %s",
|
308 |
$comment_fields, $vote_fields,
|
308 |
$comment_fields, $vote_fields,
|
309 |
$observation['id_observation'],
|
309 |
$observation['id_observation'],
|
310 |
__FILE__ . ':' . __LINE__));
|
310 |
__FILE__ . ':' . __LINE__));
|
311 |
|
311 |
|
312 |
if (!$commentaires) return;
|
312 |
if (!$commentaires) return;
|
313 |
|
313 |
|
314 |
// les commentaires réunifiées et dont les votes sont mergés
|
314 |
// les commentaires réunifiées et dont les votes sont mergés
|
315 |
$ret = array();
|
315 |
$ret = array();
|
316 |
foreach ($commentaires as $comment) {
|
316 |
foreach ($commentaires as $comment) {
|
317 |
$commentid = $comment['id_commentaire'];
|
317 |
$commentid = $comment['id_commentaire'];
|
318 |
$voteid = $comment['vote.id'];
|
318 |
$voteid = $comment['vote.id'];
|
319 |
|
319 |
|
320 |
if (!array_key_exists($commentid, $ret)) {
|
320 |
if (!array_key_exists($commentid, $ret)) {
|
321 |
$comment_extract = array_intersect_key($comment, array_flip(self::$mappings['commentaires']));
|
321 |
$comment_extract = array_intersect_key($comment, array_flip(self::$mappings['commentaires']));
|
322 |
// cas particulier: conflit d'aliases avec del_commentaire_vote
|
322 |
// cas particulier: conflit d'aliases avec del_commentaire_vote
|
323 |
$comment_extract['auteur.id'] = $comment_extract['__auteur_com'];
|
323 |
$comment_extract['auteur.id'] = $comment_extract['__auteur_com'];
|
324 |
$comment_extract['date'] = $comment_extract['__date_com'];
|
324 |
$comment_extract['date'] = $comment_extract['__date_com'];
|
325 |
unset($comment_extract['__auteur_com'], $comment_extract['__date_com']);
|
325 |
unset($comment_extract['__auteur_com'], $comment_extract['__date_com']);
|
326 |
|
326 |
|
327 |
// toujours un éléments "votes", quand bien même il n'y en aurait pas
|
327 |
// toujours un éléments "votes", quand bien même il n'y en aurait pas
|
328 |
$comment_extract['votes'] = array();
|
328 |
$comment_extract['votes'] = array();
|
329 |
$ret[$commentid] = $comment_extract;
|
329 |
$ret[$commentid] = $comment_extract;
|
330 |
}
|
330 |
}
|
331 |
|
331 |
|
332 |
if (!$comment['nom_sel'] || ! $voteid) continue;
|
332 |
if (!$comment['nom_sel'] || ! $voteid) continue;
|
333 |
$vote = array_intersect_key($comment, array_flip(self::$mappings['votes']));
|
333 |
$vote = array_intersect_key($comment, array_flip(self::$mappings['votes']));
|
334 |
$ret[$commentid]['votes'][$voteid] = $vote;
|
334 |
$ret[$commentid]['votes'][$voteid] = $vote;
|
335 |
}
|
335 |
}
|
336 |
$observation['commentaires'] = $ret;
|
336 |
$observation['commentaires'] = $ret;
|
337 |
}
|
337 |
}
|
338 |
|
338 |
|
339 |
// cf ListeObservation::reformateObservation() et ListeImages2::reformateImagesDoubleIndex()
|
339 |
// cf ListeObservation::reformateObservation() et ListeImages2::reformateImagesDoubleIndex()
|
340 |
// (trop de variétés de formatage, à unifier côté client pour unifier côté backend ...)
|
340 |
// (trop de variétés de formatage, à unifier côté client pour unifier côté backend ...)
|
341 |
static function reformateObservationSimpleIndex($obs, $url_pattern = '') {
|
341 |
static function reformateObservationSimpleIndex($obs, $url_pattern = '') {
|
342 |
// XXX: cf Observation.php::consulter(), nous pourriouns ici
|
342 |
// XXX: cf Observation.php::consulter(), nous pourriouns ici
|
343 |
// conserver les valeurs vides (pour les phptests notamment, ou non)
|
343 |
// conserver les valeurs vides (pour les phptests notamment, ou non)
|
344 |
$obs = array_map('array_filter', $obs);
|
344 |
$obs = array_map('array_filter', $obs);
|
345 |
$obs_merged = array();
|
345 |
$obs_merged = array();
|
346 |
foreach ($obs as $o) {
|
346 |
foreach ($obs as $o) {
|
347 |
$id = $o['id_observation'];
|
347 |
$id = $o['id_observation'];
|
348 |
$image = array_intersect_key($o, array_flip(array('id_image', 'date', 'hauteur' , 'largeur', 'nom_original')));
|
348 |
$image = array_intersect_key($o, array_flip(array('id_image', 'date', 'hauteur' , 'largeur', 'nom_original')));
|
349 |
$image['binaire.href'] = sprintf($url_pattern, $image['id_image']);
|
349 |
$image['binaire.href'] = sprintf($url_pattern, $image['id_image']);
|
350 |
unset($o['id_image'], $o['date'], $o['hauteur'], $o['largeur'], $o['nom_original']);
|
350 |
unset($o['id_image'], $o['date'], $o['hauteur'], $o['largeur'], $o['nom_original']);
|
351 |
if(!isset($obs_merged[$id])) $obs_merged[$id] = $o;
|
351 |
if(!isset($obs_merged[$id])) $obs_merged[$id] = $o;
|
352 |
$obs_merged[$id]['images'][$image['id_image']] = $image;
|
352 |
$obs_merged[$id]['images'][$image['id_image']] = $image;
|
353 |
}
|
353 |
}
|
354 |
return $obs_merged;
|
354 |
return $obs_merged;
|
355 |
}
|
355 |
}
|
356 |
|
356 |
|
357 |
/**
|
357 |
/**
|
358 |
* Modifie une observation directement dans le CEL en faisant un appel à un web service du CEL.
|
358 |
* Modifie une observation directement dans le CEL en faisant un appel à un web service du CEL.
|
359 |
* Utilisé uniquement par les admins.
|
359 |
* Utilisé uniquement par les admins.
|
360 |
* Permet de dépublier une observation.
|
360 |
* Permet de dépublier une observation.
|
361 |
*
|
361 |
*
|
362 |
* @param array $ressources tableau des informations contenues dans l'url après le nom du service
|
362 |
* @param array $ressources tableau des informations contenues dans l'url après le nom du service
|
363 |
* @param array $parametres contenu du post
|
363 |
* @param array $parametres contenu du post
|
364 |
* @return mixed Chaine "OK" (en majuscule) en cas de succès, booléen "false" en cas d'échec
|
364 |
* @return mixed Chaine "OK" (en majuscule) en cas de succès, booléen "false" en cas d'échec
|
365 |
*/
|
365 |
*/
|
366 |
public function modifier($ressources, $parametres) {
|
366 |
public function modifier($ressources, $parametres) {
|
367 |
$controlAcces = $this->conteneur->getControleAcces();
|
367 |
$controlAcces = $this->conteneur->getControleAcces();
|
368 |
$controlAcces->etreUtilisateurAvecDroitAdmin();
|
368 |
$controlAcces->etreUtilisateurAvecDroitAdmin();
|
369 |
|
369 |
|
370 |
$retour = false;
|
370 |
$retour = false;
|
371 |
if (isset($parametres['transmission'])) {
|
371 |
if (isset($parametres['transmission'])) {
|
372 |
$idObs = $ressources[0];
|
372 |
$idObs = $ressources[0];
|
373 |
$clientRest = $this->conteneur->getRestClient();
|
373 |
$clientRest = $this->conteneur->getRestClient();
|
374 |
$urlTpl = $this->conteneur->getParametre('urlServiceCelObs');
|
374 |
$urlTpl = $this->conteneur->getParametre('urlServiceCelObs');
|
375 |
$url = $urlTpl.$idObs;
|
375 |
$url = $urlTpl.$idObs;
|
376 |
$retourCel = $clientRest->modifier($url, $parametres);
|
376 |
$retourCel = $clientRest->modifier($url, $parametres);
|
377 |
$retour = preg_match('/^OK$/i', $retourCel) ? 'OK' : false;
|
377 |
$retour = preg_match('/^OK$/i', $retourCel) ? 'OK' : false;
|
378 |
if ($retour === false) {
|
378 |
if ($retour === false) {
|
379 |
$message = "Erreur du web service CEL : ".$retourCel;
|
379 |
$message = "Erreur du web service CEL : ".$retourCel;
|
380 |
$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
|
380 |
$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
|
381 |
throw new Exception($message, $code);
|
381 |
throw new Exception($message, $code);
|
382 |
}
|
382 |
}
|
383 |
} else {
|
383 |
} else {
|
384 |
$message = "Ce web service doit contenir un paramètre 'transmission'.";
|
384 |
$message = "Ce web service doit contenir un paramètre 'transmission'.";
|
385 |
$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
|
385 |
$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
|
386 |
throw new Exception($message, $code);
|
386 |
throw new Exception($message, $code);
|
387 |
}
|
387 |
}
|
388 |
return $retour;
|
388 |
return $retour;
|
389 |
}
|
389 |
}
|
390 |
}
|
390 |
}
|