Page-test-conversion-1

[[Image:]] Documentation Pleade3 Exercices de configuration Ce manuel rédigé par la société AJLSM est destiné à ses clientset partenaires et ne doit pas être distribué à des tiers 20 et 21 février 2013

Mode d'affichage multiple des résultats de recherche

Résumé

En plus du format cadre de classement, il est maintenant possible d'afficher les résultats de recherche en mosaïque et tabulaire.

De plus dans la page qui affiche les résultats de recherche, il est possible de « switcher » entre les différents mode d’affichages.

Pour chaque format, on peut choisir l'affichage ou non des résultats de recherche qui ne sont pas illustrés par un média numérique (image, son, ...).

On peut aussi définir un comportement différent selon chaque formulaire de recherche.

Paramétrage

Le paramétrage se fait à deux niveaux, d'abord, dans le fichier parametres.xconf ===

Attribut(s)	Défaut	Valeurs possible	Description
default	all-components	-	-

où, on définit le comportement global pour tous les résultats de recherche. Ensuite, dans chaque formulaire de recherche (fichiers xconf), on peut définir le comportement spécifique du formulaire concerné.

Chaque mode d'affichage est défini par un code. Durant le paramétrage, ce sont ces codes qui seront utilisés pour indiquer un mode.

- cdc: pour le mode cadre de classement (mode par défaut).

- mosaic: pour le mode mosaïc

- tab: pour le format tabulaire

• Paramétrage dans le fichier parametres.xconf

- ead-default-print-result-mode : C'est le mode d'affichage par défaut, cela signifie qu'en cas de problème ou d'incompatibilité, c'est ce mode d'affichage qui sera utilisé. Après avoir validé le formulaire de recherche, c'est le mode défini par ce paramètre qui est affiché en premier.

Exemple: <ead-default-print-result-mode>cdc</ead-default-print-result-mode>

Si ce paramètre est vide, c'est le format cdc qui est utilisé.

- ead-print-result-mode-activated: indique la liste des modes qui sont actifs. Les éléments sont séparés par un point-virgule. L'ordre donné dans la liste sera utilisé pour l'affichage de la case permettant le choix entre les modes d'affichage.

Exemple: <ead-print-result-mode-activated>mosaic;cdc;tab</ead-print-result-mode-activated>

Si ce paramètre ne définit qu'un mode alors, dans la page d'affichage des résultats de recherche, la case de sélection des modes ne sera pas affichée.

Exemple :<ead-print-result-mode-activated>mosaic</ead-print-result-mode-activated>

- ead-cdc-show-not-illustrated: donne la possibilité d'afficher ou non les résultats de recherche qui ne sont pas illustrés par un média numérique pour le mode cdc.

Exemple: <ead-cdc-show-not-illustrated>true</ead-cdc-show-not-illustrated> signifie que les résultats non illustrés seront affichés.

- ead-mosaic-show-not-illustrated: donne la possibilité d'afficher ou non les résultats de recherche qui ne sont pas illustrés par un média numérique pour le mode mosaïque.

Exemple: <ead-mosaic-show-not-illustrated>true</ead-mosaic-show-not-illustrated>

- ead-tab-show-not-illustrated: donne la possibilité d'afficher ou non les résultats de recherche qui ne sont pas illustrés par un média numérique pour le mode tabulaire.

Exemple: <ead-tab-show-not-illustrated>true</ead-tab-show-not-illustrated>

• Paramétrage dans les fichiers des formulaires de recherches

Les paramètres qui seront définis dans les fichiers xconf ne vont concerner que leur formulaire de recherche respectifs. Ils seront prioritaires par rapport ceux du fichiers parametres.xconf.

- display-modes: c'est un attribut de la balise form qui indique les formats d'affichage qui sont actifs. Il se comporte de la même façon que "ead-print-result-mode-activated".

Si ce paramètre est présent mais vide, c'est équivalent à écrire display-mode="cdc" ; C’est-à-dire que seul le mode cdc sera actif.

