ComposantsComponents

ComposantsComponents › Internet › FTPInternet › FTP

tFTPPut

tFTPPut

Internet › FTPInternet › FTP

Envoie des fichiers d'un dossier local vers un serveur FTP, FTPS (FTP sur TLS) ou SFTP (transfert par SSH). Les fichiers sont choisis par des masques, peuvent changer de nom à l'arrivée, et un fichier déjà présent sur le serveur est gardé, remplacé ou complété selon le réglage. Le composant ouvre sa propre connexion, ou reprend celle d'un tFTPConnection. Pour l'opération inverse, prenez un tFTPGet. Uploads files from a local folder to an FTP, FTPS (FTP over TLS) or SFTP (transfer over SSH) server. The files are chosen with masks, can be renamed on arrival, and a file already on the server is kept, replaced or extended depending on the setting. The component opens its own connection, or takes over the one of a tFTPConnection. For the opposite operation, take a tFTPGet.

EntréeInput

Aucune : il commence un sous-job. Sinon Iterate (un envoi par itération) ; un lien Main est accepté mais ne fonctionne pas (voir Les liens). None: it starts a subjob. Otherwise Iterate (one upload per iteration); a Main link is accepted but does not work (see Links).

SortieOutput

Un lien Main ou Iterate : une ligne, ou une itération, par ligne de Fichiers, sans colonne. One Main or Iterate link: one row, or one iteration, per row of Files, without columns.

Déclencheurs en sortieOutput triggers

On Subjob Ok On Subjob Error On Component Ok On Component Error Run if

UtilisationUsage

Un envoi, puis la suiteAn upload, then the rest

OnSubjobOk tFTPPut_1 tJava_1

Le composant se connecte, envoie les fichiers et ferme sa connexion. La suite lit NB_FILE ; mais ce nombre compte aussi des fichiers qui n'ont pas été envoyés (voir Pièges). The component connects, uploads the files and closes its connection. The rest reads NB_FILE; but this number also counts files that were not uploaded (see Pitfalls).

Plusieurs opérations, une connexionSeveral operations, one connection

OnSubjobOk OnSubjobOk tFTPConnection_1 tFTPPut_1 tFTPClose_1

