Cette application est basée sur le projet LIUS de l'université de Laval au Québec, qui s'appuie sur la version 1.4.3 de Lucene en l'enrichissant de fonctionnalités pour exploiter une plus large palette de format de fichiers. Elle représente le module indexation de l'application inJAC, utilisé à partir du moteur de rendu.
Attention : à partir de la version 1.1 il faut utiliser le moteur de rendu 2.4 ou supérieur.
Cette application indexe le contenu d'un espace inJAC, et a donc besoin de se connecter à un Serveur Webdav opérationnel, avec un espace inJac valide.
Sur la machine même, un environnement Java (JRE ou JDK), version 1.4.X à partir du 1.4.2(non testé sur JDK 1.5), ainsi qu'un moteur de servlet/jsp (TOMCAT 5.0.28 ou supérieur) doivent être préalablement installés.
Version 1.1
fil RSS renvoyant une liste des derniers documents indexés(voir documentation d'utilisation)
retour des résultats d'une requête en XML ou en HTML et corrections liées à l'encodage (voir documentation d'utilisation).
possibilité de paramétrer la liste des métadonnées que l'on veut dans les résultats(voir documentation d'utilisation)
paramétrage des métadonnées correspondant au titre et à la description des documents retournés.
Le déploiement s'effectue en décompressant l'archive dans un répertoire accueillant une application WEB Java( répertoire /webapps de Tomcat par exemple).
Une fois décompressé, éditer le fichier indexation.properties situé dans injac-indexing/WEB-INF/classes :
#filesystem path to repository for created index indexPath=F:/injac-indexes #default values filling create index form defaultUrl=http://slide-priv:8080/slide/files/injac/injacRoot defaultUser=admin #warning : filling this property makes it visible for any user connecting # to this application ! # if accessible on public network, better use a dummy value defaultPassword=password #default mode for metadata indexing : (none|all|injac) metadata-mode=all # config file for LIUS indexer(must be in WEB-INF/Config directory) liusConfigFile=liusFilesConfig.xml # set to true forces ssl connection forceSSL=true #leave blank if default port 443, else prefix with colon (i.e :8443) httpsPort=:8443 #warning : setting this property to on makes visible the content of this file for any user accessing this application ! debug=off # -- RESULT SETTINGS -- #list of metadata names used in different formats configured in Canal Stockage for title and desc titleMD=title,gen_title descriptionMD=description,gen_description #list of indexed MD to include in results (could be overriden by request parameter) resultMD=document-state,description # -- URLs params -- # URL of inJac renderer. If not defined URLs will be WEBDAV's ones(overridable by request param) renderURL=http://saroumane.enseeiht.fr:810/injac # upper node of inJac spaces. If not defined URLs will be WEBDAV's ones(overridable by request param) upnode=injacRoot #extensions for html rendering files intDocs=xml html htm txt jpg png gif XML HTML HTM TXT JPG PNG GIF #css file for html results cssFile=css/results-skin-esup1.css
Attention : Sous Linux, un espace à la fin d'une ligne de propriété peut-être fatal ! Vérifiez que les paramètres sont immédiatement suivis d'un retour à la ligne !
Description des paramètres de configuration :
indexPath
Chemin système désignant le répertoire où vont être générés les index.
Informations pour pré-remplir le formulaire de création d'index
defaultUrl : URL WEBDAV de l'espace racine à indexer
defaultUser : nom d'utilisateur pour l'accès à l'espace racine
defaultPassword : mot de passe pour l'accès à l'espace racine
Attention : La définition du mot de passe dans le fichier de configuration doit s'utiliser uniquement dans le cas d'un réseau privé, car il pourra être lu en éditant la source de la page. Si l'accès se fait par un réseau public comme Internet, il vaut mieux mettre un mot de passe fictif.
metadata-mode : mode d'indexation des métadonnées
none : aucune métadonnée n'est indexée
all : toutes les métadonnées inJAC sont indexées(dont le nom d'espace est "INJAC:")
injac : seules les métadonnées inJAC de l'espace racine sont indexées
liusConfigFile
Fichier pour configurer l'indexation. Ce fichier doit se situer dans le répertoire WEB-INF/Config de l'application. Un fichier est défini par défaut. Voir la documentation en ligne du projet LIUS concernant le fichier de configuration.
forceSSL
Force l'utlisation de SSL lors de la création d'index, si l'accès se fait à travers un réseau public. Ceci garanti le cryptage des informations de connexion.
httpsPort
Port utilisé dans le cas ou forceSSL est égal à "true"
debug
Permet d'obtenir des informations de déboggage sur la page HTML :
"on" = mode deboggage
"off" = mode normal.
paramétrages des résultats
titleMD
Liste des métadonnées contenant le titre du document dans les différents formats de saisie du Canal de Stockage
descriptionMD
Liste des métadonnées contenant la description du document dans les différents formats de saisie du Canal de Stockage
resultMD
Liste des métadonnées, séparées par des virgules, à renvoyer dans les résultats de recherche (voir la documentation d'utilisation)
cssFile
Fichier CSS définissant le style pour le rendu HTML des résultats de recherche faits avec l'URI htmlSearch (voir la documentation d'utilisation).
Le niveau de débogage peut être modifier en éditant le fichier WEB-INF\classes\log4j.properties. Les niveaux disponibles sont : debug, info, warn, error et fatal, du plus prolixe au plus concis.
Note : il faut également adapter le chemin du fichier de log, à la ligne :
log4j.appender.R.File=E:/Java/jakarta-tomcat-5.0.28/logs/injac-index.log