Subversion Repositories eFlore/Applications.del

Compare Revisions

Ignore whitespace Rev 1384 → Rev 1385

/trunk/services/modules/0.1/observations/Observation.php
1,28 → 1,115
<?php
// declare(encoding='UTF-8');
/**
* Le web service observations récupère toutes les observations et, pour chacune d'elle, les
* images qui lui sont associées.
* Le web service observations récupère toutes les information pour une observation:
* images, votes sur image et protocole, commentaires, votes sur commentaires, ...
*
* @category php 5.2
* @package del
* @subpackage images
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
* @copyright Copyright (c) 2012, Tela Botanica (accueil@tela-botanica.org)
* @author Raphaël Droz <raphael@tela-botanica.org>
* @copyright Copyright (c) 2013, Tela Botanica (accueil@tela-botanica.org)
* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
* @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
* @version $Id: Bdd.php 403 2012-02-22 14:35:20Z gduche $
* @see http://www.tela-botanica.org/wikini/eflore/wakka.php?wiki=ApiIdentiplante01Observations
*
* @config-depend: "url_image" (dans configurations/config_observations.ini)
* ex: http://www.tela-botanica.org/appli:cel-img:%09dXL.jpg
*/
 
// http://localhost/del/services/0.1/observations/#id => une observation donnée et ses images, SANS LES propositions & nombre de commentaire
 
require_once(dirname(__FILE__) . '/ListeObservations2.php');
 
