Aller au contenu principal

Nœuds FTP

Les nœuds FTP permettent d'effectuer des opérations sur des serveurs FTP/SFTP. Ecosystem propose plusieurs nœuds : Envoi vers FTP, Lister fichiers FTP, Lire fichier FTP, Supprimer de FTP et Déplacer fichier FTP.

Paramètres​

ParamètreTypeObligatoireDéfautDescription
AppApp❌—Application associée au nœud. Voir Apps.
Méthode d'authentificationMéthode d'authentification✅—Identifiants et protocole FTP/SFTP utilisés pour se connecter.
PathString✅—Chemin du fichier ou du répertoire ciblé par l'opération.
Stopper le flux en cas d'échecBooléen✅trueBooléen qui détermine si le flux s'arrête (true, activé par défaut) ou continue (false) en cas d'échec.

Méthodes d'authentification​

Sélectionnez la méthode d'authentification FTP/SFTP :

  • Host, port, username, password
  • Selon l'option d'authentification choisie : mot de passe associé à l'identifiant renseigné, ou clé privée et phrase secrète associées au nom d'utilisateur
  • Utilisez une méthode d'authentification Ecosystem pour la sécurité

Voir aussi : Utiliser les méthodes d'authentification dans les flux.

Path​

Chemin du répertoire ou fichier :

  • Absolu : /uploads/orders
  • Relatif : orders (relatif au répertoire par défaut)

Lister fichiers FTP​

Liste les fichiers d'un répertoire.

  • Path : Répertoire à lister
  • Extensions : Filtre par extension (optionnel)
  • Recursive : Recherche récursive (oui/non)
  • Nom de la variable des fichiers récupérés (optionnel) : clé de sortie personnalisable, valeur par défaut files (accessible via context.files)
  • Stopper l'exécution du flux en cas d'échec (obligatoire) : booléen pour arrêter ou continuer le flux

Lire fichier FTP​

Lit le contenu d'un fichier.

  • Path : Chemin complet du fichier
  • Encoding : Encodage (UTF-8 par défaut)
  • Nom de la variable du fichier récupéré (optionnel) : clé de sortie personnalisable, valeur par défaut file (accessible via context.file)
  • Stopper l'exécution du flux en cas d'échec (obligatoire) : booléen pour arrêter ou continuer le flux

Envoyer vers FTP​

Envoie un fichier vers le serveur FTP.

  • Path : Chemin de destination
  • Content : Contenu du fichier (texte ou base64)
  • Name : Nom du fichier
  • Stopper l'exécution du flux en cas d'échec (obligatoire) : booléen pour arrêter ou continuer le flux

Supprimer de FTP​

Supprime un fichier.

  • Path : Chemin complet du fichier à supprimer
  • Stopper l'exécution du flux en cas d'échec (obligatoire) : booléen pour arrêter ou continuer le flux
attention

Cette action est irréversible.

Déplacer fichier FTP​

Déplace un fichier.

  • From : Chemin source
  • To : Chemin destination
  • Stopper l'exécution du flux en cas d'échec (obligatoire) : booléen pour arrêter ou continuer le flux

Entrée​

Les nœuds FTP reçoivent le Path du fichier ou répertoire ciblé (absolu ou relatif). Le nœud Envoi vers FTP reçoit en plus le Content (texte ou base64) et le Name du fichier à écrire ; le nœud Déplacer fichier FTP reçoit From (source) et To (destination). Exemple de valeurs reçues par un nœud Envoi vers FTP :

{
  "path": "/uploads/orders",
  "name": "import_20231027.csv",
  "content": "Ligne 1;Valeur A\nLigne 2;Valeur B"
}

Sortie​

Le nœud Lister fichiers FTP injecte la liste des fichiers dans context.files (ou le nom de variable choisi) :

{
  "files": [
    {
      "name": "import_20231027.csv",
      "type": "-",
      "size": 10245,
      "modifyTime": 1698412800000,
      "accessTime": 1698412800000,
      "rights": { "user": "rw", "group": "r", "other": "r" },
      "owner": "ftpuser",
      "group": "ftpgroup"
    }
  ]
}
ChampDescription
nameNom du fichier
type- pour un fichier, d pour un répertoire
sizeTaille en octets
modifyTime / accessTimeHorodatages en millisecondes Unix
rightsPermissions (user, group, other)
owner / groupPropriétaire et groupe du fichier

Accédez ensuite aux éléments via {{files[0].name}} ou, dans une boucle ForEach, {{item.name}}.

Le nœud Lire fichier FTP injecte le contenu dans context.file (ou le nom de variable choisi) :

{
  "file": "Ligne 1;Valeur A\nLigne 2;Valeur B"
}

Le contenu est une chaîne (texte brut). Si le fichier est un JSON valide, il est parsé automatiquement en objet :

{
  "file": {
    "cle": "valeur",
    "items": [1, 2, 3]
  }
}

Utilisez ensuite context.file dans un nœud Code, ou {{file}} dans les nœuds suivants.

Pour les nœuds Envoi vers FTP, Supprimer de FTP et Déplacer fichier FTP, aucune sortie de contexte n'est documentée : le flux continue après l'opération.

Erreurs​

En cas d'échec d'une opération, le comportement du flux est contrôlé par le champ Stopper l'exécution du flux en cas d'échec (true : le flux s'arrête, false : le flux continue). Pour gérer proprement l'échec, ajoutez un nœud On Error au flux.

Limites​

Aucune limite chiffrée (taille, délais) n'est documentée pour ces nœuds.

Exemple​

Lister les fichiers d'un répertoire puis lire le premier fichier :

  1. Le nœud Lister fichiers FTP liste le répertoire (champ Path) et injecte le résultat dans context.files.
  2. Accédez aux fichiers via {{files[0].name}} ou, dans une boucle ForEach, {{item.name}}.
  3. Le nœud Lire fichier FTP lit le fichier (champ Path) et injecte son contenu dans context.file, utilisable via {{file}} dans les nœuds suivants ou dans un nœud Code.

Voir aussi​