ComposantsComponents › Fichier › LectureFile › Input
Lit un fichier texte ligne par ligne et envoie chaque ligne entière, sans la découper, dans une seule colonne line de type String. À choisir quand les lignes n'ont pas toutes la même forme : un journal, un fichier à plusieurs types d'enregistrements, des lignes à filtrer ou à découper soi-même ensuite, par exemple avec un tExtractRegexFields.
Reads a text file line by line and sends each whole line, without splitting it, in a single line column of type String. Choose it when the lines do not all have the same shape: a log, a file with several record types, lines to filter or split yourself afterwards, for instance with a tExtractRegexFields.
EntréeInput
Aucune : il commence son sous-job. Sinon un lien Iterate : il lit le fichier à chaque itération. None: it starts its subjob. Otherwise one Iterate link: it reads the file at each iteration.
SortieOutput
Main un flux : une ligne par ligne du fichierone flow: one row per line of the file
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.
Chaque ligne d'un journal arrive entière ; une expression régulière en tire l'heure, le niveau et le message. Each line of a log arrives whole; a regular expression extracts the time, the level and the message from it.
Un tFilterRow garde les lignes qui contiennent WARN ; le tFileOutputDelimited, d'une seule colonne, les réécrit telles quelles.
A tFilterRow keeps the lines that contain WARN; the tFileOutputDelimited, with a single column, writes them again as is.
ISO-8859-15 par défaut), puis reliez la sortie Main au composant suivant.
In the Advanced settings, choose the Encoding (ISO-8859-15 by default), then connect the Main output to the next component.
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 nom de fichier et le séparateur sont des expressions Java : gardez les guillemets ; une variable de contexte est acceptée. Labels are those of the Component tab; the technical name, in grey, is the parameter name in the job file. The file name and the separator are Java expressions: keep the quotes; a context variable is accepted.
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| SchémaSchemaSCHEMA | line (String) |
ToujoursAlways | La ligne lue va dans la première colonne, quel que soit son nom. Le schéma peut être modifié, mais une colonne de plus reçoit toujours une chaîne vide, et une colonne d'un autre type que String empêche le job de compiler (voir les erreurs). The line read goes to the first column, whatever its name. The schema can be changed, but an extra column always receives an empty string, and a column of another type than String prevents the job from compiling (see the errors). |
| Nom de fichierFile NameFILENAME | chemin par défaut + /in.csvdefault path + /in.csv |
ToujoursAlways |
Le fichier lu : context.folder + "/log.txt". Un fichier absent arrête toujours le job : le composant n'a pas d'option Arrêter en cas d'erreur.
The file read: context.folder + "/log.txt". A missing file always stops the job: the component has no Die on error option.
|
| Séparateur de lignesRow SeparatorROWSEPARATOR | "\n" |
ToujoursAlways |
Avec "\n" (défaut), LF, CRLF et CR seul terminent tous une ligne, et aucun \r ne reste dans la ligne. Toute autre valeur est cherchée telle quelle, sur un ou plusieurs caractères : "\r\n" ne coupe qu'aux CRLF, "</r>" coupe à chaque balise. Voir les exemples.
With "\n" (default), LF, CRLF and a lone CR all end a line, and no \r is left in the line. Any other value is searched as is, on one or more characters: "\r\n" only cuts at CRLF, "</r>" cuts at each tag. See the examples.
|
| En-têteHeaderHEADER | vide (0)empty (0) | ToujoursAlways | Nombre de lignes passées au début du fichier ; elles ne sont pas envoyées et pas comptées. Number of lines skipped at the start of the file; they are not sent and not counted. |
| Pied de pageFooterFOOTER | vide (0)empty (0) | ToujoursAlways | Nombre de lignes ignorées à la fin du fichier. Le fichier est alors lu deux fois : une première fois pour compter ses lignes. Number of lines ignored at the end of the file. The file is then read twice: a first time to count its lines. |
| LimiteLimitLIMIT | vide (aucune)empty (none) | ToujoursAlways |
Nombre maximal de lignes envoyées, après l'en-tête. 0 n'en envoie aucune.
Maximum number of rows sent, after the header. 0 sends none.
|
| Ignorer les lignes videsSkip empty rowsREMOVE_EMPTY_ROW | OuiYes | ToujoursAlways |
Saute les lignes vides. Décochée, chacune donne une ligne dont line est une chaîne vide (voir l'exemple). Une ligne faite d'espaces n'est pas vide.
Skips the empty lines. Unchecked, each one gives a row whose line is an empty string (see the example). A line made of spaces is not empty.
|
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| EncodageEncodingENCODING | "ISO-8859-15" |
ToujoursAlways |
L'encodage du fichier. Le défaut n'est pas UTF-8 : un fichier UTF-8 lu tel quel donne Café au lieu de Café (voir l'exemple). Une marque d'ordre des octets (BOM) UTF-8, UTF-16 ou UTF-32 au début du fichier l'emporte sur ce réglage, et n'apparaît pas dans la première ligne.
The encoding of the file. The default is not UTF-8: a UTF-8 file read as is gives Café instead of Café (see the example). A UTF-8, UTF-16 or UTF-32 byte order mark (BOM) at the start of the file wins over this setting, and does not show in the first line.
|
| Extraire des lignes au hasardExtract lines at randomRANDOM | NonNo | ToujoursAlways | Envoie un nombre de lignes tirées au hasard, dans l'ordre du fichier ; le tirage change à chaque exécution. Le fichier est lu deux fois. Sends a number of lines drawn at random, in the order of the file; the draw changes at each run. The file is read twice. |
| Nombre de lignesNumber of linesNB_RANDOM | 10 |
Au hasard cochéAt random checked | Nombre de lignes tirées ; tout le fichier s'il en a moins. Avec une Limite, au plus la limite. Number of lines drawn; the whole file if it has fewer. With a Limit, at most the limit. |
System.out.println("NB_LINE: " + globalMap.get("tFileInputFullRow_1_NB_LINE"));
Les fichiers sont dans le dossier de la variable de contexte folder, raccourcie ici en C:/data ; leur contenu est montré avec les fins de ligne visibles. Un tLogRow en mode Table affiche les lignes lues, ou, quand les caractères invisibles comptent, un tJavaRow affiche chaque valeur entre crochets avec ses \r et \n visibles. Puis le tJava affiche NB_LINE. Les sorties sont celles de la console, copiées depuis une exécution du job.
The files are in the folder of the folder context variable, shortened here to C:/data; their content is shown with the line ends made visible. A tLogRow in Table mode prints the rows read, or, when invisible characters matter, a tJavaRow prints each value in brackets with its \r and \n made visible. Then the tJava prints NB_LINE. The outputs are the console ones, copied from a run of the job.
Fichier log.txt, lu par context.folder + "/log.txt" :
File log.txt, read through context.folder + "/log.txt":
# export 2026-11-14\n
08:00:01 INFO start\n
08:00:02 WARN disk 85%\n
\n
08:00:03 INFO end\n
-- 3 events\n
Toutes les lignes, sauf la ligne vide. All the lines, except the empty one.
.----------------------. | tLogRow_1 | |=--------------------=| |line | |=--------------------=| |# export 2026-11-14 | |08:00:01 INFO start | |08:00:02 WARN disk 85%| |08:00:03 INFO end | |-- 3 events | '----------------------' NB_LINE: 5
En-tête 1 et Pied de page 1, puis En-tête 1 et Limite 2 : Header 1 and Footer 1, then Header 1 and Limit 2:
.----------------------. | tLogRow_1 | |=--------------------=| |line | |=--------------------=| |08:00:01 INFO start | |08:00:02 WARN disk 85%| |08:00:03 INFO end | '----------------------' NB_LINE: 3
.----------------------. | tLogRow_1 | |=--------------------=| |line | |=--------------------=| |08:00:01 INFO start | |08:00:02 WARN disk 85%| '----------------------' NB_LINE: 2
Ignorer les lignes vides décoché, affichage par le tJavaRow : Skip empty rows unchecked, printed by the tJavaRow:
[# export 2026-11-14] [08:00:01 INFO start] [08:00:02 WARN disk 85%] [] [08:00:03 INFO end] [-- 3 events] NB_LINE: 6
La ligne vide arrive comme une chaîne vide, pas comme null.
The empty line arrives as an empty string, not as null.
Extraire des lignes au hasard coché, Nombre de lignes 2. Une exécution : Extract lines at random checked, Number of lines 2. One run:
.----------------------. | tLogRow_1 | |=--------------------=| |line | |=--------------------=| |08:00:01 INFO start | |08:00:02 WARN disk 85%| '----------------------' NB_LINE: 2
Les lignes tirées gardent l'ordre du fichier ; une autre exécution en tire d'autres. The lines drawn keep the order of the file; another run draws others.
windows.txt mêle des fins de ligne CRLF, une ligne vide, un CR seul (ancien Mac), un LF seul, et une dernière ligne sans fin de ligne :
windows.txt mixes CRLF line ends, an empty line, a lone CR (old Mac), a lone LF, and a last line without a line end:
id;name\r\n
1;Ada\r\n
\r\n
2;Grace\rold mac line\n
3;Alan
"\n" (défaut)"\n" separator (default)[id;name] [1;Ada] [2;Grace] [old mac line] [3;Alan] NB_LINE: 5
Toutes les fins de ligne coupent, sans laisser de \r ; la ligne vide est sautée, la dernière ligne est lue. Le ; n'a aucun rôle.
All the line ends cut, without leaving any \r; the empty line is skipped, the last line is read. The ; plays no part.
"\r\n""\r\n" separator[id;name] [1;Ada] [2;Grace\rold mac line\n3;Alan] NB_LINE: 3
Seuls les CRLF coupent : le CR et le LF seuls restent dans la troisième ligne. Only the CRLF cut: the lone CR and LF stay in the third row.
"</r>""</r>" separator
records.txt : des enregistrements entre balises, avec un saut de ligne au milieu.
records.txt: records between tags, with a line break in the middle.
<r>1;Ada</r><r>2;Grace</r>\n
<r>3;Alan</r>
[<r>1;Ada] [<r>2;Grace] [\n<r>3;Alan] NB_LINE: 3
Le séparateur est retiré, le reste est gardé tel quel, saut de ligne compris. Le séparateur de la fin du fichier n'ajoute pas de ligne vide. The separator is removed, the rest is kept as is, line break included. The separator at the end of the file does not add an empty row.
cafe_utf8.txt contient Café 10 € en UTF-8, octets 43 61 66 C3 A9 20 31 30 20 E2 82 AC 0A. Lu avec l'encodage par défaut, puis avec "UTF-8" :
cafe_utf8.txt holds Café 10 € in UTF-8, bytes 43 61 66 C3 A9 20 31 30 20 E2 82 AC 0A. Read with the default encoding, then with "UTF-8":
[Café 10 â¬] NB_LINE: 1
[Café 10 €] NB_LINE: 1
En ISO-8859-15, chaque octet UTF-8 devient un caractère ; un caractère de contrôle invisible (code 0082) est aussi entre â et ¬.
In ISO-8859-15, each UTF-8 byte becomes one character; an invisible control character (code 0082) is also between â and ¬.
Le nom du job est remplacé par MyJob, le dossier de travail par C:\data ; les traces d'exception sont abrégées. La fin du message de fichier vient de Windows, dans sa langue.
The job name is replaced with MyJob, the working folder with C:\data; exception traces are shortened. The end of the file message comes from Windows, in its language.
Nom context.folder + "/absent.txt" : le job s'arrête (code 1), le tJava ne s'exécute pas.
Name context.folder + "/absent.txt": the job stops (exit code 1), the tJava does not run.
Exception in component tFileInputFullRow_1 (MyJob) java.io.FileNotFoundException: C:\data\absent.txt (Le fichier spécifié est introuvable) at java.base/java.io.FileInputStream.open0(Native Method) … at org.talend.fileprocess.TOSDelimitedReader.<init>(TOSDelimitedReader.java:88) at org.talend.fileprocess.FileInputDelimited.<init>(FileInputDelimited.java:164) …
Pour un fichier qui peut manquer, vérifiez-le avant avec un tFileExist et un lien Run if. For a file that may be missing, check it first with a tFileExist and a Run if link.
Schéma line (String) et n (Integer) : le job ne compile pas, nom du job remplacé :
line (String) and n (Integer) schema: the job does not compile, job name replaced:
The job failed to compile: …\MyJob.java:779: error: incompatible types: String cannot be converted to Integer row1.n = fid_tFileInputFullRow_1.get(1); ^ 1 error
Le modèle (tFileInputFullRow_begin.javajet) donne à chaque colonne le texte de même rang, sans conversion, alors que le schéma peut être modifié. Avec une seconde colonne String, essayée aussi, elle reçoit toujours une chaîne vide. Gardez la seule colonne line, et convertissez ensuite (tMap, tConvertType).
The template (tFileInputFullRow_begin.javajet) gives each column the text of the same rank, without conversion, although the schema can be changed. With a second String column, also tried, it always receives an empty string. Keep the single line column, and convert afterwards (tMap, tConvertType).
La plupart des fichiers récents sont en UTF-8 : réglez l'Encodage sur "UTF-8", sinon les accents sont faussés. Seul un fichier qui commence par une marque d'ordre des octets est lu juste sans réglage.
Most recent files are in UTF-8: set the Encoding to "UTF-8", otherwise accents are spoiled. Only a file starting with a byte order mark is read correctly without setting it.
Si toutes les lignes ont les mêmes champs séparés par un caractère, un tFileInputDelimited les découpe et les convertit lui-même. Le tFileInputFullRow sert quand les lignes diffèrent, ou pour garder la ligne d'origine. If all the lines have the same fields separated by a character, a tFileInputDelimited splits and converts them itself. The tFileInputFullRow is for when the lines differ, or to keep the original line.
Pour recevoir le fichier en une seule valeur (un JSON, un XML), prenez un tFileInputRaw. To receive the file as a single value (a JSON, an XML), take a tFileInputRaw.
Avec un Pied de page ou l'extraction au hasard, le fichier est lu deux fois. Sur un très gros fichier, préférez une Limite, ou écartez la dernière ligne plus loin dans le job. With a Footer or the random extraction, the file is read twice. On a very large file, prefer a Limit, or set aside the last line further in the job.
tFileInputDelimited · fichier délimité ou CSV, découpé en colonnesdelimited or CSV file, split into columnstFileInputRegex · lignes découpées par une expression régulièrelines split with a regular expressiontFileInputRaw · le fichier entier en une valeurthe whole file as one valuetExtractRegexFields · découper une ligne déjà luesplit a line already readtFileRowCount · compter les lignes d'un fichiercount the lines of a filetChangeFileEncoding · changer l'encodage d'un fichier textechange the encoding of a text file