ComposantsComponents

ComposantsComponents › Internet › FTP

tFTPFileExist

tFTPFileExist

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

UtilisationUsage

Télécharger le fichier s'il est làDownload the file if it is there

If tFTPFileExist_1 tFTPGet_1

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.

Vérifier une liste de nomsCheck a list of names

row1 (Main) row2 (Main) tFixedFlowInput_1 tFTPFileExist_1 tJavaRow_1

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.

  1. Déposez le tFTPFileExist depuis la famille Internet › FTP de la palette. Drop the tFTPFileExist from the Internet › FTP family of the palette.
  2. Cochez Utiliser une connexion existante et choisissez le tFTPConnection du job, ou renseignez la connexion dans le composant (voir Connexion). Check Use an existing connection and choose the tFTPConnection of the job, or fill in the connection in the component (see Connection).
  3. Indiquez le Répertoire distant, le Type de cible, puis le nom du fichier ou du répertoire cherché dans ce répertoire, en expressions Java : "/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".
  4. Reliez-le à la suite (clic droit › Déclencher › Run if) et écrivez la condition du lien avec la variable globale EXISTS. Connect it to what comes next (right-click › Trigger › Run if) and write the link condition with the EXISTS global variable.

ConnexionConnection

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.

Sans connexion existante : comme tFTPConnectionWithout an existing connection: as in tFTPConnection

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ètres simplesBasic settings

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 /.

Paramètres avancésAdvanced settings

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.

Comment il vérifieHow it checks

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.

Variables globalesGlobal variables

É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.

EXISTS Boolean
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.
FILENAME String
La valeur de Nom de fichier, telle qu'elle est écrite (sans le répertoire, \ 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"))

ExemplesExamples

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.

Deux branches avec Run ifTwo branches with Run if

If If tFTPFileExist_1 tJava_1 tJava_2
// 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.

Fichier ou répertoire, en FTP puis en SFTPFile or directory, in FTP then in SFTP

OnSubjobOk OnSubjobOk tFTPFileExist_1 tJava_1 tFTPFileExist_2 …

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.

Chemins relatifs et absolusRelative and absolute paths

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 /.

Majuscules et minusculesUpper and lower case

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.

Connexion existante et répertoire courantExisting connection and current directory

OnSubjobOk OnSubjobOk OnSubjobOk OnSubjobOk OnSubjobOk OnSubjobOk tFTPConnection_1 tFTPFileExist_1 tJava_1 tFTPFileExist_2 tJava_2 tJava_3 tFTPClose_1

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.

Une vérification par ligneOne check per row

row1 (Main) row2 (Main) tFixedFlowInput_1 tFTPFileExist_1 tJavaRow_1

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).

ErreursErrors

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 absent, en FTPMissing remote directory, in FTP

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.

Si le répertoire peut manquerIf the directory can be missing

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.

Conseils et limitesTips and limits

En SFTP, un dossier compte comme un fichierIn SFTP, a folder counts as a file

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.

Un fichier absent n'arrête rienA missing file stops nothing

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")).

Le réglage le plus sûrThe safest setting

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 une liste de fichiersFor a list of files

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.

Voir aussiSee also