ComposantsComponents

ComposantsComponents › Fichier › GestionFile › Management

tFileRowCount

tFileRowCount

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.

UtilisationUsage

Avant de charger un fichierBefore loading a file

If tFileRowCount_1 tFileInputDelimited_1

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.

Chaque fichier d'un dossierEach file of a folder

Iterate OnComponentOk tFileList_1 tFileRowCount_1 tJava_1

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.

  1. Déposez le tFileRowCount depuis la famille Fichier › Gestion de la palette. Drop the tFileRowCount from the File › Management family of the palette.
  2. Indiquez le Nom de fichier ; vérifiez le Séparateur de lignes et l'Encodage si le fichier vient d'ailleurs. Set the File Name; check the Row Separator and the Encoding if the file comes from elsewhere.
  3. Lisez 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.

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

Variable globaleGlobal variable

COUNT Integer
Le nombre de lignes comptées, en-tête compris. Écrit quand le composant s'exécute ; avec un lien Main en entrée, il garde le compte du dernier fichier.The number of lines counted, header included. Written when the component runs; with an incoming Main link, it keeps the count of the last file.
((Integer) globalMap.get("tFileRowCount_1_COUNT"))

ExemplesExamples

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.

Fins de ligne et dernière ligneLine endings and last line

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.

Lignes videsEmpty lines

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.

Séparateur et encodageSeparator and encoding

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.

Classeur Excel (.xls)Excel workbook (.xls)

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.

Chaque fichier d'un dossierEach file of a folder

Iterate OnComponentOk tFileList_1 tFileRowCount_1 tJava_1

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

Un fichier sans donnéesA file without data

If If tFileRowCount_1 tJava_1 tJava_2

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

ErreursErrors

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.

Fichier absentMissing file

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.

Classeur .xlsx.xlsx workbook

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.

Conseils et limitesTips and limits

L'en-tête compteThe header counts

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

Fichiers Windows et lignes videsWindows files and empty lines

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

Des lignes, pas des enregistrementsLines, not records

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.

Tout le fichier est luThe whole file is read

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.

Voir aussiSee also