- only-illustrated: c'est un attribut de la balise form qui donne la possibilité d'afficher ou non les résultats non illustrés. Ce paramètre à un comportement global pour tous les modes actifs. C'est-à-dire que sa valeur sera utilisée par tous les formats d'affichage qui ont été définis pour le formulaire de recherche concerné. Si only-illsutrated=true, seule les résultats illustrés seront affichés.

Exemple: <form action="results.html" max-chars="50" documents="ead" display-modes="cdc;mosaic" only-illustrated="true"> ... </form>

En plus des deux paramètres définis plus haut, pour un formulaire de recherche, on peut forcer le mode d'affichage qui sera servi en premier lorsque l'utilisateur valide le formulaire de recherche. Ce paramétrage se fait dans l'attribut action de la balise form. Pour avoir le format souhaité, la valeur se trouvant dans l'attribut action doit être précéder du code du format souhaité plus un tiret.

Exemple: <form action="mosaic-results.html" max-chars="50" documents="ead" display-modes="cdc;mosaic" only-illustrated="true"> ... </form>

Les paramètres suivants permettent la gestion de l'affichage du contexte d'un résultat de recherche pour les formats mosaïque et tab

- <ead-mosaic-show-result-context> et <ead-mosaic-show-result-context> active l'affichage du context s'ils ont la "true"

- lorsque le contexte est actif, <ead-mosaic-show-result-context-link> et <ead-tab-show-result-context-link> ajoute un lien vers le fragment EAD pour chaque élément du contexte.

Actuellement, chaque élément du contexte est séparé du suivant par le caractère " <  ". Ce séparateur est une clef i18n , il est situé dans le fichier module-eadeac.xml. Son identifiant est "mosaic.results.item.context.sep"

Les liens extptr

La balise extptr permet l'insertion d'une image simple dans la fenêtre EAD. Elle s'utilise par exemple comme suit:

<p>Un lien vers une image fait avec un extptr: <extptr href="docs/images.jpeg" linktype="simple" title="une image avec un exttr" />. Le document ...</p>La valeur de l'attribut href sera résolue en fonction du paramètre "pleade.eadeac.fs-files" (pleade-admin.properties). Le lien vers l'image est résolu relativement à l'emplacement du chemin indiqué (on n'aura pas besoin d'utiliser le protocole "file" lorsque l'on indique le chemin). Si ce paramètre est vide, l'image sera résolue relativement à l'emplacement du document EAD.

• • • • NB1 : Bien possitionner ces images dans le répertoire utilisé pour mettre les données de type multimédia
        NB2 : L'alignement par défaut se positionne comme un caractère donc faire attention au format de l'image.

<!--EndFragment-->

Lien vers ressources externes

Lien vers un document EAD

On peut lier vers

<extref href="frajlsm-pleade-test-02-fr.xml">un autre document</extref> et même vers une <extref href="frajlsm-pleade-test-02-fr.xml#unecible">unité de description précise</extref> d'un autre document.

Lien vers d'autres unités de description du même instrument de recherche

Il peut être intéressant de faire des liens vers

<ref target="essai01">une unité essai01</ref>, voire <ref target="essai03">une autre essai03</ref>.</p>

Liens vers des ressources distantes

On peut insérer un lien vers un site tel que <extref href="http://www.google.fr">Google</extref> dans le document EAD. Ce lien est affiché comme un lien hypertexte normal, un clic ouvre une nouvelle fenêtre sur la page liée.

Le lien peut également être vers un

<>document PDF</extref>

<extref href="http://www.archivesdefrance.culture.gouv.fr/static/1066">

hébergé ailleurs. Dans ce cas, un clic sur le lien ouvre le document, mais le contenu de celui-ci ne sera jamais indexé par Pleade et il ne sera pas non plus considéré comme un document attaché.

Liens vers d'autres parties du même document

Il est possible de faire un lien vers une autre partie du même document EAD.

C'est le cas avec ce lien qui pointe sur l'unité de description qui concerne les

<ref target="archives-numeriques">archives numériques</ref>.

On peut être plus précis et pointer sur un élément spécifique à l'intérieur d'une unité de description, comme ici avec la

<ref target="liens-sc">description de contenu de l'unité sur les liens hypertexte</ref>.

Liens vers d'autres documents EAD

