ComposantsComponents › Fichier › GestionFile › Management
Copie un fichier dans un répertoire de destination, sous son nom ou sous un autre, et peut supprimer le fichier source pour le déplacer. Il copie aussi un répertoire entier, sous-dossiers compris. Relié à un tFileList par un lien Iterate, il copie ou déplace tous les fichiers d'un dossier. Copies a file into a destination directory, under its own name or another one, and can remove the source file to move it. It also copies a whole directory, subfolders included. Connected to a tFileList with an Iterate link, it copies or moves all the files of a folder.
EntréeInput
Aucune : il peut commencer un sous-job. Sinon un lien Iterate (une copie par itération) ou Main (une copie par ligne). None: it can start a subjob. Otherwise one Iterate link (one copy per iteration) or Main link (one copy per row).
SortieOutput
Facultative : un lien Main, avec les lignes reçues, inchangées. Optional: one Main link, with the rows received, unchanged.
Déclencheurs en sortieOutput triggers
On Subjob Ok On Subjob Error On Component Ok On Component Error Run if
On Subjob : seulement quand il commence son sous-job. On Subjob: only when it starts its subjob.
Une copie de sauvegarde avant un traitement, ou un fichier mis à l'endroit où un autre programme l'attend. DESTINATION_FILEPATH donne le chemin de la copie au composant suivant.
A backup copy before a processing, or a file put where another program expects it. DESTINATION_FILEPATH gives the path of the copy to the next component.
Le nom de fichier est le fichier courant du tFileList : ((String) globalMap.get("tFileList_1_CURRENT_FILEPATH")). Avec Supprimer le fichier source, les fichiers sont déplacés. Voir l'exemple.
The file name is the current file of the tFileList: ((String) globalMap.get("tFileList_1_CURRENT_FILEPATH")). With Remove source file, the files are moved. See the example.
"C:/data/in/orders.csv", context.folder + "/out".
Set the File Name to copy and the Destination directory, as Java expressions: "C:/data/in/orders.csv", context.folder + "/out".
Les libellés sont ceux de l'onglet Composant ; le nom technique, en gris, est celui du paramètre dans le fichier du job. Les chemins sont des expressions Java, entre guillemets. Labels are those of the Component tab; the technical name, in grey, is the parameter name in the job file. Paths are Java expressions, in quotes.
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| Nom de fichierFile NameFILENAME | in.csv dans le chemin par défaut des composantsin.csv in the component default path |
Copier un répertoire décochéCopy a directory unchecked | Le fichier à copier. Un fichier absent, ou un dossier, est une erreur. The file to copy. A missing file, or a folder, is an error. |
| Copier un répertoireCopy a directoryENABLE_COPY_DIRECTORY | NonNo | ToujoursAlways | Copie tout le Répertoire source, sous-dossiers et dossiers vides compris, dans un dossier du même nom créé dans la destination. Les options d'un fichier seul disparaissent : un fichier déjà présent est toujours remplacé, la destination toujours créée. Voir l'exemple. Copies the whole Source directory, subfolders and empty folders included, into a folder of the same name created in the destination. The options of a single file disappear: a file already there is always replaced, the destination always created. See the example. |
| Répertoire sourceSource directorySOURCE_DERECTORY | chemin par défaut des composantscomponent default path | Copier un répertoire cochéCopy a directory checked |
Le dossier à copier. Le nom technique s'écrit bien DERECTORY.
The folder to copy. The technical name is indeed spelled DERECTORY.
|
| Répertoire de destinationDestination directoryDESTINATION | chemin par défaut des composantscomponent default path | ToujoursAlways |
Le dossier où va la copie. Pour un répertoire, la copie est destination/nom du répertoire source.
The folder where the copy goes. For a directory, the copy is destination/name of the source directory.
|
| RenommerRenameRENAME | NonNo | Copier un répertoire décochéCopy a directory unchecked | Donne à la copie le Nom du fichier de destination au lieu du nom du fichier source. Gives the copy the Destination filename instead of the name of the source file. |
| Nom du fichier de destinationDestination filenameDESTINATION_RENAME | "NewName.temp" |
Renommer cochéRename checked |
Le nouveau nom, sans le dossier : "orders_2026-11.csv". Vide, la copie s'appelle NewName.temp.
The new name, without the folder: "orders_2026-11.csv". Empty, the copy is named NewName.temp.
|
| Supprimer le fichier sourceRemove source fileREMOVE_FILE | NonNo | Copier un répertoire décochéCopy a directory unchecked | Déplace le fichier au lieu de le copier : la source n'existe plus après le composant. Un fichier source ouvert par un autre programme ne peut pas être déplacé (voir les erreurs). Moves the file instead of copying it: the source no longer exists after the component. A source file open in another program cannot be moved (see the errors). |
| Remplacer le fichier existantReplace existing fileREPLACE_FILE | OuiYes | Copier un répertoire décochéCopy a directory unchecked | Décoché, un fichier qui existe déjà dans la destination est gardé : le composant ne fait rien, sans message, et ne supprime pas la source même si Supprimer le fichier source est coché. Unchecked, a file that already exists in the destination is kept: the component does nothing, without a message, and does not remove the source even if Remove source file is checked. |
| Créer le répertoire s'il n'existe pasCreate the directory if it doesn't existCREATE_DIRECTORY | OuiYes | Copier un répertoire décochéCopy a directory unchecked | Crée le répertoire de destination, et ses parents, s'il manque ; même quand la copie échoue ensuite (source absente). Décoché, une destination absente est une erreur. Creates the destination directory, and its parents, if it is missing; even when the copy then fails (missing source). Unchecked, a missing destination is an error. |
| Échec sur erreurFail on errorFAILON | NonNo | ToujoursAlways |
Coché, une erreur arrête le composant par une exception (et le job, sans lien d'erreur). Décoché, le message est écrit sur la sortie d'erreur, rangé dans ERROR_MESSAGE, et le job continue. Voir les erreurs.
Checked, an error stops the component with an exception (and the job, without an error link). Unchecked, the message is written on the error output, stored in ERROR_MESSAGE, and the job goes on. See the errors.
|
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| Forcer la copie au lieu du déplacementForce copy instead of moveFORCE_COPY_DELETE | NonNo | Supprimer le fichier source cochéRemove source file checked |
Pour un déplacement, copie le fichier puis supprime la source, au lieu de demander au système de déplacer le fichier (Files.move de Java). Le résultat est le même : un fichier dans la destination, plus de source.
For a move, copies the file then removes the source, instead of asking the system to move the file (Java Files.move). The result is the same: a file in the destination, no more source.
|
| Préserver l'heure de dernière modificationPreserve last modified timePRESERVE_LAST_MODIFIED_TIME | NonNo | Copier un répertoire décochéCopy a directory unchecked | Remet sur la copie la date de modification du fichier source. Sous Windows, la copie garde déjà cette date, case cochée ou non (voir l'exemple). Puts the modification date of the source file back on the copy. On Windows, the copy already keeps this date, box checked or not (see the example). |
Disponibles après le composant, à chaque copie. Elles sont rangées même quand rien n'est copié (fichier déjà présent, source et destination identiques). Sous Windows, les chemins d'un fichier seul s'écrivent avec des \, même si les paramètres utilisent des /.
Available after the component, at each copy. They are stored even when nothing is copied (file already there, same source and destination). On Windows, the paths of a single file are written with \, even if the settings use /.
null pour un répertoire.Name of the copy, without the path. null for a directory.null pour un répertoire.Full path of the copy. null for a directory.null sans erreur.The last error message, when Fail on error is unchecked; null without an error.((String) globalMap.get("tFileCopy_1_DESTINATION_FILEPATH"))
((String) globalMap.get("tFileCopy_1_ERROR_MESSAGE"))
Les chemins sont écrits à partir de la variable de contexte folder, raccourcie ici en C:/work, comme les chemins des sorties. Le fichier in/orders.csv fait 21 octets. Un tJava relié par On Subjob Ok affiche le résultat ; les sorties sont celles de la console, copiées depuis une exécution du job sous Windows.
Paths are written from the folder context variable, shortened here to C:/work, like the paths in the outputs. The in/orders.csv file is 21 bytes. A tJava connected with On Subjob Ok prints the result; the outputs are the console ones, copied from a run of the job on Windows.
Nom de fichier : context.folder + "/in/orders.csv" ; Répertoire de destination : context.folder + "/out", qui n'existe pas encore. Les autres réglages restent par défaut.
File Name: context.folder + "/in/orders.csv"; Destination directory: context.folder + "/out", which does not exist yet. The other settings keep their default.
System.out.println("DESTINATION_FILENAME: " + globalMap.get("tFileCopy_1_DESTINATION_FILENAME"));
System.out.println("DESTINATION_FILEPATH: " + globalMap.get("tFileCopy_1_DESTINATION_FILEPATH"));
System.out.println("SOURCE_DIRECTORY: " + globalMap.get("tFileCopy_1_SOURCE_DIRECTORY"));
System.out.println("DESTINATION_DIRECTORY: " + globalMap.get("tFileCopy_1_DESTINATION_DIRECTORY"));
DESTINATION_FILENAME: orders.csv DESTINATION_FILEPATH: C:\work\out\orders.csv SOURCE_DIRECTORY: C:\work\in DESTINATION_DIRECTORY: C:\work\out
Le dossier out est créé ; in/orders.csv reste en place.
The out folder is created; in/orders.csv stays in place.
Le même job, Renommer coché, Nom du fichier de destination : "orders_2026-11.csv". Les deux premières lignes du même tJava :
The same job, Rename checked, Destination filename: "orders_2026-11.csv". The first two lines of the same tJava:
DESTINATION_FILENAME: orders_2026-11.csv DESTINATION_FILEPATH: C:\work\out\orders_2026-11.csv
Avec un nom vide, "" :
With an empty name, "":
DESTINATION_FILENAME: NewName.temp DESTINATION_FILEPATH: C:\work\out\NewName.temp
Le premier exemple, avec Supprimer le fichier source coché. Le tJava lit la copie et teste la source : The first example, with Remove source file checked. The tJava reads the copy and tests the source:
String text = new String(java.nio.file.Files.readAllBytes(
java.nio.file.Paths.get(context.folder + "/out/orders.csv")));
System.out.println("out/orders.csv: " + text.replace("\n", "\\n"));
System.out.println("in/orders.csv exists: "
+ new java.io.File(context.folder + "/in/orders.csv").exists());
out/orders.csv: id;amount\n1;120\n2;80\n in/orders.csv exists: false
out/orders.csv existe déjà et contient old. Même tJava que l'exemple précédent. Remplacer le fichier existant coché (défaut) :
out/orders.csv already exists and holds old. Same tJava as the previous example. Replace existing file checked (default):
out/orders.csv: id;amount\n1;120\n2;80\n in/orders.csv exists: true
Décoché : la copie n'a pas lieu, sans message, et le job se termine avec le code 0. Même sortie avec Supprimer le fichier source coché en plus : la source reste. Unchecked: the copy does not happen, without a message, and the job ends with code 0. Same output with Remove source file checked as well: the source stays.
out/orders.csv: old\n in/orders.csv exists: true
Copier un répertoire coché, Répertoire source : context.folder + "/data", Répertoire de destination : context.folder + "/backup". Avant et après l'exécution :
Copy a directory checked, Source directory: context.folder + "/data", Destination directory: context.folder + "/backup". Before and after the run:
backup/
data/
a.csv "old"
old.txt "old"
data/
a.csv "a"
empty/
sub/
b.csv "b"
backup/
data/
a.csv "a"
empty/
old.txt "old"
sub/
b.csv "b"
data/ inchangéunchanged
La copie va dans backup/data. a.csv est remplacé, le dossier vide empty est recréé, et old.txt, absent de la source, reste : c'est une copie, pas une synchronisation. Le tJava du premier exemple affiche :
The copy goes into backup/data. a.csv is replaced, the empty empty folder is created again, and old.txt, missing from the source, stays: it is a copy, not a synchronization. The tJava of the first example prints:
DESTINATION_FILENAME: null DESTINATION_FILEPATH: null SOURCE_DIRECTORY: C:/work/data DESTINATION_DIRECTORY: C:/work/backup
Une destination qui n'existe pas (context.folder + "/backup/2026-11") est créée, avec ses parents.
A destination that does not exist (context.folder + "/backup/2026-11") is created, with its parents.
in contient a.csv, b.csv et notes.txt. tFileList : Répertoire context.folder + "/in", masque "*.csv". tFileCopy : Nom de fichier ((String) globalMap.get("tFileList_1_CURRENT_FILEPATH")), destination context.folder + "/archive", Supprimer le fichier source coché.
in holds a.csv, b.csv and notes.txt. tFileList: Directory context.folder + "/in", mask "*.csv". tFileCopy: File Name ((String) globalMap.get("tFileList_1_CURRENT_FILEPATH")), destination context.folder + "/archive", Remove source file checked.
// tJava_1
System.out.println("Moved: " + globalMap.get("tFileList_1_CURRENT_FILE")
+ " -> " + globalMap.get("tFileCopy_1_DESTINATION_FILEPATH"));
// tJava_2
System.out.println("Files: " + globalMap.get("tFileList_1_NB_FILE"));
Moved: a.csv -> C:\work\archive\a.csv Moved: b.csv -> C:\work\archive\b.csv Files: 2
Il ne reste que notes.txt dans in.
Only notes.txt is left in in.
Deux lignes, colonne name : a.csv, b.csv. Nom de fichier : context.folder + "/in/" + row1.name, destination context.folder + "/out".
Two rows, column name: a.csv, b.csv. File Name: context.folder + "/in/" + row1.name, destination context.folder + "/out".
a.csv b.csv
Les deux fichiers sont copiés dans out, et les lignes passent au tLogRow sans changement.
Both files are copied into out, and the rows go on to the tLogRow unchanged.
Trois fichiers sources modifiés le 15 janvier 2026 à 8 h 30, copiés le 10 novembre 2026 par quatre tFileCopy enchaînés : out1 réglages par défaut ; out2 Préserver l'heure de dernière modification coché ; out3 Supprimer le fichier source coché ; out4 Supprimer le fichier source et Forcer la copie au lieu du déplacement cochés.
Three source files modified on January 15, 2026 at 8:30, copied on November 10, 2026 by four chained tFileCopy: out1 default settings; out2 Preserve last modified time checked; out3 Remove source file checked; out4 Remove source file and Force copy instead of move checked.
java.text.SimpleDateFormat f = new java.text.SimpleDateFormat("yyyy-MM-dd HH:mm");
for (String p : new String[] {"in/orders.csv", "out1/orders.csv", "out2/orders.csv", "out3/move.csv", "out4/force.csv"}) {
System.out.println(p + " " + f.format(new java.util.Date(new java.io.File(context.folder + "/" + p).lastModified())));
}
in/orders.csv 2026-01-15 08:30 out1/orders.csv 2026-01-15 08:30 out2/orders.csv 2026-01-15 08:30 out3/move.csv 2026-01-15 08:30 out4/force.csv 2026-01-15 08:30
Sous Windows, toutes les copies gardent la date de la source, même sans la case. La copie d'un répertoire la garde aussi. On Windows, all the copies keep the date of the source, even without the box. The copy of a directory keeps it too.
Le nom du job est remplacé par MyJob, les chemins sont raccourcis en C:/work et les traces d'exception abrégées. Les messages qui viennent de Windows sont dans la langue du système (ici le français). Dans chaque cas, un tJava relié par On Subjob Ok affiche ERROR_MESSAGE :
The job name is replaced with MyJob, the paths are shortened to C:/work and the exception traces are shortened. The messages that come from Windows are in the system language (French here). In each case, a tJava connected with On Subjob Ok prints ERROR_MESSAGE:
System.out.println("Next subjob, ERROR_MESSAGE: " + globalMap.get("tFileCopy_1_ERROR_MESSAGE"));
Le premier exemple, Créer le répertoire s'il n'existe pas décoché, out absent. Échec sur erreur décoché (défaut) :
The first example, Create the directory if it doesn't exist unchecked, out missing. Fail on error unchecked (default):
tFileCopy_1 C:\work\in\orders.csv -> C:\work\out\orders.csv Next subjob, ERROR_MESSAGE: C:\work\in\orders.csv -> C:\work\out\orders.csv
Le message ne donne que les deux chemins, sans la cause ; le job continue et se termine avec le code 0. Échec sur erreur coché, le job s'arrête avec le code 1 : The message only gives the two paths, without the cause; the job goes on and ends with code 0. Fail on error checked, the job stops with code 1:
Exception in component tFileCopy_1 (MyJob) java.nio.file.NoSuchFileException: C:\work\in\orders.csv -> C:\work\out\orders.csv at java.base/sun.nio.fs.WindowsException.translateToIOException(WindowsException.java:85) …
Nom de fichier : context.folder + "/in/missing.csv". Échec sur erreur décoché :
File Name: context.folder + "/in/missing.csv". Fail on error unchecked:
The source File "C:/work/in/missing.csv" does not exist or is not a file. tFileCopy_1 C:\work\in\missing.csv Next subjob, ERROR_MESSAGE: C:\work\in\missing.csv
Deux messages : le contrôle de la source, puis l'échec de la copie, qui le remplace dans ERROR_MESSAGE. Le dossier out est quand même créé. Échec sur erreur coché :
Two messages: the check of the source, then the failure of the copy, which replaces it in ERROR_MESSAGE. The out folder is created anyway. Fail on error checked:
Exception in component tFileCopy_1 (MyJob) java.lang.RuntimeException: The source File "C:/work/in/missing.csv" does not exist or is not a file. at demo.myjob_0_1.MyJob.tFileCopy_1Process(MyJob.java:430) …
tJava_1 ouvre in/orders.csv en lecture (new java.io.FileInputStream(…)) et le garde ouvert ; le tFileCopy doit le déplacer (Supprimer le fichier source coché). tJava_2 affiche ERROR_MESSAGE, ferme le fichier et teste la copie :
tJava_1 opens in/orders.csv for reading (new java.io.FileInputStream(…)) and keeps it open; the tFileCopy has to move it (Remove source file checked). tJava_2 prints ERROR_MESSAGE, closes the file and tests the copy:
orders.csv is open tFileCopy_1 C:\work\in\orders.csv -> C:\work\out\orders.csv: Le processus ne peut pas accéder au fichier car ce fichier est utilisé par un autre processus tFileCopy_1 - The source file "C:/work/in/orders.csv" could not be removed from the folder because it is open or you only have read-only rights. Next subjob, ERROR_MESSAGE: tFileCopy_1 - The source file "C:/work/in/orders.csv" could not be removed from the folder because it is open or you only have read-only rights. out/orders.csv exists: false
Sous Windows, un fichier ouvert par un programme ne se déplace pas : rien n'est copié, et la source reste. Le job continue, sauf si Échec sur erreur est coché. On Windows, a file open in a program cannot be moved: nothing is copied, and the source stays. The job goes on, unless Fail on error is checked.
L'exemple du répertoire, sans dossier data. Échec sur erreur décoché :
The directory example, without a data folder. Fail on error unchecked:
Path name "C:\work\data" does not denote a directory, or if an I/O error occurs. Next subjob, ERROR_MESSAGE: Path name "C:\work\data" does not denote a directory, or if an I/O error occurs.
Rien n'est créé dans la destination. Échec sur erreur coché : Nothing is created in the destination. Fail on error checked:
Exception in component tFileCopy_1 (MyJob) java.lang.RuntimeException: Path name "C:\work\data" does not denote a directory, or if an I/O error occurs. at demo.myjob_0_1.MyJob$1CopyDirectory_tFileCopy_1.copyAllFiles(MyJob.java:484) …
Échec sur erreur est décoché par défaut : un fichier absent ou une copie impossible donne un message sur la sortie d'erreur, puis le job continue comme si de rien n'était. Si la suite dépend de la copie, cochez la case, ou testez ERROR_MESSAGE avant de continuer.
Fail on error is unchecked by default: a missing file or a failed copy gives a message on the error output, then the job goes on as if nothing happened. If what follows depends on the copy, check the box, or test ERROR_MESSAGE before going on.
Deux cas où le composant ne fait rien et ne signale rien : Remplacer le fichier existant décoché avec un fichier déjà présent, et une destination identique à la source. Les variables globales sont pourtant remplies. Pour savoir si le fichier est déjà là, placez un tFileExist avant.
Two cases where the component does nothing and reports nothing: Replace existing file unchecked with a file already there, and a destination identical to the source. The global variables are filled anyway. To know if the file is already there, put a tFileExist before.
La copie d'un répertoire ajoute et remplace des fichiers, mais ne supprime rien dans la destination. Pour une copie exacte, videz d'abord la destination avec un tFileDelete (Supprimer le dossier).
The copy of a directory adds and replaces files, but removes nothing in the destination. For an exact copy, empty the destination first with a tFileDelete (Delete Folder).
Le Nom du fichier de destination est une expression Java : il peut reprendre le nom du fichier courant d'un tFileList ou la date du jour, par exemple "orders_" + TalendDate.getDate("yyyyMMdd") + ".csv".
The Destination filename is a Java expression: it can use the name of the current file of a tFileList or today's date, for example "orders_" + TalendDate.getDate("yyyyMMdd") + ".csv".
tFileList · une itération par fichier d'un dossierone iteration per file of a foldertFileDelete · supprimer un fichier ou un dossierdelete a file or a foldertFileExist · tFileProperties · tester un fichier, lire ses propriétéstest a file, read its propertiestFileArchive · tFileUnarchive · compresser ou décompresser des fichierscompress or uncompress filestFileTouch · créer un fichier videcreate an empty filetCreateTemporaryFile · créer un fichier temporairecreate a temporary file