Paramètre prop
Le paramètre prop sert à indiquer quelles données de la fiche sont retournées (sous la forme de propriétés d'un objet). La configuration de ce paramètre permet de diminuer le poids des données transmises en les limitant au nécessaire.
La valeur du paramètre prop est une liste de champs séparés par une virgule.
Les trois propriétés suivantes : le code de la fiche, le code du corpus et la partie identifiant de la fiche dans l'URI de celle-ci sont toujours présentes. Il n'est pas nécessaire de les indiquer dans le paramètre prop.
Note : même si un champ est indiqué dans prop, la propriété peut être absente dans l'objet Javascript correspondant si la valeur est nulle.
Les champs possibles sont les suivants :
- titre : titre de la fiche
- href : url de la fiche
- geo : latitude et longitude
- soustitre : sous-titre de la fiche
- annee : année de la fiche
- mtitre : retourne le titre « marqué », c'est à dire avec les indications de position des chaines de la recherche (c'est ce qui permet notamment de surligner les termes quand on affiche le titre) ; ce n'est pertinent que lorsque la liste des fiches est obtenue via une recherche libre ; la valeur est nulle si le titre n'a pas servi à la recherche
- mtitre_def : identique au précédent, sauf que si le titre n'a pas servi à la recherche, ce champ contient le titre lui-même (au lieu d'une valeur nulle)
- msoustitre : retourne le sous-titre « marqué » suivant le même principe que mtitre
- msoustitre_def : retourne le sous-titre « marqué » avec le sous-titre normal par défaut suivant le même principe que mtitre_def
- complements : tableau des champs complémentaires, ils sont représentés sous la forme d'objets avec la propriété num qui est le numéro du champ et la propriété comp qui est le contenu du complément
- mcomplements : tableau des champs complémentaires comme ci-dessus avec la propriété mcomp qui contient le champ marqué (le complément n'est pas inclus s'il n'a pas servi à la recherche)
- mcomplements_def : comme précédent, mais si le complément a participé à la recherche, il est tout de même inclus avec sa valeur dans la propriété mcomp