Pleade Formulaire de Recherche - Historique des versions

Groche : a déplacé Doc/Formulaire de Recherche vers Pleade Formulaire de Recherche

2013-04-24T10:38:13Z

a déplacé Doc/Formulaire de Recherche vers Pleade Formulaire de Recherche

← Version précédente	Version du 24 avril 2013 à 10:38
(Aucune différence)

Groche : /* Activation conditionnelle */

2012-11-07T17:33:21Z

Activation conditionnelle

← Version précédente		Version du 7 novembre 2012 à 17:33
Ligne 464 :		Ligne 464 :
	<form ...>		<form ...>
	<key type="suggest" field="fsubject" help="true" terms-browse="true">		<key type="suggest" field="fsubject" help="true" terms-browse="true">
	<activates id="fsubject">		<activates id="fsubject">
	<activateField>fulltext</activateField>		<activateField>fulltext</activateField>
	<activateField>fgeogname</activateField>		<activateField>fgeogname</activateField>
	<activateDateField>fgeogname</activateDateField>		<activateDateField>fgeogname</activateDateField>
	<activateDate>annee</activateDate>		<activateDate>annee</activateDate>
	</activates>		</activates>
	</key>		</key>
	<key type="text" field="fulltext" ... />		<key type="text" field="fulltext" ... />

Groche : /* Activation conditionnelle */

2012-11-07T17:32:18Z

Activation conditionnelle

← Version précédente		Version du 7 novembre 2012 à 17:32
Ligne 461 :		Ligne 461 :

	Ce méchanisme s'applique sur tout type de champs. Les champs à activer sont identifiés par la valeur de leur attribut {{attr\|field}}, {{attr\|hfield}} ou {{attr\|id}} (les dates non pas de {{attr\|(h)field}}).		Ce méchanisme s'applique sur tout type de champs. Les champs à activer sont identifiés par la valeur de leur attribut {{attr\|field}}, {{attr\|hfield}} ou {{attr\|id}} (les dates non pas de {{attr\|(h)field}}).
	<syntaxhighlight lang="xml" highlight="3-9">		<syntaxhighlight lang="xml" highlight="3-8">
	<form ...>		<form ...>
	<key type="suggest" field="fsubject" help="true" terms-browse="true">		<key type="suggest" field="fsubject" help="true" terms-browse="true">

Groche : /* Activation conditionnelle */

2012-11-07T17:32:02Z

Activation conditionnelle

← Version précédente		Version du 7 novembre 2012 à 17:32
Ligne 461 :		Ligne 461 :

	Ce méchanisme s'applique sur tout type de champs. Les champs à activer sont identifiés par la valeur de leur attribut {{attr\|field}}, {{attr\|hfield}} ou {{attr\|id}} (les dates non pas de {{attr\|(h)field}}).		Ce méchanisme s'applique sur tout type de champs. Les champs à activer sont identifiés par la valeur de leur attribut {{attr\|field}}, {{attr\|hfield}} ou {{attr\|id}} (les dates non pas de {{attr\|(h)field}}).
	<syntaxhighlight lang="xml" highlight="3-10">		<syntaxhighlight lang="xml" highlight="3-9">
	<form ...>		<form ...>
	<key type="suggest" field="fsubject" help="true" terms-browse="true">		<key type="suggest" field="fsubject" help="true" terms-browse="true">
Ligne 477 :		Ligne 477 :

	</syntaxhighlight>		</syntaxhighlight>

	==== Styles ====		==== Styles ====
	Dans chaque élément {{tag\|key}} il est possible de définir un attribut style dont la valeur doit être valide par rapport au contenu du même attribut dans la norme XHTML, soit des règles CSS.		Dans chaque élément {{tag\|key}} il est possible de définir un attribut style dont la valeur doit être valide par rapport au contenu du même attribut dans la norme XHTML, soit des règles CSS.

Groche : /* Styles */ [edit] Activation conditionnelle

2012-11-07T17:31:44Z

Styles : [edit] Activation conditionnelle

@@ Ligne 457 : / Ligne 457 : @@
 </syntaxhighlight>
 ==== Styles ====
 Dans chaque élément {{tag|key}} il est possible de définir un attribut style dont la valeur doit être valide par rapport au contenu du même attribut dans la norme XHTML, soit des règles CSS.

