ComposantsComponents › Fichier › GestionFile › Management
Compare un fichier à un fichier de référence, ligne à ligne (mode texte) ou octet par octet (mode binaire). Il affiche un message dans la console, met le résultat dans une variable globale et peut envoyer une ligne qui décrit la comparaison. Il sert surtout à vérifier la sortie d'un job contre un fichier attendu. Compares a file with a reference file, line by line (text mode) or byte by byte (binary mode). It prints a message in the console, puts the result in a global variable and can send a row that describes the comparison. It is mostly used to check the output of a job against an expected file.
EntréeInput
Aucune : il commence son sous-job. Sinon un lien Iterate, ou un lien Main : une comparaison par ligne. None: it starts its subjob. Otherwise one Iterate link, or one Main link: one comparison per row.
SortieOutput
Main facultative : une ligne par comparaison, avec le schéma fixe.optional: one row per comparison, with the fixed schema.
Pas avec une entrée Main : le job ne compile pas (voir les erreurs). Not with a Main input: the job does not compile (see the errors).
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.
DIFFERENCE vaut true quand les fichiers sont identiquesDIFFERENCE is true when the files are identical
Malgré son nom, la variable globale dit si la comparaison a réussi : true pour des fichiers identiques, false s'ils diffèrent. La colonne differ de la ligne de sortie dit l'inverse : 1 s'ils diffèrent, 0 sinon. Vérifiez le sens de chaque condition.
Despite its name, the global variable tells whether the comparison succeeded: true for identical files, false if they differ. The differ column of the output row says the opposite: 1 if they differ, 0 otherwise. Check the meaning of each condition.
DIFFERENCE, ou reliez la sortie Main pour garder une trace de la comparaison.
Choose what comes next with a Run if on DIFFERENCE, or connect the Main output to keep a record of the comparison.
Les libellés sont ceux de l'onglet Composant ; le nom technique, en gris, est celui du paramètre dans le fichier du job. Tous les paramètres restent visibles, quel que soit le mode. Labels are those of the Component tab; the technical name, in grey, is the parameter name in the job file. All the settings stay visible, whatever the mode.
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| SchémaSchemaSCHEMA | 7 colonnes fixes7 fixed columns | ToujoursAlways | En lecture seule : les colonnes de la ligne de sortie. Read-only: the columns of the output row. |
| Mode de comparaisonComparison ModeCOMPARISON_MODE | Comparer en mode texteCompare in text mode | ToujoursAlways |
Comparer en mode texte (TEXT_CMP) : les deux fichiers sont lus ligne à ligne avec l'Encodage ; les fins de ligne (\n, \r\n) et le saut de ligne final ne comptent pas. Comparer en mode binaire (BINARY_CMP) : tailles d'abord, puis octet par octet ; la moindre différence compte.
Compare in text mode (TEXT_CMP): both files are read line by line with the Encoding; line ends (\n, \r\n) and the final line break do not count. Compare in binary mode (BINARY_CMP): sizes first, then byte by byte; the smallest difference counts.
|
| Fichier à comparerFile to compareFILE | chemin par défaut des composants + /need_test.txtcomponent default path + /need_test.txt |
ToujoursAlways | Le fichier à vérifier, en expression Java. S'il n'existe pas, le job s'arrête. The file to check, as a Java expression. If it does not exist, the job stops. |
| Fichier de référenceReference fileFILE_REF | chemin par défaut des composants + /reference.txtcomponent default path + /reference.txt |
ToujoursAlways | Le fichier attendu, en expression Java. S'il n'existe pas, le job s'arrête (voir les erreurs). The expected file, as a Java expression. If it does not exist, the job stops (see the errors). |
| Si des différences sont détectées, les afficherIf differences detected, displayDIFFER_MESSAGE | "[job " + jobName + "] Files differ" |
ToujoursAlways |
Le message quand les fichiers diffèrent, en expression Java : texte entre guillemets, qui peut reprendre jobName, une variable de contexte ou une variable globale. Il va dans la console et dans la colonne message.
The message when the files differ, as a Java expression: text in quotes, which can include jobName, a context variable or a global variable. It goes to the console and to the message column.
|
| Si aucune différence détectée, afficherIf no differences detected, displayNO_DIFFER_MESSAGE | "[job " + jobName + "] Files are identical" |
ToujoursAlways | Le message quand les fichiers sont identiques, de la même façon. The message when the files are identical, the same way. |
| Afficher dans la consolePrint to consolePRINT | OuiYes | ToujoursAlways | Écrit le message sur la sortie standard. Décochée, rien n'est écrit ; la variable globale et la ligne de sortie ne changent pas. Writes the message to the standard output. Unchecked, nothing is written; the global variable and the output row do not change. |
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| EncodageEncodingENCODING | "ISO-8859-15" |
ToujoursAlways | L'encodage dans lequel les deux fichiers sont lus en mode texte. Sans effet en mode binaire. The encoding both files are read in, in text mode. No effect in binary mode. |
"yyyy-MM-dd HH:mm:ss").The time of the comparison ("yyyy-MM-dd HH:mm:ss" pattern).tFileCompare_1.The unique name of the component: tFileCompare_1.1 si les fichiers diffèrent, 0 s'ils sont identiques.1 if the files differ, 0 if they are identical.true si les fichiers sont identiques, false s'ils diffèrent. Écrite à chaque comparaison.true if the files are identical, false if they differ. Written at each comparison.// les fichiers diffèrent// the files differ
!((Boolean) globalMap.get("tFileCompare_1_DIFFERENCE"))
Les fichiers sont dans C:/data (chemin abrégé) ; le nom du job est remplacé par MyJob. orders.csv est la référence : 4 lignes terminées par \n. Les sorties sont celles de la console, copiées depuis une exécution du job.
The files are in C:/data (shortened path); the job name is replaced with MyJob. orders.csv is the reference: 4 lines ended with \n. The outputs are the console ones, copied from a run of the job.
orders.csvThe files compared with orders.csvorders.csv "id;amount\n1;120\n2;80\n3;45\n"
orders_copy.csv "id;amount\n1;120\n2;80\n3;45\n" (copy)
orders_changed.csv "id;amount\n1;120\n2;85\n3;45\n" (80 → 85)
orders_crlf.csv "id;amount\r\n1;120\r\n2;80\r\n3;45\r\n" (\r\n)
orders_noeol.csv "id;amount\n1;120\n2;80\n3;45" (no final \n)
header_only.csv "id;amount\n"
Fichier à comparer orders_copy.csv, référence orders.csv. Le tJava affiche la variable globale.
File to compare orders_copy.csv, reference orders.csv. The tJava prints the global variable.
System.out.println("DIFFERENCE = "
+ globalMap.get("tFileCompare_1_DIFFERENCE"));
[job MyJob] Files are identical DIFFERENCE = true
Le même job avec orders_changed.csv, plus un Run if vers un tJava qui affiche To check: orders_changed.csv.
The same job with orders_changed.csv, plus a Run if to a tJava that prints To check: orders_changed.csv.
// Run if → tJava_2
!((Boolean) globalMap.get("tFileCompare_1_DIFFERENCE"))
[job MyJob] Files differ To check: orders_changed.csv DIFFERENCE = false
Le message vient en premier, puis la branche du Run if, puis le sous-job suivant. The message comes first, then the Run if branch, then the next subjob.
Cinq tFileCompare reliés par On Subjob Ok, tous avec la référence orders.csv. Chaque message dit le mode et le fichier comparé :
Five tFileCompare connected with On Subjob Ok, all with the orders.csv reference. Each message gives the mode and the compared file:
// file mode label
tFileCompare_1 orders_crlf.csv text "Text, CRLF / LF"
tFileCompare_2 orders_crlf.csv binary "Binary, CRLF / LF"
tFileCompare_3 orders_noeol.csv text "Text, no final line break"
tFileCompare_4 orders_noeol.csv binary "Binary, no final line break"
tFileCompare_5 orders_copy.csv binary "Binary, copy"
// messages: "<label>: differ" / "<label>: identical"
Text, CRLF / LF: identical Binary, CRLF / LF: differ Text, no final line break: identical Binary, no final line break: differ Binary, copy: identical
En mode texte, seules les lignes comptent : \r\n ou \n, saut de ligne final ou non, le résultat est « identique ». En mode binaire, ces fichiers n'ont pas la même taille : ils diffèrent.
In text mode, only the lines count: \r\n or \n, final line break or not, the result is “identical”. In binary mode, these files do not have the same size: they differ.
orders_changed.csv contre orders.csv, Afficher dans la console décoché, tLogRow en mode Vertical. Le cadre est ajusté aux chemins abrégés.
orders_changed.csv against orders.csv, Print to console unchecked, tLogRow in Vertical mode. The frame is adjusted to the shortened paths.
.----------------------------------------. | #1. tLogRow_1 | +-----------+----------------------------+ | key | value | +-----------+----------------------------+ | file | C:/data/orders_changed.csv | | file_ref | C:/data/orders.csv | | moment | 2026-11-10 13:57:09 | | job | MyJob | | component | tFileCompare_1 | | differ | 1 | | message | [job MyJob] Files differ | +-----------+----------------------------+
Seul le tLogRow écrit : le message n'est plus affiché par le composant, mais reste dans message.
Only the tLogRow writes: the message is no longer printed by the component, but stays in message.
Le tFixedFlowInput envoie quatre lignes name, file, ref. Le tFileCompare n'a pas de sortie ; ses paramètres lisent la ligne :
The tFixedFlowInput sends four rows name, file, ref. The tFileCompare has no output; its settings read the row:
row1.file // Fichier à comparer// File to compare
row1.ref // Fichier de référence// Reference file
row1.name + ": differ" // Si des différences…// If differences…
row1.name + ": identical" // Si aucune différence…// If no differences…
copy: identical changed: differ header only / orders: differ orders / header only: differ
Les deux dernières lignes comparent header_only.csv et orders.csv dans les deux sens : un nombre de lignes différent compte comme une différence, quel que soit le fichier le plus long.
The last two rows compare header_only.csv and orders.csv both ways: a different number of lines counts as a difference, whichever file is the longer one.
tFileList : dossier "C:/data/out", masque "*.csv". Dans C:/data/expected, january.csv est le même, february.csv a un montant différent.
tFileList: folder "C:/data/out", mask "*.csv". In C:/data/expected, january.csv is the same, february.csv has a different amount.
// Fichier à comparer// File to compare
((String) globalMap.get("tFileList_1_CURRENT_FILEPATH"))
// Fichier de référence// Reference file
"C:/data/expected/" + ((String) globalMap.get("tFileList_1_CURRENT_FILE"))
// Si des différences sont détectées, les afficher// If differences detected, display
((String) globalMap.get("tFileList_1_CURRENT_FILE")) + " differs from the expected file"
// Si aucune différence détectée, afficher// If no differences detected, display
((String) globalMap.get("tFileList_1_CURRENT_FILE")) + " is as expected"
february.csv differs from the expected file january.csv is as expected
Le même job avec les messages par défaut, Afficher dans la console décoché et une sortie Main vers un tLogRow (mode Simple) : The same job with the default messages, Print to console unchecked and a Main output to a tLogRow (Basic mode):
C:\data\out\february.csv|C:/data/expected/february.csv|2026-11-10 14:18:33|MyJob|tFileCompare_1|1|[job MyJob] Files differ C:\data\out\january.csv|C:/data/expected/january.csv|2026-11-10 14:18:33|MyJob|tFileCompare_1|0|[job MyJob] Files are identical
file est le chemin donné par le tFileList, avec des \ sous Windows.
file is the path given by the tFileList, with \ on Windows.
Le nom du job est remplacé par MyJob, les chemins abrégés ; les traces d'exception et les messages de compilation sont raccourcis.
The job name is replaced with MyJob, the paths shortened; exception traces and compilation messages are cut.
Fichier à comparer "C:/data/orders.csv", Fichier de référence "C:/data/expected/orders.csv", qui n'existe pas. Mode texte.
File to compare "C:/data/orders.csv", Reference file "C:/data/expected/orders.csv", which does not exist. Text mode.
Exception in component tFileCompare_1 (MyJob) java.io.FileNotFoundException: C:\data\expected\orders.csv (Le fichier spécifié est introuvable) at java.base/java.io.FileInputStream.open0(Native Method) … at demo.myjob_0_1.MyJob.tFileCompare_1Process(MyJob.java:401) …
Le job s'arrête avec le code 1, sans message de comparaison. La fin du message vient du système (ici un Windows en français). Pour un fichier qui peut manquer, testez-le d'abord avec un tFileExist.
The job stops with exit code 1, without a comparison message. The end of the message comes from the system (here a Windows in French). For a file that may be missing, test it first with a tFileExist.
Le job de l'exemple « une comparaison par ligne », avec en plus une sortie row2 vers un tLogRow :
The job of the “one comparison per row” example, with in addition a row2 output to a tLogRow:
MyJob.java:1523: error: cannot find symbol
row2.file_ref = row1.ref;
^
symbol: variable file_ref
location: variable row2 of type row1Struct
…
Avec une entrée Main, le générateur donne à la ligne de sortie la structure de la ligne d'entrée (row1Struct) : les colonnes du schéma fixe n'y sont pas. Le job ne compile pas. Gardez l'entrée sans sortie, ou passez par un lien Iterate (après un tFlowToIterate).
With a Main input, the generator gives the output row the structure of the input row (row1Struct): the columns of the fixed schema are not there. The job does not compile. Keep the input without an output, or go through an Iterate link (after a tFlowToIterate).
Un fichier écrit avec \r\n au lieu de \n, ou sans saut de ligne final, passe pour identique en mode texte. Si les octets exacts comptent (fichier livré à un autre système), prenez le mode binaire.
A file written with \r\n instead of \n, or without a final line break, counts as identical in text mode. If the exact bytes matter (file delivered to another system), take the binary mode.
Le composant s'arrête à la première différence et ne dit ni où elle est ni combien il y en a : le résultat est oui ou non. The component stops at the first difference and tells neither where it is nor how many there are: the result is yes or no.
Le message affiché va sur la sortie standard. Pour garder une trace, décochez Afficher dans la console et reliez la sortie Main à un composant qui écrit dans un fichier ou une table : la ligne a l'heure, le job et les deux fichiers. The printed message goes to the standard output. To keep a record, uncheck Print to console and connect the Main output to a component that writes to a file or a table: the row has the time, the job and both files.
Les messages sont des expressions Java : dans une boucle, reprenez le nom du fichier courant, comme dans l'exemple. Un texte seul s'écrit entre guillemets. The messages are Java expressions: in a loop, include the name of the current file, as in the example. Plain text is written in quotes.
tFileProperties · MD5 d'un fichier, pour comparer sans le fichier de référenceMD5 of a file, to compare without the reference filetFileExist · tester si un fichier existetest whether a file existstFileRowCount · compter les lignes d'un fichiercount the lines of a filetFileList · parcourir les fichiers d'un dossiergo through the files of a foldertLogRow · afficher la ligne de sortieprint the output rowtJava · choisir la branche avec Run ifchoose the branch with Run if