####################
Création d'un rebond
####################


Dans cette partie, nous allons réutiliser la configuration générée dans les
pages précédentes, et la modifier pour automatiser un rebond entre les
différents agents de transfert :

1. Un fichier va être envoyer à la Gateway en SFTP (utilisation de la première
   règle définie)
2. Le fichier reçu est renvoyé vers un partenaire tiers avec la deuxième règle
   définie.

Pour ce faire, nous allons modifier la première règle et ajouter un traitement
post-transfert pour ré-émettre le fichier automatiquement.


Modification de la règle ``sftp_recv``
======================================

Pour permettre d'automatiser le rebond, la chaîne de traitement post-transfert
doit avoir deux tâches :

1. La première déplace le fichier du dossier de réception de la première règle
   (en l'occurrence, le dossier ``in`` de la Gateway) vers le dossier d'envoi de
   la seconde règle (ici, le dossier ``out`` de la seconde règle). C'est une
   tâche :any:`reference-tasks-moverename`.
2. La deuxième tâche lance un transfert avec la seconde règle. C'est une tâche
   :any:`reference-tasks-transfer`.

Les tâches sont définies au format JSON comme un objet avec deux propriétés :
``type``, pour indiquer le type de la tâche, et ``args``, pour fournir les
arguments nécessaires à l'exécution de la tâche.

Dans notre cas, la tâche :any:`reference-tasks-moverename` a besoin d'un argument ``path``,
pour indiquer le nouveau chemin du fichier ; et la tâche :any:`reference-tasks-transfer` a
besoin *a minima* des mêmes arguments que ceux à renseigner dans la commande de
création d'un transfert, à savoir ``file``, ``to``, ``as`` et ``rule``.

Nous allons également utiliser des substitution dans les différentes tâches.
Celles-ci sont remplacées au moment de l'exécution de la tâche par des valeurs
dépendant du fichier transféré ou du transfert lui-même. Par exemple,
``#ORIGINALFILENAME#`` sera remplacé par le nom initial du fichier.

En mettant tout bout à bout, les traitements peuvent être ajoutés à la règle
avec la commande suivante :

.. code-block:: shell-session

   $ waarp-gateway rule update sftp_recv RECEIVE \
      -p '/sftp_recv' \
      -s '{"type": "MOVERENAME", "args": {"path":"#OUTPATH#/#ORIGINALFILENAME#"}}' \
      -s '{"type": "TRANSFER", "args":{"file": "#OUTPATH#/#ORIGINALFILENAME#", "to":"sftp_localhost", "as":"sftpuser", "rule":"sftp_send"}}'
   The rule sftp_recv was successfully updated.


.. seealso::

   La liste des tâches disponibles et leurs arguments est documentée
   :any:`ici <reference-tasks>`.

   La liste des substitutions est consultable :any:`ici <reference-tasks-substitutions>`

.. todo::

   - ajouter une page sur les substitutions


Test de transfert
=================

Nous pouvons maintenant effectuer un transfert de test. Pour cela, nous allons
déposer un fichier en SFTP sur la Gateway, et vérifier que le rebond a bien été
pris en compte et que deux transferts ont été faits :

.. code-block:: shell-session

   $ sftp -P 2223 myuser@localhost
   myuser@localhost's password: 
   Connected to myuser@localhost.
   sftp> put test.txt sftp_recv/test02.txt
   Uploading test.txt to /sftp_recv/test02.txt
   test.txt                                                                                              100%   20     5.7KB/s   00:00    
   sftp> quit

Après avoir établi une connexion avec la Gateway, nous avons déposé un fichier
avec la commande ``put`` dans le dossier ``sftp_recv`` que nous avons défini
ci-dessus comme le ``path`` de la règle ``sftp_recv``.

Nous pouvons vérifier que les transfert se bien passés dans l'historique des
transferts de la Gateway :

.. code-block:: shell-session

   $ waarp-gateway history list
   History:
   [...]
   ● Transfer 25 (as server) [DONE]
       Way:              RECEIVE
       Protocol:         sftp
       Rule:             sftp_recv
       Requester:        myuser
       Requested:        sftp_server
       Source file:      test04.txt
       Destination file: test04.txt
       Start date:       2020-10-02T15:10:48Z
       End date:         2020-10-02T15:10:49Z
   ● Transfer 26 (as client) [DONE]
       Way:              SEND
       Protocol:         sftp
       Rule:             sftp_send
       Requester:        sftpuser
       Requested:        sftp_localhost
       Source file:      test04.txt
       Destination file: test04.txt
       Start date:       2020-10-02T15:10:49Z
       End date:         2020-10-02T15:10:49Z
   
Le fichier disponible est maintenant dans le dossier ``in`` de la Gateway.
Comme nous n'avons pas spécifié de dossier spécifique dans la règle
``sftp_send``, c'est le dossier par défaut du service qui est utilisé :

.. code-block:: shell-session

   # s -l /home/sftpuser/
   total 8
   -rw-rw-r--. 1 sftpuser sftpuser 13 Sep 17 17:27 a-envoyer.txt
   -rw-rw-r--. 1 sftpuser sftpuser 20 Oct  2 15:10 test04.txt