ComposantsComponents › Fichier › GestionFile › Management
Crée un fichier vide. Si le fichier existe déjà, son contenu est gardé et seule sa date de modification passe à l'heure actuelle, comme la commande touch d'Unix. Il sert surtout à poser un fichier témoin (« traitement terminé ») qu'un autre job ou un autre programme attend.
Creates an empty file. If the file already exists, its content is kept and only its modification date changes to the current time, like the Unix touch command. It is mostly used to put a flag file ("processing done") that another job or program waits for.
EntréeInput
Aucune : il peut commencer un sous-job. Sinon un lien Iterate ou Main (un fichier par ligne). None: it can start a subjob. Otherwise one Iterate or Main link (one file 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.
Le fichier témoin (orders.done) n'est créé que si le sous-job d'avant a réussi : le programme qui attend le fichier de données sait qu'il est complet.
The flag file (orders.done) is only created if the previous subjob succeeded: the program that waits for the data file knows it is complete.
context.folder + "/out/orders.done".
Set the File Name, as a Java expression: context.folder + "/out/orders.done".
Le nom technique, en gris, est celui du paramètre dans le fichier du job. Le composant n'a pas de paramètres avancés propres, pas d'option Échec sur erreur (une erreur arrête toujours le composant) et pas de variable globale propre. The technical name, in grey, is the parameter name in the job file. The component has no advanced settings of its own, no Fail on error option (an error always stops the component) and no global variable of its own.
| ParamètreSetting | DéfautDefault | OngletTab | Description |
|---|---|---|---|
| Nom de fichierFile NameFILENAME | in.csv dans le chemin par défaut des composantsin.csv in the component default path |
Paramètres simplesBasic settings | Le fichier à créer, ou dont la date change s'il existe. Son contenu n'est jamais modifié. The file to create, or whose date changes if it exists. Its content is never changed. |
| Créer le répertoire s'il n'existe pasCreate directory if does not existCREATEDIR | NonNo | Paramètres simplesBasic settings | Crée le dossier du fichier, et ses parents, s'il manque. Décoché, un dossier absent arrête le job (voir les erreurs). Creates the folder of the file, and its parents, if it is missing. Unchecked, a missing folder stops the job (see the errors). |
Le chemin est écrit à partir de la variable de contexte folder. Un tJava relié par On Subjob Ok affiche le fichier ; les sorties sont celles de la console, copiées depuis une exécution du job le 10 novembre 2026.
The path is written from the folder context variable. A tJava connected with On Subjob Ok prints the file; the outputs are the console ones, copied from a run of the job on November 10, 2026.
java.io.File f = new java.io.File(context.folder + "/out/orders.done");
System.out.println(f.getName() + ": exists " + f.exists() + ", " + f.length() + " bytes, modified "
+ new java.text.SimpleDateFormat("yyyy-MM-dd HH:mm").format(new java.util.Date(f.lastModified())));
Nom de fichier : context.folder + "/out/orders.done", dans un dossier out qui existe.
File Name: context.folder + "/out/orders.done", in an out folder that exists.
orders.done: exists true, 0 bytes, modified 2026-11-10 13:59
orders.done existe, contient batch 42 (9 octets) et date du 15 janvier 2026. Les deux tJava affichent le fichier avant et après, précédé de "Before: " et "After: " :
orders.done exists, holds batch 42 (9 bytes) and dates from January 15, 2026. The two tJava print the file before and after, preceded by "Before: " and "After: ":
Before: orders.done: exists true, 9 bytes, modified 2026-01-15 08:30 After: orders.done: exists true, 9 bytes, modified 2026-11-10 13:59
Le contenu est gardé ; seule la date change. The content is kept; only the date changes.
Nom de fichier : context.folder + "/flags/2026/orders.done", sans dossier flags ; Créer le répertoire s'il n'existe pas coché. Le tJava teste le fichier :
File Name: context.folder + "/flags/2026/orders.done", without a flags folder; Create directory if does not exist checked. The tJava tests the file:
System.out.println("Next subjob: "
+ new java.io.File(context.folder + "/flags/2026/orders.done").exists());
Next subjob: true
flags et flags/2026 sont créés.
flags and flags/2026 are created.
Deux lignes, colonne name : a.done, b.done. Nom de fichier : context.folder + "/out/" + row1.name.
Two rows, column name: a.done, b.done. File Name: context.folder + "/out/" + row1.name.
a.done b.done
out contient ensuite deux fichiers vides, a.done et b.done ; les lignes passent au tLogRow sans changement.
out then holds two empty files, a.done and b.done; the rows go on to the tLogRow unchanged.
Le nom du job est remplacé par MyJob et la trace d'exception est abrégée.
The job name is replaced with MyJob and the exception trace is shortened.
Le même job, Créer le répertoire s'il n'existe pas décoché (défaut) : The same job, Create directory if does not exist unchecked (default):
Exception in component tFileTouch_1 (MyJob) java.io.IOException: Le chemin d’accès spécifié est introuvable at java.base/java.io.WinNTFileSystem.createFileExclusively0(Native Method) at java.base/java.io.WinNTFileSystem.createFileExclusively(WinNTFileSystem.java:536) at java.base/java.io.File.createNewFile(File.java:1045) at demo.myjob_0_1.MyJob.tFileTouch_1Process(MyJob.java:426) …
Le message vient de Windows, dans la langue du système (ici le français), et ne donne pas le chemin. Le job s'arrête avec le code 1 ; le sous-job suivant ne s'exécute pas. The message comes from Windows, in the system language (French here), and does not give the path. The job stops with code 1; the next subjob does not run.
Sur un fichier existant, le tFileTouch ne change que la date. Pour repartir d'un fichier vide, supprimez-le d'abord avec un tFileDelete (Échec sur erreur décoché, s'il peut manquer).
On an existing file, the tFileTouch only changes the date. To start again from an empty file, delete it first with a tFileDelete (Fail on error unchecked, if it can be missing).
Reliez le tFileTouch par On Subjob Ok au sous-job qui écrit les données : en cas d'erreur, le témoin n'est pas posé. Le job qui attend peut le tester avec un tFileExist ou l'attendre avec un tWaitForFile.
Connect the tFileTouch with On Subjob Ok to the subjob that writes the data: on an error, the flag is not put. The job that waits can test it with a tFileExist or wait for it with a tWaitForFile.
tCreateTemporaryFile · un fichier vide au nom unique, supprimé à la fin du joban empty file with a unique name, deleted at the end of the jobtFileExist · tester l'existence d'un fichiertest whether a file existstFileProperties · lire la taille et la date d'un fichierread the size and date of a filetFileDelete · supprimer un fichier ou un dossierdelete a file or a foldertFileCopy · copier ou déplacer un fichiercopy or move a file