ComposantsComponents › Internet › FTP
Vérifie si un fichier ou un répertoire existe sur un serveur FTP, FTPS ou SFTP, et range la réponse dans la variable globale EXISTS, à tester dans un Run if. Une entrée absente n'est pas une erreur. C'est le pendant distant de tFileExist, mais la vérification n'est pas la même en FTP et en SFTP : la casse, le type de l'entrée et les chemins n'y sont pas traités de la même façon (voir Comment il vérifie).
Checks if a file or a directory exists on an FTP, FTPS or SFTP server, and stores the answer in the EXISTS global variable, to test in a Run if. A missing entry is not an error. It is the remote counterpart of tFileExist, but the check is not the same in FTP and in SFTP: case, the type of the entry and paths are not handled the same way (see How it checks).
EntréeInput
Aucune : il commence son sous-job. Sinon un lien Main (une vérification par ligne, le nom peut venir d'une colonne) ou Iterate (une vérification par itération). None: it starts its subjob. Otherwise one Main link (one check per row, the name can come from a column) or Iterate link (one check per iteration).
SortieOutput
Un lien Main avec un flux d'entrée : les lignes reçues passent telles quelles. Le résultat n'est pas une colonne mais EXISTS, réécrite à chaque ligne.
One Main link with an input flow: the received rows go through as they are. The result is not a column but EXISTS, written again for each row.
Déclencheurs en sortieOutput triggers
On Subjob Ok On Subjob Error On Component Ok On Component Error Run if
Condition du Run if : ((Boolean) globalMap.get("tFTPFileExist_1_EXISTS")). Sans fichier, le tFTPGet n'est pas lancé et le job se termine normalement. Voir l'exemple.
Run if condition: ((Boolean) globalMap.get("tFTPFileExist_1_EXISTS")). Without a file, the tFTPGet is not started and the job ends normally. See the example.
Le Nom de fichier est une colonne de la ligne reçue (row1.name) ; le composant suivant lit EXISTS ligne par ligne. Une seule connexion pour toutes les lignes. Voir l'exemple.
The File Name is a column of the received row (row1.name); the next component reads EXISTS row by row. A single connection for all the rows. See the example.
"/in", "orders.csv".
Set the Remote directory, the Target Type, then the name of the file or directory to look for in that directory, as Java expressions: "/in", "orders.csv".
EXISTS.
Connect it to what comes next (right-click › Trigger › Run if) and write the link condition with the EXISTS global variable.
Les libellés sont ceux de l'onglet Composant ; le nom technique, en gris, est celui du paramètre dans le fichier du job. Labels are those of the Component tab; the technical name, in grey, is the parameter name in the job file.
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| Utiliser une connexion existanteUse an existing connectionUSE_EXISTING_CONNECTION | NonNo | ToujoursAlways | Reprend la connexion ouverte par un tFTPConnection, avec son protocole ; le composant ne la ferme pas. Sans connexion existante, le composant ouvre la sienne au début et la ferme à la fin (une seule fois pour toutes les lignes d'un flux). Takes the connection opened by a tFTPConnection, with its protocol; the component does not close it. Without an existing connection, the component opens its own at the start and closes it at the end (once for all the rows of a flow). |
| Liste des composantsComponent listCONNECTION | videempty | Connexion existante cochéeExisting connection checked | Le tFTPConnection à utiliser. The tFTPConnection to use. |
Les paramètres de connexion ont les mêmes libellés, défauts et conditions d'affichage que dans tFTPConnection, où ils sont décrits en détail, et sont cachés dès que Utiliser une connexion existante est coché : hôte, port, utilisateur et mot de passe, Support de SFTP ou Support de FTPS et leurs réglages (méthode d'authentification et clé privée, magasin de clés, mode de sécurité), mode de connexion, encodage ; en paramètres avancés, le proxy Socks, la protection FTPS, la vérification distante, le délai de connexion, le parsage strict et Config client. The connection settings have the same labels, defaults and display conditions as in tFTPConnection, where they are described in detail, and are hidden as soon as Use an existing connection is checked: host, port, user and password, SFTP Support or FTPS Support and their settings (authentication method and private key, keystore, security mode), connection mode, encoding; in advanced settings, the Socks proxy, FTPS protection, remote verification, the connection timeout, strict reply parsing and Config client.
Trois différences : l'utilisateur et le mot de passe s'appellent USERNAME et PASSWORD dans le fichier du job (USER et PASS dans tFTPConnection) ; le mot de passe vaut "suomynona" par défaut (vide dans tFTPConnection) ; un paramètre avancé de plus, Ignorer les erreurs à la fermeture (FTP), décrit plus bas.
Three differences: the user and the password are named USERNAME and PASSWORD in the job file (USER and PASS in tFTPConnection); the password is "suomynona" by default (empty in tFTPConnection); one more advanced setting, Ignore Failure At Quit (FTP), described below.
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| Répertoire distantRemote directoryREMOTEDIR | "." |
ToujoursAlways |
Le répertoire où chercher, en expression Java ; les \ sont changés en /. Un chemin relatif part du répertoire de connexion ou, avec une connexion FTP existante, du répertoire courant de la connexion (en SFTP, toujours du répertoire de connexion). En FTP, un répertoire absent arrête le composant ; en SFTP, il donne EXISTS à false.
The directory to look in, as a Java expression; the \ are changed to /. A relative path starts from the login directory or, with an existing FTP connection, from the current directory of the connection (in SFTP, always from the login directory). In FTP, a missing directory stops the component; in SFTP, it gives EXISTS set to false.
|
| Déplacer vers le répertoire courantMove to the current directoryMOVE_TO_THE_CURRENT_DIRECTORY | OuiYes | Connexion existante FTP ou FTPSExisting FTP or FTPS connection | Coché : après la vérification, la connexion reste dans le Répertoire distant, et les composants suivants qui l'utilisent partent de là pour leurs chemins relatifs. Décoché : elle revient au répertoire où elle était. Voir l'exemple. Checked: after the check, the connection stays in the Remote directory, and the next components that use it start from there for their relative paths. Unchecked: it goes back to the directory it was in. See the example. |
| Type de cibleTarget TypeTARGETTYPE | FichierFile | ToujoursAlways |
Fichier ou Répertoire. En FTP, seul un fichier répond à Fichier et seul un répertoire à Répertoire. En SFTP, le choix ne change que le champ du nom : toute entrée de ce nom donne true.
File or Directory. In FTP, only a file answers File and only a directory answers Directory. In SFTP, the choice only changes the name field: any entry with that name gives true.
|
| Nom de fichierFile NameFILENAME | "filename.suffix" |
Type FichierFile type |
Le fichier cherché dans le Répertoire distant, en expression Java. De préférence un nom seul ; un chemin avec des / est accepté, mais traité différemment en FTP et en SFTP (voir les chemins).
The file looked for in the Remote directory, as a Java expression. Preferably a name only; a path with / is accepted, but handled differently in FTP and in SFTP (see the paths).
|
| Nom du répertoireDirectory nameDIRECTORYNAME | "directoryname" |
Type RépertoireDirectory type |
Le répertoire cherché, à partir du Répertoire distant (en FTP, un chemin absolu marche aussi) ; les \ sont changés en /.
The directory looked for, from the Remote directory (in FTP, an absolute path works too); the \ are changed to /.
|
En plus des paramètres de connexion, cachés avec une connexion existante. In addition to the connection settings, hidden with an existing connection.
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| Ignorer les erreurs à la fermeture (FTP)Ignore Failure At Quit (FTP)IGNORE_FAILURE_AT_QUIT | NonNo | FTP simple (ni SFTP ni FTPS), connexion propre ou existantePlain FTP (neither SFTP nor FTPS), own or existing connection |
Coché : une erreur d'entrée-sortie pendant la fermeture de la connexion n'arrête pas le composant ; son message est rangé dans tFTPFileExist_1_ERROR_MESSAGE. Sans effet avec une connexion existante, que le composant ne ferme pas.
Checked: an input-output error while closing the connection does not stop the component; its message is stored in tFTPFileExist_1_ERROR_MESSAGE. No effect with an existing connection, which the component does not close.
|
Lu dans le code du composant et vérifié par les exemples ci-dessous. FTPS se comporte comme FTP. Read in the code of the component and checked with the examples below. FTPS behaves like FTP.
| FTP, FTPS | SFTP | |
|---|---|---|
| FichierFile | Entre dans le Répertoire distant (CWD), puis, si le nom contient un /, dans la partie qui précède le dernier /. Demande la liste du répertoire (LIST) et y cherche un fichier de ce nom exact, casse comprise : la comparaison se fait dans le job.Enters the Remote directory (CWD), then, if the name holds a /, the part before the last /. Asks for the list of the directory (LIST) and looks in it for a file with that exact name, case included: the comparison is made in the job. |
Demande au serveur les attributs de répertoire + "/" + nom. Une réponse, quelle que soit l'entrée (fichier ou dossier), donne true ; une erreur, false. Le serveur décide de la casse et de la forme des chemins.Asks the server for the attributes of directory + "/" + name. An answer, whatever the entry (file or folder), gives true; an error, false. The server decides about case and the form of the paths. |
| RépertoireDirectory | Essaie d'entrer dans le Nom du répertoire depuis le Répertoire distant : réussite, true. Le serveur décide (casse comprise).Tries to enter the Directory name from the Remote directory: success, true. The server decides (case included). |
|
| Répertoire distant absentMissing remote directory | Erreur, le job s'arrêteError, the job stops | EXISTS = false |
| AprèsAfterwards | Revient au répertoire de départ, puis, si Déplacer vers le répertoire courant est coché, entre dans le Répertoire distant.Goes back to the starting directory, then, if Move to the current directory is checked, enters the Remote directory. | Avec une connexion existante, la connexion reste dans le Répertoire distant (réglage caché, coché par défaut) ; les autres composants tFTP repartent de toute façon du répertoire de connexion.With an existing connection, the connection stays in the Remote directory (hidden setting, checked by default); the other tFTP components start again from the login directory anyway. |
Ce que le composant envoie au serveur FTP d'essai pour "orders_2026-01.csv" dans "/in" (journal du serveur) :
What the component sends to the FTP test server for "orders_2026-01.csv" in "/in" (server log):
[ftp] 49153 > PWD [ftp] 49153 < 257 "/" is the current directory. [ftp] 49153 > CWD /in [ftp] 49153 < 250 Directory successfully changed. [ftp] 49153 > SYST [ftp] 49153 < 215 UNIX Type: L8 [ftp] 49153 > PASV [ftp] 49153 < 227 Entering Passive Mode (127,0,0,1,192,2). [ftp] 49153 > LIST [ftp] 49153 < 150 Here comes the directory listing. [ftp] 49153 < 226 Directory send OK. [ftp] 49153 > CWD / [ftp] 49153 < 250 Directory successfully changed. [ftp] 49153 > CWD /in [ftp] 49153 < 250 Directory successfully changed. [ftp] 49153 > QUIT
La liste complète du répertoire est demandée à chaque vérification de fichier : sur un répertoire de milliers d'entrées, et pour chaque ligne d'un flux, cela compte. Le dernier CWD /in vient de Déplacer vers le répertoire courant, coché par défaut même s'il n'est affiché qu'avec une connexion existante ; il est sans conséquence ici, la connexion étant fermée juste après.
The full list of the directory is requested at each file check: on a directory of thousands of entries, and for each row of a flow, this matters. The last CWD /in comes from Move to the current directory, checked by default even though it is only shown with an existing connection; it has no consequence here, as the connection is closed right after.
Écrites à chaque vérification : avant, elles valent null. À lire dans la condition d'un Run if ou dans les composants qui suivent.
Written at each check: before that, they are null. To read in the condition of a Run if or in the components that follow.
true si l'entrée cherchée existe, false sinon (voir Comment il vérifie). Avec un flux d'entrée, réécrite pour chaque ligne.true if the entry looked for exists, false otherwise (see How it checks). With an input flow, written again for each row.\ gardés). Seulement avec le type Fichier : avec Répertoire, elle reste null et le composant écrit à la place tFTPFileExist_1_DIRECTORYNAME, absente de la liste des variables du composant.The value of File Name, as written (without the directory, \ kept). Only with the File type: with Directory, it stays null and the component writes tFTPFileExist_1_DIRECTORYNAME instead, missing from the list of variables of the component.((Boolean) globalMap.get("tFTPFileExist_1_EXISTS"))
((String) globalMap.get("tFTPFileExist_1_FILENAME"))
((String) globalMap.get("tFTPFileExist_1_DIRECTORYNAME"))
Deux serveurs d'essai, un serveur FTP et un serveur SFTP, tous deux sous Windows, ont le même répertoire /in : Customers.CSV, notes.txt, orders_2026-01.csv, orders_2026-02.csv, readme et le dossier archive, qui contient orders_2025-12.csv. Les sorties sont celles de la console, copiées depuis une exécution du job.
Two test servers, an FTP server and an SFTP server, both on Windows, have the same /in directory: Customers.CSV, notes.txt, orders_2026-01.csv, orders_2026-02.csv, readme and the archive folder, which holds orders_2025-12.csv. The outputs are the console ones, copied from a run of the job.
// Run if → tJava_1
((Boolean) globalMap.get("tFTPFileExist_1_EXISTS"))
// Run if → tJava_2
!((Boolean) globalMap.get("tFTPFileExist_1_EXISTS"))
// tJava_1
System.out.println("Found: " + globalMap.get("tFTPFileExist_1_FILENAME"));
// tJava_2
System.out.println("Missing: " + globalMap.get("tFTPFileExist_1_FILENAME"));
Répertoire distant "/in", Nom de fichier "notes.txt", qui existe.
Remote directory "/in", File Name "notes.txt", which exists.
Found: notes.txt
"notes_old.txt", qui n'existe pas.
"notes_old.txt", which does not exist.
Missing: notes_old.txt
En FTP comme en SFTP, et dans les deux cas le job se termine avec le code 0 : un fichier absent n'est pas une erreur. In FTP as in SFTP, and in both cases the job ends with exit code 0: a missing file is not an error.
Cinq tFTPFileExist enchaînés, chacun suivi d'un tJava qui affiche son type, son nom et son répertoire, puis ses variables : Five chained tFTPFileExist, each followed by a tJava that prints its type, its name and its directory, then its variables:
System.out.println("file \"orders_2026-01.csv\" in \"/in\": EXISTS = "
+ globalMap.get("tFTPFileExist_1_EXISTS")
+ ", FILENAME = " + globalMap.get("tFTPFileExist_1_FILENAME")
+ ", DIRECTORYNAME = " + globalMap.get("tFTPFileExist_1_DIRECTORYNAME"));
Serveur FTP :FTP server:
file "orders_2026-01.csv" in "/in": EXISTS = true, FILENAME = orders_2026-01.csv, DIRECTORYNAME = null file "orders_2026-03.csv" in "/in": EXISTS = false, FILENAME = orders_2026-03.csv, DIRECTORYNAME = null file "archive" in "/in": EXISTS = false, FILENAME = archive, DIRECTORYNAME = null dir "archive" in "/in": EXISTS = true, FILENAME = null, DIRECTORYNAME = archive dir "notes.txt" in "/in": EXISTS = false, FILENAME = null, DIRECTORYNAME = notes.txt
Serveur SFTP, même job :SFTP server, same job:
file "orders_2026-01.csv" in "/in": EXISTS = true, FILENAME = orders_2026-01.csv, DIRECTORYNAME = null file "orders_2026-03.csv" in "/in": EXISTS = false, FILENAME = orders_2026-03.csv, DIRECTORYNAME = null file "archive" in "/in": EXISTS = true, FILENAME = archive, DIRECTORYNAME = null dir "archive" in "/in": EXISTS = true, FILENAME = null, DIRECTORYNAME = archive dir "notes.txt" in "/in": EXISTS = true, FILENAME = null, DIRECTORYNAME = notes.txt
En FTP, le type compte : le dossier archive n'est pas un fichier, notes.txt n'est pas un répertoire. En SFTP, le type est ignoré : les deux donnent true. FTPS donne la même sortie que FTP. FILENAME n'est écrite qu'avec le type Fichier.
In FTP, the type matters: the archive folder is not a file, notes.txt is not a directory. In SFTP, the type is ignored: both give true. FTPS gives the same output as FTP. FILENAME is only written with the File type.
Le même genre de job, connexion dans /, avec des chemins dans le nom et dans le répertoire. Serveur FTP :
The same kind of job, login in /, with paths in the name and in the directory. FTP server:
file "archive/orders_2025-12.csv" in "/in": EXISTS = true, FILENAME = archive/orders_2025-12.csv, DIRECTORYNAME = null file "/in/archive/orders_2025-12.csv" in "/in": EXISTS = true, FILENAME = /in/archive/orders_2025-12.csv, DIRECTORYNAME = null file "in/archive/orders_2025-12.csv" in "/": EXISTS = true, FILENAME = in/archive/orders_2025-12.csv, DIRECTORYNAME = null file "in/notes.txt" in ".": EXISTS = true, FILENAME = in/notes.txt, DIRECTORYNAME = null file "notes.txt" in "in": EXISTS = true, FILENAME = notes.txt, DIRECTORYNAME = null file "../notes.txt" in "/in/archive": EXISTS = true, FILENAME = ../notes.txt, DIRECTORYNAME = null file "nosuch/notes.txt" in "/in": EXISTS = false, FILENAME = nosuch/notes.txt, DIRECTORYNAME = null file "archive\\orders_2025-12.csv" in "\\in": EXISTS = true, FILENAME = archive\orders_2025-12.csv, DIRECTORYNAME = null dir "in/archive" in "/": EXISTS = true, FILENAME = null, DIRECTORYNAME = in/archive dir "/in/archive" in "/in": EXISTS = true, FILENAME = null, DIRECTORYNAME = /in/archive
Serveur SFTP, même job :SFTP server, same job:
file "archive/orders_2025-12.csv" in "/in": EXISTS = true, FILENAME = archive/orders_2025-12.csv, DIRECTORYNAME = null file "/in/archive/orders_2025-12.csv" in "/in": EXISTS = false, FILENAME = /in/archive/orders_2025-12.csv, DIRECTORYNAME = null file "in/archive/orders_2025-12.csv" in "/": EXISTS = false, FILENAME = in/archive/orders_2025-12.csv, DIRECTORYNAME = null file "in/notes.txt" in ".": EXISTS = true, FILENAME = in/notes.txt, DIRECTORYNAME = null file "notes.txt" in "in": EXISTS = true, FILENAME = notes.txt, DIRECTORYNAME = null file "../notes.txt" in "/in/archive": EXISTS = true, FILENAME = ../notes.txt, DIRECTORYNAME = null file "nosuch/notes.txt" in "/in": EXISTS = false, FILENAME = nosuch/notes.txt, DIRECTORYNAME = null file "archive\\orders_2025-12.csv" in "\\in": EXISTS = false, FILENAME = archive\orders_2025-12.csv, DIRECTORYNAME = null dir "in/archive" in "/": EXISTS = false, FILENAME = null, DIRECTORYNAME = in/archive dir "/in/archive" in "/in": EXISTS = false, FILENAME = null, DIRECTORYNAME = /in/archive
En FTP, le composant se déplace de répertoire en répertoire : un nom absolu, relatif, avec .. ou avec des \ fonctionne, et un sous-répertoire absent donne false sans erreur. En SFTP, il colle répertoire + "/" + nom : un nom absolu donne /in//in/archive/…, qui n'existe pas ; les \ du nom ne sont pas changés ; et avec le répertoire "/", le chemin commence par //, que le serveur d'essai (sous Windows) a refusé — d'autres serveurs l'acceptent peut-être. En SFTP, donnez le répertoire sans / final et un nom relatif, avec des /.
In FTP, the component moves from directory to directory: an absolute or relative name, with .. or with \, works, and a missing subdirectory gives false without an error. In SFTP, it sticks directory + "/" + name together: an absolute name gives /in//in/archive/…, which does not exist; the \ of the name are not changed; and with the "/" directory, the path starts with //, which the test server (on Windows) refused — other servers may accept it. In SFTP, give the directory without a trailing / and a relative name, with /.
Les fichiers s'appellent orders_2026-01.csv et Customers.CSV, le répertoire /in, le dossier archive. Serveur FTP, puis serveur SFTP :
The files are named orders_2026-01.csv and Customers.CSV, the directory /in, the folder archive. FTP server, then SFTP server:
file "ORDERS_2026-01.csv" in "/in": EXISTS = false, FILENAME = ORDERS_2026-01.csv, DIRECTORYNAME = null file "customers.csv" in "/in": EXISTS = false, FILENAME = customers.csv, DIRECTORYNAME = null file "notes.txt" in "/IN": EXISTS = true, FILENAME = notes.txt, DIRECTORYNAME = null dir "ARCHIVE" in "/in": EXISTS = true, FILENAME = null, DIRECTORYNAME = ARCHIVE
file "ORDERS_2026-01.csv" in "/in": EXISTS = true, FILENAME = ORDERS_2026-01.csv, DIRECTORYNAME = null file "customers.csv" in "/in": EXISTS = true, FILENAME = customers.csv, DIRECTORYNAME = null file "notes.txt" in "/IN": EXISTS = true, FILENAME = notes.txt, DIRECTORYNAME = null dir "ARCHIVE" in "/in": EXISTS = true, FILENAME = null, DIRECTORYNAME = ARCHIVE
Seul le nom de fichier en FTP est comparé par le composant, en tenant compte de la casse, quel que soit le serveur. Tout le reste (le répertoire distant, le répertoire cherché, et tout en SFTP) est résolu par le serveur : ici, un serveur sous Windows, qui ignore la casse. Sur un serveur Linux, ces lignes donneraient en général false ; ne comptez pas sur l'une ou l'autre réponse et écrivez les noms avec leur casse exacte.
Only the file name in FTP is compared by the component, case-sensitive, whatever the server. All the rest (the remote directory, the directory looked for, and everything in SFTP) is resolved by the server: here, a server on Windows, which ignores case. On a Linux server, these lines would usually give false; do not rely on either answer and write the names with their exact case.
Serveur FTP, tous les liens en On Subjob Ok, les deux tFTPFileExist sur la connexion de tFTPConnection_1. tFTPFileExist_1 : "orders_2026-01.csv" dans "/in". tFTPFileExist_2 : "notes.txt" dans ".". tJava_3 affiche le répertoire courant de la connexion (printWorkingDirectory()). À gauche Déplacer vers le répertoire courant coché (défaut) sur les deux composants, à droite décoché.
FTP server, all links in On Subjob Ok, both tFTPFileExist on the connection of tFTPConnection_1. tFTPFileExist_1: "orders_2026-01.csv" in "/in". tFTPFileExist_2: "notes.txt" in ".". tJava_3 prints the current directory of the connection (printWorkingDirectory()). On the left Move to the current directory checked (default) on both components, on the right unchecked.
file "orders_2026-01.csv" in "/in": EXISTS = true, FILENAME = orders_2026-01.csv, DIRECTORYNAME = null file "notes.txt" in ".": EXISTS = true, FILENAME = notes.txt, DIRECTORYNAME = null Working directory: /in
file "orders_2026-01.csv" in "/in": EXISTS = true, FILENAME = orders_2026-01.csv, DIRECTORYNAME = null file "notes.txt" in ".": EXISTS = false, FILENAME = notes.txt, DIRECTORYNAME = null Working directory: /
Coché, tFTPFileExist_1 laisse la connexion dans /in : le "." de tFTPFileExist_2 est donc /in, où se trouve notes.txt. Décoché, la connexion revient dans /, où il n'est pas. En SFTP, l'option n'est pas proposée et les deux jobs donnent la sortie de droite.
Checked, tFTPFileExist_1 leaves the connection in /in: the "." of tFTPFileExist_2 is therefore /in, where notes.txt is. Unchecked, the connection goes back to /, where it is not. In SFTP, the option is not offered and both jobs give the output on the right.
tFixedFlowInput_1 : une colonne name, trois lignes. tFTPFileExist_1 : "/in", Nom de fichier row1.name, même schéma que l'entrée. tJavaRow_1 :
tFixedFlowInput_1: one name column, three rows. tFTPFileExist_1: "/in", File Name row1.name, same schema as the input. tJavaRow_1:
System.out.println("row2.name = " + input_row.name
+ ", EXISTS = " + globalMap.get("tFTPFileExist_1_EXISTS")
+ ", FILENAME = " + globalMap.get("tFTPFileExist_1_FILENAME"));
row2.name = notes.txt, EXISTS = true, FILENAME = notes.txt row2.name = readme, EXISTS = true, FILENAME = readme row2.name = orders_2026-03.csv, EXISTS = false, FILENAME = orders_2026-03.csv
En FTP comme en SFTP. La ligne reçue passe telle quelle ; EXISTS est réécrite pour chaque ligne, avant que la ligne n'arrive au tJavaRow. Pour garder le résultat dans le flux, recopiez-le dans une colonne (dans un tMap ou un tJavaRow).
In FTP as in SFTP. The received row goes through as it is; EXISTS is written again for each row, before the row reaches the tJavaRow. To keep the result in the flow, copy it into a column (in a tMap or a tJavaRow).
Le nom du job est remplacé par MyJob ; la trace d'exception est abrégée. Le message après 550 vient du serveur.
The job name is replaced with MyJob; the exception trace is shortened. The message after 550 comes from the server.
Répertoire distant "/nosuch", Nom de fichier "notes.txt" :
Remote directory "/nosuch", File Name "notes.txt":
Exception in component tFTPFileExist_1 (MyJob) java.lang.RuntimeException: Failed to change remote directory. 550 /nosuch: No such directory. at demo.myjob_0_1.MyJob.tFTPFileExist_1Process(MyJob.java:486) …
Le job s'arrête avec le code 1, sans écrire EXISTS. En SFTP, le même réglage donne EXISTS = false et le job continue.
The job stops with exit code 1, without writing EXISTS. In SFTP, the same setting gives EXISTS = false and the job goes on.
Pour traiter un répertoire absent comme un fichier absent en FTP, vérifiez d'abord le répertoire lui-même : un premier tFTPFileExist avec le type Répertoire, le répertoire parent en Répertoire distant et le nom du répertoire en Nom du répertoire, puis un Run if sur son EXISTS vers la vérification du fichier. Ou bien reliez le tFTPFileExist à la suite par On Component Error.
To handle a missing directory like a missing file in FTP, first check the directory itself: a first tFTPFileExist with the Directory type, the parent directory as Remote directory and the name of the directory as Directory name, then a Run if on its EXISTS to the file check. Or connect the tFTPFileExist to what follows with On Component Error.
Le Type de cible n'est pas vérifié en SFTP : un dossier qui porte le nom attendu donne true avec le type Fichier, et un fichier avec le type Répertoire. Si un dossier peut porter le nom du fichier, ne concluez pas qu'il y a un fichier à télécharger.
The Target Type is not checked in SFTP: a folder with the expected name gives true with the File type, and a file with the Directory type. If a folder can have the name of the file, do not conclude that there is a file to download.
Le composant réussit dans les deux cas : un On Subjob Ok ou un On Component Ok passe aussi quand le fichier manque. Seul un Run if sur EXISTS distingue les deux cas ; pour arrêter le job, faites-le suivre d'un tDie. La condition doit convertir la valeur : ((Boolean) globalMap.get("tFTPFileExist_1_EXISTS")).
The component succeeds in both cases: an On Subjob Ok or an On Component Ok also goes through when the file is missing. Only a Run if on EXISTS tells the two cases apart; to stop the job, follow it with a tDie. The condition must cast the value: ((Boolean) globalMap.get("tFTPFileExist_1_EXISTS")).
Un Répertoire distant absolu, sans / final ("/in"), et un nom de fichier seul, avec sa casse exacte ("orders_2026-01.csv") : avec eux, FTP, FTPS et SFTP donnent la même réponse sur tous les serveurs d'essai, tant qu'aucun dossier ne porte le nom du fichier.
An absolute Remote directory, without a trailing / ("/in"), and a file name alone, with its exact case ("orders_2026-01.csv"): with them, FTP, FTPS and SFTP give the same answer on all the test servers, as long as no folder has the name of the file.
Pour savoir quels fichiers d'un répertoire correspondent à un masque, un tFTPFileList est plus direct : il ne demande la liste qu'une fois. Pour quelques noms connus, une vérification par ligne d'un flux réutilise une seule connexion, mais redemande la liste du répertoire à chaque ligne en FTP. To know which files of a directory match a mask, a tFTPFileList is more direct: it asks for the list only once. For a few known names, one check per row of a flow reuses a single connection, but asks for the list of the directory again at each row in FTP.
tFTPConnection · tFTPClose · ouvrir et fermer la connexion partagéeopen and close the shared connectiontFTPFileList · lister un répertoire distantlist a remote directorytFTPFileProperties · taille, date et MD5 d'un fichier distantsize, date and MD5 of a remote filetFTPGet · tFTPDelete · télécharger ou supprimer le fichierdownload or delete the filetFileExist · la même question sur la machine du jobthe same question on the job machinetDie · arrêter le job si le fichier manquestop the job if the file is missing