ComposantsComponents › Fichier › GestionFile › Management
Compte les lignes d'un fichier texte et met le nombre dans une variable globale, sans lire les données. Il sert à vérifier qu'un fichier contient des lignes avant de le charger, ou à contrôler un fichier écrit. L'en-tête compte comme une ligne. Counts the lines of a text file and puts the number in a global variable, without reading the data. It is used to check that a file has lines before loading it, or to check a written file. The header counts as a line.
EntréeInput
Aucune : il commence son sous-job. Sinon un lien Iterate, ou un lien Main : le comptage est refait à chaque ligne. None: it starts its subjob. Otherwise one Iterate link, or one Main link: the count is done again for each row.
SortieOutput
Aucune : pas de flux de données. Le nombre est dans la variable globale COUNT.
None: no data flow. The number is in the COUNT global variable.
Un lien Iterate est accepté : ses composants s'exécutent une fois, après le comptage. An Iterate link is accepted: its components run once, after the count.
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.
Condition : ((Integer) globalMap.get("tFileRowCount_1_COUNT")) > 1, plus qu'un en-tête. Voir l'exemple.
Condition: ((Integer) globalMap.get("tFileRowCount_1_COUNT")) > 1, more than a header. See the example.
Nom de fichier : ((String) globalMap.get("tFileList_1_CURRENT_FILEPATH")) ; le tJava lit COUNT à chaque fichier. Voir l'exemple.
File Name: ((String) globalMap.get("tFileList_1_CURRENT_FILEPATH")); the tJava reads COUNT for each file. See the example.
COUNT dans la condition d'un Run if (clic droit › Déclencher › Run if) ou dans les composants qui suivent.
Read COUNT in the condition of a Run if (right-click › Trigger › Run if) or in the components that follow.
Les libellés sont ceux de l'onglet Composant ; 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. Labels are those of the Component tab; the technical name, in grey, is the parameter name in the job file. The component has no advanced settings.
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| Nom de fichierFile NameFILENAME | chemin par défaut des composants + /in.csvcomponent default path + /in.csv |
ToujoursAlways |
Le fichier à compter, en expression Java. Un nom qui finit par .xls est lu comme un classeur Excel 97-2003 : ce sont les lignes de toutes ses feuilles qui sont comptées. Un nom en .xlsx arrête le job (voir les erreurs). Majuscules ou minuscules, l'extension est reconnue.
The file to count, as a Java expression. A name that ends with .xls is read as an Excel 97-2003 workbook: the rows of all its sheets are counted. A name in .xlsx stops the job (see the errors). Upper or lower case, the extension is recognized.
|
| Séparateur de lignesRow SeparatorROWSEPARATOR | "\n" |
ToujoursAlways |
Ce qui termine une ligne, en expression Java, d'un ou plusieurs caractères. "\n" compte aussi les lignes d'un fichier Windows (\r\n) : le \r reste dans la ligne. "\r\n" ne coupe plus aux \n seuls. Sans effet pour un .xls.
What ends a line, as a Java expression, of one or more characters. "\n" also counts the lines of a Windows file (\r\n): the \r stays in the line. "\r\n" no longer cuts at lone \n. No effect for an .xls.
|
| Ignorer les lignes videsIgnore empty rowsIGNORE_EMPTY_ROW | NonNo | ToujoursAlways |
Ne compte pas les lignes vides : rien entre deux séparateurs. Une ligne d'espaces n'est pas vide, ni, avec "\n", une ligne vide d'un fichier Windows (elle contient \r). Les lignes vides à la fin du fichier ne sont jamais comptées, case cochée ou non. Pour un .xls : les lignes sans cellule.
Does not count empty lines: nothing between two separators. A line of spaces is not empty, nor, with "\n", an empty line of a Windows file (it holds \r). Empty lines at the end of the file are never counted, box checked or not. For an .xls: the rows without a cell.
|
| EncodageEncodingENCODING | "ISO-8859-15" |
ToujoursAlways | L'encodage dans lequel le fichier est lu. Il ne change le compte que si un saut de ligne n'y tient pas sur un seul octet, comme en UTF-16 ; pour l'UTF-8 ou l'ISO-8859-15, le résultat est le même. The encoding the file is read in. It only changes the count if a line break does not fit in a single byte, as in UTF-16; for UTF-8 or ISO-8859-15, the result is the same. |
((Integer) globalMap.get("tFileRowCount_1_COUNT"))
Dans les premiers exemples, plusieurs tFileRowCount se suivent par On Subjob Ok, puis un tJava affiche chaque COUNT avec le nom du fichier et le réglage. Les fichiers sont dans C:/data (chemin abrégé). Les sorties sont celles de la console, copiées depuis une exécution du job.
In the first examples, several tFileRowCount follow one another through On Subjob Ok, then a tJava prints each COUNT with the file name and the setting. The files are in C:/data (shortened path). The outputs are the console ones, copied from a run of the job.
Réglages par défaut. Le même fichier de 4 lignes (un en-tête, 3 lignes de données), en trois versions, puis un fichier vide : Default settings. The same file of 4 lines (a header, 3 data lines), in three versions, then an empty file:
orders.csv "id;amount\n1;120\n2;80\n3;45\n"
orders_crlf.csv "id;amount\r\n1;120\r\n2;80\r\n3;45\r\n"
orders_noeol.csv "id;amount\n1;120\n2;80\n3;45"
empty.txt ""
orders.csv: 4 orders_crlf.csv: 4 orders_noeol.csv: 4 empty.txt: 0
Le saut de ligne final n'ajoute pas de ligne ; une dernière ligne sans saut de ligne est comptée. The final line break does not add a line; a last line without a line break is counted.
Deux fichiers : a, une ligne vide, b, puis deux lignes vides à la fin.
Two files: a, an empty line, b, then two empty lines at the end.
blank.txt "a\n\nb\n\n\n"
blank_crlf.txt "a\r\n\r\nb\r\n\r\n"
blank.txt: 3 blank.txt, ignore empty rows: 2 blank_crlf.txt: 4 blank_crlf.txt, ignore empty rows: 4 blank_crlf.txt, ignore empty rows, CRLF separator: 2
blank.txt : les lignes vides de la fin ne comptent jamais ; la case retire celle du milieu. blank_crlf.txt avec "\n" : chaque ligne vide garde son \r, rien n'est vide. Avec Séparateur de lignes "\r\n", le compte est juste.
blank.txt: the empty lines at the end never count; the box removes the one in the middle. blank_crlf.txt with "\n": each empty line keeps its \r, nothing is empty. With Row Separator "\r\n", the count is right.
notes_crlf.csv : lignes terminées par \r\n, dont un commentaire coupé par un \n seul. utf16.txt : a et b en UTF-16, avec marque d'ordre des octets. Puis orders.csv (exemple précédent) avec ";" comme séparateur.
notes_crlf.csv: lines ended with \r\n, one of them a comment cut by a lone \n. utf16.txt: a and b in UTF-16, with a byte order mark. Then orders.csv (previous example) with ";" as separator.
notes_crlf.csv
"id;comment\r\n1;first line\nsecond line\r\n2;ok\r\n"
notes_crlf.csv, LF separator: 4 notes_crlf.csv, CRLF separator: 3 utf16.txt, ISO-8859-15: 3 utf16.txt, UTF-16: 2 orders.csv, ; separator: 5
Le composant compte des lignes, pas des enregistrements : avec "\n", le commentaire sur deux lignes compte double. Lu en ISO-8859-15 (défaut), le fichier UTF-16 donne une ligne de trop ; avec l'Encodage "UTF-16", le compte est juste. Avec ";", ce sont les morceaux entre les ; qui sont comptés.
The component counts lines, not records: with "\n", the comment on two lines counts twice. Read as ISO-8859-15 (default), the UTF-16 file gives one line too many; with the "UTF-16" Encoding, the count is right. With ";", the pieces between the ; are counted.
book.xls, écrit par le job avant le comptage : feuille 2025 avec id, 1, une ligne vide, 3 ; feuille 2026 avec id, 4. Compté une fois sans, une fois avec Ignorer les lignes vides.
book.xls, written by the job before the count: sheet 2025 with id, 1, an empty row, 3; sheet 2026 with id, 4. Counted once without, once with Ignore empty rows.
book.xls: 6 book.xls, ignore empty rows: 5
Les deux feuilles sont additionnées, en-têtes compris ; la ligne vide de la première feuille est retirée par la case. Both sheets are added up, headers included; the empty row of the first sheet is removed by the box.
tFileList : dossier "C:/data/out", masque "*.csv". tFileRowCount : Nom de fichier ((String) globalMap.get("tFileList_1_CURRENT_FILEPATH")).
tFileList: folder "C:/data/out", mask "*.csv". tFileRowCount: File Name ((String) globalMap.get("tFileList_1_CURRENT_FILEPATH")).
// tJava_1
System.out.println(
((String) globalMap.get("tFileList_1_CURRENT_FILE"))
+ ": "
+ ((Integer) globalMap.get("tFileRowCount_1_COUNT")));
february.csv: 2 january.csv: 3
Nom de fichier : "C:/data/header_only.csv", qui n'a que l'en-tête id;amount.
File Name: "C:/data/header_only.csv", which only has the id;amount header.
// Run if → tJava_1 (prints "Loading … lines")
((Integer) globalMap.get("tFileRowCount_1_COUNT")) > 1
// Run if → tJava_2
((Integer) globalMap.get("tFileRowCount_1_COUNT")) <= 1
// tJava_2
System.out.println("No data rows: "
+ ((Integer) globalMap.get("tFileRowCount_1_COUNT"))
+ " line");
No data rows: 1 line
Le nom du job est remplacé par MyJob, le chemin abrégé et les traces d'exception raccourcies. Dans les deux cas, le job s'arrête avec le code 1.
The job name is replaced with MyJob, the path shortened and the exception traces cut. In both cases, the job stops with exit code 1.
Nom de fichier : "C:/data/orders_2026.csv", qui n'existe pas.
File Name: "C:/data/orders_2026.csv", which does not exist.
Exception in component tFileRowCount_1 (MyJob) java.io.FileNotFoundException: C:\data\orders_2026.csv (Le fichier spécifié est introuvable) at java.base/java.io.FileInputStream.open0(Native Method) … at demo.myjob_0_1.MyJob.tFileRowCount_1Process(MyJob.java:432) …
La fin du message vient du système (ici un Windows en français). Pour un fichier qui peut manquer, placez un tFileExist avant, avec un Run if.
The end of the message comes from the system (here a Windows in French). For a file that may be missing, put a tFileExist before, with a Run if.
Nom de fichier : "C:/data/report.xlsx".
File Name: "C:/data/report.xlsx".
Exception in component tFileRowCount_1 (MyJob) java.lang.RuntimeException: not support excel 2007 at demo.myjob_0_1.MyJob.tFileRowCount_1Process(MyJob.java:395) …
Le refus vient du nom, avant toute lecture : le fichier n'a même pas besoin d'exister. Seuls les classeurs .xls (Excel 97-2003) sont comptés.
The refusal comes from the name, before any reading: the file does not even need to exist. Only .xls workbooks (Excel 97-2003) are counted.
Le composant ne connaît pas les en-têtes : un fichier avec une ligne d'en-tête et 3 lignes de données donne 4. Retirez l'en-tête dans la condition ou le calcul (COUNT - 1).
The component does not know about headers: a file with a header line and 3 data lines gives 4. Remove the header in the condition or the calculation (COUNT - 1).
Avec le séparateur par défaut "\n", le compte d'un fichier \r\n est juste, mais Ignorer les lignes vides ne retire rien. Pour ces fichiers, mettez "\r\n".
With the default "\n" separator, the count of a \r\n file is right, but Ignore empty rows removes nothing. For these files, set "\r\n".
Les guillemets d'un CSV ne sont pas lus : un champ qui contient un saut de ligne compte pour deux lignes. Si les enregistrements se terminent par \r\n et les sauts de ligne internes par \n, mettez "\r\n" comme séparateur.
The quotes of a CSV are not read: a field that holds a line break counts as two lines. If the records end with \r\n and the inner line breaks with \n, set "\r\n" as separator.
Le comptage parcourt le fichier jusqu'au bout, caractère par caractère : sur un très gros fichier, il prend le temps d'une lecture complète. The count goes through the file to the end, character by character: on a very large file, it takes the time of a full reading.
tFileExist · tester si le fichier existe avant de comptertest whether the file exists before countingtFileProperties · taille, date et MD5 d'un fichiersize, date and MD5 of a filetFileList · parcourir les fichiers d'un dossiergo through the files of a foldertFileCompare · comparer un fichier à un fichier de référencecompare a file with a reference filetChangeFileEncoding · changer l'encodage d'un fichierchange the encoding of a filetJava · choisir la branche avec Run ifchoose the branch with Run if