Module d'import de documents 3.2
Description
Ce module importe automatiquement dans JCMS les fichiers déposés dans un répertoire externe à JCMS.
Il supporte le stockage des documents en base en plus du stockage classique.
Depuis la version 3.0 du module, il est possible de gérer (superviser) plusieurs répertoires de dépôt et pour chaque répertoire spécifier:
- l'auteur des documents importés,
- le status de base des documents importés,
- le workspace des documents importés,
- le workflow des documents importés,
- des catégories des documents importés,
- les droits de lecture pour un ou plusieurs groupes sur les documents importés,
- les droits de modification pour un ou plusieurs groupes sur les documents importés,
- une expression régulière pour la génération des titres des documents (les préfixer par exemple),
- le comportement à l'issue de l'opération d'importation, à savoir : conserver, supprimer ou déplacer l'original.
- la classe de document : FileDocument ou DBFileDocument
Captures d'écran
1. Exemple de règle d'import
|
Installation
- Déployer l'archive compressée du module.
- Avant de démarrer Jcms, renseigner les propriétés sur des répertoire de dépôt dans custom.prop en vous inspirant de l'exemple dans plugin.prop du module.
Depuis la version 3.0, les propriétés du module ne sont plus éditables via la fenêtre de propriété dans l'espace d'administration.
Toutefois un exemple de configuration existe dans le fichier plugin.prop du module.
Référez vous donc à cet exemple pour paramétrer le module et l'adapter à votre besoin.
Pour cela, copiez cet exemple dans custom.prop et remplacez ‹repository-id› par l'identifiant que vous souhaiterez donner à votre répertoire.
Le tableau suivant liste l'ensemble des propriétés du module.
| Nom | Description | Obligatoire | Valeur par défaut |
|---|---|---|---|
| <repository-id>.name | Le nom fonctionnel du répertoire | non | Valeur de <repository-id> |
| <repository-id>.baseDirectory | Répertoire d'import: il s'agit du répertoire que le module va superviser et dont les fichiers seront importés en documents JCMS. Cette propriété est obligatoire. | oui | - |
| <repository-id>.schedulePeriod | La période de balayage: permet d'effectuer des vérifications périodiques de l'arrivé de nouveaux fichiers. La valeur doit être supérieure ou égale à 1. | oui | 1 |
| <repository-id>.component.ImportDocumentProcessor.extensions | Les extensions des fichiers à importer: liste des extensions de fichiers pris en compte (séparées par un espace). Par exemple : doc ppt xls pdf. | oui | |
| <repository-id>.behavior | Le comportement du processeur après l'import: cette propriété détermine si le fichier doit être conservé (keep) ou supprimé (delete) ou archivé (répertoire d'archivage) à l'issue de l'import. Par défaut le fichier est maintenu. | non | keep |
| <repository-id>.import.title-regexp | L'expression régulière utilisée pour la génération du titre du document. | non | |
| <repository-id>.import.type | Type de document à créer: document(FileDocument) ou document en base(DBFileDocument) | non | FileDocument |
| <repository-id>.import.pstatus | Le status du fichier importé: la valeur est un entier correspondant à un status du fichier JCMS (par ex. -10, 0, 10, 20) ou une valeur personnelle. Si aucune valeur n'est spécifiée, la valeur 0 est utilisée. | non | 0 |
| <repository-id>.import.author | Auteur des documents importés: le membre ayant cet identifiant est positionné techniquement comme auteur des fichiers importés. Si cette propriété n'est pas positionnée, l'administrateur par défaut est utilisé. | non | Administrateur par défaut. |
| <repository-id>.import.ws | L'espace de travail: l'identifiant de l'espace de travail des fichiers importés. Si cette propriété n'est pas spécifiée, l'espace par défaut est utilisé. | non | Espace par défaut |
| <repository-id>.import.workflow | Le Workflow à utiliser. Par défaut, le workflow configuré dans l'espace sera utilisé. | non | Workflow par défaut. |
| <repository-id>.import.categories | Les catégories: les identifiants des catégories de l'espace de travail séparés par un espace. Si aucune valeur n'est spécifiée les documents ne sont pas catégorisés. | non | |
| <repository-id>.import.read-rights.mbr | Droit de consultation au niveau des membres : des identifiants des membres autorisés à consulter les fichiers. | non | |
| <repository-id>.import.read-rights.grp | Droit de consultation au niveau des groupes : des identifiants des groupes autorisés à consulter les fichiers. | non | |
| <repository-id>.import.update-rights.mbr | Droit de modification au niveau des membres : des identifiants des membres autorisés à modifier les fichiers. | ||
| <repository-id>.import.update-rights.grp | Droit de modification au niveau des groupes : des identifiants des groupes autorisés à modifier les fichiers. |
Exemples :
# Scans import
fileprocessor.repository.scanner.name: HotFolder - Scans
fileprocessor.repository.scanner.baseDirectory: /home/pseudo/jaliosnet/hotfolder/scans
fileprocessor.repository.scanner.schedulePeriod: 1
fileprocessor.repository.scanner.component.ImportDocumentProcessor.class: com.jalios.jcmsplugin.importdocument.ImportDocumentProcessor
fileprocessor.repository.scanner.component.ImportDocumentProcessor.extensions: pdf
fileprocessor.repository.scanner.behavior: delete
fileprocessor.repository.scanner.import.type: FileDocument
fileprocessor.repository.scanner.import.author: c_110
fileprocessor.repository.scanner.import.ws: j_4
fileprocessor.repository.scanner.import.categories: jn1_148915
fileprocessor.repository.scanner.import.read-rights.grp: jn1_148923
# Fax import
fileprocessor.repository.fax.name: HotFolder - Fax
fileprocessor.repository.fax.baseDirectory: /home/pseudo/jaliosnet/hotfolder/fax
fileprocessor.repository.fax.schedulePeriod: 1
fileprocessor.repository.fax.component.ImportDocumentProcessor.class: com.jalios.jcmsplugin.importdocument.ImportDocumentProcessor
fileprocessor.repository.fax.component.ImportDocumentProcessor.extensions: pdf
fileprocessor.repository.fax.behavior: delete
fileprocessor.repository.fax.import.type: DBFileDocument
fileprocessor.repository.fax.import.author: jn1_33315
fileprocessor.repository.fax.import.ws: j_4
fileprocessor.repository.fax.import.categories: jn1_148914
fileprocessor.repository.fax.import.read-rights.grp: jn1_148924
fileprocessor.repository.fax.import.title-regexp: s!img-!fax-!
Changements
FAQ
1. Comment préfixer les documents déposés ?
En utilisant la propriété title-regexp, vous pouvez ajouter un préfixe à tous les documents importés.
Par exemple, pour ajouter le prefixe "Scan Marketing ", il suffit de déclarer une propriété de la forme :
fileprocessor.repository.scanner.import.title-regexp: s!^(.)!Scan Marketing $1!
