Collecteur de fichiers file-collector
Le Collecteur de fichiers assure un suivi de l'arrivée d'un ou plusieurs fichiers dans un répertoire et active sa transition pour chacun des fichiers reçus. Pour chaque événement, une variable filename contient le nom complet du fichier reçu. Les fichiers collectés sont déplacés dans un autre répertoire afin de ne les prendre en compte qu'une seule fois et pour historisation.
Par défaut, le collecteur de fichiers est une tâche persistante testant la présence de fichiers aux heures spécifiées par le planning.
Les fichiers doivent se trouver sur le serveur sur lequel s'exécute le module wfserver qui prend en charge ce workflow. Si plusieurs modules wfserver sont déployés sur une même instance, il faut spécifier soit l'affinité des activités utilisant ces fichiers, soit l'affinité globale du workflow.
Propriétés properties
Le premier onglet de l’activité du Collecteur de fichiers vous permet de sélectionner le répertoire source et, si nécessaire, de filtrer les fichiers collectés. Les autres onglets sont présentés dans la section Réception d’emails (onglets Planning et Expiration).
-
Récupération des fichiers
-
Répertoire
Répertoire contenant le ou les fichiers à récupérer. Ce répertoire doit être créé au préalable sur le serveur : s'il n'existe pas, une erreur est générée.
-
Filtre
Seuls les fichiers correspondant à ce filtre sont pris en compte. Les autres fichiers du répertoire seront ignorés. Si le filtre est vide, tous les fichiers du répertoire seront pris en compte. Exemples de filtre : *.zip, import-*.txt.
-
Terminer dès qu'un fichier est traité
Si cette option est activée, la tâche se termine après réception du premier fichier. Si plusieurs fichiers correspondant au filtre sont présents dans le répertoire, un seul sera pris en compte. Cette option garantit qu'un seul événement sera émis. Le fichier pris en compte est le premier de la liste dans l'ordre alphabétique.
Dans le cas d'une activité non planifiée, si aucun fichier correspondant au filtre n'est trouvé dans le répertoire spécifié et si l'option Traiter l'absence de fichier n'est pas activée, une erreur est générée.
-
Planning d'exécution
Détermine la fréquence de vérification de la présence des fichiers via les paramétres de l'onglet Planning.
-
-
Traitement des erreurs
Les deux options suivantes sont disponibles :
-
Traiter les fichiers absents
Cette option fait apparaître une transition particulière qui sera activée à chaque vérification de présence de fichier si aucun fichier correspondant au filtre n'est trouvé dans le répertoire spécifié.
Si la tâche n'est pas planifiée, cette transition sera activée une seule fois.
-
Traiter les erreurs
Cette option fait apparaître une transition particulière qui sera activée si une erreur est générée. Dans ce cas, le workflow ne passe pas en état d'erreur et continue son exécution.
Les erreurs prises en compte sont les erreurs du système de fichiers (impossible de déplacer un fichier, impossible d'accéder au répertoire, etc.).
Cette option ne traite pas les erreurs liées au paramétrage de l'activité, c'est-à-dire des valeurs invalides.
-
-
Historisation
Voir l’étape Historisation des fichiers de la section Téléchargement Web.
L’ordre de traitement des fichiers ne peut pas être déterminé. Pour traiter un ensemble de fichiers de manière séquentielle, utilisez la variable Terminer dès qu'un fichier a été traité et créez une boucle. Dans ce cas, les fichiers seront traités par ordre alphabétique. La variable Traiter l'absence de fichier permet de terminer l’itération.
Paramètres de sortie output-parameters
- Filename : Nom complet du fichier. Il s’agit du nom de fichier après son déplacement dans le répertoire d’historisation. Le chemin d’accès est donc différent, mais le nom est également différent si un autre fichier portant le même nom existe déjà dans le répertoire. L’extension est conservée.