Chapitre 2 Administration du FileConnector

2.1 Installation

L'installation du FileConnector est conforme aux autres modules Dynacase. Le module dynacase-fileconnector installe la famille FILECONNECTOR qui a pour fonction de transférer les fichiers dans les documents.

2.2 Création et modification d'un FileConnector

Suite à l'installation du module dynacase-fileconnector, dans les familles installées vous devez trouver la famille FileConnector. Pour créer un nouveau FileConnector, utilisez le menu "créer" de la famille FileConnector.

2.3 Paramétrage d'un FileConnector

Figure 1. édition du FileConnector

En édition, un FileEditor est décomposé en 4 zones principales (repérées sur la capture ci-dessus).

2.3.1 (1) Description

Le nom du FileConnector est obligatoire (c'est le titre du document). La description optionnelle vous permet de décrire son rôle, son fonctionnement.

2.3.2 (2) Source

Ce cadre permet de spécifier où sont recherché les fichiers à importer : la source.

• mode d'accès : la première information attendue et obligatoire est le mode d'accès. A ce jour seuls les systèmes de fichiers locaux sont supportés. Un système de fichier est dit local s'il est accessible directement sur le serveur applicatif : disque local, montage NFS, montage CIFS.
• machine hôte : pour usage futur
• port réseau : pour usage futur
• login : pour usage futur
• password : pour usage futur
• chemin du répertoire : permet d'indiquer le chemin d'accès au répertoire à surveiller

Mode d'accès par système de fichier

Si ce mode d'accès est choisi, le seul paramètre supplémentaire pour configurer la source est le chemin d'accès. Ce répertoire doit être accessible en lecture par le serveur dynacase. En terme de droits *nix cela signifie que le process apache doit accéder en lecture au répertoire.

Contrôle de l'accès à la source

Lors de la création (ou modification) du FileConnector, dynacase contrôle que la source est accessible (accès en lecture). Un message popup est affiché pour indiquer si l'accès est possible ou non. Cette information est affichée sur le document FileConnector (Accessible).

2.3.3 (3) Règles d'importation

Pour chacun des fichiers présents dans la source, le FileConnector vérifie qu'il correspond à une règle d'importation. Les règles d'importation sont appliquées dans l'ordre d'affichage. Elles permettent de définir :

• (3a) le nom de la règle
• (3b) la règle d'analyse du nom du fichier : cette information est détaillée ci-dessous.
• (3c) la famille cible : il s'agit de la famille de document pour laquelle un nouveau document sera créé lors de l'import de chacun des fichiers correspondant à cette règle. Seules les familles possédant au moins un attribut de type file ou image sont proposées.
• (3d) le nom de l'attribut : cet attribut est optionnel, s'il n'est pas précisé le premier attribut de type file ou image de la famille est utilisé pour stocker le fichier dans le document créé.
• (3e) le dossier de destinationest le dossier dynacase dans lequel est placé le document lors de sa création.
• (3f) si la demande de suppression est positionnée à Oui, le fichier est supprimé suite à la création du document (i.e. son importation dans dynacase).
  Si une erreur survient lors de la phase de création du document cible, le fichier n'est pas supprimé. Si une erreur survient lors de la suppression (droits insuffisants par exemple) aucune erreur n'est remontée. Le fichier ne sera plus traité.

2.3.3.1 Expression des règles d'analyse

Les règles d'analyses, appelées recherche de motifs, sont appliquées sur le nom du fichier (nom et extension). Elle sont exprimées sous la forme d'expression rationnelle PERL.

2.3.3.2 Exemple de règle de base :

• .*\.png$: filtre les fichiers dont l'extension est png;
• ^des : filtre les fichiers commençant par "des";
• ^fact.*2008.*\.pdf$ : filtre tous les fichier pdf commençant par "fact" et contenant "2008"
• ^.*$ : filtre tous les fichiers

2.3.4 (4) Programmation

La programmation permet de d'automatiser l'importation des fichiers trouvés dans la source et correspondant aux règles.

les paramètres de programmation sont :

• exécution programmée : en positionnant à Oui, les importations seront activées selon le cycle que vos allez définir avec les paramètres de période. date d'exécution précise la date et l'heure de la première exécution)
• période (jours) nombre de jours entre 2 exécutions
• période (heures) nombre d'heure entre 2 exécutions
• période (minutes) nombre de minutes entre 2 exécutions

Pour une exécution toutes les 5 minutes (à partir du 1er janvier 2009 0h) :

date d'exécution  = 01/01/2009 00:00
période (jours)   = 0
période (heures)  = 0
période (minutes) = 5

Pour une exécution tous les jours à 13h (à partir du 1er janvier 2009 13h) :

date d'exécution  = 01/01/2009 13:00
période (jours)   = 1
période (heures)  = 0
période (minutes) = 0

2.4 Fonction de surveillance et de gestion manuelle

Le menu Source sur le document FileConnector permet de réaliser des tests et de lancer manuellement les importations. Ce menu n'est pas accessible si la source est inaccessible.

En cliquant, sur ce menu les items suivants sont proposés :

• Importer les nouveaux : lance interactivement l'importation des fichiers correspondant aux règles
• Contrôler les nouveaux : lance l'analyse de la source et établit la liste des fichiers à importer
• Vider la liste des fichiers : à tout moment permet de vider la liste des fichiers.

Le document FileConnector propose la liste des fichiers à traiter

Cet affichage, conjointement à l'utilisation des menus décrits ci-dessus vous permet de tester les règles que vous définissez.

Figure 2. fichier à traiter

Pour chacun des fichier, il est indiqué à quelle règle il correspond, son nom est rappelé ainsi que sa taille, sa date de modification et son état. L'état peut prendre les valeurs suivantes :

• nouveau : le fichier est détecté dans la source mais non traité;
• importé : le fichier est importé et la suppression n'est pas demandée pour cette règle
• détruit : le fichier est importé, et la suppression du fichier source demandée n'a pas fonctionné