Documentation SDX-2 Télécharger Installer Présentation Configuration Indexation Recherche OAI Javadoc Référence API-XSP Pages XSP Paramètres SDX Vue d'ensemble Structure Paramètres et flux Identification Droits Localisation Pipelines Thesaurus Indexation Recherche Index Requêtes Paramètres Amender Résultats Documents Liste alphabétique Migration Schemas Performances | # Paramètres communs des requêtes Cette page contient la description de l'ensemble des paramètres partagés par les actions d'exécution de requêtes. Ces actions admettent d'autres paramètres, mais ceux-ci ne sont pas forcément communs à l'ensemble. On se reportera logiquement aux sections de description de ces actions : `sdx:executeFieldQuery` ; `sdx:executeListQuery` ; `sdx:executeDateQuery` ; `sdx:executeSimpleQuery` ; `sdx:executeLinearQuery` ; `sdx:executeComplexQuery`. Tableau 1. Paramètres employés par les actions d'exécution de requêtes
Nom | Description
--- | ---
`show` | Ce paramètre permet de définir le résumé des informations de l'environnement dans lequel la page SDX est utilisée. Les valeurs autorisées pour ce paramètre (avec les actions d'exécution de requête, voir `sdx:page` pour connaître une autre utilisation de ce paramètre) sont : `documents` `show="documents"` déclenche la commande d'inclusion du document dans la page de résultat, non plus les seules informations permettant de retrouver ce document (avec `sdx:includeDocument` par exemple). `results` `show="results"` déclenche la commande d'inclusion des `sdx:result` contenant les informations permettant de retrouver le document (comportement par défaut). `fields` `show="fields"` déclenche la commande d'inclusion des `sdx:field` marqué `brief="true"` dans le fichier `application.xconf` (comportement par défaut).
| Note
Ces valeurs sont juxtaposables (e.g., `show="results documents"`). Noter toutefois l'obligation de préciser l'ensemble des résultats désirés dès le moment où l'une des valeurs est employées. Ainsi `show="results"` n'inclura que les `sdx:result` dans la page de résultat. Le document lui-même et les `sdx:field` seront omis. `show="results` document" inclura les `sdx:result` et les documents eux-mêmes dans la page de résultat ; les `sdx:field` seront omis.
`hilite` | Active la mise en évidence du (des) terme(s) de la requête. Deux valeurs sont autorisées pour ce paramètre : `true` et `false`. Ce paramètre peut également être employé pour passer l'identifiant d'une requête dont SDX récupère alors le(s) terme(s) pour les mettre en évidence (cf. l'exemple Activer la mise en évidence sur une ancienne requête de `sdx:debug`).
`docs` | Active la commande d'inclusion du ou des documents issus d'une requête. Les deux valeurs autorisées pour ce paramètres sont : `true` (active la commande) et `false` (désactive la commande).
`page` | Numéro de la page de résultat que l'on souhaite appeler.
`p` | Idem. Déprécié
`no` | Numéro du résultat que l'on souhaite appeler.
`n` | Idem. Déprécié
`app` | Identifiant de l'application. Par défaut, il s'agit de l'application courante.
`bqid` | Identifiant de la requête que l'on souhaite reprendre pour l'affiner ou l'étendre (cf. `sdx:baseQuery` pour approfondir la notion de sur-requête).
`bop` | Opérateur entrant la construction d'une sur-requête (cf. `sdx:baseQuery`). Par défaut , l'opérateur est un `ou` logique (inclusif).
`ff` | Identifiant un champ sur lequel on souhaite activer un filtre de recherche (voir `sdx:filter` pour approfondir la notion).
`fv` | Identifiant une valeur sur laquelle on souhaite activer un filtre de recherche (cf. `sdx:filter`).
`fop` | Opérateur entrant dans la construction d'un filtre (cf. `sdx:filter`). Par défaut, l'opérateur est un `ou` logique (inclusif).
`appByPath` | Indique la partie de l'URL qui suit "`sdx/`" dans une installation standard, par exemple "`sdxtest`".
`base` | Identifiant de la base de documents. Par défaut, il s'agit de la base courante.
`qid` | Identifiant de la requête que l'on souhaite reprendre. Cet identifiant est donné automatiquement à chaque requête exécutée. Par défaut, SDX conserve 5 résultats de requête en mémoire. Ce nombre peut être augmenté en modifiant la variable `sdx_qmax` (cf. la logicsheet `sdx.xsl`). Il est possible de conserver un résultat de requête le temps d'une session d'utilisateur en donnant statiquement un identifiant à un résultat de requête (cf. `sdx:results` pour approfondir ce point). .
`hpp` | Spécifie le nombre de réponses que devra contenir la page de résultats. Par défaut, ce nombre est fixé à 20 (cf. fichier `sdx.xsl`).
`sf` | Identifie le champ sur lequel on souhaite effectuer un tri. Ce paramètre est répétable en autant de clés de tri désirées.
`so` | Identifie l'ordre de classement d'une clé de tri. Par défaut, le classement s'effectue de manière ascendante (de `1` à `10`, de `a` à `z`).
`boost` | Indique un facteur de pondération de la pertinence pour cette requête. La valeur doit être un nombre réel, s'il est supérieur à 1.0 alors cette requête aura un facteur de pondération positif ou, autrement dit, elle sera plus importante que la moyenne. Ce facteur est utile pour pondérer les différentes composantes d'une requête de type complexe. Cette fonctionnalité est disponible depuis la version 2.3 de SDX uniquement. Sur une version antérieure, elle n'a aucun effet.
| Auteur : Malo Pichot (AJLSM) - 2004-08-25

| Home |
Copyright © 2000, 2001, 2002, 2003, 2004 Ministère de la culture et de la communication, AJLSM.