Groche : mise en forme+catégorie

2012-09-13T16:33:04Z

mise en forme+catégorie

Voir les modifications

Groche : création

2012-09-13T09:04:47Z

création

Nouvelle page

== Introduction ==
Dans une application Pleade, on peut proposer aux utilisateurs des formulaires de recherche, qui permettent d'exprimer une requête et de lancer la recherche. Dans un projet d'intégration Pleade, la préparation de ces formulaires de recherche est en général une activité importante.

On peut afficher dans Pleade un formulaire de recherche avec une URL qui utilise le nom du fichier de formulaire. Par exemple, pour afficher le formulaire défini dans le fichier {{path|cadastre.xconf}}, il faut utiliser l'URL {{path|search-form.html?name=cadastre}}. Donc dans le paramètre name, on indique le nom du fichier du formulaire, mais sans son extension. Tous les fichiers de configuration de formulaires sont dans le répertoire {{path|module-eadeac/conf/search-forms/}}.

Le formulaire nommé {{path|ead-default.xconf}} est un cas particulier, il peut être appelé directement par l'URL {{path|search-forms.html}}, sans paramètre {{attr|name}}. Il s'agit du formulaire par défaut de Pleade.

Dans l'interface d'administration des menus, un formulaire est présenté comprenant autant d'onglets que de formulaires configurés dans l'application, plus un permettant d'ajouter un nouveau formulaire.
[image:administration-search-form.png]

== Structure générale ==
La structure générale du document XML qui décrit un formulaire est schématisée ainsi :
<syntaxhighlight lang="xml">
<form ...>
<key.../>
<key.../>
...
</form>
</syntaxhighlight>

Cette structure est donc très simple : un élément {{tag|form}} qui matérialise le formulaire et ensuite une suite d'éléments {{tag|key}} qui représentent chacun un critère de recherche.

On constate donc une caractéristique importante des formulaires Pleade : il s'agit nécessairement d'un formulaire de recherche « à plat », c'est-à-dire constitué d'une suite de critères, mais sans regroupement, sans sous-critères, etc.

== Attributs du formulaire ==
L'élément racine form dans le fichier de définition du formulaire peut prendre ces différents attributs :
<syntaxhighlight lang="xml">
<form
action=""
max-chars=""
documents=""
auto-expand=""
>
...
</form>
</syntaxhighlight>