On peut également faire des liens vers d'autres instruments de recherche en format EAD. Voici un lien vers le <archref href="frajlsm-pleade-test-02-fr.xml">second instrument de recherche de test</archref>.

Voici un lien vers <archref href="frajlsm-pleade-test-01-fr.xml">ce même instrument de recherche</archref>, pour être certain que l'on puisse voir le comportement. A noter que l'on peut aussi pointer sur <archref href="frajlsm-pleade-test-01-fr.xml#de-7">une partie</archref> d'un instrument de recherche.

Liens vers des ressources locales

Ces liens utilisent des adresses relatives, adresse qui est résolue par rapport à la localisation du document EAD au moment de la publication.

On peut ainsi lier vers un <extref href="docs/test.pdf">document PDF</extref>, un fichier sonore <extref href="docs/test.wma">en format WMA</extref> ou en <extref href="docs/test.mp3">format MP3</extref>

un fichier <extref href="docs/test.wmv">vidéo</extref>, une <extref href="docs/test.jpg">image</extref>

Paramètres de publication

Important : les paramètres de publication proposés par défaut sont pour la plupart du temps adéquats pour répondre à vos besoins. Dans ce cas, vous n'avez pas besoin de vous soucier de ces paramètres.

Les paramètres de publication sont associés au document EAD lors de sa publication. Ils conditionnent la manière dont il est indexé par le moteur de recherche. Lorsqu'on souhaite modifier ces paramètres, il est nécessaire de republier le document.

Dates de communicabilité

Ce paramètre permet de fixer l'année de communicabilité la plus extrême. Le traitement se fait à la publication. On peut définir des paramètres génériques dans le fichier module-eadeac/conf/ead-documents-property-sets.xconf. Lors de la publication, on peut changer le comportement dans l'onglet paramètres de publication. Les liens vers les média numériques sont alors supprimés à la publication.

Exemple : Si la date de communicabilité maximale est fixée à 1911, il n'y aura pas de communication pour les images de 1912 et au-delà.

<property name="min-years-access" default="1911"/>

La date de communicabilité supporte des exceptions. Ces exceptions sont renseignées par une balise et sa valeur. Si cet élément est présent, il ajoute une condition et annule la date de communicabilté fixée ci-dessus. Il est possible de rajouter des conditions en mettant un ; entre chaque condition qui correspond à un "et" .

Exemple : exception qui permet la communicabilité des registres matricules  car les tables sont communicables jusqu'à aujourd'hui.

<property name="all-years-access-tag" default="genreform:table"/>

Gestion des groupes d'utilisateurs et des utilisateurs

Fonctionnalité permettant d'associer un IR à des utilisateurs ou à des groupes d'utilisateurs; c'est-à-dire que l'Instrument de Recherche ne sera visible en recherche et en affichage qu'aux utilisateurs associés.

L'association se fait à la publication dans l'onglet paramètres de publication. La liste des utilisateurs et des groupes est récupérée automatiquement dans le fichier pleade-users.xonf (ou un annuaire LDAP).

• Paramètres dans ead-documents-property-sets.xconf

Dans ce fichier on définit les paramètres de publication par défaut:

- ir2group-list : permet la définition du groupe par défaut

- ir2user-list : permet la définition de l'utilisateur par défaut

On peut définir plusieurs utilisateurs ou groupes en les séparant par le caractére ";" (point virgule).

• Paramètres dans parameters.xonf

- acces-all-users définit la liste des utilisateurs qui ont accès à tous les IRs

- acces-all-groups définit la liste des groupes qui ont accès à tous les IRs

NB: l'utilisateur "all" et le groupe "all" désignent respectivement tous les utilisateurs et tous les groupes. "all" est défini par le système, il ne doit pas être utilisé dans le fichier pleade-users.sconf

Lors de la publication, on peut sélectionner plusieurs utilisateurs ou groupes en maintenant la touche ctrl enfoncée.

Exemple :

<property name="ir2group-list" default="all"/>

<property name="ir2user-list" default="all"/>

Fragmentation [frag-method]

