ComposantsComponents › Fichier › LectureFile › Input
Lit un fichier texte à positions fixes, ligne par ligne : chaque champ est pris à sa place dans la ligne, sur une largeur donnée, sans séparateur entre les champs, puis converti dans le type de sa colonne. Pour les fichiers d'échange à largeur fixe (banques, anciens systèmes) ; c'est la lecture de ce qu'écrit tFileOutputPositional. Reads a fixed-width text file, line by line: each field is taken at its place in the line, over a given width, without a separator between the fields, then converted to the type of its column. For fixed-width exchange files (banks, legacy systems); it reads what tFileOutputPositional writes.
EntréeInput
Iterate facultatif : aucun flux de données en entrée, le composant commence un sous-joboptional: no data flow in, the component starts a subjob
SortieOutput
Main une ligne par ligne du fichierone row per line of the file Reject les lignes dont une valeur n'a pas pu être convertie (sans Arrêter en cas d'erreur)the lines with a value that could not be converted (without Die on error)
Déclencheurs en sortieOutput triggers
On Subjob Ok On Subjob Error On Component Ok On Component Error Run if
Le composant découpe chaque ligne selon son Modèle et envoie les valeurs converties sur le lien Main ; une ligne dont une valeur ne se convertit pas part sur le lien Reject, avec le message d'erreur, par exemple vers un tLogRow ou un fichier de rejets. The component cuts each line according to its Pattern and sends the converted values on the Main link; a line with a value that does not convert leaves on the Reject link, with the error message, for example to a tLogRow or a reject file.
"3,10,10,*", * pour le reste de la ligne).
Set the File name/Stream, then the Pattern: the widths of the fields, separated by commas, in the order of the line ("3,10,10,*", * for the rest of the line).
ISO-8859-15 par défaut), et reliez un lien Reject (clic droit › Ligne › Reject) pour garder les lignes en erreur.
If needed, set the Header and Footer to skip, the Encoding in the advanced settings (ISO-8859-15 by default), and connect a Reject link (right-click › Row › Reject) to keep the lines in error.
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, le séparateur de lignes et le modèle sont des expressions Java : gardez les guillemets. Labels are those of the Component tab; the technical name, in grey, is the parameter name in the job file. The file name, the row separator and the pattern are Java expressions: keep the quotes.
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| Type de propriétéProperty TypePROPERTY | Built-inBuilt-In | ToujoursAlways | Built-in : les réglages sont saisis dans le composant. Référentiel : le nom du fichier, le séparateur de lignes, le modèle, l'en-tête, le pied, la limite, les lignes vides et l'encodage viennent d'une métadonnée de fichier positionnel du Référentiel. Built-In: the settings are typed in the component. Repository: the file name, the row separator, the pattern, the header, the footer, the limit, the empty rows and the encoding come from a positional file metadata of the Repository. |
| Utiliser dynamique existantUse existing dynamicUSE_EXISTING_DYNAMIC | NonNo | ToujoursAlways |
Pour un schéma avec une colonne Dynamic : ses colonnes sont lues l'une après l'autre, à partir de sa position, avec les longueurs du schéma dynamique d'un tSetDynamicSchema. D'après les modèles du composant, non essayé ici.
For a schema with a Dynamic column: its columns are read one after the other, from its position, with the lengths of the dynamic schema of a tSetDynamicSchema. From the component templates, not tried here.
|
| Liste des composantsComponent ListDYNAMIC | — | Dynamique existant cochéExisting dynamic checked |
Le tSetDynamicSchema du job. S'il devine le schéma depuis un fichier, le composant s'arrête : tFileInputPositional doesn't support to work with tSetDynamicSchema when 'Guess schema from file' option is activated.
The tSetDynamicSchema of the job. If it guesses the schema from a file, the component stops: tFileInputPositional doesn't support to work with tSetDynamicSchema when 'Guess schema from file' option is activated.
|
| Nom de fichier/FluxFile name/StreamFILENAME | chemin par défaut + /in.csvdefault path + /in.csv |
ToujoursAlways |
Le fichier lu : context.folder + "/people.txt". Ou un flux Java (java.io.InputStream) ouvert avant : le composant ne le ferme pas, et le Pied de page doit rester à 0. Un fichier absent n'arrête pas le job, sauf avec Arrêter en cas d'erreur (voir les erreurs).
The file read: context.folder + "/people.txt". Or a Java stream (java.io.InputStream) opened before: the component does not close it, and the Footer must stay at 0. A missing file does not stop the job, except with Die on error (see the errors).
|
| Séparateur de lignesRow SeparatorROWSEPARATOR | "\n" |
ToujoursAlways |
Le texte qui finit chaque ligne. Avec "\n", un fichier en CRLF garde le \r à la fin du dernier champ, que la suppression des espaces retire (voir l'exemple). "" : pas de séparateur, des enregistrements de longueur fixe, la somme des largeurs du modèle (voir l'exemple).
The text that ends each line. With "\n", a CRLF file keeps the \r at the end of the last field, which the trimming removes (see the example). "": no separator, fixed-length records, the sum of the widths of the pattern (see the example).
|
| PersonnaliserCustomizeADVANCED_OPTION | NonNo | ToujoursAlways | Remplace le Modèle par le tableau Formats : pour chaque colonne, une taille, un caractère de remplissage et un alignement ; le remplissage est retiré de la valeur (voir le tableau Formats). Replaces the Pattern with the Formats table: for each column, a size, a padding character and an alignment; the padding is removed from the value (see the Formats table). |
| ModèlePatternPATTERN | "5,4,5" |
Personnaliser décochéCustomize unchecked |
Les largeurs des champs, séparées par des virgules, dans l'ordre des colonnes du schéma. * prend le reste de la ligne : les colonnes suivantes restent vides. Moins de largeurs que de colonnes : les dernières colonnes restent vides (voir l'exemple). Une expression Java (guillemets, variable de contexte) ou le texte seul, 3,10,10,*, sont acceptés.
The widths of the fields, separated by commas, in the order of the schema columns. * takes the rest of the line: the next columns stay empty. Fewer widths than columns: the last columns stay empty (see the example). A Java expression (quotes, context variable) or the bare text, 3,10,10,*, are both accepted.
|
| Unités des modèlesPattern unitsPATTERN_UNITS | SymbolesSymbols | ToujoursAlways |
Ce que comptent les largeurs. Symboles : les caractères Java (UTF-16) ; un caractère hors du plan de base, comme un émoji, compte pour 2. Symboles (même rares) : les caractères Unicode, l'émoji compte pour 1. Bytes : les octets dans l'Encodage ; é compte pour 2 en UTF-8. Voir l'exemple.
What the widths count. Symbols: Java characters (UTF-16); a character outside the basic plane, such as an emoji, counts for 2. Symbols (including rare): Unicode characters, the emoji counts for 1. Bytes: the bytes in the Encoding; é counts for 2 in UTF-8. See the example.
|
| FormatsFORMATS | une ligne par colonneone line per column | Personnaliser cochéCustomize checked | Voir le tableau Formats ci-dessous. See the Formats table below. |
| Ignorer les lignes videsSkip empty rowsREMOVE_EMPTY_ROW | OuiYes | ToujoursAlways |
Saute les lignes entièrement vides (une ligne d'espaces n'est pas vide). Décochée, une ligne vide donne une ligne de sortie : texte vide dans les colonnes String, null ailleurs (voir l'exemple).
Skips the completely empty lines (a line of spaces is not empty). Unchecked, an empty line gives an output row: empty text in the String columns, null elsewhere (see the example).
|
| Décompresser en tant que fichier ZIPUncompress as zip fileUNCOMPRESS | NonNo | ToujoursAlways | Lit une archive zip : chacun de ses fichiers à la suite, l'en-tête sauté dans chacun. Masque le pied de page. La Limite y est mal appliquée (voir l'exemple). Reads a zip archive: each of its files in turn, the header skipped in each one. Hides the footer. The Limit is badly applied there (see the example). |
| Arrêter en cas d'erreurDie on errorDIE_ON_ERROR | NonNo | ToujoursAlways | Arrête le job à la première valeur qui ne se convertit pas, ou si le fichier ne s'ouvre pas. Décochée, la ligne part sur le lien Reject ; sans lien Reject, son message est écrit sur la sortie d'erreur et la ligne est sautée. Cochée, le lien Reject n'est plus proposé. Stops the job at the first value that does not convert, or if the file does not open. Unchecked, the line leaves on the Reject link; without a Reject link, its message is written to the error output and the line is skipped. Checked, the Reject link is no longer offered. |
| En-têteHeaderHEADER | 0 |
ToujoursAlways | Nombre de lignes sautées au début du fichier (titres des colonnes…). Number of lines skipped at the start of the file (column titles…). |
| Pied de pageFooterFOOTER | 0 |
Décompresser décochéUncompress unchecked |
Nombre de lignes ignorées à la fin (totaux…). Le composant lit alors le fichier une première fois pour compter ses lignes, puis une seconde. Impossible avec un flux : When the input source is a stream,footer shouldn't be bigger than 0.
Number of lines ignored at the end (totals…). The component then reads the file a first time to count its lines, then a second time. Not possible with a stream: When the input source is a stream,footer shouldn't be bigger than 0.
|
| LimiteLimitLIMIT | videempty | ToujoursAlways |
Nombre maximal de lignes lues après l'en-tête, lignes rejetées comprises. Vide : toutes ; 0 : aucune.
Maximum number of lines read after the header, rejected lines included. Empty: all; 0: none.
|
| SchémaSchemaSCHEMA | — | ToujoursAlways |
Les colonnes, dans l'ordre des champs de la ligne. Chaque valeur est débarrassée de ses espaces (paramètres avancés), puis convertie : un champ vide donne un texte vide dans une colonne String, null dans un autre type (0 pour un type primitif non nullable). Les dates suivent le modèle de leur colonne. Le lien Reject reçoit les mêmes colonnes, plus errorCode et errorMessage.
The columns, in the order of the fields of the line. Each value is trimmed (advanced settings), then converted: an empty field gives an empty text in a String column, null in another type (0 for a non-nullable primitive type). Dates follow the pattern of their column. The Reject link receives the same columns, plus errorCode and errorMessage.
|
Avec Personnaliser coché : une ligne par colonne du schéma, dans son ordre. Les champs se suivent, chacun commençant où finit le précédent ; le remplissage est retiré du côté opposé à l'alignement, puis les espaces si Supprimer les espaces… est coché. With Customize checked: one line per schema column, in its order. The fields follow each other, each one starting where the previous one ends; the padding is removed on the side opposite to the alignment, then the spaces if Trim all columns is checked.
| ColonneColumn | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| TailleSizeSIZE | 10 |
ToujoursAlways |
Largeur du champ, dans l'unité d'Unités des modèles. Pour la dernière colonne, * (ou vide) prend le reste de la ligne.
Width of the field, in the unit of Pattern units. For the last column, * (or empty) takes the rest of the line.
|
| Caractère de remplissagePadding charPADDING_CHAR | ' ' |
ToujoursAlways |
Le caractère qui complète la valeur dans le fichier, entre apostrophes Java : ' ', '0', '.'. Toutes ses répétitions sont retirées.
The character that completes the value in the file, in Java single quotes: ' ', '0', '.'. All its repetitions are removed.
|
| AlignementAlignmentALIGN | GaucheLeft | ToujoursAlways |
La place de la valeur dans son champ, donc le côté du remplissage à retirer. Gauche : retiré à droite (Ada....... → Ada). Droite : à gauche (00012 → 12). Centre : des deux côtés (--FR-- → FR). Un champ fait seulement de remplissage devient vide : 00000 donne null (voir l'exemple).
The place of the value in its field, so the side of the padding to remove. Left: removed on the right (Ada....... → Ada). Right: on the left (00012 → 12). Center: on both sides (--FR-- → FR). A field made only of padding becomes empty: 00000 gives null (see the example).
|
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| Requis afin de traiter des lignes dont la longueur dépasse les 100 000 caractèresNeeded to process rows longer than 100 000 charactersPROCESS_LONG_ROW | NonNo | ToujoursAlways |
Lève la limite de 100 000 caractères par ligne (Maximum row record length of 100,000 exceeded…). D'après les sources de la bibliothèque de lecture, la limite ne vaut qu'avec un séparateur de lignes autre que "\n" et "\r\n". Non essayé ici.
Lifts the limit of 100,000 characters per line (Maximum row record length of 100,000 exceeded…). From the sources of the reading library, the limit only applies with a row separator other than "\n" and "\r\n". Not tried here.
|
| Séparateur avancé (pour les nombres)Advanced separator (for numbers)ADVANCED_SEPARATOR | NonNo | ToujoursAlways |
Lit les nombres avec les deux séparateurs ci-dessous : 1.250,50 donne 1250.50. Sans, une virgule dans un nombre met la ligne en erreur (voir l'exemple).
Reads the numbers with the two separators below: 1.250,50 gives 1250.50. Without, a comma in a number puts the line in error (see the example).
|
| Séparateur de milliersThousands separatorTHOUSANDS_SEPARATOR | "," |
Séparateur avancé cochéAdvanced separator checked | Retiré des nombres. Removed from the numbers. |
| Séparateur décimalDecimal separatorDECIMAL_SEPARATOR | "." |
Séparateur avancé cochéAdvanced separator checked | Remplacé par le point décimal. Replaced with the decimal point. |
| Supprimer les espaces en début et fin de champ dans toutes les colonnesTrim all columnsTRIMALL | OuiYes | ToujoursAlways |
Retire les espaces (et \r, tabulations…) au début et à la fin de chaque champ, avant la conversion. Décochée, le tableau suivant choisit les colonnes (voir l'exemple). Sans Personnaliser, les nombres et les dates sont débarrassés de leurs espaces de toute façon ; avec, un nombre entouré d'espaces met la ligne en erreur.
Removes the spaces (and \r, tabs…) at the start and end of each field, before the conversion. Unchecked, the next table chooses the columns (see the example). Without Customize, numbers and dates are trimmed anyway; with it, a number surrounded by spaces puts the line in error.
|
| Valider la dateValidate dateCHECK_DATE | NonNo | ToujoursAlways |
Lit les dates strictement : 2026-02-30 devient une erreur (Unparseable date) au lieu du 2 mars 2026. Chaque date refusée écrit aussi une trace Java sur la sortie d'erreur (voir l'exemple).
Reads the dates strictly: 2026-02-30 becomes an error (Unparseable date) instead of March 2, 2026. Each refused date also writes a Java trace to the error output (see the example).
|
| Sélectionner la colonne où supprimer les espaces entourant les champsCheck column to trimTRIMSELECT | une ligne par colonneone line per column | Supprimer les espaces… décochéTrim all columns unchecked | Une case par colonne du schéma : Supprimer les espaces en début et fin de champ. One box per schema column: Trim. |
| 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 é pour é. D'après le modèle, une marque d'ordre des octets (BOM) en tête de fichier est sautée.
The encoding of the file. The default is not UTF-8: a UTF-8 file read as is gives é for é. From the template, a byte order mark (BOM) at the start of the file is skipped.
|
NB_LINE (Integer, disponible après l'exécution du composant) : nombre de lignes lues, sans l'en-tête, le pied ni les lignes vides sautées, lignes rejetées comprises. Dans l'exemple du lien Reject, quatre lignes dont une rejetée donnent NB_LINE: 4.
NB_LINE (Integer, available after the component has run): number of lines read, without the header, the footer or the skipped empty lines, rejected lines included. In the Reject link example, four lines, one of them rejected, give NB_LINE: 4.
System.out.println("NB_LINE: " + globalMap.get("tFileInputPositional_1_NB_LINE"));
Les fichiers sont lus dans le dossier de la variable de contexte folder. Les lignes vont à un tLogRow, en mode tableau sauf mention contraire ; un tJava relié par On Subjob Ok affiche ensuite NB_LINE. Les sorties sont celles de la console, copiées depuis une exécution du job.
The files are read in the folder of the folder context variable. The rows go to a tLogRow, in table mode unless stated otherwise; a tJava connected with On Subjob Ok then prints NB_LINE. The outputs are the console ones, copied from a run of the job.
people.txt, avec une ligne vide et une ligne courte :
people.txt, with an empty line and a short line:
ID NAME CITY AMOUNT
001Ada London 1250.50
002Margaret Paris 80
003Alan Manchester3.14
004Grace
END 4 rows
Modèle "3,10,10,*", En-tête 1, Pied de page 1. Schéma : id (Integer), name, city (String), amount (BigDecimal).
Pattern "3,10,10,*", Header 1, Footer 1. Schema: id (Integer), name, city (String), amount (BigDecimal).
.--+--------+----------+-------. | tLogRow_1 | |=-+--------+----------+------=| |id|name |city |amount | |=-+--------+----------+------=| |1 |Ada |London |1250.50| |2 |Margaret|Paris |80 | |3 |Alan |Manchester|3.14 | |4 |Grace | |null | '--+--------+----------+-------' NB_LINE: 4
001 devient l'entier 1.
The padding spaces are removed; 001 becomes the integer 1.
004Grace s'arrête avant city : texte vide pour la colonne String, null pour le BigDecimal, sans erreur.
004Grace ends before city: empty text for the String column, null for the BigDecimal, with no error.
Même fichier. Limite 2, pied 0 : les lignes 1 et 2, NB_LINE: 2. Puis le réglage du premier exemple, Ignorer les lignes vides décoché :
Same file. Limit 2, footer 0: rows 1 and 2, NB_LINE: 2. Then the settings of the first example, Skip empty rows unchecked:
.--+--------+----------+-------. | tLogRow_1 | |=-+--------+----------+------=| |id|name |city |amount | |=-+--------+----------+------=| |1 |Ada |London |1250.50| |2 |Margaret|Paris |80 | |null| | |null | |3 |Alan |Manchester|3.14 | |4 |Grace | |null | '--+--------+----------+-------' NB_LINE: 5
La ligne vide donne une ligne : null pour les nombres, texte vide pour les colonnes String. Elle compte dans NB_LINE.
The empty line gives a row: null for the numbers, empty text for the String columns. It counts in NB_LINE.
Même fichier et même schéma. Modèle "3,10", deux largeurs pour quatre colonnes :
Same file and same schema. Pattern "3,10", two widths for four columns:
.--+--------+----+------. | tLogRow_1 | |=-+--------+----+-----=| |id|name |city|amount| |=-+--------+----+-----=| |1 |Ada | |null | |2 |Margaret| |null | |3 |Alan | |null | |4 |Grace | |null | '--+--------+----+------'
Modèle "3,*,10" : l'étoile prend toute la fin de la ligne.
Pattern "3,*,10": the star takes the whole end of the line.
.--+---------------------------+----+------. | tLogRow_1 | |=-+---------------------------+----+-----=| |id|name |city|amount| |=-+---------------------------+----+-----=| |1 |Ada London 1250.50| |null | |2 |Margaret Paris 80 | |null | |3 |Alan Manchester3.14 | |null | |4 |Grace | |null | '--+---------------------------+----+------'
Aucune erreur dans les deux cas : vérifiez que le modèle a une largeur par colonne, et l'étoile seulement en dernier. No error in either case: check that the pattern has one width per column, and the star only last.
codes.txt
00012Ada.......--FR--00125050
00007Margaret..-UK---00008000
00000Zero......--DE--00000000
| ColonneColumn | TailleSize | RemplissagePadding | AlignementAlignment |
|---|---|---|---|
| id Integer | 5 | '0' | DroiteRight |
| name String | 10 | '.' | GaucheLeft |
| country String | 6 | '-' | CentreCenter |
| cents Integer | 8 | '0' | DroiteRight |
.--+--------+-------+------. | tLogRow_1 | |=-+--------+-------+-----=| |id|name |country|cents | |=-+--------+-------+-----=| |12|Ada |FR |125050| |7 |Margaret|UK |8000 | |null|Zero |DE |null | '--+--------+-------+------' NB_LINE: 3
-UK---, décentré, perd aussi tous ses tirets.
-UK---, off-center, also loses all its dashes.
00000 et 00000000 ne gardent rien : la valeur zéro devient null.
00000 and 00000000 keep nothing: the zero value becomes null.
* pour une dernière colonne rest après id, elle reçoit toute la fin : Ada.......--FR--00125050.
With a * size for a last rest column after id, it gets the whole end: Ada.......--FR--00125050.
orders.txt
0012026-11-0119.90
0022026-11-3105.00
00X2026-11-0207.50
0042026-02-3012.00
Modèle "3,10,*". Schéma : id (Integer), day (Date, "yyyy-MM-dd"), price (BigDecimal). Le schéma du lien Reject a les mêmes colonnes, plus errorCode et errorMessage.
Pattern "3,10,*". Schema: id (Integer), day (Date, "yyyy-MM-dd"), price (BigDecimal). The Reject link schema has the same columns, plus errorCode and errorMessage.
.--+----------+-----. | tLogRow_1 | |=-+----------+----=| |id|day |price| |=-+----------+----=| |1 |2026-11-01|19.90| |2 |2026-12-01|5.00 | |4 |2026-03-02|12.00| '--+----------+-----' .--+---+-----+---------+---------------------------------. | tLogRow_2 | |=-+---+-----+---------+--------------------------------=| |id|day|price|errorCode|errorMessage | |=-+---+-----+---------+--------------------------------=| |null|null|null |null |For input string: "00X" - Line: 2| '--+---+-----+---------+---------------------------------' NB_LINE: 4
Line: 2 est le rang de la ligne lue, à partir de 0 (troisième ligne du fichier). errorCode reste vide.
Line: 2 is the rank of the line read, from 0 (third line of the file). errorCode stays empty.
Même job, Valider la date coché. Les deux dates impossibles sont rejetées, avec les colonnes déjà lues (id). Avant les tableaux, chacune a écrit une trace Java sur la sortie d'erreur (abrégée ici) :
Same job, Validate date checked. Both impossible dates are rejected, with the columns already read (id). Before the tables, each one wrote a Java trace to the error output (shortened here):
java.lang.IllegalArgumentException: MONTH: 10 -> 11 at java.base/java.util.GregorianCalendar.computeTime(GregorianCalendar.java:2798) … at routines.system.FastDateParser$DateParser.parse(FastDateParser.java:137) at routines.system.ParserUtils.parseTo_Date(ParserUtils.java:379) … java.lang.IllegalArgumentException: MONTH: 1 -> 2 … .--+----------+-----. | tLogRow_1 | |=-+----------+----=| |id|day |price| |=-+----------+----=| |1 |2026-11-01|19.90| '--+----------+-----' .--+---+-----+---------+----------------------------------------. | tLogRow_2 | |=-+---+-----+---------+---------------------------------------=| |id|day|price|errorCode|errorMessage | |=-+---+-----+---------+---------------------------------------=| |2 |null|null |null |Unparseable date: "2026-11-31" - Line: 1| |null|null|null |null |For input string: "00X" - Line: 2 | |4 |null|null |null |Unparseable date: "2026-02-30" - Line: 3| '--+---+-----+---------+----------------------------------------' NB_LINE: 4
Défaut de Talaxie : la trace vient de la routine système FastDateParser (modèle yyyy-MM-dd), qui affiche l'exception (printStackTrace) avant de signaler la date comme illisible. Le rejet est correct ; seule la sortie d'erreur est encombrée, d'une trace par date refusée.
Talaxie flaw: the trace comes from the FastDateParser system routine (yyyy-MM-dd pattern), which prints the exception (printStackTrace) before reporting the date as unreadable. The reject is right; only the error output is cluttered, with one trace per refused date.
units.txt, en UTF-8 (Encodage "UTF-8"), lu avec le Modèle "5,5" dans deux colonnes String, tLogRow en mode simple :
units.txt, in UTF-8 (Encoding "UTF-8"), read with the Pattern "5,5" into two String columns, tLogRow in basic mode:
Café.Paris
😀abc.Lyon.
SymbolesSymbols
Café.|Paris 😀abc|.Lyon
Symboles (même rares)Symbols (including rare)
Café.|Paris 😀abc.|Lyon.
Bytes
Café|.Pari 😀a|bc.Ly
L'émoji compte pour deux symboles, un symbole rare ou quatre octets ; é pour deux octets. Choisissez l'unité de celui qui a écrit le fichier.
The emoji counts for two symbols, one rare symbol or four bytes; é for two bytes. Choose the unit of whoever wrote the file.
amounts.txt, Modèle "1,*", colonnes code (String) et amount (BigDecimal). Séparateur avancé coché, milliers ".", décimal "," :
amounts.txt, Pattern "1,*", columns code (String) and amount (BigDecimal). Advanced separator checked, thousands ".", decimal ",":
A1.250,50
B 12,05
C 1.000.000
.----+-------. | tLogRow_1 | |=---+------=| |code|amount | |=---+------=| |A |1250.50| |B |12.05 | |C |1000000| '----+-------'
Sans la case, aucune ligne ne passe ; chacune écrit son erreur et le job continue : Without the box, no row goes through; each one writes its error and the job goes on:
Character , is neither a decimal digit number, decimal point, nor "e" notation exponential mark. Character , is neither a decimal digit number, decimal point, nor "e" notation exponential mark. Character array contains more than one decimal point.
records.txt, sans fin de ligne, trois enregistrements de 8 caractères. Séparateur de lignes "", Modèle "3,5" :
records.txt, without line ends, three records of 8 characters. Row Separator "", Pattern "3,5":
001Ada 002Bob 003Cy
.--+----. |tLogRow_1| |=-+---=| |id|name| |=-+---=| |1 |Ada | |2 |Bob | |3 |Cy | '--+----' NB_LINE: 3
La longueur d'un enregistrement est la somme des largeurs : avec "3,*", le composant écrit For input string: "*" sur la sortie d'erreur et ne lit rien (NB_LINE: 0), sans arrêter le job.
The length of a record is the sum of the widths: with "3,*", the component writes For input string: "*" to the error output and reads nothing (NB_LINE: 0), without stopping the job.
Les lignes vont à un tJavaRow qui affiche chaque valeur entre crochets, \r rendu visible. Premier exemple, Supprimer les espaces… décoché, seule name cochée dans le tableau :
The rows go to a tJavaRow that prints each value in brackets, with \r made visible. First example, Trim all columns unchecked, only name checked in the table:
id=[1] name=[Ada] city=[London ] amount=[1250.50] id=[2] name=[Margaret] city=[Paris ] amount=[80] id=[3] name=[Alan] city=[Manchester] amount=[3.14] id=[4] name=[Grace] city=[] amount=[null]
crlf.txt ("001Ada \r\n002Bob \r\n"), Modèle "3,*", séparateur "\n" par défaut, aucune colonne à nettoyer :
crlf.txt ("001Ada \r\n002Bob \r\n"), Pattern "3,*", default "\n" separator, no column to trim:
id=[1] name=[Ada \r] id=[2] name=[Bob \r]
Avec la case cochée (défaut), name=[Ada] et name=[Bob]. Pour garder les espaces d'un fichier Windows, réglez le séparateur sur "\r\n".
With the box checked (default), name=[Ada] and name=[Bob]. To keep the spaces of a Windows file, set the separator to "\r\n".
people.zip contient deux fichiers, chacun avec sa ligne de titres. Décompresser en tant que fichier ZIP coché, Modèle "3,*", En-tête 1 :
people.zip holds two files, each one with its title line. Uncompress as zip file checked, Pattern "3,*", Header 1:
part1.txt "ID NAME\n001Ada\n002Margaret\n"
part2.txt "ID NAME\n003Alan\n"
.--+--------. | tLogRow_1 | |=-+-------=| |id|name | |=-+-------=| |1 |Ada | |2 |Margaret| |3 |Alan | '--+--------' NB_LINE: 3
Défaut du modèle : la limite ne vaut que pour le premier fichier. Même archive, Limite 2 : la sortie est la même, trois lignes et NB_LINE: 3.
Template flaw: the limit only holds for the first file. Same archive, Limit 2: the output is the same, three rows and NB_LINE: 3.
Atteinte, la limite arrête la lecture du fichier en cours, pas celle de l'archive (tFileInputPositional_end.javajet) : chaque fichier suivant donne encore une ligne. Avec une archive de plusieurs fichiers, limitez plutôt en aval, par exemple avec un tFilterRow sur un compteur.
Once reached, the limit stops the reading of the current file, not of the archive (tFileInputPositional_end.javajet): each following file still gives one row. With an archive of several files, limit downstream instead, for example with a tFilterRow on a counter.
Le nom du job est remplacé par MyJob, le dossier des fichiers par C:\data ; les traces d'exception sont abrégées. La fin du message d'un fichier absent vient de Windows, dans sa langue.
The job name is replaced with MyJob, the folder of the files with C:\data; exception traces are shortened. The end of the message of a missing file comes from Windows, in its language.
Réglages par défaut, missing.txt n'existe pas. Le message va sur la sortie d'erreur, le tLogRow reçoit zéro ligne et le job finit normalement (code 0) :
Default settings, missing.txt does not exist. The message goes to the error output, the tLogRow receives no row and the job ends normally (exit code 0):
C:\data\missing.txt (Le fichier spécifié est introuvable) .--+----+----+------. | tLogRow_1 | |=-+----+----+-----=| |id|name|city|amount| |=-+----+----+-----=| '--+----+----+------' NB_LINE: 0
Avec Arrêter en cas d'erreur, le job s'arrête (code 1) : Exception in component tFileInputPositional_1 (MyJob), puis java.io.FileNotFoundException: C:\data\missing.txt (…). Pour un fichier obligatoire, cochez la case ou testez-le avant avec tFileExist.
With Die on error, the job stops (exit code 1): Exception in component tFileInputPositional_1 (MyJob), then java.io.FileNotFoundException: C:\data\missing.txt (…). For a required file, check the box or test it before with tFileExist.
orders.txt de l'exemple du lien Reject, sans le lien : la ligne 00X est sautée, son message écrit sur la sortie d'erreur ; les trois autres sortent.
orders.txt of the Reject link example, without the link: the 00X line is skipped, its message written to the error output; the three others go out.
For input string: "00X"
Même fichier, case cochée, tLogRow en mode simple : les deux premières lignes sont passées, puis le job s'arrête (code 1). Same file, box checked, tLogRow in basic mode: the first two rows have gone through, then the job stops (exit code 1).
1|2026-11-01|19.90 2|2026-12-01|5.00 Exception in component tFileInputPositional_1 (MyJob) java.lang.NumberFormatException: For input string: "00X" at java.base/java.lang.NumberFormatException.forInputString(NumberFormatException.java:67) at java.base/java.lang.Integer.parseInt(Integer.java:662) …
Par défaut, un fichier introuvable ne donne qu'un message et zéro ligne : la suite du job s'exécute comme si le fichier était vide. Cochez Arrêter en cas d'erreur, ou vérifiez NB_LINE dans un lien Run if.
By default, a file not found only gives a message and no row: the rest of the job runs as if the file were empty. Check Die on error, or check NB_LINE in a Run if link.
Sans Valider la date, une date impossible est reportée sur le jour réel suivant (2026-02-30 → 2 mars), sans erreur. Cochez la case pour rejeter ces lignes.
Without Validate date, an impossible date is carried over to the next real day (2026-02-30 → March 2), with no error. Check the box to reject these lines.
Avec Personnaliser et le remplissage '0', un champ de zéros devient null. Si la valeur zéro compte, gardez un remplissage ' ' ou le mode simple, qui lit 00000 comme 0.
With Customize and the '0' padding, a field of zeros becomes null. If the zero value matters, keep a ' ' padding or the simple mode, which reads 00000 as 0.
Ni le nombre de largeurs, ni leur somme ne sont comparés au schéma ou aux lignes : une ligne trop courte laisse ses dernières colonnes vides, une ligne trop longue perd sa fin (ou la donne à *). Comptez les largeurs sur une ligne réelle du fichier.
Neither the number of widths nor their sum is compared to the schema or to the lines: a line that is too short leaves its last columns empty, a line that is too long loses its end (or gives it to *). Count the widths on a real line of the file.
Le n de - Line: n compte les lignes lues depuis 0, après l'en-tête et sans les lignes vides sautées : ajoutez l'en-tête et 1 pour retrouver le numéro de ligne du fichier. Les colonnes du rejet gardent les valeurs lues avant l'erreur.
The n of - Line: n counts the lines read from 0, after the header and without the skipped empty lines: add the header and 1 to find the line number in the file. The columns of the reject keep the values read before the error.
Le défaut est ISO-8859-15. Pour un fichier UTF-8, réglez l'Encodage, et, si les largeurs ont été comptées en octets, les Unités des modèles sur Bytes. Un fichier dans un autre encodage peut aussi être converti avant avec tChangeFileEncoding. The default is ISO-8859-15. For a UTF-8 file, set the Encoding, and, if the widths were counted in bytes, the Pattern units to Bytes. A file in another encoding can also be converted first with tChangeFileEncoding.
tFileOutputPositional · écrire un fichier à positions fixeswrite a fixed-width filetFileInputMSPositional · fichier positionnel à plusieurs schémaspositional file with several schemastFileInputDelimited · fichier délimité ou CSVdelimited or CSV filetFileInputRegex · découper les lignes avec une expression régulièresplit the lines with a regular expressiontFileInputFullRow · lire chaque ligne entière dans une colonneread each whole line into one columntChangeFileEncoding · changer l'encodage du fichier avant de le lirechange the encoding of the file before reading it