Fork me on GitHub

Installation

Le plugin Files2Docs est à installer dans une application contenant au minimum :

  • Le coeur de Lutèce
  • Le plugin Document

Il existe plusieurs possibilités d'installation en fonction de la distribution employée :

  • Distribution binaire : Le contenu du fichier zip de la distribution binaire doit être décompressé dans une webapp contenant déjà le coeur de Lutèce ainsi que le plugin Document.
  • Sources : Dans ce cas, il est nécessaire d'ajouter la dépendance sur le coeur et le plugin Document afin de pouvoir compiler les sources et de se retrouver avec une distribution binaire.

Pour générer la distribution binaire, il suffit de télécharger les sources du projet et d'exécuter la commande :
mvn lutece:assembly.

Pour les détails de l'installation, reportez-vous à la rubrique : Installation de plugin

Remarque :
Il est possible d'obtenir un fichier war déployable en utilisant un packaging de type lutece-site. Ce fichier doit être placé dans le répertoire webapps de votre installation de Tomcat. Il sera automatiquement déployé lors du lancement du serveur.

Configuration

Mode Portail

La configuration correspond à la configuration classique d'un portail Lutèce.

Fichiers paramétrables

db.properties :

Pour utiliser un pool spécifique au plugin Files2docs, ajouter le code suivant dans ce fichier :

					files2docs.poolservice=fr.paris.lutece.util.pool.service.LuteceConnectionService
					files2docs.driver=org.gjt.mm.mysql.Driver
					files2docs.url=jdbc:mysql://<mysqlhost>:<mysqlport>/<basename>?
								autoReconnect=true&useUnicode=yes&characterEncoding=utf8
					files2docs.user=
					files2docs.password=
					files2docs.initconns=2
					files2docs.maxconns=5
					files2docs.logintimeout=2000
					files2docs.checkvalidconnectionsql=SELECT 1
				

files2docs.properties :

Certains réglages sont disponibles au niveau du plugin :

Propriété Description
files2docs.itemsPerPage Nombre de lignes par défaut affichées par le paginator dans les interfaces d'administration du plugin.
files2docs.listAttributeTypeFile Liste des attributs de document comportant un champ de type input="file"
files2docs.parentPath Chemin parent utilisé pour importer les fichiers
files2docs.swfupload.file_upload_limit Nombre maximum de fichiers à importer. Renseignez la valeur 0 pour que le nombre de fichiers soit illimité.
files2docs.swfupload.file_queue_limit Nombre maximum de fichiers placés dans la file d'attente. Renseignez la valeur 0 pour que le nombre de fichiers soit illimité.
files2docs.swfupload.requeue_on_error Pour replacer les fichiers en erreur dans la file d'attente, renseignez la valeur true, sinon false.
files2docs.swfupload.debug Pour activer le mode debug du composant SWFUpload, renseignez la valeur true, sinon false.
files2docs.requestMaxSize Taille maximale (en octets) par requête (ou fichier importé). Cette valeur doit être identique à la valeur renseignée dans le filtre du coeur de Lutèce (requestMaxSize).
files2docs.minInterval Intervalle de temps minimum (en millisecondes) autorisé entre deux requêtes du même client. Cette valeur doit correspondre à la valeur renseignée dans le filtre du coeur de Lutèce (minInterval).
files2docs.mapping.listTags Liste des tags définis ci-dessous :
files2docs.mapping.tag.filename Nom du tag permettant de récupérer le nom du fichier importé (sans extension).
files2docs.mapping.tag.mimetype Nom du tag permettant de récupérer le type MIME du fichier importé.
files2docs.mapping.tag.extension Nom du tag permettant de récupérer l'extension du fichier importé (sans le "." devant l'extension).
files2docs.mapping.tag.date Nom du tag permettant de récupérer la date de l'import.
daemon.autoCleaning.interval Intervalle de temps (en millisecondes) entre chaque passage du daemon de nettoyage des fichiers importés. Ce dernier est chargé de supprimer les fichiers importés dont la date de dernière modification est supérieure à un jour.
daemon.autoCleaning.onstartup Pour démarrer le daemon de nettoyage des fichiers importés au démarrage de la webapp, renseignez la valeur 1, sinon 0.