Utiliser une connexion existante coché : le tFTPPut reprend la connexion du tFTPConnection, et ne la ferme pas ; le tFTPClose s'en charge. Attention au répertoire courant qu'il laisse (voir l'exemple). Use an existing connection checked: the tFTPPut takes over the connection of the tFTPConnection, and does not close it; the tFTPClose does. Mind the current directory it leaves (see the example).

  1. Déposez le tFTPPut depuis la famille Internet › FTP de la palette. Drop the tFTPPut from the Internet › FTP family of the palette.
  2. Renseignez la connexion (hôte, port, utilisateur, mot de passe, et Support de SFTP ou Support de FTPS), ou cochez Utiliser une connexion existante. Fill in the connection (host, port, user, password, and SFTP Support or FTPS Support), or check Use an existing connection.
  3. Indiquez le Répertoire local (chemin absolu) et le Répertoire distant, puis une ligne par masque dans Fichiers : "*.csv". Give the Local directory (absolute path) and the Remote directory, then one row per mask in Files: "*.csv".
  4. En FTP et FTPS, passez le Mode de transfert à Binaire sauf pour des fichiers texte que le serveur doit convertir : le défaut ASCII modifie les fins de ligne (voir Le mode de transfert). With FTP and FTPS, set the Transfer mode to binary except for text files the server must convert: the default ascii changes the line ends (see The transfer mode).
  5. Choisissez ce qui arrive à un fichier déjà présent sur le serveur (Écraser le fichier, voir Fichier déjà présent). Choose what happens to a file already on the server (Overwrite file, see File already there).

Paramètres simplesBasic settings

La connexionThe connection

Sans connexion existante, le composant a les réglages de connexion du tFTPConnection, avec les mêmes défauts et le même code généré ; ils sont décrits sur sa page. Ils sont masqués quand Utiliser une connexion existante est coché. Without an existing connection, the component has the connection settings of the tFTPConnection, with the same defaults and the same generated code; they are described on its page. They are hidden when Use an existing connection is checked.

  • Type de propriété (PROPERTY) : Built-in ou une connexion FTP du Référentiel.Property Type (PROPERTY): Built-in or an FTP connection of the Repository.
  • Utiliser une connexion existante (USE_EXISTING_CONNECTION, non) et Liste des composants (CONNECTION) : un tFTPConnection du job.Use an existing connection (USE_EXISTING_CONNECTION, no) and Component list (CONNECTION): a tFTPConnection of the job.
  • Hôte (HOST, "localhost"), Port (PORT, 21 ; FTPS_PORT, 990 en FTPS), Utilisateur (USERNAME, "anonymous"), Mot de passe (PASSWORD, "suomynona").Host (HOST, "localhost"), Port (PORT, 21; FTPS_PORT, 990 with FTPS), Username (USERNAME, "anonymous"), Password (PASSWORD, "suomynona").
  • Support de SFTP (SFTP) ou Support de FTPS (FTPS), l'un excluant l'autre ; ni l'un ni l'autre : FTP.SFTP Support (SFTP) or FTPS Support (FTPS), each excluding the other; neither: FTP.
  • SFTP : Méthode d'authentification, Clé privée, Phrase secrète clé, Encodage du nom de fichier. FTPS : Fichier KeyStore, Mot de passe du KeyStore, Mode de sécurité (Implicite par défaut). FTP et FTPS : Mode de connexion (Passif), Encodage ("ISO-8859-15").SFTP: Authentication method, Private key, Key Passphrase, Filename encoding. FTPS: Keystore File, Keystore Password, Security Mode (Implicit by default). FTP and FTPS: Connection Mode (Passive), Encoding ("ISO-8859-15").
  • Onglet Paramètres avancés : proxy Socks, délai de connexion, analyse stricte des réponses, protection du canal de données FTPS, vérification distante, paramètres du client SFTP.Advanced settings tab: Socks proxy, connection timeout, strict reply parsing, FTPS data channel protection, remote verification, SFTP client parameters.

Deux différences avec le tFTPConnection : l'utilisateur et le mot de passe s'appellent ici USERNAME et PASSWORD (USER et PASS là-bas, défaut ""), et le composant a en plus Ignorer les erreurs à la fermeture (FTP), décrit plus bas. Two differences with the tFTPConnection: the user and the password are named USERNAME and PASSWORD here (USER and PASS there, default ""), and the component also has Ignore Failure At Quit (FTP), described below.

Les réglages du transfert, dans l'ordre de l'onglet Composant ; le nom technique, en gris, est celui du paramètre dans le fichier du job. « FTP », « FTPS », « SFTP » désignent le protocole du composant, ou celui du tFTPConnection choisi. The transfer settings, in the order of the Component tab; the technical name, in grey, is the parameter name in the job file. "FTP", "FTPS", "SFTP" mean the protocol of the component, or the one of the chosen tFTPConnection.

ParamètreSetting DéfautDefault VisibleShown Description
Répertoire localLocal directoryLOCALDIR "." ToujoursAlways Dossier de la machine du job où sont pris les fichiers. "." est le dossier de travail du processus du job, qui dépend de la façon dont il est lancé : écrivez un chemin absolu. Un dossier absent est traité comme un dossier où aucun fichier ne correspond (voir Erreurs). Folder of the job machine where the files are taken. "." is the working folder of the job process, which depends on how it is started: write an absolute path. A missing folder is handled like a folder where no file matches (see Errors).
Répertoire distantRemote directoryREMOTEDIR "." ToujoursAlways Dossier du serveur où vont les fichiers. Absolu ("/out") ou relatif au dossier courant de la connexion, en général le dossier de connexion du compte. Les \ sont changés en /. En SFTP, une valeur vide "" envoie à la racine / (le nom distant est construit comme dossier + "/" + nom). Folder of the server where the files go. Absolute ("/out") or relative to the current folder of the connection, usually the login folder of the account. \ are changed into /. With SFTP, an empty value "" uploads to the root / (the remote name is built as folder + "/" + name).
Créer le répertoire s'il n'existe pasCreate directory if not existsCREATE_DIR_IF_NOT_EXIST NonNo ToujoursAlways Crée le Répertoire distant et ses parents, un niveau après l'autre (commandes MKD en FTP, mkdir en SFTP). Décochée, un dossier absent arrête le job (voir Erreurs). Creates the Remote directory and its parents, one level after the other (MKD commands with FTP, mkdir with SFTP). Unchecked, a missing folder stops the job (see Errors).
Déplacer vers le répertoire courantMove to the current directoryMOVE_TO_THE_CURRENT_DIRECTORY OuiYes Connexion existante, pas en SFTPExisting connection, not SFTP Cochée : après le composant, la connexion partagée reste dans le Répertoire distant. Décochée : elle revient au dossier où elle était avant. Avec des répertoires relatifs, le composant suivant part donc d'ailleurs (voir l'exemple). En SFTP, le composant repart toujours du dossier de connexion du compte. Checked: after the component, the shared connection stays in the Remote directory. Unchecked: it goes back to the folder it was in before. With relative directories, the next component thus starts from somewhere else (see the example). With SFTP, the component always starts again from the login folder of the account.
Mode de transfertTransfer modeMODE ASCIIascii FTP et FTPSFTP and FTPS ASCII (TYPE A) : les fins de ligne sont converties, pour du texte. Binaire (TYPE I) : les octets arrivent tels quels. Le défaut ASCII abîme tout fichier qui n'est pas du texte. Voir Le mode de transfert. ascii (TYPE A): the line ends are converted, for text. binary (TYPE I): the bytes arrive as they are. The default ascii damages any file that is not text. See The transfer mode.
Écraser le fichierOverwrite fileOVERWRITE Jamaisnever FTP, Écrire à la suite de décochéFTP, Append unchecked Jamais, Toujours ou taille différente. Voir Fichier déjà présent. never, always or size different. See File already there.
Écrire à la suite deAppendAPPEND NonNo FTP Un fichier déjà présent est complété (APPE) au lieu d'être remplacé ; un nouveau est créé. Écraser le fichier est alors masqué et ignoré. A file already there is extended (APPE) instead of being replaced; a new one is created. Overwrite file is then hidden and ignored.
Écraser le fichierOverwrite fileSFTPOVERWRITE Écraseroverwrite SFTP Écraser, Reprendre ou Écrire à la suite de. Voir Fichier déjà présent. overwrite, resume or append. See File already there.
Écraser le fichierOverwrite fileFTPSOVERWRITE Toujoursalways FTPS Jamais ou Toujours, comme en FTP. Pas d'ajout ni de comparaison de taille en FTPS. Attention, le défaut n'est pas celui du FTP. never or always, as with FTP. No append or size comparison with FTPS. Mind that the default is not the FTP one.
Utiliser des Expressions Regex Perl5 en tant que masque de fichier (décocher signifie utiliser les Expressions globales)Use Perl5 Regex Expressions as Filemask (UnChecked means Glob Expressions)PERL5_REGEX NonNo ToujoursAlways Décochée : masques avec *, traduits de façon partielle. Cochée : expressions régulières Java. Voir Les masques. Unchecked: masks with *, partly translated. Checked: Java regular expressions. See The masks.
FichiersFilesFILES · FILEMASK, NEWNAME videempty ToujoursAlways Une ligne par masque : Masque de fichier (expression Java, "*.csv") et Nouveau nom ("" : le nom d'origine). Les lignes sont traitées dans l'ordre. Sans ligne, rien n'est envoyé, sans erreur. Voir Les masques. One row per mask: Filemask (Java expression, "*.csv") and New name ("": the original name). The rows are handled in order. Without a row, nothing is uploaded, without an error. See The masks.
Arrêter en cas d'erreurDie on errorDIE_ON_ERROR OuiYes ToujoursAlways Cochée : une erreur de transfert arrête le composant par une exception, et aussi le fait qu'aucun fichier n'ait été traité alors que Fichiers a des lignes. Décochée : le message est écrit sur la sortie d'erreur et le job continue. La connexion, le mot de passe et un répertoire distant absent (FTP, FTPS) arrêtent le job dans les deux cas. Checked: a transfer error stops the component with an exception, and so does the fact that no file was handled while Files has rows. Unchecked: the message is written to the error output and the job goes on. The connection, the password and a missing remote directory (FTP, FTPS) stop the job in both cases.

Paramètres avancésAdvanced settings

Les réglages de connexion de cet onglet sont ceux du tFTPConnection (voir La connexion). En plus : The connection settings of this tab are those of the tFTPConnection (see The connection). In addition:

ParamètreSetting DéfautDefault VisibleShown Description
Ignorer les erreurs à la fermeture (FTP)Ignore Failure At Quit (FTP)IGNORE_FAILURE_AT_QUIT NonNo FTP Une erreur d'entrée-sortie pendant la déconnexion (QUIT), une fois les fichiers envoyés, est rangée dans ERROR_MESSAGE au lieu d'arrêter le job. Sans effet avec une connexion existante, que le composant ne ferme pas. An input-output error during the disconnection (QUIT), once the files are uploaded, is stored in ERROR_MESSAGE instead of stopping the job. No effect with an existing connection, which the component does not close.
Renommer après chargement/à distanceRename after upload/on remoteRENAME_AFTER NonNo ToujoursAlways Avec un Nouveau nom : le fichier est d'abord envoyé sous son nom, puis renommé sur le serveur (RNFR/RNTO, rename en SFTP). Un programme qui surveille le dossier distant ne voit le nouveau nom qu'une fois le fichier complet. Un fichier qui porte déjà le nouveau nom est d'abord supprimé, sauf avec Jamais (FTP, FTPS) ou Écrire à la suite de (SFTP) ; avec Jamais, notre serveur d'essai a refusé le renommage (550 customers.csv: File exists.) et le job s'est arrêté, le fichier restant sous son nom d'origine. En SFTP, le renommage utilise le masque comme nom : il ne marche qu'avec un nom de fichier exact (voir Erreurs). With a New name: the file is first uploaded under its own name, then renamed on the server (RNFR/RNTO, rename with SFTP). A program that watches the remote folder only sees the new name once the file is complete. A file that already has the new name is deleted first, except with never (FTP, FTPS) or append (SFTP); with never, our test server refused the renaming (550 customers.csv: File exists.) and the job stopped, the file keeping its original name. With SFTP, the renaming uses the mask as the name: it only works with an exact file name (see Errors).

Les masquesThe masks

Chaque ligne de Fichiers retient les fichiers du Répertoire local dont le nom correspond au masque ; les dossiers sont ignorés, ce qui est dans les sous-dossiers n'est pas envoyé. Ce qui est lu dans le code généré, puis vérifié lors de nos essais : Each row of Files keeps the files of the Local directory whose name matches the mask; folders are ignored, what is in subfolders is not uploaded. What is read in the generated code, then checked in our runs:

Case décochée : un « glob » incompletBox unchecked: an incomplete "glob"

Le masque est changé en expression régulière en remplaçant seulement . par \. et * par .* ; le reste garde son sens d'expression régulière, et le nom entier doit correspondre, casse comprise : The mask is turned into a regular expression by only replacing . with \. and * with .*; the rest keeps its regular expression meaning, and the whole name must match, case included:

  • "*.csv" : a.csv, b.csv ; pas A.CSV, même sous Windows."*.csv": a.csv, b.csv; not A.CSV, even on Windows.
  • "[ab].csv" : a.csv, b.csv (classe de caractères)."[ab].csv": a.csv, b.csv (character class).
  • "?.csv" : erreur PatternSyntaxException, le ? n'est pas traduit."?.csv": PatternSyntaxException error, the ? is not translated.
  • "report(1).csv" : ne trouve pas report(1).csv, les parenthèses forment un groupe."report(1).csv": does not find report(1).csv, the parentheses form a group.

Case cochée : expressions régulièresBox checked: regular expressions

Le masque est une expression régulière Java (et non Perl 5, malgré le libellé), qui doit couvrir tout le nom, casse comprise. Dans la chaîne Java, doublez les \ : The mask is a Java regular expression (not Perl 5, despite the label), which must cover the whole name, case included. In the Java string, double the \:

"[ab]\\.csv|notes\\..*"

a retenu a.csv, b.csv et notes.txt. Une expression qui contient / est quand même coupée au dernier / (voir ci-dessous) : n'en mettez pas, sauf pour désigner un sous-dossier. kept a.csv, b.csv and notes.txt. An expression that contains / is still cut at the last / (see below): do not put one, except to point to a subfolder.

Un sous-dossier dans le masqueA subfolder in the mask

Ce qui précède le dernier / (ou \, case décochée) est un sous-dossier du Répertoire local : "sub/*.csv" envoie sub/c.csv. Le fichier arrive directement dans le Répertoire distant, sous le nom c.csv : le sous-dossier n'est pas recréé sur le serveur. What comes before the last / (or \, box unchecked) is a subfolder of the Local directory: "sub/*.csv" uploads sub/c.csv. The file goes straight into the Remote directory, named c.csv: the subfolder is not created again on the server.

Le nouveau nomThe new name

Le Nouveau nom d'une ligne s'applique à tous les fichiers de son masque. Avec "*.csv" et "all.csv", a.csv a été envoyé sous le nom all.csv, puis b.csv a été écarté avec Jamais, ou a remplacé a.csv avec Toujours. Réservez-le à un masque qui désigne un seul fichier. Une ligne sans masque ("") écrit file name invalid!. The New name of a row applies to all the files of its mask. With "*.csv" and "all.csv", a.csv was uploaded as all.csv, then b.csv was skipped with never, or replaced a.csv with always. Keep it for a mask that points to a single file. A row without a mask ("") writes file name invalid!.

Fichier déjà présentFile already there

Ce que fait chaque choix, d'après les commandes reçues par nos serveurs d'essai. En FTP et FTPS, le composant liste d'abord le dossier distant (NLST) pour savoir quels noms existent déjà. What each choice does, from the commands received by our test servers. With FTP and FTPS, the component first lists the remote folder (NLST) to know which names already exist.

ChoixChoice Fichier distant déjà làRemote file already there Lors de nos essaisIn our runs
Jamais (FTP, FTPS)never (FTP, FTPS) Rien n'est envoyé pour ce fichier.Nothing is uploaded for this file. Fichier distant intact, mais compté dans NB_FILE et annoncé « upload successfully » dans TRANSFER_MESSAGES (exemple).Remote file untouched, but counted in NB_FILE and announced "upload successfully" in TRANSFER_MESSAGES (example).
Toujours (FTP, FTPS)always (FTP, FTPS) Supprimé (DELE), puis envoyé (STOR).Deleted (DELE), then uploaded (STOR). Remplacé. Pendant un court instant, le fichier n'existe plus sur le serveur.Replaced. For a short moment, the file no longer exists on the server.
taille différente (FTP)size different (FTP) Taille lue (LIST) ; si elle diffère, le fichier est supprimé. Il est envoyé dans tous les cas.Size read (LIST); if it differs, the file is deleted. It is uploaded in all cases. Un fichier de même taille a été renvoyé et remplacé : le choix se comporte comme Toujours (exemple).A file of the same size was uploaded again and replaced: the choice behaves like always (example).
Écrire à la suite de coché (FTP)Append checked (FTP) Complété (APPE).Extended (APPE). 15 + 14 octets : 29 octets, les deux contenus à la suite.15 + 14 bytes: 29 bytes, both contents one after the other.
Écraser (SFTP)overwrite (SFTP) Ouvert en écriture et vidé, puis écrit.Opened for writing and emptied, then written. Remplacé.Replaced.
Écrire à la suite de (SFTP)append (SFTP) Complété.Extended. 29 octets, comme en FTP.29 bytes, as with FTP.
Reprendre (SFTP)resume (SFTP) Seule la fin manquante est envoyée, à partir de la taille du fichier distant.Only the missing end is uploaded, from the size of the remote file. Distant de 8 octets, local de 14 : 6 octets écrits, fichier complet. Distant plus long que le local : erreur 4: failed to resume for … (exemple). Le contenu déjà présent n'est pas comparé.Remote of 8 bytes, local of 14: 6 bytes written, file complete. Remote longer than the local one: 4: failed to resume for … error (example). The content already there is not compared.

Le mode de transfertThe transfer mode

En FTP et FTPS, la connexion passe d'abord en binaire (TYPE I), puis le composant applique le Mode de transfert (TYPE A pour ASCII). En mode ASCII, le client convertit chaque fin de ligne LF en CRLF, la forme réseau ; c'est au serveur de la ramener à la sienne. Deux fichiers envoyés : lines.txt (texte, 14 octets, fins de ligne LF) et image.png (11 octets, qui contiennent les octets 0D 0A et 0A). Taille reçue par le serveur, puis taille du fichier enregistré : With FTP and FTPS, the connection first switches to binary (TYPE I), then the component applies the Transfer mode (TYPE A for ascii). In ascii mode, the client converts each LF line end to CRLF, the network form; the server has to bring it back to its own. Two files uploaded: lines.txt (text, 14 bytes, LF line ends) and image.png (11 bytes, which contain the bytes 0D 0A and 0A). Size received by the server, then size of the stored file:

Mode, serveurMode, server lines.txt (14) image.png (11)
ASCII, serveur qui enregistre tel quelascii, server that stores as is 17 reçus, 17 enregistrés (CRLF)17 received, 17 stored (CRLF) 13 reçus, 13 enregistrés : abîmé13 received, 13 stored: damaged
ASCII, serveur qui convertit (comme ProFTPD)ascii, server that converts (like ProFTPD) 17 reçus, 14 enregistrés (LF)17 received, 14 stored (LF) 13 reçus, 10 enregistrés : abîmé13 received, 10 stored: damaged
Binaire, l'un ou l'autrebinary, either one 14, identique14, identical 11, identique11, identical

Extrait du journal du serveur d'essai sans conversion (commandes reçues >, réponses <) : Excerpt of the log of the test server without conversion (commands received >, replies <):

> TYPE I
< 200 Type set to I.
> TYPE A
< 200 Type set to A.
…
> STOR image.png
< 150 Ok to send data (ASCII).
received 13 bytes
< 226 Transfer complete.
> STOR lines.txt
< 150 Ok to send data (ASCII).
received 17 bytes
< 226 Transfer complete.

Le mode ASCII ne convient qu'à du texte dont le serveur doit adapter les fins de ligne ; dans le doute, choisissez Binaire. En SFTP, il n'y a pas de mode : les fichiers arrivent toujours tels quels. The ascii mode only suits text whose line ends the server must adapt; when in doubt, choose binary. With SFTP, there is no mode: files always arrive as they are.

Variables globalesGlobal variables

NB_FILE et TRANSFER_MESSAGES sont disponibles après le composant ; CURRENT_STATUS et CURRENT_FILE_EXISTS aussi pendant, à chaque ligne de Fichiers (liens Main ou Iterate). Leurs valeurs dépendent du protocole : NB_FILE and TRANSFER_MESSAGES are available after the component; CURRENT_STATUS and CURRENT_FILE_EXISTS also during it, at each row of Files (Main or Iterate links). Their values depend on the protocol:

VariableVariable FTP FTPS SFTP
NB_FILE
Integer
Fichiers retenus par les masques, envoyés ou non : un fichier écarté par Jamais, ou refusé par le serveur quand Arrêter en cas d'erreur est décoché, compte.Files kept by the masks, uploaded or not: a file skipped by never, or refused by the server when Die on error is unchecked, counts. Fichiers envoyés, plus ceux en échec quand Arrêter en cas d'erreur est décoché.Files uploaded, plus the failed ones when Die on error is unchecked.
CURRENT_STATUS
String
File rename OK. après une ligne qui a traité un fichier, même sans renommage ; No file transfered. sinon ; File rename fail. sur une erreur d'entrée-sortie.File rename OK. after a row that handled a file, even without renaming; No file transfered. otherwise; File rename fail. on an input-output error. Toujours No file transfered. à la fin d'une ligne, même après un envoi réussi ou un renommage.Always No file transfered. at the end of a row, even after a successful upload or a renaming. File transfer OK., File transfer fail., No file transfered. ; File rename OK. ou File rename fail. avec le renommage.File transfer OK., File transfer fail., No file transfered.; File rename OK. or File rename fail. with the renaming.
CURRENT_FILE_EXISTS
Boolean
Le nom de destination du dernier fichier traité existait avant l'envoi (d'après le NLST).The destination name of the last file handled existed before the upload (from the NLST). Le fichier distant existe après l'envoi : true dès qu'un fichier est passé.The remote file exists after the upload: true as soon as a file went through.
TRANSFER_MESSAGES
String
Une ligne par fichier traité, file: <chemin local>, size: N bytes upload successfully, puis N files have been uploaded.One line per file handled, file: <local path>, size: N bytes upload successfully, then N files have been uploaded. null De même, pour les fichiers envoyés.The same, for the uploaded files.
((Integer) globalMap.get("tFTPPut_1_NB_FILE"))
((String) globalMap.get("tFTPPut_1_CURRENT_STATUS"))
((Boolean) globalMap.get("tFTPPut_1_CURRENT_FILE_EXISTS"))
((String) globalMap.get("tFTPPut_1_TRANSFER_MESSAGES"))

