ComposantsComponents

ComposantsComponents › Internet › FTP

tFTPFileList

tFTPFileList

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

UtilisationUsage

Traiter chaque fichier distantProcess each remote file

OnSubjobOk Iterate row1 (Main) tFTPConnection_1 tFTPFileList_1 tFTPFileProperties_1 tLogRow_1

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.

Après la boucleAfter the loop

OnSubjobOk tFTPFileList_1 tJava_1

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.

  1. Déposez le tFTPFileList depuis la famille Internet › FTP de la palette. Drop the tFTPFileList 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, puis une ligne par masque dans Fichiers, avec ses guillemets : "*.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.
  4. Reliez-le au composant à exécuter pour chaque entrée (clic droit › Ligne › Iterate) et utilisez les variables globales dans ses paramètres. Connect it to the component to run for each entry (right-click › Row › Iterate) and use the global variables in its settings.

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

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

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.

Paramètres avancésAdvanced settings

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.

Variables globalesGlobal variables

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.

CURRENT_FILE String
Nom de l'entrée, sans chemin : 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.
CURRENT_FILEPATH String
Le Répertoire distant tel qu'il est écrit (\ 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).
NB_FILE Integer
Après la boucle : le nombre d'entrées données (une entrée retenue par deux masques compte deux fois). Pendant la boucle : 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"))

ExemplesExamples

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.

Le répertoire distantThe remote directory

/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

Les deux tJavaThe two tJava

// 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"));

Tout le répertoire, en FTP puis en SFTPThe whole directory, in FTP then in SFTP

Iterate tFTPFileList_1 tJava_1

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.

Masque "*.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.

Deux masquesTwo masks

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.

Chemins relatifsRelative paths

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.

Détail du fichierFile detail

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.

Connexion existante et répertoire courantExisting connection and current directory

OnSubjobOk OnSubjobOk OnSubjobOk tFTPConnection_1 tFTPFileList_1 tJava_2 tFTPClose_1

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.

Les propriétés de chaque fichierThe properties of each file

OnSubjobOk Iterate row1 (Main) tFTPConnection_1 tFTPFileList_1 tFTPFileProperties_1 tLogRow_1

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.

Différences avec tFileListDifferences with tFileList

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)

ErreursErrors

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 absentMissing directory

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.

Un fichier comme répertoireA file as the directory

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 sans guillemetsMask without quotes

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.

Conseils et limitesTips and limits

Les dossiers passent aussiFolders go through too

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 ?, 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.

Une connexion pour toute la boucleOne connection for the whole loop

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.

Ce que le composant demande au serveurWhat the component asks the server

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.

Casse du répertoireCase of the directory

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.

Une ligne par fichierOne row per file

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.

Voir aussiSee also