ComposantsComponents › Internet › FTP
Liste un répertoire d'un serveur FTP, FTPS ou SFTP et exécute une fois par entrée retenue les composants reliés par un lien Iterate. Le nom et le chemin distant de l'entrée courante sont dans des variables globales : un tFTPFileProperties, un tFTPGet ou un tFTPDelete les reprend pour traiter tout un dossier distant. C'est le pendant distant de tFileList, en plus simple : ni sous-répertoires, ni tri, ni choix entre fichiers et dossiers (voir les différences). Lists a directory of an FTP, FTPS or SFTP server and runs the components connected with an Iterate link once per kept entry. The name and the remote path of the current entry are in global variables: a tFTPFileProperties, a tFTPGet or a tFTPDelete takes them to process a whole remote folder. It is the remote counterpart of tFileList, simpler: no subdirectories, no sorting, no choice between files and folders (see the differences).
EntréeInput
Aucune : il commence son sous-job (souvent après un tFTPConnection, par On Subjob Ok). Sinon un lien Iterate. None: it starts its subjob (often after a tFTPConnection, with On Subjob Ok). Otherwise one Iterate link.
SortieOutput
Un ou plusieurs liens Iterate : leurs composants s'exécutent une fois par entrée. Pas de flux de données. One or more Iterate links: their components run once per entry. No data flow.
Déclencheurs en sortieOutput triggers
On Subjob Ok On Subjob Error On Component Ok On Component Error Run if
Le tFTPFileList et le composant de la boucle utilisent la même connexion. Le nom de fichier du composant itéré est ((String) globalMap.get("tFTPFileList_1_CURRENT_FILE")). Voir l'exemple.
The tFTPFileList and the component of the loop use the same connection. The file name of the iterated component is ((String) globalMap.get("tFTPFileList_1_CURRENT_FILE")). See the example.
Une fois la boucle finie, NB_FILE donne le nombre d'entrées retenues. Il n'est écrit qu'à la fin : pendant la boucle, il ne donne pas le rang, contrairement à tFileList.
Once the loop is over, NB_FILE gives the number of kept entries. It is only written at the end: during the loop, it does not give the rank, unlike tFileList.
"*.csv". Sans ligne, toutes les entrées du répertoire sont listées, dossiers compris.
Set the Remote directory, then one line per mask in Files, with its quotes: "*.csv". Without a line, all the entries of the directory are listed, folders included.
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 de la liste. 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 of the list. |
| Liste des composantsComponent listCONNECTION | videempty | Connexion existante cochéeExisting connection checked | Le tFTPConnection à utiliser (seuls les tFTPConnection du job sont proposés). The tFTPConnection to use (only the tFTPConnection components of the job are offered). |
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, Mot de passe, Support de SFTP, Support de FTPS, Méthode d'authentification, Clé privée, Phrase secrète clé, Fichier KeyStore, Mot de passe du KeyStore, Mode de connexion, Mode de sécurité, Encodage du nom de fichier, Encodage ; en paramètres avancés, le proxy Socks, le niveau de protection et la taille de la mémoire tampon 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, Username, Password, SFTP Support, FTPS Support, Authentication method, Private key, Key Passphrase, Keystore File, Keystore Password, Connection Mode, Security Mode, Filename encoding, Encoding; in advanced settings, the Socks proxy, the FTPS protection level and buffer size, 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 à lister, en expression Java : "/in", context.remoteDir. Les \ sont changés en /. Un chemin relatif part du répertoire de connexion ("." : ce répertoire même) ; avec une connexion FTP existante, du répertoire courant de la connexion (en SFTP, toujours du répertoire de connexion). En FTP, le composant y entre par CWD : un répertoire absent arrête le composant (voir les erreurs). En SFTP, il le liste sans y entrer.
The directory to list, as a Java expression: "/in", context.remoteDir. The \ are changed to /. A relative path starts from the login directory (".": that directory itself); with an existing FTP connection, from the current directory of the connection (in SFTP, always from the login directory). In FTP, the component enters it with CWD: a missing directory stops the component (see the errors). In SFTP, it lists it without entering it.
|
| 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é : la connexion reste dans le Répertoire distant après la liste, et les composants suivants qui l'utilisent partent de là pour leurs chemins relatifs. Décoché : elle revient au répertoire où elle était. Sans effet en SFTP, où le composant liste le répertoire sans y entrer. Voir l'exemple. Checked: the connection stays in the Remote directory after the list, and the next components that use it start from there for their relative paths. Unchecked: it goes back to the directory it was in. No effect in SFTP, where the component lists the directory without entering it. See the example. |
| Détail du fichierFile detailDIR_FULL | NonNo | ToujoursAlways |
Coché : CURRENT_FILE contient la ligne complète de la liste du serveur, à la manière de ls -l (droits, propriétaire, taille, date, nom), au lieu du nom seul ; CURRENT_FILEPATH garde le nom seul. Le masque porte toujours sur le nom. Voir l'exemple.
Checked: CURRENT_FILE holds the full line of the server listing, like ls -l (rights, owner, size, date, name), instead of the name only; CURRENT_FILEPATH keeps the name only. The mask still applies to the name. See the example.
|
| FichiersFilesFILES · FILEMASK | videempty | ToujoursAlways |
Un Masque de fichier par ligne, expression Java entre guillemets, comparé au nom seul de chaque entrée, en tenant compte de la casse. Dans le masque, * vaut n'importe quelle suite de caractères et . est un point ; le reste est lu comme une expression régulière Java : ? ne vaut pas un caractère (voir les masques). Sans ligne : "*", tout le répertoire. Les masques sont appliqués l'un après l'autre : une entrée retenue par deux masques est donnée deux fois.
One Filemask per line, a Java expression in quotes, compared with the name only of each entry, case-sensitive. In the mask, * stands for any sequence of characters and . is a dot; the rest is read as a Java regular expression: ? does not stand for one character (see the masks). Without a line: "*", the whole directory. The masks are applied one after the other: an entry kept by two masks is given twice.
|
En plus des paramètres de connexion (proxy, FTPS, délai…), cachés avec une connexion existante. In addition to the connection settings (proxy, FTPS, timeout…), 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 (QUIT, puis déconnexion) n'arrête pas le composant ; son message est rangé dans tFTPFileList_1_ERROR_MESSAGE. Sans effet avec une connexion existante, que le composant ne ferme pas.
Checked: an input-output error while closing the connection (QUIT, then disconnection) does not stop the component; its message is stored in tFTPFileList_1_ERROR_MESSAGE. No effect with an existing connection, which the component does not close.
|
CURRENT_FILE et CURRENT_FILEPATH sont mises à jour à chaque entrée, à lire dans les composants reliés par Iterate ; après la boucle, elles gardent les valeurs de la dernière entrée. NB_FILE n'est écrite qu'à la fin.
CURRENT_FILE and CURRENT_FILEPATH are updated for each entry, to read in the components connected with Iterate; after the loop, they keep the values of the last entry. NB_FILE is only written at the end.
orders_2026-01.csv. Avec Détail du fichier, la ligne complète de la liste du serveur.Name of the entry, without a path: orders_2026-01.csv. With File detail, the full line of the server listing.\ changés en /), un / s'il n'y est pas déjà, puis le nom : /in/orders_2026-01.csv. Un répertoire relatif donne un chemin relatif (in/archive/…, ./in).The Remote directory as written (\ changed to /), a / unless it already ends with one, then the name: /in/orders_2026-01.csv. A relative directory gives a relative path (in/archive/…, ./in).null au premier passage (voir l'exemple).After the loop: the number of given entries (an entry kept by two masks counts twice). During the loop: null on the first run (see the example).((String) globalMap.get("tFTPFileList_1_CURRENT_FILE"))
((String) globalMap.get("tFTPFileList_1_CURRENT_FILEPATH"))
((Integer) globalMap.get("tFTPFileList_1_NB_FILE"))
Deux serveurs d'essai, un serveur FTP et un serveur SFTP, tous deux sous Windows, ont le même répertoire /in. Dans chaque exemple, un tJava relié par Iterate affiche l'entrée courante, un second, relié par On Subjob Ok, le nombre d'entrées. 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. In each example, a tJava connected with Iterate prints the current entry, a second one, connected with On Subjob Ok, the number of entries. The outputs are the console ones, copied from a run of the job.
/in
archive/
orders_2025-12.csv 22 bytes
Customers.CSV 38 bytes
notes.txt 9 bytes
orders_2026-01.csv 21 bytes
orders_2026-02.csv 15 bytes
readme 39 bytes
// tJava_1 (Iterate)
System.out.println(
((String) globalMap.get("tFTPFileList_1_CURRENT_FILE")) + " "
+ ((String) globalMap.get("tFTPFileList_1_CURRENT_FILEPATH")));
// tJava_2 (On Subjob Ok)
System.out.println("Files found: "
+ globalMap.get("tFTPFileList_1_NB_FILE"));
Répertoire distant "/in", Fichiers vide. À gauche le serveur FTP, à droite le même job avec Support de SFTP coché.
Remote directory "/in", Files empty. On the left the FTP server, on the right the same job with SFTP Support checked.
Customers.CSV /in/Customers.CSV archive /in/archive notes.txt /in/notes.txt orders_2026-01.csv /in/orders_2026-01.csv orders_2026-02.csv /in/orders_2026-02.csv readme /in/readme Files found: 6
archive /in/archive Customers.CSV /in/Customers.CSV notes.txt /in/notes.txt orders_2026-01.csv /in/orders_2026-01.csv orders_2026-02.csv /in/orders_2026-02.csv readme /in/readme Files found: 6
Le dossier archive est donné comme les fichiers, mais son contenu n'est pas parcouru. L'ordre est celui où chaque serveur envoie sa liste : le composant ne trie pas. Le même job en FTPS donne la même sortie que le serveur FTP.
The archive folder is given like the files, but its content is not visited. The order is the one in which each server sends its list: the component does not sort. The same job in FTPS gives the same output as the FTP server.
"*.csv", puis "*.CSV""*.csv" mask, then "*.CSV"Serveur FTP. Même sortie en SFTP. FTP server. Same output in SFTP.
orders_2026-01.csv /in/orders_2026-01.csv orders_2026-02.csv /in/orders_2026-02.csv Files found: 2
Customers.CSV /in/Customers.CSV Files found: 1
La casse compte, quel que soit le serveur : le masque est comparé dans le job, pas par le serveur. Il n'y a pas d'option pour l'ignorer. Case matters, whatever the server: the mask is compared in the job, not by the server. There is no option to ignore it.
Fichiers : "*.txt" et "orders_*-02.csv", puis "orders*" et "*.csv", qui retiennent les mêmes fichiers.
Files: "*.txt" and "orders_*-02.csv", then "orders*" and "*.csv", which keep the same files.
notes.txt /in/notes.txt orders_2026-02.csv /in/orders_2026-02.csv Files found: 2
orders_2026-01.csv /in/orders_2026-01.csv orders_2026-02.csv /in/orders_2026-02.csv orders_2026-01.csv /in/orders_2026-01.csv orders_2026-02.csv /in/orders_2026-02.csv Files found: 4
Chaque masque parcourt toute la liste à son tour : les fichiers retenus par les deux masques sont donnés deux fois, et comptés deux fois dans NB_FILE. En FTP comme en SFTP.
Each mask goes through the whole list in turn: the files kept by both masks are given twice, and counted twice in NB_FILE. In FTP as in SFTP.
? et expressions régulières? and regular expressions
Le composant fait du masque une expression régulière Java en changeant seulement . en \. et * en .*. À gauche, le masque "orders_2026-0?.csv" ; à droite, deux masques : "orders_\\d{4}-\\d{2}.csv" et "(notes|readme).*".
The component turns the mask into a Java regular expression by only changing . into \. and * into .*. On the left, the "orders_2026-0?.csv" mask; on the right, two masks: "orders_\\d{4}-\\d{2}.csv" and "(notes|readme).*".
Files found: 0
orders_2026-01.csv /in/orders_2026-01.csv orders_2026-02.csv /in/orders_2026-02.csv notes.txt /in/notes.txt Files found: 3
À gauche, ? reste un symbole d'expression régulière (« le caractère précédent, facultatif ») : le masque demande orders_2026- suivi ou non d'un 0, puis .csv, et ne trouve rien. À droite, \\d et les accolades fonctionnent ; mais readme n'est pas retenu, car le point de .* devient un vrai point : le masque devient (notes|readme)\..*. Pour « un caractère quelconque », écrivez * ou une classe comme [0-9]. Mêmes sorties en SFTP.
On the left, ? stays a regular expression symbol (“the previous character, optional”): the mask asks for orders_2026- followed or not by a 0, then .csv, and finds nothing. On the right, \\d and the braces work; but readme is not kept, because the dot of .* becomes a real dot: the mask becomes (notes|readme)\..*. For “any one character”, write * or a class such as [0-9]. Same outputs in SFTP.
NB_FILE pendant la boucleNB_FILE during the loop
Masque "*.csv" ; le tJava_1 affiche NB_FILE avant le nom.
"*.csv" mask; tJava_1 prints NB_FILE before the name.
System.out.println(globalMap.get("tFTPFileList_1_NB_FILE")
+ " " + ((String) globalMap.get("tFTPFileList_1_CURRENT_FILE")));
null orders_2026-01.csv null orders_2026-02.csv Files found: 2
En FTP comme en SFTP. Pour un rang, comptez vous-même dans le tJava, ou passez par un tSetGlobalVar. Si le sous-job est relancé (dans un tLoop), la boucle voit le total du passage précédent. In FTP as in SFTP. For a rank, count yourself in the tJava, or use a tSetGlobalVar. If the subjob is run again (in a tLoop), the loop sees the total of the previous run.
Serveur FTP, connexion dans /. Répertoire distant "in/archive", puis "\\in\\archive", puis ".".
FTP server, login in /. Remote directory "in/archive", then "\\in\\archive", then ".".
orders_2025-12.csv in/archive/orders_2025-12.csv Files found: 1
orders_2025-12.csv /in/archive/orders_2025-12.csv Files found: 1
in ./in Files found: 1
CURRENT_FILEPATH recopie le répertoire tel qu'il est écrit : il reste relatif. Les deux premiers donnent la même chose en SFTP ; "." y liste le répertoire de connexion du compte, propre à chaque serveur.
CURRENT_FILEPATH copies the directory as written: it stays relative. The first two give the same in SFTP; "." lists the login directory of the account there, specific to each server.
Répertoire distant "/in", Fichiers vide, Détail du fichier coché. En FTP, puis en SFTP.
Remote directory "/in", Files empty, File detail checked. In FTP, then in SFTP.
-rw-r--r-- 1 demo demo 38 Oct 5 08:00 Customers.CSV /in/Customers.CSV drwxr-xr-x 1 demo demo 0 Jan 2 2026 archive /in/archive -rw-r--r-- 1 demo demo 9 Nov 20 17:03 notes.txt /in/notes.txt -rw-r--r-- 1 demo demo 21 Nov 2 09:15 orders_2026-01.csv /in/orders_2026-01.csv -rw-r--r-- 1 demo demo 15 Nov 16 14:42 orders_2026-02.csv /in/orders_2026-02.csv -rw-r--r-- 1 demo demo 39 Jun 1 12:00 readme /in/readme Files found: 6
drwxr-xr-x 1 User Aucun 0 Jan 2 2026 archive /in/archive -rw-r--r-- 1 User Aucun 38 Oct 5 08:00 Customers.CSV /in/Customers.CSV -rw-r--r-- 1 User Aucun 9 Nov 20 17:03 notes.txt /in/notes.txt -rw-r--r-- 1 User Aucun 21 Nov 2 09:15 orders_2026-01.csv /in/orders_2026-01.csv -rw-r--r-- 1 User Aucun 15 Nov 16 14:42 orders_2026-02.csv /in/orders_2026-02.csv -rw-r--r-- 1 User Aucun 39 Jun 1 12:00 readme /in/readme Files found: 6
La ligne est celle que le serveur envoie, sans retouche : sa forme (propriétaire, groupe, date sans l'année ou sans l'heure) dépend du serveur. Le d du début distingue les dossiers. C'est le seul moyen, dans ce composant, de connaître les droits d'une entrée.
The line is the one the server sends, untouched: its form (owner, group, date without the year or without the time) depends on the server. The leading d tells folders apart. It is the only way, in this component, to know the rights of an entry.
Serveur FTP. tFTPFileList_1 sur la connexion de tFTPConnection_1, Répertoire distant "/in", masque "*.txt", tJava_1 relié par Iterate comme plus haut. tJava_2 affiche le répertoire courant de la connexion. À gauche Déplacer vers le répertoire courant coché (défaut), à droite décoché.
FTP server. tFTPFileList_1 on the connection of tFTPConnection_1, Remote directory "/in", "*.txt" mask, tJava_1 connected with Iterate as above. tJava_2 prints the current directory of the connection. On the left Move to the current directory checked (default), on the right unchecked.
// tJava_2
org.apache.commons.net.ftp.FTPClient ftp = (org.apache.commons.net.ftp.FTPClient)
globalMap.get("conn_tFTPConnection_1");
System.out.println("Working directory: " + ftp.printWorkingDirectory());
notes.txt /in/notes.txt Working directory: /in
notes.txt /in/notes.txt Working directory: /
Coché, la connexion reste dans /in : un composant suivant qui l'utilise avec un chemin relatif (ou ".") part de /in, pas du répertoire de connexion. En SFTP, l'option n'est pas proposée et le répertoire courant ne change pas.
Checked, the connection stays in /in: a next component using it with a relative path (or ".") starts from /in, not from the login directory. In SFTP, the option is not offered and the current directory does not change.
Serveur FTP. tFTPFileList_1 : connexion existante, "/in", masque "*.csv". tFTPFileProperties_1 : la même connexion, Répertoire distant "/in", Fichier ((String) globalMap.get("tFTPFileList_1_CURRENT_FILE")). tLogRow_1 en mode Tableau ; un tFTPClose ferme la connexion après la boucle.
FTP server. tFTPFileList_1: existing connection, "/in", "*.csv" mask. tFTPFileProperties_1: the same connection, Remote directory "/in", File ((String) globalMap.get("tFTPFileList_1_CURRENT_FILE")). tLogRow_1 in Table mode; a tFTPClose closes the connection after the loop.
.----------------------+-------+------------------+----+-------------+----------------------------. | tLogRow_1 | |=---------------------+-------+------------------+----+-------------+---------------------------=| |abs_path |dirname|basename |size|mtime |mtime_string | |=---------------------+-------+------------------+----+-------------+---------------------------=| |/in/orders_2026-01.csv|/in |orders_2026-01.csv|21 |1793607300000|Mon Nov 02 09:15:00 CET 2026| '----------------------+-------+------------------+----+-------------+----------------------------' .----------------------+-------+------------------+----+-------------+----------------------------. | tLogRow_1 | |=---------------------+-------+------------------+----+-------------+---------------------------=| |abs_path |dirname|basename |size|mtime |mtime_string | |=---------------------+-------+------------------+----+-------------+---------------------------=| |/in/orders_2026-02.csv|/in |orders_2026-02.csv|15 |1794836520000|Mon Nov 16 14:42:00 CET 2026| '----------------------+-------+------------------+----+-------------+----------------------------'
Un tableau par itération : le tLogRow est relancé à chaque fichier. Une seule connexion sert toute la boucle. Avec le masque "*", le dossier archive passerait aussi dans la boucle.
One table per iteration: the tLogRow is run again for each file. A single connection serves the whole loop. With the "*" mask, the archive folder would go through the loop too.
tFileList parcourt un dossier de la machine du job ; tFTPFileList, un répertoire d'un serveur. Ce qui change (d'après le code des deux composants et les exemples de leurs pages) : tFileList goes through a folder of the job machine; tFTPFileList, a directory of a server. What changes (from the code of both components and the examples of their pages):
| tFileList | tFTPFileList | |
|---|---|---|
| Fichiers ou dossiersFiles or folders | Au choix : fichiers, répertoires, les deuxTo choose: files, directories, both | Toujours les deux, sans les distinguerAlways both, without telling them apart |
| Sous-répertoiresSubdirectories | En optionOptional | NonNo |
| OrdreOrder | Trié (chemin, nom, taille ou date)Sorted (path, name, size or date) | Celui du serveur, groupé par masqueThe server's, grouped by mask |
| MasquesMasks | Glob (*, ?) ou expression régulière ; casse au choix ; masque d'exclusionGlob (*, ?) or regular expression; case to choose; exclude mask |
* seulement (le reste en expression régulière) ; toujours sensible à la casse ; pas d'exclusion* only (the rest as a regular expression); always case-sensitive; no exclusion |
| Entrée retenue par deux masquesEntry kept by two masks | Donnée une foisGiven once | Donnée deux foisGiven twice |
NB_FILE |
Rang pendant la boucle, total aprèsRank during the loop, total after | Total après la boucle seulementTotal after the loop only |
| Autres variablesOther variables | CURRENT_FILEDIRECTORY, CURRENT_FILEEXTENSION |
Aucune ; à la place, la ligne complète du serveur (Détail du fichier)None; instead, the full line of the server (File detail) |
| Dossier absentMissing folder | Liste vide (erreur en option)Empty list (error as an option) | Erreur, en FTP comme en SFTP ; pas d'option d'erreur si la liste est videError, in FTP as in SFTP; no error option when the list is empty |
| Chemin renduReturned path | AbsoluAbsolute | Tel que le répertoire est écrit (relatif s'il l'est)As the directory is written (relative if it is) |
Le nom du job est remplacé par MyJob ; les traces d'exception et les messages de compilation sont abrégés. Les messages qui suivent le code 550 ou 2: viennent du serveur et changent d'un serveur à l'autre.
The job name is replaced with MyJob; exception traces and compilation messages are shortened. The messages after the 550 or 2: code come from the server and change from one server to another.
Répertoire distant "/nosuch". En FTP :
Remote directory "/nosuch". In FTP:
Exception in component tFTPFileList_1 (MyJob) java.lang.RuntimeException: Failed to change remote directory. 550 /nosuch: No such directory. at demo.myjob_0_1.MyJob.tFTPFileList_1Process(MyJob.java:485) …
En SFTP : In SFTP:
Exception in component tFTPFileList_1 (MyJob) 2: No such file at com.jcraft.jsch.ChannelSftp.throwStatusError(…) … at demo.myjob_0_1.MyJob.tFTPFileList_1Process(MyJob.java:543) …
Le job s'arrête avec le code 1 ; le tJava relié par On Subjob Ok ne s'exécute pas. Un On Component Error permet de réagir. Un répertoire vide, ou sans entrée qui corresponde au masque, n'est pas une erreur : Files found: 0.
The job stops with exit code 1; the tJava connected with On Subjob Ok does not run. An On Component Error lets you react. An empty directory, or one with no entry matching the mask, is not an error: Files found: 0.
Répertoire distant "/in/notes.txt", un fichier. En FTP :
Remote directory "/in/notes.txt", a file. In FTP:
Exception in component tFTPFileList_1 (MyJob) java.lang.RuntimeException: Failed to change remote directory. 550 /in/notes.txt: No such directory. at demo.myjob_0_1.MyJob.tFTPFileList_1Process(MyJob.java:485) …
En SFTP, pas d'erreur, mais un chemin faux : In SFTP, no error, but a wrong path:
notes.txt /in/notes.txt/notes.txt Files found: 1
Le serveur SFTP liste le fichier lui-même, et le composant ajoute son nom au « répertoire ». Indiquez toujours un répertoire ; pour tester un fichier, prenez un tFTPFileExist. The SFTP server lists the file itself, and the component adds its name to the “directory”. Always give a directory; to test a file, take a tFTPFileExist.
Masque de fichier écrit *.csv :
Filemask written *.csv:
MyJob.java:400: error: illegal start of expression maskList_tFTPFileList_1.add(*.csv); ^
Le masque est une expression Java, recopiée dans le code du job : écrivez "*.csv", avec les guillemets. Le job ne compile pas et ne démarre pas.
The mask is a Java expression, copied into the job code: write "*.csv", with the quotes. The job does not compile and does not start.
Rien ne distingue un dossier d'un fichier dans CURRENT_FILE. Un composant de la boucle qui attend un fichier (lecture, téléchargement, MD5) échoue sur un dossier. Choisissez des masques qui ne retiennent que des fichiers ("*.csv"), ou testez la ligne de Détail du fichier, qui commence par d pour un dossier.
Nothing tells a folder from a file in CURRENT_FILE. A component of the loop that expects a file (reading, download, MD5) fails on a folder. Choose masks that only keep files ("*.csv"), or test the File detail line, which starts with d for a folder.
?, pas de triNo ?, no sorting
? ne vaut pas un caractère et un . est toujours un point (voir les masques). L'ordre des entrées est celui du serveur, qui peut changer d'un serveur à l'autre : si l'ordre compte, triez les noms vous-même, par exemple après un tIterateToFlow et un tSortRow.
? does not stand for one character and a . is always a dot (see the masks). The order of the entries is the server's, which can change from one server to another: if the order matters, sort the names yourself, for instance after a tIterateToFlow and a tSortRow.
Sans connexion existante, chaque composant FTP de la boucle ouvre et ferme sa propre connexion à chaque itération. Un tFTPConnection avant la liste et un tFTPClose après n'en ouvrent qu'une. Pensez alors à Déplacer vers le répertoire courant si les composants suivants utilisent des chemins relatifs. Without an existing connection, each FTP component of the loop opens and closes its own connection at each iteration. A tFTPConnection before the list and a tFTPClose after open only one. Then mind Move to the current directory if the next components use relative paths.
En FTP, il entre dans le répertoire (CWD), puis demande la liste détaillée (LIST) et la liste des noms (NLST) ; sans Détail du fichier, les noms viennent de NLST, dont le contenu dépend du serveur. En SFTP, une seule demande de liste. Toute la liste est lue avant la première itération.
In FTP, it enters the directory (CWD), then asks for the detailed list (LIST) and the list of names (NLST); without File detail, the names come from NLST, whose content depends on the server. In SFTP, a single list request. The whole list is read before the first iteration.
Le masque tient toujours compte de la casse. Le nom du Répertoire distant, lui, est interprété par le serveur : le serveur d'essai, sous Windows, a accepté "/IN" pour /in (en FTP comme en SFTP), ce qu'un serveur Linux ne ferait en général pas. Écrivez-le avec sa casse exacte.
The mask always takes case into account. The name of the Remote directory, however, is read by the server: the test server, on Windows, accepted "/IN" for /in (in FTP as in SFTP), which a Linux server would usually not do. Write it with its exact case.
Pour obtenir la liste comme un flux de données (une ligne par entrée, vers une table ou un fichier), reliez le tFTPFileList à un tIterateToFlow. To get the list as a data flow (one row per entry, to a table or a file), connect the tFTPFileList to a tIterateToFlow.
tFTPConnection · tFTPClose · ouvrir et fermer la connexion partagéeopen and close the shared connectiontFTPFileProperties · taille et date d'un fichier distantsize and date of a remote filetFTPFileExist · tester un fichier ou un dossier distanttest a remote file or foldertFTPGet · tFTPPut · télécharger, envoyerdownload, uploadtFTPDelete · tFTPRename · supprimer, renommerdelete, renametFileList · le même parcours sur la machine du jobthe same walk on the job machine