ComposantsComponents

ComposantsComponents › Fichier › LectureFile › Input

tFileInputFullRow

tFileInputFullRow

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.

UtilisationUsage

Lire, puis découperRead, then split

row1 (Main) row2 (Main) tFileInputFullRow_1 tExtractRegexFields_1 tLogRow_1

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.

Garder certaines lignesKeep some lines

row1 (Main) row2 (Filter) tFileInputFullRow_1 tFilterRow_1 tFileOutputDelimited_1

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.

  1. Déposez le tFileInputFullRow depuis la famille Fichier › Lecture de la palette. Drop the tFileInputFullRow from the File › Input family of the palette.
  2. Indiquez le Nom de fichier et, si le fichier commence ou finit par des lignes à passer, l'En-tête et le Pied de page. Set the File Name and, if the file starts or ends with lines to skip, the Header and the Footer.
  3. Dans les Paramètres avancés, choisissez l'Encodage (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.

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

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.

Variable globaleGlobal variable

NB_LINE Integer
Nombre de lignes envoyées, en-tête et pied non comptés, lignes vides comptées seulement si elles sont envoyées ; disponible après l'exécution du composant. Par exemple dans un tJava relié par On Subjob Ok, comme dans les exemples :Number of rows sent, header and footer not counted, empty lines counted only if they are sent; available after the component has run. For instance in a tJava connected with On Subjob Ok, as in the examples:
System.out.println("NB_LINE: " + globalMap.get("tFileInputFullRow_1_NB_LINE"));

ExemplesExamples

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.

row1 (Main) OnSubjobOk tFileInputFullRow_1 tLogRow_1 tJava_1

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

Réglages par défautDefault settings

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, pied de page, limiteHeader, footer, limit

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

Lignes vides gardéesEmpty lines kept

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.

Au hasardAt random

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.

Fins de ligne et séparateurLine ends and separator

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

Séparateur "\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.

Séparateur "\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.

Séparateur "</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.

EncodageEncoding

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

ErreursErrors

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.

Fichier absentMissing file

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.

Colonne qui n'est pas StringColumn that is not String

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

Conseils et limitesTips and limits

ISO-8859-15 par défautISO-8859-15 by default

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.

Fichier délimitéDelimited file

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.

Fichier entierWhole file

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.

Pied de page et hasardFooter and random

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.

Voir aussiSee also