S-FTP In
La tâche “S-FTP In” permet de télécharger en toute sécurité un ou plusieurs fichiers d'un serveur distant vers le système local en utilisant le protocole SFTP (Secure File Transfer Protocol). Il s'agit d'un composant essentiel pour automatiser l'acquisition de données ou de fichiers à partir de systèmes externes, les rendant disponibles pour être traités par le Workflow.
Configuration
La configuration de la tâche consiste à définir les identifiants d'accès et à spécifier ce qu'il faut télécharger. Les champs de configuration de la tâche peuvent être renseignés manuellement ou via paramètres et variables du flux de travail
Authentification
Définit la méthode par laquelle le Workflow s'authentifiera auprès du serveur SFTP.
- Méthode d'Authentification : Vous pouvez choisir parmi :
- Mot de passe : L'authentification se fera via le mot de passe associé à l'utilisateur.
- Clés SSH : L'authentification se fera via une paire de clés SSH (publique/privée).
- Hôte : L'adresse IP ou le nom DNS du serveur SFTP auquel se connecter.
- Port : Le port de communication pour la connexion SFTP. La valeur par défaut est 22.
- Utilisateur : Le nom d'utilisateur pour la connexion.
Téléchargement de fichiers à distance
Spécifie le mode de téléchargement.
- Mode de Téléchargement : Vous pouvez choisir parmi deux options :
- Fichier Unique : Permet de télécharger un seul fichier spécifique.
- Répertoire Entier : Permet de télécharger tous les fichiers contenus dans un répertoire spécifique.
- Nom de Fichier : Ce champ est visible uniquement si vous choisissez le mode "Fichier Unique". Ici, vous devez entrer le nom exact du fichier à télécharger.
- Chemin distant : Le chemin du répertoire sur le serveur SFTP à partir duquel les fichiers doivent être téléchargés. Si un seul fichier est téléchargé, il s'agit du chemin du répertoire qui le contient.
Paramètres de sortie
Après avoir tenté l'opération de téléchargement, la tâche expose les paramètres de sortie suivants, qui fournissent des informations détaillées sur le résultat et les fichiers téléchargés.
- result : Contient un message textuel décrivant le résultat de l'opération.
- Exemple de succès (fichier unique) : "Transfert du fichier [NomeFile] réussi !"
- Exemple de succès (répertoire) : "Transfert des fichiers du répertoire [PathRemoto] réussi !"
- Exemple d'échec : "Erreur d'authentification avec l'utilisateur [NomeUtente]" ou "Erreur dans le transfert du fichier [NomeFile]!"
- ftpInFile : Contient le nom du fichier téléchargé.
- ftpInPath : Retourne le chemin du répertoire distant à partir duquel le téléchargement a été effectué.
- resultJson : Représente le résultat de l'exécution de la tâche au format JSON, incluant des informations générales, les configurations et les détails sur l'exécution.
Notes Importantes
- Le mode "Répertoire Entier" télécharge les fichiers présents au premier niveau du répertoire spécifié, mais ne télécharge pas récursivement le contenu de toutes les sous-répertoires.