CURRENT_STATUS repart de No file transfered. à chaque ligne de Fichiers : après le composant, il ne décrit que la dernière ligne. CURRENT_FILE_EXISTS reste null si aucun fichier n'a été retenu. Sur une erreur, le message est aussi dans tFTPPut_1_ERROR_MESSAGE, comme pour tout composant. Aucune de ces valeurs ne dit de façon sûre que tous les fichiers sont arrivés : pour le vérifier, listez le dossier distant ensuite (tFTPFileList, tFTPFileExist). CURRENT_STATUS starts again from No file transfered. at each row of Files: after the component, it only describes the last row. CURRENT_FILE_EXISTS stays null when no file was kept. On an error, the message is also in tFTPPut_1_ERROR_MESSAGE, as for any component. None of these values reliably says that all the files arrived: to check it, list the remote folder afterwards (tFTPFileList, tFTPFileExist).

ExemplesExamples

Les sorties sont copiées depuis des exécutions du job (lancé depuis Talaxie, Java 21) contre des serveurs d'essai installés sur le poste : un serveur FTP et FTPS qui répond comme un serveur Unix, et un serveur SFTP (sous-système sftp-server d'OpenSSH). Le Répertoire local, raccourci ici en C:/work/put comme les chemins des sorties, contient a.csv (14 octets), b.csv (16), notes.txt (8) et sub/c.csv (16) ; le Répertoire distant est "/out", vide au départ ; Mode de transfert : Binaire. Les journaux des serveurs sont des extraits (commandes reçues >, réponses <). Le tJava relié par On Subjob Ok est, sauf mention contraire : The outputs are copied from runs of the job (started from Talaxie, Java 21) against test servers installed on the machine: an FTP and FTPS server that answers like a Unix server, and an SFTP server (sftp-server subsystem of OpenSSH). The Local directory, shortened here to C:/work/put like the paths in the outputs, holds a.csv (14 bytes), b.csv (16), notes.txt (8) and sub/c.csv (16); the Remote directory is "/out", empty at the start; Transfer mode: binary. The server logs are excerpts (commands received >, replies <). The tJava connected with On Subjob Ok is, unless stated otherwise:

System.out.println("NB_FILE = " + globalMap.get("tFTPPut_1_NB_FILE"));
System.out.println("CURRENT_STATUS = " + globalMap.get("tFTPPut_1_CURRENT_STATUS"));
System.out.println("CURRENT_FILE_EXISTS = " + globalMap.get("tFTPPut_1_CURRENT_FILE_EXISTS"));
System.out.println("TRANSFER_MESSAGES = [" + globalMap.get("tFTPPut_1_TRANSFER_MESSAGES") + "]");
System.out.println("ERROR_MESSAGE = " + globalMap.get("tFTPPut_1_ERROR_MESSAGE"));

FTP : les fichiers CSV d'un dossierFTP: the CSV files of a folder

Fichiers : "*.csv", Nouveau nom "". Files: "*.csv", New name "".

NB_FILE = 2
CURRENT_STATUS = File rename OK.
CURRENT_FILE_EXISTS = false
TRANSFER_MESSAGES = [file: C:\work\put\a.csv, size: 14 bytes upload successfully
file: C:\work\put\b.csv, size: 16 bytes upload successfully
2 files have been uploaded.
]
ERROR_MESSAGE = null

Journal du serveur : Server log:

> TYPE I
< 200 Type set to I.
> TYPE I
< 200 Type set to I.
> PWD
< 257 "/" is the current directory.
> CWD /out
< 250 Directory successfully changed.
> PASV
< 227 Entering Passive Mode (127,0,0,1,202,199).
> NLST
…
> STOR a.csv
< 150 Ok to send data (BINARY).
received 14 bytes
< 226 Transfer complete.
…
> STOR b.csv
…
> QUIT