Ce paramètre permet de préciser la méthode utilisée pour fragmenter le document EAD en unités de recherche et d'affichage. Par défaut, Pleade considère que toutes les unités de description du document sont fragmentées, c'est-à-dire qu'elles peuvent faire partie des résultats de recherche et qu'elles sont affichées dans leur propre page. Il s'agit de la méthode « Tous les composants » [all-components]. On peut toutefois modifier ce comportement.

Pour sélectionner une méthode différente, il s'agit de la choisir dans la liste et éventuellement ajouter des précisions complémentaires dans la zone de texte complément [frag-method-info]. Les méthodes disponibles sont :

• Pas de fragmentation [_none] : il y aura une seule unité de recherche et d'affichage pour tout le document.
• Nom de l'élément [element-name] : vous devez fournir une liste de noms d'éléments de la DTD EAD (parmi archdesc, c, c01, c02, …) et seules les unités décrites à l'aide de ces éléments seront fragmentées. Les éléments doivent être séparés par un espace. Exemple : archdesc c
• Niveau hiérarchique [h-level] : les unités fragmentées peuvent être sélectionnées en fonction de leur niveau hiérarchique dans l'arborescence du document EAD. Vous devez alors préciser tous les niveaux hiérarchiques qui doivent déclencher une fragmentation, en les séparant par un espace. Par exemple, vous pouvez indiquer 1h 2h 3h pour indiquer une fragmentation sur les trois premiers niveaux en comptant par le haut (début) du document, ou encore 1b 2b pour indiquer les deux derniers niveaux, ou les deux premiers en comptant par le bas de l'arborescence.
• Niveau archivistique [a-level] : vous pouvez préciser quelles unités fragmenter en fonction de leur niveau archivistique, c'est-à-dire la valeur de leur attribut level ou otherlevel. Vous pouvez préciser plusieurs valeurs, en les séparant par un espace. Exemple : series item file
• Présence de l'attribut level [with-level] : en choisissant cette méthode, seules les unités qui ont un attribut level seront fragmentées.
• Absence de l'attribut level [without-level] : en choisissant cette méthode, seules les unités qui n'ont pas d'attribut level seront fragmentées.
  

Table des matières [toc-method]

Pleade propose une navigation par table des matières ou sommaire du document EAD. Ce paramètre permet de déterminer quelles unités de description feront partie de cette table des matières.

Les méthodes pour sélectionner ces unités sont les mêmes que pour la fragmentation ci-dessus, avec aussi la possibilité de fournir une information complémentaire dans la zone de texte intitulée complément [toc-method-info], avec en plus :

• Identique à la fragmentation [_same] : toutes les unités fragmentées feront partie de la table des matières.

Héritage des champs

Pour certains champs, Pleade applique une méthode d'héritage des informations. Ainsi, pour une unité de description, les informations que l'on trouve dans les unités ancêtres (au-dessus) seront rapatriées et pourront ainsi être exploitées en recherche. Cet héritage peut être systématique ou encore conditionnel à la présence de l'information dans l'unité concernée.

Pour ce paramètre, on va donc distinguer les champs hérités systématiquement (« Toujours ») [inheritance-always] ou uniquement lorsque l'information est absente (« Si absent ») [inheritance-always]. Dans les deux cas, on peut sélectionner des champs en saisissant dans la zone de texte la ou les premières lettres du nom du champ ; une liste de suggestions est alors proposée, et vous pouvez choisir l'index souhaité. Il sera alors ajouté sous la liste, et vous pouvez supprimer un index sélectionné en cliquant sur le bouton « X » devant cet index.

Héritage des index [inheritance-index]

De même que les champs, les index peuvent bénéficier du mécanisme d'héritage des informations mais cette possibilité peut être restreinte à la recherche [global] et / ou la navigation [local]. Ce paramétrage s'applique à tous les index sans distinction.

Par défaut dans Pleade, aucun héritage ne s'applique aux index.

Séries d'images [dao-implicit-series]

Ce paramètre concerne le serveur d'images du module Pleade Image. Si le bouton radio Oui est coché [true], cela signifie que l'on force le serveur d'images à servir les images. Dans ce cas, tous les dao et daoloc sont considérés comme des séries d'images. Si le lien désigne une image particulière celle-ci sera utilisée pour construire la vignette illustrant la série dans la fenêtre de consultation du document EAD.