class Observation {
 
/* Map les champs MySQL vers les champs utilisés dans le JSON pour les clients pour
chacune des différentes tables utilisées pour le chargement de résultats ci-dessous.
- chargerObservation() (v_del_image)
- chargerVotesImage() (del_image_vote, del_image_protocole)
- chargerCommentaires() (del_commentaire_vote, del_commentaire).
Si la valeur vaut 1, aucun alias ne sera défini (nom du champ d'origine), cf consulter() */
static $mappings = array(
'observations' => array( // v_del_image
"id_observation" => 1,
"date_observation" => 1,
"date_transmission" => 1,
"famille" => "determination.famille",
"nom_sel" => "determination.ns",
"nom_sel_nn" => "determination.nn",
"nom_referentiel" => "determination.referentiel",
"nt" => "determination.nt",
"ce_zone_geo" => "id_zone_geo",
"zone_geo" => 1,
"lieudit" => 1,
"station" => 1,
"milieu" => 1,
"ce_utilisateur" => "auteur.id",
"mots_cles_texte" => "mots_cles_texte",
"commentaire" => 1),
/* exclus car issus de la jointure annuaire:
"nom" => "auteur.nom", // XXX: jointure annuaire
"prenom" => "auteur.prenom", // XXX: jointure annuaire
"courriel" => "observateur", // XXX: jointure annuaire */
/* présents dans cel_obs mais exclus:
ordre, nom_ret, nom_ret_nn, latitude, longitude, altitude, geodatum
transmission, date_creation, date_modificationabondance, certitude, phenologie, code_insee_calcule */
 
'images' => array( // v_del_image
"id_image" => 1,
"hauteur" => 1,
// "largeur" => 1, inutile semble-t-il
"date_prise_de_vue" => "date"),
/* présents dans cel_images mais exclus:
i_commentaire, nom_original, publiable_eflore, i_mots_cles_texte, i_ordre,
i_ce_utilisateur, i_prenom_utilisateur, i_nom_utilisateur, i_courriel_utilisateur */
 
'protocoles' => array( // del_image_protocole
"ce_protocole" => "protocole.id",
"id_protocole" => "protocole.id",
"intitule" => "protocole.intitule",
"descriptif" => "protocole.descriptif",
"tag" => "protocole.tag"),
 
/* See desc del_commentaire_vote & desc del_image_vote;
Les deux schémas sont similaires, à l'exception de ce_protocole
spécifique à del_image_vote et ce_proposition => ce_image */
'votes' => array( // del_image_vote et del_commentaire_vote
"id_vote" => "vote.id",
"ce_proposition" => "proposition.id",
"ce_image" => "image.id",
"ce_utilisateur" => "auteur.id", // attention, conflit avec commentaire, cf ci-dessous
"valeur" => "vote",
"date" => 1, // attention, conflit avec commentaire, cf ci-dessous
// absents du JSON, et pourtant présents dans services/configurations/config_mapping_votes.ini
// (nécessiterait une propre jointure sur del_utilisateur)
/* "nom" => "auteur.nom",
"prenom" => "auteur.prenom",
"courriel" => "auteur.courriel" */),
 
'commentaires' => array( // del_commentaire
"id_commentaire" => 1,
"ce_observation" => "observation",
"ce_proposition" => "proposition",
"ce_commentaire_parent" => "id_parent",
 
// les deux alias suivants sont particuliers afin d'éviter un conflit d'alias
// lors des jointures avec del_commentaire_vote ci-dessus
// (cf cas particulier dans la boucle de chargerCommentaires())
"ce_utilisateur" => "__auteur_com",
"date" => "__date_com",
 
"texte" => 1,
"utilisateur_nom" => "auteur.nom",
"utilisateur_prenom" => "auteur.prenom",
"utilisateur_courriel" => "auteur.courriel",
"nom_sel" => 1,
"nom_sel_nn" => 1,
"nom_ret_nn" => 1,
"proposition_initiale" => 1),
);
 
private $conteneur;
private $gestionBdd;
private $bdd;
private $id_observation;
private $imageIds;
public function __construct(Conteneur $conteneur = null) {
$this->conteneur = $conteneur == null ? new Conteneur() : $conteneur;
41,327 → 128,215
* @param array $parametres les paramètres situés après le ? dans l'url
* */
public function consulter($ressources, $parametres) {
if (!$ressources || count($ressources) != 1 ) {
throw new Exception("Le service observation accepte un unique identifiant d'observation", RestServeur::HTTP_CODE_ERREUR);
}
 
// initialise les mappings:
// substitue les valeurs à 1 par le nom de la clef (pas d'alias de champ)
array_walk(self::$mappings['observations'], create_function('&$val, $k', 'if($val==1) $val = $k;'));
array_walk(self::$mappings['images'], create_function('&$val, $k', 'if($val==1) $val = $k;'));
array_walk(self::$mappings['protocoles'], create_function('&$val, $k', 'if($val==1) $val = $k;'));
array_walk(self::$mappings['votes'], create_function('&$val, $k', 'if($val==1) $val = $k;'));
array_walk(self::$mappings['commentaires'], create_function('&$val, $k', 'if($val==1) $val = $k;'));
 
 
// Gestion des configuration du script
$this->configurer($ressources);
$this->verifierConfiguration();
// Lancement du service
$liaisons = $this->chargerLiaisons();
$observation = array();
$idobs = $ressources[0];
$protocole = isset($parametres['protocole']) && is_numeric($parametres['protocole']) ?intval($parametres['protocole']) : NULL;
 
if($liaisons) {
$observation = $this->chargerObservation($liaisons);
// modifie $observation
$this->chargerImages($observation);
// modifie $observation
$this->chargerCommentaires($observation);
}
else {
// 1) récupération de l'observation (et de ses images (v_del_image est une vue utilisant des INNER JOIN))
$liaisons = self::chargerObservation($this->bdd, $idobs);
if(!$liaisons) {
header('HTTP/1.0 404 Not Found');
// don't die (phpunit)
throw(new Exception());
}
 
// 2) réassocie les images "à plat" à leur observation (merge)
$observations = ListeObservations2::reformateObservationSimpleIndex($liaisons, $this->conteneur->getParametre('url_images'));
// bien que dans notre cas il n'y est qu'une seule observation, issu de plusieurs images
// dans $liaisons, $observation est un tableau (cf reformateObservation).
// Considérons la chose comme telle au cas où le webservice doivent demain demander une paire
// d'observations (... convergence ListeObservations)
 
$observation = array_pop($observations);
 
// 3) charge les données de votes et protocoles associés aux images
if($observation['images']) {
$votes = self::chargerVotesImage($this->bdd, $observation['images'], $protocole);
// 3") merge/reformate les données retournées
self::mapVotesToImages($votes,
$observation['images']);
}
 
// 4) charge les commentaires et les votes associés
// modifie/créé $observation['commentaires']
self::chargerCommentaires($this->bdd, $observation);
 
 
// désindexe le tableau (tel qu'apparement attendu par les applis), c'est une exception
// corriger l'appli cliente pour utiliser les index puis supprimer cette ligne
$observation['images'] = array_values($observation['images']);
// autre élément de post-processing: le ce_utilisateur de l'observation non-numeric...
if(!is_numeric($observation['auteur.id'])) $observation['auteur.id'] = "0";
if(!isset($observation['auteur.nom'])) $observation['auteur.nom'] = '[inconnu]';
// Mettre en forme le résultat et l'envoyer pour affichage
$resultat = new ResultatService();
$resultat->corps = $observation;
return $resultat;
}
 
static function chargerObservation($db, $idobs) {
// prenom_utilisateur, nom_utilisateur, courriel_utilisateur sont exclus du mapping
// car nous utilisons une construction SQL élaborée pour eux (cf IFNULL ci-dessous)
$obs_fields = self::sqlFieldsToAlias(self::$mappings['observations'], NULL, 'dob');
 
$image_fields = self::sqlFieldsToAlias(self::$mappings['images'], NULL, 'dob');
 
// champs de l'annuaire (del_utilisateur): id_utilisateur prenom, nom, courriel
$annuaire_fields = implode(', ', array("IFNULL(du.prenom, prenom_utilisateur) AS `auteur.prenom`",
"IFNULL(du.nom, nom_utilisateur) AS `auteur.nom`",
"IFNULL(du.courriel, courriel_utilisateur) AS observateur"));
return $db->recupererTous(sprintf(
'SELECT %s, %s, %s FROM v_del_image as dob'.
' LEFT JOIN del_utilisateur du ON CAST(du.id_utilisateur AS CHAR) = CAST(dob.ce_utilisateur AS CHAR)'.
' WHERE dob.id_observation = %d -- %s',
$obs_fields, $image_fields, $annuaire_fields, $idobs, __FILE__ . ':' . __LINE__));
}
 
/*-------------------------------------------------------------------------------
CONFIGURATION DU SERVICE
--------------------------------------------------------------------------------*/
/**
* Configuration du service en fonction du fichier de config config_del.ini
* */
private function configurer($ressources) {
$this->mappingObservation = $this->conteneur->getParametre('mapping_observation');
$this->mappingVotes = $this->conteneur->getParametre('mapping_votes');
$this->mappingCommentaire = $this->conteneur->getParametre('mapping_commentaire');
if (empty($ressources) || sizeof($ressources) > 1 ) {
$e = 'Le service observation accepete 1 et 1 seule ressource';
throw new Exception($e, RestServeur::HTTP_CODE_ERREUR);
} else {
$this->id_observation = $ressources[0];
// Charger les images et leurs votes associés
static function chargerVotesImage($db, $images, $protocole = NULL) {
if(!$images) return NULL;
 
$select = array('votes' =>
array('id_vote', 'ce_image', 'ce_protocole', 'ce_utilisateur', 'valeur', 'date', /* del_image_vote */),
'protocole' =>
array('id_protocole', 'intitule', 'descriptif', 'tag' /* del_image_protocole */ ));
$vote_fields = self::sqlFieldsToAlias(self::$mappings['votes'], $select['votes'], 'v'); // "v": cf alias dans la requête
$proto_fields = self::sqlFieldsToAlias(self::$mappings['protocoles'], $select['protocole'], 'p');
$where = array();
$where[] = sprintf('v.ce_image IN (%s)',
implode(',', array_values(array_map(create_function('$a', 'return $a["id_image"];'), $images))));
 
if ($protocole) {
$where[] = "v.ce_protocole = $protocole";
}
 
return $db->recupererTous(sprintf(
'SELECT %s, %s FROM del_image_vote AS v'.
' INNER JOIN del_image_protocole p ON v.ce_protocole = p.id_protocole'.
' WHERE %s -- %s',
$vote_fields, $proto_fields,
$where ? implode(' AND ', $where) : 1,
__FILE__ . ':' . __LINE__));
}
/**
* Vérifier que le service est bien configuré
* Formater une observation depuis une ligne liaison
* @param $liaison liaison issue de la recherche
* @return $observation l'observation mise en forme
* Exemple: vote, au sortir de MySQL contient:
* 'xxx' => 'blah', 'descriptif' => 'foo', 'valeur' => 3
* et le tableau de mapping contient:
* descriptif = protocole.descriptif, valeur = vote
* Alors $retour[ contient:
*
* */
private function verifierConfiguration() {
$erreurs = array();
$tableauImages = $this->conteneur->getParametre('observations');
if (empty($tableauImages)) {
$erreurs[] = '- le fichier de configuration ne contient pas le tableau [images] ou celui-ci est vide ;';
} else {
if ($this->conteneur->getParametre('url_service') == null) {
$erreurs[] = '- paramètre "url_service" manquant ;';
}
static function mapVotesToImages($votes, &$images) {
if(!$votes) return;
 
// pour chaque vote
foreach ($votes as $vote) {
$imgid = $vote['image.id'];
$protoid = $vote['protocole.id'];
if ($this->conteneur->getParametre('url_images') == null) {
$erreurs[] = '- paramètre "url_images" manquant ;';
// un vote sans image associée ? est-ce possible ?
// if(!isset($images[$imgid])) continue;
if(!array_key_exists('protocoles_votes', $images[$imgid]) ||
!array_key_exists($protoid, $images[$imgid]['protocoles_votes'])) {
// extrait les champs spécifique au protocole (le LEFT JOIN de chargerVotesImage les ramène en doublons
$protocole = array_intersect_key($vote, array_flip(self::$mappings['protocoles']));
$images[$imgid]['protocoles_votes'][$protoid] = $protocole;
}
}
 
if (empty($this->mappingObservation)) {
$erreurs[] = '- le fichier de configuration ne contient pas le tableau [mapping_observation] ou celui-ci est vide ;';
} else {
$champsMappingObs = array('id_observation', 'date_observation', 'date_transmission', 'famille', 'nom_sel', 'nom_sel_nn', 'nt',
'ce_zone_geo', 'zone_geo', 'lieudit', 'station', 'courriel', 'ce_utilisateur', 'nom', 'prenom');
foreach ($champsMappingObs as $champ) {
if (!isset($this->mappingObservation[$champ])) {
$erreurs[] = '- le mapping du champ "'.$champ.'" pour l\'observation est manquant ;';
}
}
$vote = array_intersect_key($vote, array_flip(self::$mappings['votes']));
$images[$imgid]['protocoles_votes'][$protoid]['votes'][$vote['vote.id']] = $vote;
}
if (empty($this->mappingCommentaire)) {
$erreurs[] = '- le fichier de configuration ne contient pas le tableau [mapping_commentaire] ou celui-ci est vide ;';
} else {
$champsMappingCom = array('id_commentaire', 'texte', 'ce_utilisateur', 'utilisateur_nom', 'utilisateur_prenom', 'utilisateur_courriel', 'date');
foreach ($champsMappingCom as $champ) {
if (!isset($this->mappingCommentaire[$champ])) {
$erreurs[] = '- le mapping du champ "'.$champ.'" pour le commentaire est manquant ;';
}
}
}
if (!empty($erreurs)) {
$e = 'Erreur lors de la configuration : '."\n";
$e .= implode("\n", $erreurs);
throw new Exception($e, RestServeur::HTTP_CODE_ERREUR);
}
}
/*-------------------------------------------------------------------------------
CHARGEMENT DES OBSERVATIONS
--------------------------------------------------------------------------------*/
/**
* Chargement depuis la bdd de toutes les liaisons entre images et observations
* */
private function chargerLiaisons() {
$requeteLiaisons = 'SELECT *, dob.commentaire as dob_commentaire '.
'FROM '.$this->gestionBdd->formaterTable('del_observation', 'dob').
'INNER JOIN '.$this->gestionBdd->formaterTable('del_obs_image', 'doi').
'ON doi.id_observation = dob.id_observation '.
'LEFT JOIN del_utilisateur du '.
'ON du.id_utilisateur = dob.ce_utilisateur '.
'WHERE doi.id_observation = '.$this->id_observation;
$requeteLiaisons .= ' GROUP BY doi.id_observation';
$requeteLiaisons .= ' ORDER BY date_transmission DESC ';
$requeteLiaisons .= $this->gestionBdd->getLimitSql();
return $this->bdd->recuperer($requeteLiaisons);
}
/**
* Retourner un tableau d'images formaté en fonction des liaisons trouvées
* @param $liaisons les liaisons de la table del_obs_images
* */
private function chargerObservation($liaison) {
 
if($liaison['ce_utilisateur'] == 0) {
$liaison['nom'] = $liaison['nom_utilisateur'];
$liaison['prenom'] =$liaison['prenom_utilisateur'];
}
$observation = $this->formaterObservation($liaison);
return $observation;
}
/**
* Sélectionner toutes les images de chaque observation
* @param array $observations la liste des observations
* */
private function chargerImages(&$observation) {
$images = $this->bdd->recupererTous(sprintf(
'SELECT * FROM %s INNER JOIN %s ON doi.id_image = di.id_image WHERE doi.id_observation = %d',
$this->gestionBdd->formaterTable('del_obs_image', 'doi'),
$this->gestionBdd->formaterTable('del_image', 'di'),
$observation['id_observation']));
if(!$images) return;
$images = $this->formaterImages($images);
// modifie $images
$this->chargerVotesImage($images);
$observation['images'] = $images;
}
/**
* Charger les votes pour chaque image
* */
private function chargerVotesImage(&$images) {
$resultatsVotes = $this->bdd->recupererTous(sprintf(
'SELECT v.*, p.* FROM %s INNER JOIN del_image_protocole p ON v.ce_protocole = p.id_protocole %s -- %s',
$this->gestionBdd->formaterTable('del_image_vote', 'v'),
$this->chargerClauseWhereVotesImage(),
// Charger les commentaires et leurs votes associés
static function chargerCommentaires($db, &$observation) {
$select = array('votes' =>
array('id_vote', 'ce_proposition', 'ce_utilisateur', 'valeur', 'date' /* del_commentaire_vote */),
'commentaires' =>
array('id_commentaire', 'ce_observation', 'ce_proposition', 'ce_commentaire_parent', 'texte',
'ce_utilisateur', 'utilisateur_prenom', 'utilisateur_nom', 'utilisateur_courriel',
'nom_sel', 'nom_sel_nn', 'nom_ret', 'nom_ret_nn', 'nt', 'famille', 'nom_referentiel', 'date',
'proposition_initiale'));
$vote_fields = self::sqlFieldsToAlias(self::$mappings['votes'], $select['votes'], 'cv'); // "v": cf alias dans la requête
$comment_fields = self::sqlFieldsToAlias(self::$mappings['commentaires'], $select['commentaires'], 'dc');
 
$commentaires = $db->recupererTous(sprintf(
"SELECT %s, %s FROM del_commentaire as dc".
// LEFT JOIN optionnel, mais explicatif:
// on ne récupère des infos de vote que pour les commentaires comportant un
// nom_sel "valide"
" LEFT JOIN del_commentaire_vote cv".
" ON cv.ce_proposition = dc.id_commentaire AND dc.nom_sel != '' AND dc.nom_sel IS NOT NULL".
" WHERE ce_observation = %d -- %s",
$comment_fields, $vote_fields,
$observation['id_observation'],
__FILE__ . ':' . __LINE__));
if(!$resultatsVotes) return;
 
$votes = $this->formaterVotesImages($resultatsVotes);
foreach ($images as $id => $image) {
if (isset($votes[$image['id_image']])) {
foreach($votes[$image['id_image']] as $id_vote => $vote_image) {
$images[$id]['protocoles_votes'][$id_vote] = $vote_image;
}
}
}
}
private function chargerClauseWhereVotesImage() {
if (sizeof($this->imageIds) > 0) {
$chaineImageIds = implode(',', $this->imageIds);
$where[] = 'v.ce_image IN ('.$chaineImageIds.')';
}
if (isset($this->parametres['protocole'])) {
$where[] = 'v.ce_protocole = '.$this->proteger($this->parametres['protocole']);
}
$where = (!empty($where)) ? 'WHERE '.implode(' AND ', $where) : '';
return $where;
}
/**
* Récupérer tous les commentaires au total
* @param array $observations la liste des observations à mettre à jour
* */
private function chargerCommentaires(&$observation) {
$requeteCommentaires = 'SELECT * FROM '.$this->gestionBdd->formaterTable('del_commentaire', 'dc').
'WHERE ce_observation = '.$observation['id_observation'];
$commentaires = $this->bdd->recupererTous($requeteCommentaires);
if(!$commentaires) return;
 
$commentaires_formates = array();
foreach ($commentaires as $commentaire) {
$commentaire = $this->formaterCommentaire($commentaire);
if (isset($commentaire['nom_sel']) && $commentaire['nom_sel'] != null) {
$commentaire['votes'] = $this->chargerVotes($commentaire['id_commentaire']);
// les commentaires réunifiées et dont les votes sont mergés
$ret = array();
foreach ($commentaires as $comment) {
$commentid = $comment['id_commentaire'];
$voteid = $comment['vote.id'];
 
if(!array_key_exists($commentid, $ret)) {
$comment_extract = array_intersect_key($comment, array_flip(self::$mappings['commentaires']));
// cas particulier: conflit d'aliases avec del_commentaire_vote
$comment_extract['auteur.id'] = $comment_extract['__auteur_com'];
$comment_extract['date'] = $comment_extract['__date_com'];
unset($comment_extract['__auteur_com'], $comment_extract['__date_com']);
 
// toujours un éléments "votes", quand bien même il n'y en aurait pas
$comment_extract['votes'] = array();
$ret[$commentid] = $comment_extract;
}
$commentaires_formates[$commentaire['id_commentaire']] = $commentaire;
 
if(!$comment['nom_sel'] || ! $voteid) continue;
$vote = array_intersect_key($comment, array_flip(self::$mappings['votes']));
$ret[$commentid]['votes'][$voteid] = $vote;
}
$observation['commentaires'] = $commentaires_formates;
$observation['commentaires'] = $ret;
}
private function chargerVotes($id_commentaire) {
$requeteVotes = 'SELECT * FROM '.
$this->gestionBdd->formaterTable('del_commentaire_vote').
'WHERE ce_proposition = '.$this->proteger($id_commentaire);
$resultatsVotes = $this->bdd->recupererTous($requeteVotes);
$votes = array();
foreach ($resultatsVotes as $vote) {
$id_vote = $vote['id_vote'];
$votes[$id_vote] = $this->formaterVote($vote);
}
return $votes;
}
/*-------------------------------------------------------------------------------
FORMATER ET METTRE EN FORME
--------------------------------------------------------------------------------*/
/**
* Formater les images d'une observation
* @param array $images les images de l'observation
* // TODO: en faire le maximum dans le SELECT
* */
private function formaterImages($images) {
$imagesRetour = array();
foreach ($images as $image) {
$this->imageIds[] = $image['id_image'];
$imageCourante = array();
$imageCourante['id_image'] = $image['id_image'];
$imageCourante['date'] = $image['date_prise_de_vue'];
$imageCourante['binaire.href'] = sprintf($this->conteneur->getParametre('url_images'), $image['id_image']);
$imageCourante['hauteur'] = $image['hauteur'];
$imageRetour['largeur'] = $image['largeur'];
$imagesRetour[] = $imageCourante;
}
return $imagesRetour;
}
/**
* Formater une observation depuis une ligne liaison
* @param $liaison liaison issue de la recherche
* @return $observation l'observation mise en forme
* */
private function formaterObservation($liaison) {
$observation = array();
foreach ($this->mappingObservation as $nomOriginal => $nomFinal) {
$observation[$nomFinal] = $liaison[$nomOriginal];
}
$observation['images'] = array();
 
return $observation;
 
/* SQL helper
Converti un tableau associatif et un préfix optionnel en une chaîne de champs adéquate
à un SELECT MySQL.
$select (optionnel) restreint les champs mappés aux valeurs de $select.
Si $select n'est pas fourni, toutes les clefs présentes dans $map seront présentes dans
le SELECT en sortie */
static function sqlFieldsToAlias($map, $select = NULL, $prefix = NULL) {
if($select) $arr = array_intersect_key($map, array_flip($select));
else $arr = $map;
$keys = array_keys($arr);
 
if($prefix) array_walk($keys, create_function('&$val, $k, $prefix', '$val = sprintf("%s.`%s`", $prefix, $val);'), $prefix);
else array_walk($keys, create_function('&$val, $k', '$val = sprintf("`%s`", $val);'));
 
return implode(', ', array_map(create_function('$v, $k', 'return sprintf("%s AS `%s`", $k, $v);'), $arr, $keys));
}
private function proteger($valeur) {
if (is_array($valeur)) {
return $this->bdd->protegerTableau($valeur);
} else {
return $this->bdd->proteger($valeur);
}
}
/**
*
* Formate un commentaire en fonction du fichier de configuration
*/
private function formaterCommentaire($commentaire) {
$commentaire_formate = array();
foreach ($this->mappingCommentaire as $nomOriginal => $nomFinal) {
if (isset($commentaire[$nomOriginal])) {
$commentaire_formate[$nomFinal] = $commentaire[$nomOriginal];
}
}
return $commentaire_formate;
}
/**
* Formater un vote en fonction du fichier de configuration config_votes.ini
* @param $votes array()
* */
private function formaterVote($vote) {
$retour = array();
foreach ($vote as $param => $valeur) {
$retour[$this->mappingVotes[$param]] = $valeur;
}
return $retour;
}
/**
* Formater une observation depuis une ligne liaison
* @param $liaison liaison issue de la recherche
* @return $observation l'observation mise en forme
* */
private function formaterVotesImages($votes) {
$retour = array();
foreach ($votes as $vote) {
$retour_vote = array();
foreach ($vote as $param=>$valeur) {
if (strpos($this->mappingVotes[$param], 'protocole.') === 0) {
$retour_protocole[$this->mappingVotes[$param]] = $valeur;
} else {
$retour_vote[$this->mappingVotes[$param]] = $valeur;
}
}
if (!isset($retour[$vote['ce_image']][$vote['ce_protocole']])) {
$retour[$vote['ce_image']][$vote['ce_protocole']] = $retour_protocole;
}
$retour[$vote['ce_image']][$vote['ce_protocole']]['votes'][$vote['id_vote']] = $retour_vote;
}
return $retour;
}
}
?>
}