CURRENT_STATUS dit File rename OK. alors qu'aucun fichier n'a été renommé : c'est le texte que le composant range après tout envoi FTP. CURRENT_STATUS says File rename OK. although no file was renamed: it is the text the component stores after any FTP upload.

Fichier déjà présent, JamaisFile already there, never

Le même job ; le serveur a déjà un /out/a.csv de 15 octets. Écraser le fichier : Jamais (défaut). The same job; the server already has a 15-byte /out/a.csv. Overwrite file: never (default).

NB_FILE = 2
CURRENT_STATUS = File rename OK.
CURRENT_FILE_EXISTS = false
TRANSFER_MESSAGES = [file: C:\work\put\a.csv, size: 14 bytes upload successfully
file: C:\work\put\b.csv, size: 16 bytes upload successfully
2 files have been uploaded.
]
ERROR_MESSAGE = null

Le journal du serveur montre qu'un seul fichier est parti : The server log shows that a single file went:

> NLST
…
> STOR b.csv
< 150 Ok to send data (BINARY).
received 16 bytes
< 226 Transfer complete.

a.csv est resté tel quel (15 octets), comme voulu ; mais rien dans les variables ne le dit. CURRENT_FILE_EXISTS ne décrit que le dernier fichier, b.csv. a.csv stayed as it was (15 bytes), as wanted; but nothing in the variables says so. CURRENT_FILE_EXISTS only describes the last file, b.csv.

