# ICAP (BETA)

Le traitement `ICAP` upload le fichier de transfert vers un serveur ICAP pour être traité. Dans le cas où le transfert est un envoi, la méthode Icap `REQMOD` sera utilisée. Dans le cas d’une réception, la methode `RESPMOD` sera utilisée.

Avertissement

L’implémentation actuelle de ICAP n’est pas complète, et souffre donc de 2 sévères limitations :

1) Le fichier est lu intégralement en mémoire avant d’être écrit dans la requête ICAP. Cela signifie que les fichiers de transfert de taille importante ne peuvent pas, et ne doivent pas être traités via cette tâche, au risque de causer un crash de la gateway pour cause de manque de mémoire. En règle générale, il est fortement déconseillé d’utiliser le traitement ICAP sur des fichiers de plus de quelques mégaoctets. 2) Le client ICAP actuel ne supporte pas TLS. Les requêtes ICAP seront donc toujours envoyées en clair.

Nous travaillons à résoudre ces deux limitations dans un futur proche.

Les arguments de ce traitement sont:

- `uploadURL` (string) - L’URL complète de la requête ICAP. Cela inclue l’hôte, le port, ainsi que le chemin.

- `timeout` (string) - Le temps de timeout de la requête. Les unités de temps acceptées sont: `ms` (millisecondes), `s` (secondes), `m` (minutes), et `h` (heures).

- `allowFileModifications` (bool) - Indique si le serveur ICAP est autorisé à modifier le fichier de transfert, auquel cas le fichier de transfert sera écrasé par le contenu de la réponse du serveur. Par défaut les modifications sont interdites.

- `onError` (string) - L’action à effectuer en cas d’erreur. Les valeurs acceptées sont : (vide) pour ne rien faire, `delete` pour supprimer le fichier de transfert ou `move` pour déplacer le fichier de transfert dans un autre dossier. Par défaut, aucune action n’est prise sur le fichier en cas d’erreur (le transfert tombera tout de même en erreur).

- `onErrorMovePath` (string) - Le chemin vers lequel le fichier de transfert sera déplacé en cas d’erreur. Cette option est obligatoire si `onError` est `move`. Dans le cas contraire, cette option n’a aucun effet.