La signification des différents attributs est :
{| class="wikitable sortable"
|-
! Attribut !! Description
|-
| {{attr|action}} ||
'''Obligatoire'''. L'URL qui doit être appelée par le formulaire lorsque l'utilisateur valide sa recherche. Pour l'instant, les seules valeurs supportées par Pleade doivent être de la forme {{path|*-results.html}}. La valeur par défaut est {{path|results.html}}. Les types d'affichage des résultats possibles sont :
* {{path|results.html}} : '''défaut'''. affichage selon le cadre declassement ;
* {{path|table-results.html}} : affichage sous forme de tableau ;
* {{path|list-results.html}} : affichage en liste sans hiérarchie ;
* {{path|mosaic-results.html}} : affichage sous forme d'apercu ;
* {{path|custom-results.html}} : affichage personnalisable.
|-
| {{attr|max-chars}} ||
'''Optionnel'''. Dans les listes de valeurs, le nombre maximal de caractères à afficher en largeur, afin d'éviter des débordements (listes trop longues en largeur). Cette indication peut également être fournie dans la définition d'un critère de recherche.
|-
| {{attr|documents}} ||
'''Obligatoire'''. La base de documents à rechercher, dans une installation standard de Pleade, les valeurs possibles sont : {{value|ead}}, {{value|eac}} ou tout autre bases définies. Plusieurs valeurs peuvent être indiquées séparées par une espace.
|-
| {{attr|auto-expand}} ||
'''Optionnel'''. Les résultats de recherche étant affichés dans l'ordre du cadre de classement, on peut
indiquer avec cet attribut comment les entrées du cadre de classement seront affichées, c'est-à-dire si
elles seront automatiquement « ouvertes » ou non. Si cet attribut n'est pas renseigné, c'est le
paramètre d'installation correspondant qui fait foi.
Cet attribut peut prendre différentes valeurs :
●
_all : tous les niveaux seront automatique ouverts.
●
n (un nombre, par exemple 3) : les entrées jusqu'au niveau indiqué seront automatiquement
ouvertes.
●
docs:n (la mention « docs » suivie d'un nombre) :une entrée sera ouverte uniquement si elle
contient au plus n documents résultats.
●
units:n (la mention « units » suivie d'un nombre) : une entrée sera ouverte uniquement si
elle contient au plus n unités de recherche résultats.
== Les critères de recherche ==
=== Principales caractéristiques communes ===
Chaque critère de recherche est exprimé par un élément key. Cet élément peut prendre de nombreux
attributs mais également des sous-éléments. Ces attributs ou sous-éléments sont parfois communs à
l'ensemble des critères, soit spécifiques à un type de critère.
Nous allons dans un premier explorer les principales caractéristiques communes à tous les types de critères.
La structure générale de l'élément key est la suivante :
<key
id=""
type=""
field=""
fieldh=""
connector=""
format=""
max-chars=""
terms-browse=""
help=""
>
...
</key>
Les attributs et leur définition sont :
id
'''Optionnel'''. L'identifiant unique du critère qui va permettre de pouvoir distinguer le critère d'un autre
dans la mise en forme par feuille de style CSS.
type
'''Obligatoire'''. Le type de critère ; ce qui va déterminer comment il sera affiché (zone de saisie, liste,
etc.) et aussi quels sont les autres attributs qui pourront lui être associés. Les valeurs possibles sont :
cdc, text, suggest, list, hidden, date, boolean.
field
'''Obligatoire''' pour la plupart des types de critères. Le champ dans lequel s'effectue la recherche avec
ce critère. Si l'attribut fieldh est spécifié, l'attribut field indique le champ utilisé lorsqu'un seul
critère de recherche est renseigné par l'utilisateur.
Pour connaître la liste des champs définis par défaut dans Pleade, se reporter au manuel Gestion de
contenu.
fieldh
'''Optionnel''', mais fortement conseillé pour la plupart des types de critères. Le champ dupliqué dans
lequel s'effectue la recherche si au moins deux critères de recherche sont renseignés par l'utilisateur.
connector
'''Optionnel'''. Des informations sur l'opérateur booléen entre ce critère et le précédent dans le formulaire.
La valeur de cet attribut est un nombre :
●
1 : l'opérateur est forcément le ET, il ne sera pas affiché. C'est également le comportement si
l'attribut connector n'est pas renseigné.
●
2 : l'opérateur est forcément le OU, il ne sera pas affiché.
●
3 : l'opérateur peut être le ET ou le OU, et le choix sera laissé à l'utilisateur, par l'affichage
d'une liste déroulante à gauche du critère.
●
4 : l'opérateur est forcément le SAUF, il ne sera pas affiché.
format
'''Optionnel'''. Le format accepté pour le critère, particulièrement utile pour les dates ou les zones de
texte, dans certains cas ; il déclenche la validation par javascript du critère à la soumission du
formulaire. Si l'utilisateur saisit une valeur non permise par le format, le formulaire ne sera pas validé
et un message sera affiché. Le contenu de cet attribut doit être une expression régulière valide en
Javascript.
max-chars
'''Optionnel'''. Dans les listes de valeurs, le nombre maximal de caractères à afficher en largeur, afin
d'éviter des débordements (listes trop longues en largeur). Cette indication peut également être
fournie dans la définition d'un critère de recherche.
Si cet attribut n'est pas renseigné, c'est la valeur de l'attribut défini au niveau de l'élément form qui
s'applique sauf dans le cas des dates, où la valeur est automatiquement fixée à quatre (recherche par
année seulement).
help
'''Optionnel'''. Si sa valeur est true, un bouton d'aide est affiché à droite du critère.
Les critères peuvent prendre d'autres attributs, qui sont expliqués soit dans les explications sur les différents
types de critères dans la section suivante soit dans les fonctions avancées un peu plus loin ( === Fonctions ===
avancées).
=== Types de critères ===
Un formulaire de test reprenant les types de critères courants et des commentaires explicatifs est livré par
défaut. Il peut servir de modèle pour créer ou modifier un formulaire. Ce formulaire de test est visible à
l'URL {{path|/search-forms.html?name=test}}.
==== Critère caché (hidden) ====
Les critères cachés permettent d'ajouter systématiquement un critère de recherche de manière transparente
pour l'utilisateur. On doit utiliser la valeur hidden pour l'attribut type. Il supporte un attribut spécifique :
value
'''Obligatoire''' pour utiliser ce critère. Il s'agit de la valeur que doit avoir le champ indiqué dans l'attribut
field.
<key type="hidden" connector="2" field="unitid" value="2002W" />
==== Cadre de classement (cdc) ====
Ce critère se comporte de manière particulière : il permet d'afficher le cadre de classement à droite du
formulaire, et l'utilisateur pourra choisir une ou plusieurs entrées du cadre de classement à l'aide de cases à
cocher.
Il ne supporte aucun attribut spécifique.
<key type="cdc"/>
Pour un critère de ce type, les attributs field et fieldh ne sont pas utiles, car Pleade utilise toujours les
mêmes champs de recherche. De même, l'attribut help n'a aucun impact.
==== Zone de texte (text) ====
Ce critère se présente sous la forme d'une zone de texte où l'utilisateur peut saisir librement des mots,
expressions, etc. On l'utilise normalement pour des recherches sur des champs de type « mot ».
Pour un tel critère, on peut ajouter des attributs afin de permettre à l'utilisateur de choisir un autre champ de
recherche, un champ « alternatif ». Cela est particulièrement utile pour proposer à l'utilisateur d'étendre la
recherche aux documents associés, comme le fait le formulaire par défaut de la distribution standard de
Pleade.
Quand est un champ alternatif est défini pour un critère, une boîte à cocher est affichée sous le critère
offrant à l'utilisateur un choix.
<key type="text" field="fulltext" fieldh="hfulltext" help="true" alternate-field="extfulltext"
alternate-fieldh="hextfulltext" alternate-field-checked="false"/>
Pour réaliser cela, il faut ajouter les attributs suivants à l'élément key :
alternate-field
'''Obligatoire''' pour utiliser cette fonctionnalité. Le nom du champ à rechercher si l'utilisateur choisit cette
option. Si l'attribut alternate-fieldh est également renseigné, ce champ sera utilisé uniquement
s'il y a un seul critère de recherche.
alternate-fieldh
'''Optionnel''' mais fortement recommandé. Le nom du champ dupliqué alternatif à rechercher si
l'utilisateur renseigne au moins deux critères de recherche.
alternate-field-checked
'''Optionnel''', la valeur par défaut est false. Si la valeur est true, l'option pour le champ alternatif sera
déjà sélectionnée au moment d'afficher le formulaire.
À noter que les champs alternatifs sont supportés uniquement pour les critères de type texte dans
Pleade.
On peut également omettre l'attribut field et plutôt proposer à l'utilisateur de choisir un champ de
recherche parmi une liste.
Pour ce faire, il faut donc ne pas renseigner l'attribut field mais plutôt des sous-éléments field tel que
dans cet exemple :
<key type="text" ...>
<field name="scopecontent"/>
<field name="unittitle" default="true"/>
<field name="fulltext"/>
</key>
Dans cet exemple, trois champs seront proposés à l'utilisateur, avec une liste déroulante située à gauche de
la zone de texte. La seconde valeur sera pré-sélectionnée, grâce à la présence de l'attribut default avec la
valeur true.
À noter que si vous utilisez cette possibilité de laisser à l'utilisateur le choix du champ, l'attribut fieldh n'est
pas utilisé et il n'est actuellement pas possible de faire l'équivalent.
==== Listes (list) ====
Les listes sont destinées à présenter à l'utilisateur une liste de choix. Il peut alors sélectionner une ou
plusieurs valeurs et effectuer une recherche sur ces valeurs. Les listes peuvent être présentées de
différentes façons, et c'est la valeur de l'attribut variant qui va le déterminer :
combo
Une liste déroulante. Dans la liste, l'utilisateur ne peut sélectionner qu'une valeur, mais Pleade offre la
possibilité d'ajouter d'autres valeurs.
fixed
Une liste à hauteur fixe, c'est-à-dire avec un nombre prédéfini de valeurs affichées. On peut
directement sélectionner plusieurs valeurs.
checkbox
Des cases à cocher, donc chaque item de la liste est accompagné d'une case à cocher. On peut
sélectionner plusieurs valeurs.
radio
Des boutons radio, donc chaque item de la liste est accompagné d'un bouton radio. On ne peut
sélectionner qu'une seule valeur.
En général, les valeurs de la liste seront automatiquement renseignées par Pleade à partir des valeurs que
l'on trouve dans le champ indiqué par l'attribut field.
On peut également pour les listes, contrôler l'opérateur intra-champ (voir {{path|4.4}}.{{path|3.2}} Choix de l'opérateur intra-
champ)
==== Suggestions (suggest) ====
Les suggestions sont un cas particulier de liste : toutes les valeurs ne sont pas présentées directement à
l'utilisateur, celui-ci va plutôt saisir quelques lettres et la liste sera filtrée automatiquement avec des entrées
qui contiennent ces lettres, sans tenir compte des accents et des majuscules/minuscules.
Pour avoir un tel critère, il s'agit d'utiliser l'attribut type avec une valeur suggest. Par défaut, l'utilisateur
peut sélectionner plusieurs valeurs, mais si l'on souhaite qu'il ne sélectionne qu'une seule valeur on peut
ajouter un attribut multiple="false".
<key type="suggest" field="fgeogname" help="true" multiple="false"/>
On peut également contrôler l'opérateur intra-champ (voir {{path|4.4}}.{{path|3.2}} Choix de l'opérateur intra-champ).
==== Booléens (boolean) ====
Un critère booléen est un critère qui ne peut prendre que deux valeurs, vrai ou faux. Il se présente sous la
forme d'une boîte à cocher. On utilise généralement ce critère pour filtrer la recherche sur un attribut
particulier : par exemple, les documents illustrés, limiter la recherche aux articles, etc.
Pour un tel critère, on peut ajouter les attributs particuliers suivants :
value-on
'''Obligatoire''' pour utiliser ce critère. Il s'agit de la valeur que doit avoir le champ indiqué dans l'attribut
field.
default
Si la valeur de cet attribut est on, la case sera cochée par défaut.
<key type="boolean" field="fgeogname" value-on="Afrique" default="on" connector="3" />
==== Dates (date) ====
La recherche par dates est traitée de manière particulière dans Pleade et fait l'objet d'un type de critère bien
particulier. Il n'est pas nécessaire de préciser le champ de recherche car Pleade va toujours utiliser les
mêmes champs associés aux dates extrêmes (bdate et edate). De plus, il n'est pas nécessaire d'utiliser le
mécanisme des champs dupliqués et de l'attribut fieldh car les dates sont déjà héritées par défaut dans
Pleade.
Donc pour effectuer une recherche par dates, on doit utiliser une syntaxe telle que celle-ci :
<key
type="date"
id="annee"
variant="exact interval"
max-chars="4"
format="(\d)+"
help="true"
/>
Les attributs type, format, max-chars et help ont déjà été évoqués, les autres attributs sont :
id
'''Obligatoire'''. L'identifiant du critère, utilisé pour le lier avec les clés i18n pour la génération des textes.
variant
'''Obligatoire'''. Des précisions sur les zones de texte à saisir. Si cet attribut contient exact, une
recherche d'une date exacte sera proposée. Si cet attribut contient interval, une recherche par
intervalle sera proposée. On peut bien sûr obtenir les deux en indiquant les deux mots, séparés par
une espace comme dans l'exemple ci-dessus.
=== Fonctions avancées ===
==== Troncature implicite ====
Une troncature permet de faire une recherche sur une partie d'un mot. Par exemple, une troncature à droite
sur le mot "bois" s'écrit "bois*". La recherche s'effectue alors sur tous les mots commençant par "bois".
Une troncature implicite peut être ajoutée aux éléments de formulaire de type text. Pour ajouter la
troncature automatiquement à la validation du formulaire, il suffit d'ajouter l'attribut truncate.
truncate
Permet de déterminer où sera ajoutée la troncature implicite. Cet attribut peut prendre les valeurs
left, right ou both :
<key type="text" field="fulltext" truncate="left"/>
<key type="text" field="fulltext" truncate="right"/>
<key type="text" field="fulltext" truncate="both"/>
{{path|4.4}}.{{path|3.2}} Choix de l'opérateur intra-champ
Par défaut, l'opérateur intra-champ pour tous les éléments de formulaire qui ne sont pas de type list ou
suggest, est l'opérateur AND. Pour les éléments de type list et suggest, l'opérateur intra-champ par
défaut est l'opérateur OR.
Il est possible de changer ces valeurs par défaut au moyen de l'attribut op dans les éléments key.
op
Cet attribut peut prendre les valeurs AND ou OR. Il permet de définir l'opérateur intra-champs.
op-display
Permet de gérer l'affichage de ces opérateurs dans l'interface. Il peut prendre les valeurs true ou
false. Dans le cas des éléments de formulaire de type list avec les attributs variant="fixed"
et selection="multiple", ainsi que pour les éléments de type suggest multiples, les opérateurs
s'afficheront lorsqu'il y a plus de deux sélections.
Exemple :
<key type="suggest" field="fgeogname" style="background:#00CCFF" help="true" op-display="true"/>
<key type="suggest" field="fgeogname" style="background:coral" op-display="true" op="AND"/>
<key type="list" variant="combo" rows="5"
selection="multiple" op-display="true"
display-field="fatitle" field="root-id">
<no-choice i18n-key="form-no-choice-choix"/>
</key>
==== Accès au index ====
Pour chaque critère, il est possible d'ajouter un bouton permettant de parcourir dans un panneau, la liste des
termes indexés, associés au champ de la suggestion.
Pour cela, il suffit d'ajouter :
terms-browse
'''Optionnel'''. Permet d'activer l'aide à la recherche de type "navigation d'index" ; c'est-à-dire une icône
placée à droite du critère qui déclenche l'affichage d'un panneau listant tous les termes indexés dans
un champ de recherche. Cet attribut peut avoir plusieurs valeurs :
* true ou 1 : cette aide est activée et l'index consulté est celui indiqué comme valeur de l'attribut
field
* vide ou false ou 0 : cette aide n'est pas activée. Même chose si cet attribut est absent.
* contient le nom d'un champ autre que celui indiqué comme valeur de l'attribut field : cette aide est
activée et l'index consulté est celui indiqué comme valeur d'attribut.
terms-browse-hpp
'''Optionnel'''. Cet attribut permet de préciser le nombre d'entrées par page proposées dans la fenêtre de
consultation de l'index.
==== Accès à un thesaurus ====
Cette partie ne concerne que les applications Pleade disposant du module Thesaurus.
Pour chaque critère dont le champ de recherche est lié à un vocabulaire contrôlé, il est possible d'ajouter un
bouton permettant de consulter ce vocabulaire s'il est géré par ThesX.
Pour cela, il suffit d'ajouter :
thesx-browse
'''Optionnel'''. Permet d'activer l'aide à la recherche de type « consultation de thesaurus » dans un
panneau ; c'est-à-dire une icône placée à droite du critère qui déclenche l'affichage d'un panneau
permettant de naviguer dans le thesaurus. Cet attribut peut avoir plusieurs valeurs :
* true ou 1 : cette aide est activée et le thesaurus consulté est celui dont l'identifiant correspond à
celui indiqué comme valeur de l'attribut thesx-id
* vide ou false ou 0 : cette aide n'est pas activée. Même chose si cet attribut est absent.
thesx-id
'''Optionnel''' mais obligatoire si l'attribut thesx-browse active l'aide. Il s'agit de l'identifiant du thesaurus
géré par ThesX que l'on veut consulter.
thesx-relations
'''Optionnel'''. Cet attribut permet de préciser selon quel type de relations on veut étendre la recherche.
Par défaut la recherche est étendue au terme sélectionné et à tous ses spécifiques (relation TS).
==== Filtre ====
Il est possible à l'aide d'un critère ou plusieurs critères cachés de limiter la recherche à l'aide d'un formulaire
de recherche à une rubrique (voir section suivante 5) Rubriques), à une liste d'instruments de recherche, à
une valeur particulière pour un champ. Dans ce cas, si jamais le formulaire de recherche propose des listes
ou des aides à la recherche comme un accès aux index, il faut que ces listes soient elles-aussi filtrées par
les mêmes critères.
Attention : Pour le moment, les filtres ne fonctionnent pas avec les critères de type Suggestions.
L'usage des filtres peut remplacer les rubriques.
Pour filtrer un critère de recherche, on doit utiliser une syntaxe telle que :
<key type="list" ...>
<filters>
<filter field=""
value=""/>
</filters>
</key>
L'élément filters permet de définir un ensemble de filtre. Il contient des éléments filter : chaque filtre
est exprimé par un élément filter. Cet élément peut prendre deux attributs :
field
'''Obligatoire'''. Le champ qui permet de filtrer le critère.
Pour connaître la liste des champs définis par défaut dans Pleade, se reporter au manuel Gestion de
contenu.
value
'''Obligatoire'''. La valeur que doit avoir le champ pour le filtre.
Voilà l'exemple d'un filtre sur un type de documents :
<filters>
<filter field="fgenreform" value="dessins"/>
</filters>
==== Listes dépendantes ====
Une liste peut dépendre d'une autre c'est-à-dire que son contenu peut changer en fonction de la valeur
sélectionnée dans l'autre liste. Par exemple, dans un formulaire pour des documents d'état civil, on pourrait
vouloir que la liste des types de registres se mette à jour en fonction de la commune sélectionnée.
Pour obtenir ce fonctionnement, il faut utiliser l'attribut :
updateSelect
Placé au niveau du critère de type liste source (celle dont la sélection d'une entrée va mettre à jour la
liste cible ou liste dépendante), sa valeur doit être le nom du champ (attribut field) de la liste cible
(celle dont le contenu va changer).Dans notre exemple de formulaire d'état civil, sa valeur serait le
nom du champ correspondant aux types de registres.
De plus, au chargement du formulaire, deux comportements sont possibles :
* le critère cible est rempli normalement, dans ce cas en général une indication invite l'utilisateur à
choisir une entrée
* le critère cible est vide et ne contient qu'une indication invitant l'utilisateur à choisir une entrée dans
la liste source.
<key type="list" field="insee" updateSelect="type" variant="combo" [...]>
{champ source}
</key>
<key type="list" field="type" variant="combo" [...]>
{champ cible)
Solution 1 : au chargement de la page, le critère est "rempli" normalement,
son premier item invite l'utilisateur à sélectionner une valeur.
<no-choice i18n-key="form-no-choice-choix"/>
Solution 2 : au chargement de la page, le critère est vide et ne contient
qu'une unique valeur : un message invitant l'utilisateur à
sélectionner une valeur dans le champ source.
<items>
<item value="" i18n-key="form-no-choice-since-insee-choix" />
</items>
</key>
==== Styles ====
Dans chaque élément key il est possible de définir un attribut style dont la valeur doit être valide par
rapport au contenu du même attribut dans la norme XHTML, soit des règles CSS.
style
Permet de surcharger le style CSS de l'élément de formulaire.
<key type="text" style="width:10em;" field="fulltext"/>

Pleade Formulaire de Recherche - Historique des versions

Groche : a déplacé Doc/Formulaire de Recherche vers Pleade Formulaire de Recherche

Groche : /* Activation conditionnelle */

Groche : /* Activation conditionnelle */

Groche : /* Activation conditionnelle */

Groche : /* Styles */ [edit] Activation conditionnelle

Groche : mise en forme+catégorie

Groche : création

Groche : a déplacé Doc/Formulaire de Recherche vers Pleade Formulaire de Recherche

Groche : /* Activation conditionnelle */

Groche : /* Activation conditionnelle */

Groche : /* Activation conditionnelle */

Groche : /* Styles */ [edit] Activation conditionnelle

Groche : mise en forme+catégorie

Groche : création