taille différentesize different

Le serveur a déjà a.csv de la même taille (14 octets, autre contenu) et b.csv de 6 octets. Journal du serveur : The server already has a.csv of the same size (14 bytes, other content) and a 6-byte b.csv. Server log:

> NLST
…
> SYST
< 215 UNIX Type: L8
> LIST a.csv
…
> STOR a.csv
…
received 14 bytes
< 226 Transfer complete.
> LIST b.csv
…
> DELE b.csv
< 250 Delete operation successful.
> STOR b.csv
…
received 16 bytes
< 226 Transfer complete.

a.csv, de même taille, a quand même été renvoyé et son contenu remplacé. Seule la suppression préalable dépend de la taille. a.csv, of the same size, was still uploaded again and its content replaced. Only the prior deletion depends on the size.

Nouveau nom, renommé après chargementNew name, renamed after upload

Fichiers : "a.csv", Nouveau nom "customers.csv". Sans Renommer après chargement, le serveur reçoit directement STOR customers.csv. Avec : Files: "a.csv", New name "customers.csv". Without Rename after upload, the server directly receives STOR customers.csv. With it:

> NLST
…
> STOR a.csv
…
received 14 bytes
< 226 Transfer complete.
> RNFR a.csv
< 350 Ready for RNTO.
> RNTO customers.csv
< 250 Rename successful.

En SFTP, même résultat (posix-rename de /out/a.csv en /out/customers.csv), précédé d'une suppression de /out/customers.csv. With SFTP, same result (posix-rename of /out/a.csv to /out/customers.csv), preceded by a deletion of /out/customers.csv.

Créer le répertoire distantCreate the remote directory

Répertoire distant : "/out/2026/11", absent ; Créer le répertoire s'il n'existe pas coché. Journal du serveur : Remote directory: "/out/2026/11", missing; Create directory if not exists checked. Server log:

> CWD /out/2026/11
< 550 /out/2026/11: No such directory.
> CWD /
< 250 Directory successfully changed.
> MKD out
< 550 out: File exists.
> CWD out
< 250 Directory successfully changed.
> MKD 2026
< 257 "/out/2026" created.
> CWD 2026
< 250 Directory successfully changed.
> MKD 11
< 257 "/out/2026/11" created.
> CWD 11
< 250 Directory successfully changed.
> CWD /
< 250 Directory successfully changed.
> CWD /out/2026/11
< 250 Directory successfully changed.

L'échec de MKD sur un dossier qui existe est sans conséquence. En SFTP, les deux dossiers manquants ont été créés de même (mkdir). The failure of MKD on a folder that exists has no consequence. With SFTP, the two missing folders were created the same way (mkdir).

FTPS expliciteExplicit FTPS

Le premier exemple avec Support de FTPS, Mode de sécurité Explicite et un Fichier KeyStore qui contient le certificat du serveur (voir tFTPConnection). The first example with FTPS Support, Security Mode Explicit and a Keystore File that holds the certificate of the server (see tFTPConnection).

NB_FILE = 2
CURRENT_STATUS = No file transfered.
CURRENT_FILE_EXISTS = false
TRANSFER_MESSAGES = [null]
ERROR_MESSAGE = null

Journal du serveur : Server log:

> AUTH TLS
< 234 Proceed with negotiation.
> USER demo
…
> TYPE I
< 200 Type set to I.
> PBSZ 0
< 200 PBSZ=0
> PROT P
< 200 Protection level set to P.
> TYPE I
…
> STOR a.csv
…
> STOR b.csv

Les deux fichiers sont arrivés, mais CURRENT_STATUS dit le contraire et TRANSFER_MESSAGES est vide : en FTPS, seul NB_FILE renseigne. En FTPS implicite, même sortie ; la session commence directement en TLS, sans AUTH TLS. Both files arrived, but CURRENT_STATUS says the opposite and TRANSFER_MESSAGES is empty: with FTPS, only NB_FILE tells something. With implicit FTPS, same output; the session starts directly in TLS, without AUTH TLS.

SFTP

Le premier exemple avec Support de SFTP, Méthode d'authentification Mot de passe, Écraser le fichier Écraser. The first example with SFTP Support, Authentication method Password, Overwrite file overwrite.

NB_FILE = 2
CURRENT_STATUS = File transfer OK.
CURRENT_FILE_EXISTS = true
TRANSFER_MESSAGES = [file: C:\work\put\a.csv, size: 14 bytes upload successfully
file: C:\work\put\b.csv, size: 16 bytes upload successfully
2 files have been uploaded.
]
ERROR_MESSAGE = null

Journal du serveur SFTP : SFTP server log:

sftp-server: open "/out/a.csv" flags WRITE,CREATE,TRUNCATE mode 0666
sftp-server: close "/out/a.csv" bytes read 0 written 14
sftp-server: open "/out/b.csv" flags WRITE,CREATE,TRUNCATE mode 0666
sftp-server: close "/out/b.csv" bytes read 0 written 16

