IBM FileNet P8, Version 5.2            

Personnalisation des options de recherche de Workplace XT

Vous pouvez personnaliser les cases à cocher correspondant aux options de recherche de Workplace XT qui apparaissent sur les pages de recherche simple ou avancée. Les options de recherche sont affichées dans les listes Options et Types de document. Vous pouvez personnaliser les listes des manières suivantes :
  • Ajout d'options
  • Suppression d'options
  • Changement de noms d'options
Avant toute recherche, Workplace XT transforme les conditions de recherche en requête SQL. Chaque case à cocher d'option de recherche représente une condition ajoutée à la clause WHERE de l'instruction SQL. Les cases à cocher sont définies dans le fichier <chemin de déploiement de WPXT>/FileNet/Config/WC/SimpleSearch.xml. Comme indiqué dans le fragment XML, chaque case à cocher est décrite dans un élément d'objet searchOption.
<object key="searchOptionGroup">
 <setting key="id">options</setting>
 <list key="searchOptions">
 <object key="searchOption">
 <label key="label" localizationKey="server.SimpleSearch.createdByMe">
 <resource>Added by me</resource>
 </label>
 <setting key="symname">Creator</setting>
 <setting key="value">{CURRENT_USER}</setting>
 <setting key="type">typestring</setting>
 <setting key="operator">eq</setting>
 <setting key="join">and</setting>
 <array key="objectTypes">
 <value>document</value>
 <value>folder</value>
 </array>
 <array key="objectStores"></array>
 <array key="roles"></array>
 </object>
...
Remarques :
  • Lorsque vous éditez le fichier XML, veillez à utiliser le fichier déployé sur votre serveur d'applications, qui peut être différent de celui de l'emplacement d'installation par défaut.
  • Sauvegardez SimpleSearch.xml avant de le modifier.
  • Si vous modifiez le fichier pour inclure les caractères étendus, enregistrez-le au format UTF-8.
  • Après avoir modifié SimpleSearch.xml, vous pouvez le recharger à partir de Workplace XT pour éviter de redémarrer le serveur d'applications.
Le tableau suivant décrit les éléments dans SimpleSearch.xml en utilisant la case à cocher Ajouté par moi comme exemple. Tout élément est identifié par son attribut key. Sauf indication contraire, les éléments suivants sont obligatoires.
Tableau 1. Ce tableau décrit les éléments dans SimpleSearch.xml en utilisant la case à cocher Ajouté par moi comme exemple.
Paramètre Valeur
<object key="searchOptionGroup">
 <setting key="id">options</setting>
L'élément searchOptionGroup répartit les options de recherche dans les listes Options et Types de document sur les pages de recherche simple et avancée. L'élément id indique la liste : les éléments avec la valeur options apparaissent dans la liste Options et ceux avec la valeur docTypes dans la liste Types de document.
<object key="searchOption">
 <label key="label"
 localizationKey=
 "server.SimpleSearch.createdByMe">
 <resource>
 Added by me
 </resource>
 <resource locale=fr_FR" >
 Créé par moi
 </resource>
 </label>
L'élément searchOption définit une option de recherche. L'élément label définit plusieurs attributs du texte permettant de décrire la case à cocher.

L'élément label nécessite un attribut localizationKey. Pour indiquer la valeur de l'attribut localizationKey lors de la création d'une option de recherche, utilisez la chaîne server.SimpleSearch. et ajoutez un nom descriptif. localizationKey doit être unique dans SimpleSearch.xml. Utilisez l'élément resource pour indiquer le texte permettant de décrire la case à cocher.

L'élément label prend en charge les chaînes localisées. Vous pouvez si vous le souhaitez avoir un ou plusieurs éléments resource avec un attribut locale. La valeur de cet attribut doit utiliser les codes de langue et de pays ISO standard pris en charge par les navigateurs.
<setting key="symname"> 
 Creator
</setting>
L'élément symname indique le nom symbolique (identificateur de programme) de la propriété associée à la case à cocher. Vous pouvez obtenir le nom symbolique d'une propriété via Enterprise Manager.
<setting key="value">
 {CURRENT_USER}
</setting>
L'élément value indique la valeur de la propriété spécifiée dans la requête SQL. Le cas échéant, les macros suivantes sont prises en charge :
  • {CURRENT_USER} est le nom de version abrégé de l'utilisateur actuellement connecté.
  • {DATE}[ + | - ][jours] et la date actuelle +/- le nombre de jours spécifié. Par exemple, " {DATE}-7" signifie jour en cours moins 7 jours. Les espaces ne sont pas autorisés.
<setting key="type">
 typestring
</setting>
L'élément type indique le type de données de la propriété. Les types de données sont typestring, typeboolean et typedate. Vous pouvez déterminer le type de données d'une propriété via Enterprise Manager.
<setting key="operator">
 eq
</setting>
L'élément operator indique l'opérateur relationnel utilisé dans la requête SQL. Les valeurs valides sont les suivantes : eq, lt, gt, lte, gte, neq, in, isnull, isnotnull, like.
<setting key="join">
  and
</setting>
L'élément join indique comment cette option de recherche est combinée avec les autres. Cette option a pour valeur par défaut or pour les cases à cocher Type de document et and pour toutes les autres. Par exemple, si un utilisateur sélectionne les types de document Word, Excel et PDF, la fonction de recherche renvoie tous les documents de type Word ou Excel ou PDF. De même, si un utilisateur coche les cases Créé par moi et Réservé, la fonction de recherche renvoie les documents créés par lui et réservés.

Lorsque Workplace XT transforme les options de recherche en requête SQL, il regroupe toutes les conditions and, suivies de toutes les conditions or. Par exemple, avec les paramètres par défaut, si un utilisateur sélectionne Word, PDF, Créé par moi et Réservé, la fonction de recherche soumet une requête semblable à "created by me" and checked out and (Word or PDF).

<array key="objectTypes">
 <value>document</value>
 <value>folder</value>
</array>
L'élément objectTypes indique la liste des types d'objet pour lesquels cette option de recherche est valide. Les valeurs prises en charge sont document et folder.
<array key="objectStores">
 <value>Claims</value>
</array>
L'élément objectStores indique la liste des conteneurs d'objets pour lesquels cette propriété est valide. Si l'utilisateur effectue une recherche dans un conteneur d'objets où la propriété n'est pas valide, l'option de recherche associée n'apparaît pas. Pour afficher l'option de recherche pour tous les conteneurs d'objets, ignorez l'élément d'objet value.
<array key="roles">
 <value>Adjustor</value>
</array>
L'élément roles indique la liste des rôles bénéficiant d'un accès à cette option de recherche. Si l'utilisateur n'est pas membre d'un rôle spécifié, l'option de recherche associée n'apparaît pas. Pour afficher l'option de recherche pour tous les utilisateurs, ignorez l'élément d'objet value.


Commentaires

Dernière mise à jour : Mars 2013
wpxt_search_options.htm

© Copyright IBM Corp. 2013.
Ce centre de documentation est doté de la technologie Eclipse. (http://www.eclipse.org)