L'installation du FileConnector est conforme aux autres applications et modules freedom. Le FileConnector est distribué sous le nom de composant freedom-fileconnector.

Un FileConnector est un document freedom.

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

Pour modifier un FileConnector, utilisez le menu éditer du document FileConnector en question.

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

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.

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 seul les systèmes de fichiers locaux¹⁾ sont supportés.
• 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 freedom. 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, freedom 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).

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 freedom 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 freedom 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 freedom). 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é.

expression des règles d'analyse

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

Exemple de règle de base :

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

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

Le menu Source sur le document FileConnector⁴⁾ permet de réaliser des tests et de lancer manuellement les importations.

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 test les règles que vous définissez.

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é