En SFTP, CURRENT_FILE_EXISTS vaut true parce que le fichier existe après l'envoi. Avec Écrire à la suite de, le fichier est ouvert sans TRUNCATE. With SFTP, CURRENT_FILE_EXISTS is true because the file exists after the upload. With append, the file is opened without TRUNCATE.

SFTP, ReprendreSFTP, resume

Sur le serveur : a.csv interrompu (ses 8 premiers octets) et b.csv de 22 octets, plus long que le fichier local. Nom du job remplacé par MyJob, pile abrégée : On the server: an interrupted a.csv (its first 8 bytes) and a 22-byte b.csv, longer than the local file. Job name replaced with MyJob, shortened stack:

Exception in component tFTPPut_1 (MyJob)
4: failed to resume for /out/b.csv
	at com.jcraft.jsch.ChannelSftp.put(ChannelSftp.java:439)
	at demo.myjob_0_1.MyJob.tFTPPut_1Process(MyJob.java:645)
	…

Journal du serveur SFTP : SFTP server log:

sftp-server: open "/out/a.csv" flags WRITE,CREATE mode 0666
sftp-server: close "/out/a.csv" bytes read 0 written 6

a.csv a reçu ses 6 derniers octets et est complet ; le job s'est arrêté sur b.csv, laissé tel quel. a.csv received its last 6 bytes and is complete; the job stopped on b.csv, left as it was.

Connexion existante et répertoire relatifExisting connection and relative directory

OnSubjobOk OnSubjobOk tFTPConnection_1 tFTPPut_1 tFTPPut_2

FTP, connexion ouverte dans /. Les deux tFTPPut ont Utiliser une connexion existante coché, le même Répertoire distant relatif "out", et envoient a.csv puis b.csv. Avec Déplacer vers le répertoire courant coché (défaut) : FTP, connection opened in /. Both tFTPPut have Use an existing connection checked, the same relative Remote directory "out", and upload a.csv then b.csv. With Move to the current directory checked (default):

Exception in component tFTPPut_2 (MyJob)
java.lang.RuntimeException: Failed to change remote directory. 550 out: No such directory.

	at demo.myjob_0_1.MyJob.tFTPPut_2Process(MyJob.java:1065)
	…

Le journal du serveur montre pourquoi : après le premier envoi, la connexion est restée dans /out, et le second composant y a cherché out. The server log shows why: after the first upload, the connection stayed in /out, and the second component looked for out there.

> PWD
< 257 "/" is the current directory.
> CWD out
< 250 Directory successfully changed.
…
> STOR a.csv
…
> PWD
< 257 "/out" is the current directory.
> CWD out
< 550 out: No such directory.

Case décochée, chaque tFTPPut revient ensuite à / (CWD /) et les deux fichiers arrivent dans /out. Avec des Répertoires distants absolus ("/out"), la case n'a pas d'importance. Box unchecked, each tFTPPut then goes back to / (CWD /) and both files arrive in /out. With absolute Remote directories ("/out"), the box does not matter.

ErreursErrors

Messages relevés dans la console (première ligne de l'exception, ou message écrit sur la sortie d'erreur). Une exception arrête le job avec le code 1, sauf si un lien On Component Error ou On Subjob Error la reprend. Messages seen in the console (first line of the exception, or message written to the error output). An exception stops the job with code 1, unless an On Component Error or On Subjob Error link takes it over.

