.. _filewatcher:

############################
Utilisation des filewatchers
############################

Le filewatcher est un mode particulier du client Waarp R66 : une fois démarré,
celui-ci surveille un ou plusieurs répertoires et envoit tous les fichiers qui y
sont déposés selon les données paramétrées (notamment le destinataire et la
règle de transfert).

Un même filewatcher peut surveiller plusieurs répertoires ou arborescences et
envoyer les fichiers à un ou plusieurs destinataires.

.. seealso::

   * La documentation de Waarp R66 concernant le paramétrage, l'administration
     et l'utilisation des filewatchers : :doc:`r66:usage/filewatcher`

Pré-requis
==========

- Filewatcher configuré et lancé indépendemment de Waarp Manager
- Le partenaire d'origine doit être un serveur Waarp Transfer, Waarp R66, Waarp
  Gateway SFTP ou Waarp Gateway FTP

Principe
========

Le filewatcher est un mode particulier du client Waarp R66 ou Waarp Transfer :
une fois démarré, celui-ci surveille un ou plusieurs répertoires et envoit tous
les fichiers qui y sont déposés selon les données paramétrées (notamment le
destinataire et la règle de transfert).

Un même filewatcher peut surveiller plusieurs répertoires ou arborescences et
envoyer les fichiers à un ou plusieurs destinataires.

Pour Waarp Manager, un dossier à surveiller peut être configuré par flux.
La configuration du filewatcher est générée lors du déploiement de la
configuration et transmis au partenaire d'origine pour pouvoir être utilisée.


Utilisation d'un filewatcher pour un flux
=========================================

L'activation du filewatcher pour un flux donné se fait dans le formulaire
d':ref:`flow-edit-create`, dans l'onglet « filewatcher » 
(:numref:`fig-fw-edit-filewatcher`).


.. _fig-fw-edit-filewatcher:
.. figure:: ../../_static/img/flow_edit_filewatcher.png
   :align: center

   Édition/créationd'un flux (onglet "filewatcher")

Le formulaire permet de définir paramétrer les éléments suivants :

Repertoire surveillé
   Le dossier que le filewatcher surveille. C'est ici que doivent être déposés
   les fichiers à transférer.

Utilise TLS
   Quand cette option est activée, le premier transfert lancé par le filewatcher
   est chiffré en utilisant TLS

Recursive
   Permet de définir la sonde du filewatcher comme récursive, c'est-à-dire que
   tous les sous-dossiers du dossier principal sont également surveillés, et les
   fichiers qui y sont déposés sont également transférés.

Asynchrone
   Quand cette option est activée, le premier transfert lancé par le filewatcher
   est asynchrone (le filewatcher enregistre la demande de transfert, et
   celui-ci est exécuté par le serveur Waarp R66 associé au filewatcher). Dans
   le cas contraire, c'est le filewatcher qui exécute directement le transfert
   (transfert synchrone).

Expression régulière
   Cette expression régulière permet de filtrer les fichiers déposés dans le
   dossier surveillé : seuls les fichiers correspondant à cette expression
   régulière sont transférés

