Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente | Prochaine révision Les deux révisions suivantes | ||
serveurscrutari:json:fiche_fields [2017/11/02 12:46] vincent |
serveurscrutari:json:fiche_fields [2017/11/04 14:48] vincent |
||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
====== Champs des fiches ====== | ====== Champs des fiches ====== | ||
- | Les champs des fiches constituent la masse la plus importante de données susceptibles d'être transmise par les différentes requêtes. La liste des champs à transmettre doit donc être indiquée par le paramètre //fichefields//. | + | Les champs des fiches constituent la masse la plus importante de données susceptibles d'être transmise par les différentes requêtes. La liste des champs à transmettre est indiquée soit par le paramètre //fichefields//, soit par la variante de champs à utiliser indiquée par le paramètre //fieldvariant//. Dans le cas d'absence des deux paramètres, c'est la variante par défaut qui est utilisée (voir la configuration des variantes de champs côté serveur avec le fichier [[serveurscrutari:config:fields|fields.xml]]. |
- | La valeur du paramètre //fichefields// est une liste de champs séparés par une virgule avec les valeurs suivantes : | + | |
+ | La valeur du paramètre //fichefields// ou de l'attribut //@fields// de l'élément !!<fiche>!! dans [[serveurscrutari:config:fields|fields.xml]] est une liste de champs séparés par une virgule avec les valeurs suivantes : | ||
* //-codefiche// : par défaut, le code de la fiche est toujours inséré, ce paramètre permet de l'éviter | * //-codefiche// : par défaut, le code de la fiche est toujours inséré, ce paramètre permet de l'éviter | ||
Ligne 64: | Ligne 65: | ||
===== Renommage des noms des champs dans l'objet résultant ===== | ===== Renommage des noms des champs dans l'objet résultant ===== | ||
- | Cette fonctionnalité peut être utile quand l'objet JSON est traité directement par d'autres outils (dans l'export au format GeoJSON notamment), il permet de changer le nom de la propriété dans l'objet résultant. Cette fonction est possible pour les champs suivants : | + | Cette fonctionnalité peut être utile quand l'objet JSON est traité directement par d'autres outils (dans l'export au format GeoJSON notamment). |
+ | |||
+ | Le moyen le plus efficace est de renommer un champ est d'utiliser les variantes de champs définies du côté serveur avec le fichier [[serveurscrutari:config:fields|fields.xml]] et les éléments !!<alias>!! (qui permettent notamment la concaténation de plusieurs champs en un seul). | ||
+ | |||
+ | Pour des raisons historiques et pratiques, il est possible de renommer certains champs directement avec les paramètres suivants : | ||
* //field-titre// : nom de la propriété du titre (//titre// par défaut) | * //field-titre// : nom de la propriété du titre (//titre// par défaut) | ||
Ligne 72: | Ligne 77: | ||
* //field-{nom d'attribut}// : pour toutes les propriétés basées sur un attribut (//{nom de l'attribut}// par défaut) | * //field-{nom d'attribut}// : pour toutes les propriétés basées sur un attribut (//{nom de l'attribut}// par défaut) | ||
- | Par exemple, l'application Umap (http://umap.openstreetmap.fr) peut traiter directement le résultat d'une recherche au format GeoJSON. Cependant, le nom d'un marqueur est déduit de la propriété //name//. Avec le paramètre //field-titre=name//, on s'assure que le titre apparait sous la propriété //name//. | + | |