ComposantsComponents › 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
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).
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).
"*.csv".
Give the Local directory (absolute path) and the Remote directory, then one row per mask in Files: "*.csv".
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.
PROPERTY) : Built-in ou une connexion FTP du Référentiel.Property Type (PROPERTY): Built-in or an FTP connection of the Repository.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.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").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."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").
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. |
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).
|
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:
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.
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.
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 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!.
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. |
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.
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).
Le code généré enveloppe le traitement de chaque ligne de Fichiers dans une boucle, et y place le composant relié en sortie. Les masques sont calculés avant la boucle, au début du composant. The generated code wraps the handling of each row of Files in a loop, and puts the component connected on the output inside it. The masks are computed before the loop, at the start of the component.
Trois lignes dans Fichiers : "*.csv", "*.txt", "*.xml" (aucun fichier XML), FTP. Le composant relié affiche NB_FILE, CURRENT_STATUS et CURRENT_FILE_EXISTS ; un tJava relié par On Subjob Ok affiche les deux premiers. Avec un lien Iterate :
Three rows in Files: "*.csv", "*.txt", "*.xml" (no XML file), FTP. The connected component prints NB_FILE, CURRENT_STATUS and CURRENT_FILE_EXISTS; a tJava connected with On Subjob Ok prints the first two. With an Iterate link:
Iterate: NB_FILE = null, CURRENT_STATUS = File rename OK., CURRENT_FILE_EXISTS = false Iterate: NB_FILE = null, CURRENT_STATUS = File rename OK., CURRENT_FILE_EXISTS = false Iterate: NB_FILE = null, CURRENT_STATUS = No file transfered., CURRENT_FILE_EXISTS = false No matches found for mask '*.xml'! After: NB_FILE = 3, CURRENT_STATUS = No file transfered.
Le lien Main a donné les mêmes trois passages : une ligne sans colonne par ligne de Fichiers, pas une par fichier envoyé (le composant n'a pas de schéma). NB_FILE n'existe qu'à la fin. Le message d'erreur s'est intercalé à cet endroit dans la console ; il est écrit pendant le traitement de la troisième ligne.
The Main link gave the same three passes: one row without columns per row of Files, not one per uploaded file (the component has no schema). NB_FILE only exists at the end. The error message was inserted at this place in the console; it is written while the third row is handled.
Deux lignes, colonne name : a.csv, notes.txt. Masque de fichier : (String) globalMap.get("row1.name"). Un tJava relié au tFTPPut par On Component Ok affiche NB_FILE et CURRENT_STATUS :
Two rows, name column: a.csv, notes.txt. Filemask: (String) globalMap.get("row1.name"). A tJava connected to the tFTPPut with On Component Ok prints NB_FILE and CURRENT_STATUS:
tFTPPut_1 NB_FILE = 1, CURRENT_STATUS = File rename OK. tFTPPut_1 NB_FILE = 1, CURRENT_STATUS = File rename OK.
Chaque itération ouvre sa propre connexion et envoie son fichier. Un lien Main direct, row1.name comme masque, ne marche pas : le masque est lu avant la première ligne, il vaut null, et le job s'arrête (file name invalid! à chaque ligne, puis Error during component operation!).
Each iteration opens its own connection and uploads its file. A direct Main link, row1.name as the mask, does not work: the mask is read before the first row, it is null, and the job stops (file name invalid! at each row, then Error during component operation!).
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"));
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.
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.
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.
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.
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).
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.
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.
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.
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.
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.
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.
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.
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.
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.
"" 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.
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).
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.
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:
tFTPGet · télécharge des fichiers du serveurdownloads files from the servertFTPConnection · ouvre une connexion partagée, et décrit ses réglagesopens a shared connection, and describes its settingstFTPClose · ferme la connexion partagéecloses the shared connectiontFTPFileList · liste les fichiers distants, pour vérifier l'envoilists the remote files, to check the uploadtFTPFileExist · vérifie qu'un fichier distant existechecks that a remote file existstFTPRename · renomme un fichier distantrenames a remote filetFTPDelete · supprime des fichiers distantsdeletes remote filestFileList · parcourt des dossiers locauxgoes through local folders