Par défaut dans Pleade, le bouton radio Non est coché [false] : les documents numériques ne sont donc pas considérés comme des séries d'images, ce qui n'empêche pas leur consultation dans la visionneuse.

Il est aussi possible de définir des séries d'images directement dans le document EAD en définissant des attributs particuliers. Ceux-ci sont listés dans un tableau en annexe (voir 5[#1.6.Séries d'images|outline . Séries d'images]).

Rubriques [subset-list]

Ce paramètre permet d'associer une rubrique à un document EAD ; il suffit de la sélectionner dans la liste déroulante. En effet, Pleade permet d'organiser les documents dans une arborescence de rubriques et sous-rubriques afin de faciliter leur exploration.

Publiez les documents EAD mis à disposition sur le serveur en respectant les paramètres suivants :

État civil : FRAD027_8MI2E_court.xml

Année communicabilité : 1911

Héritage des champs : fgeogname flieuacte fgenreform facte

Registres matricules : FRAD027_404142R_court.xml

Année communicabilité : 1911 et Exception : genreform:table

Héritage des champs : fbureau

Recensements de population : FRAD027_RP_court.xml

Année communicabilité : 1911

Héritage des champs : "vide"

Cartes postales : FRAD027_0000000CP_court.xml

Année communicabilité : "vide"

Héritage des champs : frcommune ftheme fsoustheme

Etat des fonds : FRAD027_0000guide_9_court.xml

Année communicabilité : "vide"

Héritage des champs : "vide"

Plans cadastraux : FRAD027_PC_court.xml

Année communicabilité : vide

Héritage des champs : frcommune fanciennecommune allcommunes (à tester uniquement avec allcommunes qui devrait suffire)

Index

Déclaration

Un index est déclaré par l'ajout d'un élément index à l'intérieur de l'élément racine du fichier de configuration, et en attribuant un identifiant unique à cet index.

À noter que Pleade considère uniquement certains éléments EAD comme pouvant faire partie d'un index : unitid, publisher, corpname, famname, geogname, name, occupation, persname, subject, genreform, function, title.

Par exemple :

<index-list>

<index id="test" ...>

<content element="" role="" source="" type="" ancestor=""/>

</index>

...

</index-list>

Création d'index à partir des attributs source et role:

Nous allons maintenant créer un index "commune" pour tous les éléments dont l'attribut source a la valeur "liste-commune", puis l'index "anciennescommune" pour tous les éléments dont l'attribut role a la valeur "ancienne-commune", puis l'index "bureau" pour tous les éléments dont l'attribut role a la valeur "bureau" et enfin l'index "rcommune" tous les éléments dont l'attribut role "commune"

Dans la section Recherche et publication, onglet Index, récupérez le fichier ead-index.xconf et en suivant le modèle ci dessous, créez les index demandés:

Exemple :

<index id="nomindex" local-sdxfield="lfnomindex" global-sdxfield="fnomindex" wordsdxfield="nomindex">
<content element="" role=""/>
    </index>

Création d'index à partir des attributs source suivants :

A partir de l'attribut source, nous allons créer les index suivants :

Création de l'index "typedocac" à partir de l'élément genreform ayant pour source "type-doc-AC", puis création de l'index "listeacte" à partir de l'élément genreform ayant pour source "liste-acte", puis de l'index "typedoccadastre" à partir de l'élément genreform ayant pour source "type-doc-cadastre", puis de l'index "passportpersname" à partir de l'élément persname ayant pour source "liste-noms-passeports".

Création d'un index typir de type typir

Nous allons créer l'index typir à partir de tous les éléments dont le type est typir qui correspond à un type d'instrument de recherche pour préciser si l'on veut chercher dans un IR d'orientation ou un IR détaillé.

Le nouvel index créé peut être consulté à l'adresse :

    /pleade/navindex.html?field=fparoisses
    /pleade/navindex.html?field=fgeogcommune

Champs

Création de champs combinés

Nous allons créer un nouveau champ appelé extfulltext, combinant les valeurs des champs ext et fulltexte, puis nous créerons un champ appelé analysetitre combinant les valeurs des champs contenus dans scopecontent et unittittle. Ensuite, créer un champ appelé allcommunes, combinant les valeurs des champs frcommune et fbureau, lieuacte, fanciennescommune puis le champ appelé allnames en combinant les valeurs des champs : fpersname,ffamname. Puis créer Enfin, nous allons créer un champ allsujets, à partir des champs : ftheme, fsoustheme, fsubject.

Pour cela, dans la section Recherche et publication, onglet Champs combinés, récupérez le fichier ead-aggregated-fields.xconf et ajoutez-y l'élément aggregated-field suivant :

<aggregated-field name="..." type="...">

<field name="..."/>

<field name="..."/>

</aggregated-field>

Mettez le fichier de configuration à jour en utilisant le cadre Envoyer un nouveau fichier.

Pour que les changements soient pris en compte il est nécessaire de redémarrer l'application, dans l'onglet Redémarrer l'application.

Le nouvel index créé peut être consulté à l'adresse :

    /pleade/navindex.html?field=nomdelindexagrege

Création de champs dupliqués pour la recherche multi-critères

En suivant le modèle ci-dessous créez les champs dupliqués pour le champ fulltexte, extfulltexte, fpersname, fgeogname, allsujets, allcommunes, allnames.

Pour cela, dans la section Recherche et publication, onglet Champs dupliqués, récupérez le fichier ead-duplicated-fields.xconf et ajoutez les champs dupliqués comme demandé :

<duplicated-fields>
    <duplicated-field original="fulltext" duplicate="hfulltext"/>

</duplicated-fields>

Mettez le fichier de configuration à jour en utilisant le cadre Envoyer un nouveau fichier.

Pour que les changements soient pris en compte il est nécessaire de redémarrer l'application, dans l'onglet Redémarrer l'application.

Concevoir ou modifier un formulaire de recherche :

Concevoir le formulaire de recherche Etat Civil

En suivant le modèle ci-dessous, concevez un formulaire de recherche dédié à l'Etat Civil et filtré sur la valeur FRAD027_8MI2E pour le champ root-id. Notez, comme dans l'exemple, que chaque liste de suggestion doit elle aussi être filtrée sur la même valeur.

<key type="hidden" connector="1" field="root-id" value="FRAD027_8MI2E"/> <key type="suggest" field="fgeogname" help="true" terms-browse="true" multiple="false"> <activates id="fgeogname" connector="or"> <activateDate>annee</activateDate> <activateList>fgenreform</activateList> <activateList>facte</activateList> </activates> <filters> <filter field="root-id" value="FRAD027_8MI2E"/> </filters> </key>

Critères de recherche conditionnels :

activates id= des critères conditionnels ne sont accessibles que lorsque l'un des critères de recherche obligatoire est renseigné. Il se construit de la manière suivante :

Sont conditionnels le champs date, le champs type d'acte et le champs type de document. Pour chaque champ obligatoire il faut donc rajouter la condition d'activation des champs date, type d'acte et type de document

Pour la balise activate il faut rajouter un id, ici on va activer les champs fgenreform, annee, facte.

Les champs activés sont typés. Et à l'intérieur de la balise, on renseigne la valeur du field du champ conditionnel concerné.

- activateField : pour les champs de types suggest et fulltext - activateList : pour les champs liste - activateDate : pour les champs de type date (année + écart) - activateDateField : pour les champs field de type date.

Connector = "or" permet la recherche croisée

critère	Description	Apparence et commentaires
Commune	Interroge le contenu de<fgeogname>	Liste de suggestion avec un accès aux index et à la bulle d'aide
Ancienne Commune, Paroisse, Hôpital	Interroge le contenu de<flieuacte>	Liste de suggestion avec un accès aux index et à la bulle d'aide
Date	Interroge le critère de type <date>	Année ou intervalle d'année et accès à la bulle d'aide.
Type de document	Interroge le contenu de <fgenreform>	Liste déroulante avec un accès à la bulle d'aide.
Type d'acte	Interroge le contenu de <facte>	Liste déroulante avec un accès à la bulle d'aide. Clé i18n pour la barre de sélection représentée sous forme de tirets.

Ce nouveau formulaire sera accessible à l'adresse : /pleade/search-form.html?name=etat-civil

Concevoir le formulaire de recherche Etat des fonds

En suivant le modèle ci-dessous, concevez un formulaire de recherche dédié à l'Etat Civil et filtré sur la valeur FRAD027_0000guide_9 pour le champ root-id. Notez, comme dans l'exemple, que chaque liste de suggestion doit elle aussi être filtrée sur la même valeur.

<key type="hidden" connector="1" field="root-id" value="FRAD027_0000guide_9"/>

<key type="text" field="fulltext" fieldh="hfulltext" help="true" />

<!-- <key type="text" field="fulltext" fieldh="hfulltext" help="true" alternate-field="extfulltext" alternate-fieldh="hextfulltext" alternate-field-checked="true"/> -->

<key type="suggest" field="fpersname" help="true" terms-browse="true">

<filters>

<filter field="root-id" value="FRAD027_0000guide_9"/>

</filters>

</key>

critère	Description	Apparence et commentaires
Texte libre	Champ fulltexte	Zone de texte, saisie libre et accès à la bulle d'aide
Personne	Interroge le contenu de<cfpersname>	Liste de suggestion avec un accès aux index et à la bulle d'aide
Commune	Interroge le contenu de <fgeogname>	Liste de suggestion avec un accès aux index et à la bulle d'aide
Contexte historique	Interroge le contenu de <fcontexte>	Liste déroulante avec un accès à la bulle d'aide. Clé i18n pour la barre de sélection représentée sous forme de tirets.
Date	Interroge le critère de type <date>	Année ou intervalle d'année et accès à la bulle d'aide.

Ce nouveau formulaire sera accessible à l'adresse :

    /pleade/search-form.html?name=etat-des-fonds

Concevoir le formulaire de recherche pour les cartes postales

En suivant le modèle ci-dessous, concevez un formulaire de recherche dédié aux cartes postales et filtré sur la valeur FRAD027_0000guide_9 pour le champ root-id.

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 le formulaire de recherche des cartes postales, on souhaite que les listes de thèmes et de sous-thèmes se mettent à 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.

<key type="list" field="frcommune" variant="combo">

<no-choice i18n-key="form-choice-choix-commune"/>

<updates>

<updateSelect>ftheme</updateSelect>

<updateSelect>fsoustheme</updateSelect>

</updates>

</key>

critère	Description	Apparence et commentaires
Commune	Interroge le contenu de<frcommune>	Liste déroulante. Clé i18n pour la barre de sélection ravec le message "Choisissez une commune".
Thème	Interroge le contenu de<ftheme>	Liste déroulante avec un accès à la bulle d'aide. Clé i18n pour la barre de sélection ravec le message "Choisissez un thème".
Sous-thème	Interroge le contenu de<fsoustheme>	Liste déroulante avec un accès à la bulle d'aide. Clé i18n pour la barre de sélection ravec le message "Ou, choisissez un sous-thème".

Ce nouveau formulaire sera accessible à l'adresse :

    /pleade/search-form.html?name=cartes-postales

Pages statiques

Depuis l'interface d'administration, il est possible d'ajouter des pages statiques et de modifier leur contenu facilement.

Exercice : édition de la page d'accueil

Une fois authentifié, accédez à la page d'administration des pages statiques, dans l'onglet Administration, section Pages statiques.

Dans le cadre Gestion des fichiers, sélectionnez le fichier index.html. Ce fichier correspond à la page d'accueil.

Cliquez sur Récupérer le fichier et sauvegarder le fichier index.html.

Éditez ce fichier pour y apporter vos propres modifications. Conservez le lien vers la page de login, car vous en aurez besoin par la suite pour vous connecter. Ensuite, en utilisant le formulaire Remplacer par un nouveau fichier, sélectionnez votre fichier index.html modifié puis valider l'envoi.

Vérifiez que la page d'accueil a été modifiée en rafraichissant la page.

Exercice : créer une nouvelle page statique

Renommez le fichier index.html que vous avez téléchargé et renommez-le pres.html.

Editez son contenu puis ajouter-le aux pages statiques de Pleade en utilisant le formulaire qui permet d'ajouter des fichiers. Ajouter-le dans le dossier par défaut fr. Le contenu de exercice.html est maintenant accessible à l'adresse /pleade/pages/pres.html.

Menus

Accédez à la page d'administration des menus, dans l'onglet Administration, section Menus.

Récupérez le fichier menus.xconf. Ce fichier contient la configuration de l'ensemble des menus de Pleade.

La notion de context dans Pleade est optionnelle. Cette notion renvoit au contexte où cet item est « actif », c'est-à-dire le patron d'URL qui, s'il est respecté par la page en cours d'affichage, rend l'item actif. Le patron est une expression régulière valide selon la norme XSLT.

Le contexte peut aussi être donné par l'attribut href, dans ce cas, il faut indiquer @href comme contexte. Par exemple, si le contexte est edit/.*, cela signifie que l'item sera actif lorsque la page affiché a une URL qui comme par edit/.

Créer une nouvelle entrée de menu horizontale correspondant :

Créez un menu horizontal pour la page statique pres que vous venez de créer :

Pour cela, ajoutez un nouveaux menu horizontal (type=htabs)

Pour ce faire, inspirez-vous de l'onglet créé pour la page d'accueil.

<item id="index" type="link-normal" context="@href" href="pages/index.html" title="pleade:menu.home.title" i18n:attr="title">

<i18n:text key="menu.home.text" catalogue="pleade">accueil</i18n:text>

</item>

Nota Bene : Lorsque l’on renseigne le fichier menu.xconf, écrire tous les libellés en minuscules, afin de ne pas oublier ensuite de remplir le fichier des clés i18n à sauver ensuite dans le répertoire theme/I18n/local.

Clés i18N

Rappel !!

Créer un répertoire local (sous-répertoire de theme/i18n/local/) afin d’y sauver les fichiers qu’on aura précédemment copiés à partir des originaux en gardant le même nom et sur lesquels on ne mettra que les modifications (surcharge). Ce qui permet de ne pas écraser les anciennes versions de fichiers, le nouveau fichier écrasant l’ancien, puisque les deux fichiers ont le même intitulé.

Ensuite, on sauve ces fichiers dans le dossier « local » et on redémarre le serveur pour que les modifications soient prises en compte.

Quand on modifie un catalogue de clé i18n, il faut recharger la page (touche F5) puis redémarrer le serveur.

Pour faire une recherche de clé i18n (pour ne pas créer une clé qui existe déjà) faire une recherche Directory dans JEdit. Par exemple, pour chercher form.field  qui est le début de ma clé i18n, Hypersearch dans JEdit.

form.field.fsubject = c’est le sujet

form.field.unitid = c’est la côte

Ensuite, copier la totalité de la clé et la copier dans l’élément message dont l’attribut key aura la valeur de la clé trouvée. Puis créer ensuite les clés i18n.

Images dans les pages statiques et dans les rubriques

Les images à l'intérieur des pages statiques sont à placer dans le dossier pages/ en créant un sous-dossier images.

À la racine du dossier pages si c'est pour toutes les langues, sinon à l'intérieur du répertoire fr si l'image est uniquement relative à une langue.

Les autres images, celles qui sont liées aux css, sont à placer dans theme.

<!--EndFragment--><!--EndFragment-->

CSS (fond derrière image padding marging justifier le corps du texte)

Utiliser l'inspecteur de document du Plugin Firebug pour tester des modifications de CSS et visualiser leur emplacement dans les feuilles de style. (surcharges en local)

Créer un répertoire local (sous-répertoire de theme/css/local/) afin d’y sauver les fichiers qu’on aura précédemment copiés à partir des originaux en gardant le même nom et sur lesquels on ne mettra que les modifications (surcharge). Ce qui permet de ne pas écraser les anciennes versions de fichiers, le nouveau fichier écrasant l’ancien, puisque les deux fichiers ont le même intitulé.

Ensuite, on sauve ces fichiers dans le dossier « local » et on redémarre le serveur pour que les modifications soient prises en compte.