ComposantsComponents

ComposantsComponents › Fichier › GestionFile › Management

tFileCompare

tFileCompare

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.

UtilisationUsage

Arrêter si un fichier changeStop if a file changes

If tFileCompare_1 tDie_1

Condition : !((Boolean) globalMap.get("tFileCompare_1_DIFFERENCE")), c'est-à-dire « les fichiers diffèrent ». Voir l'exemple. Condition: !((Boolean) globalMap.get("tFileCompare_1_DIFFERENCE")), that is “the files differ”. See the example.

Chaque fichier d'un dossierEach file of a folder

Iterate row1 (Main) tFileList_1 tFileCompare_1 tLogRow_1

Chaque fichier produit est comparé au fichier du même nom dans un dossier de référence. Voir l'exemple. Each produced file is compared with the file of the same name in a reference folder. See the example.

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.

  1. Déposez le tFileCompare depuis la famille Fichier › Gestion de la palette. Drop the tFileCompare from the File › Management family of the palette.
  2. Indiquez le Fichier à comparer et le Fichier de référence, puis le Mode de comparaison. Set the File to compare and the Reference file, then the Comparison Mode.
  3. Adaptez les deux messages, ou décochez Afficher dans la console. Adapt the two messages, or uncheck Print to console.
  4. Choisissez la suite avec un Run if sur 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.

Paramètres simplesBasic settings

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ètres avancésAdvanced settings

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.

Ligne de sortieOutput row

file String
La valeur de Fichier à comparer.The value of File to compare.
file_ref String
La valeur de Fichier de référence.The value of Reference file.
moment Date
L'heure de la comparaison (modèle "yyyy-MM-dd HH:mm:ss").The time of the comparison ("yyyy-MM-dd HH:mm:ss" pattern).
job String
Le nom du job.The job name.
component String
Le nom unique du composant : tFileCompare_1.The unique name of the component: tFileCompare_1.
differ Integer
1 si les fichiers diffèrent, 0 s'ils sont identiques.1 if the files differ, 0 if they are identical.
message String
Le message choisi, même si Afficher dans la console est décoché.The chosen message, even if Print to console is unchecked.

Variable globaleGlobal variable

DIFFERENCE Boolean
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"))

ExemplesExamples

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.

Les fichiers comparés à orders.csvThe files compared with orders.csv

orders.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"

Fichiers identiques, réglages par défautIdentical files, default settings

OnSubjobOk tFileCompare_1 tJava_1

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

Fichiers différents, avec Run ifDifferent files, with Run if

If OnSubjobOk tFileCompare_1 tJava_2 tJava_1

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.

Mode texte ou binaireText or binary mode

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.

La ligne de sortieThe output row

row1 (Main) tFileCompare_1 tLogRow_1

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.

Une comparaison par ligne d'un fluxOne comparison per row of a flow

row1 (Main) tFixedFlowInput_1 tFileCompare_1

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.

Chaque fichier d'un dossierEach file of a folder

Iterate tFileList_1 tFileCompare_1

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.

ErreursErrors

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 de référence absentMissing reference file

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.

Entrée Main et sortie MainMain input and Main output

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

Conseils et limitesTips and limits

Le mode texte ignore les fins de ligneText mode ignores line ends

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.

Pas de détail des différencesNo detail of the differences

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.

Une trace des comparaisonsA record of the comparisons

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.

Des messages qui disent quel fichierMessages that say which file

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.

Voir aussiSee also