CasCase Message Arrêter en cas d'erreur décochéDie on error unchecked
Répertoire distant absent (FTP, FTPS)Missing remote directory (FTP, FTPS) java.lang.RuntimeException: Failed to change remote directory. 550 /out/2026/11: No such directory. Le job s'arrête quand même.The job stops anyway.
Répertoire distant absent (SFTP)Missing remote directory (SFTP) 2: No such file File permission denied: /out/2026/11/a.csv pour chaque fichier, le job continue ; NB_FILE les compte, TRANSFER_MESSAGES dit 2 files have been uploaded.File permission denied: /out/2026/11/a.csv for each file, the job goes on; NB_FILE counts them, TRANSFER_MESSAGES says 2 files have been uploaded.
Aucun fichier ne correspond (masque, dossier local absent)No file matches (mask, missing local folder) No matches found for mask '*.xml'! puis, si aucune ligne de Fichiers n'a rien donné, java.lang.RuntimeException: Error during component operation!No matches found for mask '*.xml'! then, when no row of Files gave anything, java.lang.RuntimeException: Error during component operation! Seul le premier message ; NB_FILE = 0.Only the first message; NB_FILE = 0.
Ligne de Fichiers sans masqueRow of Files without a mask file name invalid!, puis la même exception s'il n'y a pas d'autre fichier.file name invalid!, then the same exception when there is no other file. Seul le premier message.Only the first message.
Envoi refusé par le serveur (FTP, réponse 5xx)Upload refused by the server (FTP, 5xx reply) java.lang.RuntimeException: FTP operation failed, message: 550 Permission denied. Le message pour chaque fichier, le job continue ; NB_FILE, CURRENT_STATUS (File rename OK.) et TRANSFER_MESSAGES (« upload successfully ») annoncent pourtant un succès.The message for each file, the job goes on; NB_FILE, CURRENT_STATUS (File rename OK.) and TRANSFER_MESSAGES ("upload successfully") still announce a success.
Mot de passe refusé (FTP)Password rejected (FTP) java.lang.RuntimeException: Login failed Le job s'arrête quand même.The job stops anyway.
Masque glob avec ?Glob mask with ? java.util.regex.PatternSyntaxException: Dangling meta character '?' near index 0 Le message sur la sortie d'erreur, puis les lignes suivantes de Fichiers sont traitées ; TRANSFER_MESSAGES contient file not found?: Dangling meta character '?' ….The message on the error output, then the next rows of Files are handled; TRANSFER_MESSAGES contains file not found?: Dangling meta character '?' ….
Reprendre, fichier distant plus long (SFTP)resume, longer remote file (SFTP) 4: failed to resume for /out/b.csv File permission denied: /out/b.csv, le job continue.File permission denied: /out/b.csv, the job goes on.
Renommer après chargement avec un masque "*.csv" (SFTP)Rename after upload with a "*.csv" mask (SFTP) 4: /out/*.csv is not unique: [/out/a.csv, /out/b.csv] Le message, puis les lignes suivantes. Dans les deux cas, les fichiers sont envoyés sous leur nom, pas renommés.The message, then the next rows. In both cases, the files are uploaded under their name, not renamed.

Les messages No matches found…, file name invalid! et File permission denied… vont sur la sortie d'erreur du job, sans arrêter le composant. Dans la ligne Reprendre, le texte File permission denied est celui que le composant écrit pour toute erreur SFTP, quelle qu'en soit la cause. La connexion elle-même (hôte, port, certificat, clé) est traitée sur la page du tFTPConnection. The No matches found…, file name invalid! and File permission denied… messages go to the error output of the job, without stopping the component. In the resume row, the File permission denied text is the one the component writes for any SFTP error, whatever the cause. The connection itself (host, port, certificate, key) is dealt with on the tFTPConnection page.

PiègesPitfalls

Le mode ASCII par défautThe default ascii mode

En FTP et en FTPS, le Mode de transfert vaut ASCII au dépôt du composant : une image, une archive, un PDF arrivent abîmés, sans aucune erreur, et même un CSV peut changer de taille selon le serveur (voir Le mode de transfert). Passez-le à Binaire. With FTP and FTPS, the Transfer mode is ascii when the component is dropped: an image, an archive, a PDF arrive damaged, without any error, and even a CSV can change size depending on the server (see The transfer mode). Set it to binary.

Les compteurs annoncent des fichiers non envoyésThe counters announce files not uploaded

En FTP et FTPS, NB_FILE et TRANSFER_MESSAGES comptent chaque fichier retenu par un masque : écarté par Jamais, ou refusé par le serveur quand Arrêter en cas d'erreur est décoché, il est quand même compté et dit « upload successfully ». En SFTP, de même pour un fichier en échec, case décochée. Ne déduisez pas d'un NB_FILE positif que les fichiers sont arrivés. With FTP and FTPS, NB_FILE and TRANSFER_MESSAGES count each file kept by a mask: skipped by never, or refused by the server when Die on error is unchecked, it is still counted and says "upload successfully". With SFTP, the same for a failed file, box unchecked. Do not infer from a positive NB_FILE that the files arrived.

taille différente renvoie toutsize different uploads everything

Le choix ne sert qu'à supprimer d'abord un fichier de taille différente ; un fichier de même taille est renvoyé et remplacé lui aussi (exemple). Pour ne pas renvoyer un fichier déjà là, prenez Jamais. The choice only deletes first a file of a different size; a file of the same size is uploaded again and replaced too (example). To avoid uploading again a file already there, take never.

Des masques glob qui n'en sont pasGlob masks that are not quite globs

Case décochée, seuls * et . sont traduits : ? provoque une erreur, des parenthèses ou un + dans un nom de fichier l'empêchent d'être trouvé, et la casse compte. Le tFTPGet traduit ces masques correctement (la casse y compte aussi). Pour un nom à caractères spéciaux, cochez la case et échappez-les : "report\\(1\\)\\.csv" a bien envoyé report(1).csv. Box unchecked, only * and . are translated: ? causes an error, parentheses or a + in a file name prevent it from being found, and case matters. The tFTPGet translates these masks correctly (case matters there too). For a name with special characters, check the box and escape them: "report\\(1\\)\\.csv" did upload report(1).csv.

CURRENT_STATUS peu fiableUnreliable CURRENT_STATUS

En FTP, il dit File rename OK. après tout envoi ; en FTPS, No file transfered. même quand les fichiers sont partis ; partout, il ne décrit que la dernière ligne de Fichiers. Testez plutôt l'absence d'erreur (On Subjob Ok, Arrêter en cas d'erreur coché) et vérifiez le dossier distant. With FTP, it says File rename OK. after any upload; with FTPS, No file transfered. even when the files went; everywhere, it only describes the last row of Files. Rather test the absence of error (On Subjob Ok, Die on error checked) and check the remote folder.

Un répertoire distant vide en SFTPAn empty remote directory with SFTP

"" ne désigne pas le dossier courant : le fichier est écrit à la racine du serveur (/notes.txt lors de nos essais). Laissez "." pour le dossier de connexion du compte. "" does not mean the current folder: the file is written at the root of the server (/notes.txt in our runs). Keep "." for the login folder of the account.

Les sous-dossiers ne sont pas envoyésSubfolders are not uploaded

Même avec "*", seuls les fichiers du Répertoire local partent. Pour une arborescence, une ligne par sous-dossier ("sub/*") dépose ses fichiers à plat dans le Répertoire distant ; pour la recréer, un tFTPPut par dossier, avec un Répertoire distant et Créer le répertoire à chaque fois (par exemple dans une boucle tFileList). Even with "*", only the files of the Local directory go. For a tree, one row per subfolder ("sub/*") drops its files flat in the Remote directory; to rebuild it, one tFTPPut per folder, with a Remote directory and Create directory each time (for example in a tFileList loop).

Arrêter en cas d'erreur décoché ne suffit pasDie on error unchecked is not enough

La connexion, le mot de passe et un répertoire distant absent en FTP ou FTPS arrêtent le job dans tous les cas : ils sont traités avant les fichiers. Pour continuer malgré eux, reliez le composant à la suite par On Subjob Error ou On Component Error. Inversement, case décochée, une erreur sur un fichier n'est visible que sur la sortie d'erreur et dans ERROR_MESSAGE. The connection, the password and a missing remote directory with FTP or FTPS stop the job in all cases: they are handled before the files. To go on despite them, connect the component to the rest with On Subjob Error or On Component Error. Conversely, box unchecked, an error on a file is only visible on the error output and in ERROR_MESSAGE.

Voir aussiSee also

Les autres composants de la famille Internet › FTP, et ceux qui servent avec le tFTPPut : The other components of the Internet › FTP family, and those used with the tFTPPut: