ComposantsComponents

ComposantsComponents › Fichier › GestionFile › Management

tFileTouch

tFileTouch

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.

UtilisationUsage

Un fichier témoin à la fin du traitementA flag file at the end of the processing

row1 (Main) OnSubjobOk tFileInputDelimited_1 tFileOutputDelimited_1 tFileTouch_1

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.

  1. Déposez le tFileTouch depuis la famille Fichier › Gestion de la palette. Drop the tFileTouch from the File › Management family of the palette.
  2. Indiquez le Nom de fichier, en expression Java : context.folder + "/out/orders.done". Set the File Name, as a Java expression: context.folder + "/out/orders.done".
  3. Si son dossier peut manquer, cochez Créer le répertoire s'il n'existe pas : sinon le job s'arrête sur une erreur. If its folder can be missing, check Create directory if does not exist: otherwise the job stops on an error.

ParamètresSettings

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

ExemplesExamples

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())));

Créer un fichier videCreate an empty file

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

Fichier déjà présentFile already there

OnSubjobOk OnSubjobOk tJava_1 tFileTouch_1 tJava_2

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.

Dossier absent, crééMissing folder, created

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.

Un fichier par ligne d'un fluxOne file per row of a flow

row1 (Main) row2 (Main) tFixedFlowInput_1 tFileTouch_1 tLogRow_1

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.

ErreursErrors

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.

Dossier absentMissing folder

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.

Conseils et limitesTips and limits

Il ne vide pas un fichierIt does not empty a file

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

Fichier témoinFlag file

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.

Voir aussiSee also