ComposantsComponents

ComposantsComponents › Fichier › LectureFile › Input

tFileInputMSDelimited

tFileInputMSDelimited

Fichier › LectureFile › Input

Lit un fichier délimité qui mélange plusieurs types d'enregistrements (un en-tête, des lignes de détail, un pied…) et envoie chaque type vers sa propre sortie, avec son propre schéma. Le type d'une ligne est la valeur d'un de ses champs, par exemple le premier. Les types peuvent former une hiérarchie : chaque ligne d'un type enfant reçoit alors la clé de la dernière ligne parente lue. Le composant se règle avec l'éditeur multi-schéma du Studio. Reads a delimited file that mixes several record types (a header, detail lines, a trailer…) and sends each type to its own output, with its own schema. The type of a line is the value of one of its fields, for example the first one. The types can form a hierarchy: each line of a child type then receives the key of the last parent line read. The component is set up with the multi-schema editor of the Studio.

EntréeInput

Aucune : il commence son sous-job. Sinon un lien Iterate (un fichier par tour). None: it starts its subjob. Otherwise one Iterate link (one file per turn).

SortieOutput

Main un lien par type d'enregistrement, chacun avec son schéma ; pas de lien Rejectone link per record type, each one with its schema; no Reject link

Déclencheurs en sortieOutput triggers

On Subjob Ok On Subjob Error On Component Ok On Component Error Run if

UtilisationUsage

Une sortie par typeOne output per type

row_A_1 (Main) row_B_1 (Main) row_C_1 (Main) tFileInputMSDelimited_1 tLogRow_1 tLogRow_2 tLogRow_3

L'éditeur nomme les schémas A, B, C… dans l'ordre où il trouve les types, et chaque lien d'après son schéma : row_A_1, row_B_1… Chaque sortie ne reçoit que les lignes de son type. The editor names the schemas A, B, C… in the order it finds the types, and each link after its schema: row_A_1, row_B_1… Each output only receives the lines of its type.

Le tableau SortieThe Output table

ConnexionConnection Type d'enregistrement liéRelated record type Séparateur de champsField Separator
A"H"";"
B"L"";"
C"T"";"

Une ligne par type, remplie par l'éditeur. Le Studio n'en montre que ces trois colonnes ; trois autres, cachées, portent la hiérarchie (voir les paramètres). One row per type, filled by the editor. The Studio only shows these three columns; three other ones, hidden, hold the hierarchy (see the settings).

  1. Déposez le tFileInputMSDelimited depuis la famille Fichier › Lecture de la palette. Drop the tFileInputMSDelimited from the File › Input family of the palette.
  2. Ouvrez l'Éditeur multi-schéma (bouton de l'onglet Composant). Indiquez le fichier, son encodage, ses séparateurs et, au besoin, les options CSV : ces réglages ne sont que dans l'éditeur. Dans l'aperçu, choisissez la colonne qui porte le type d'enregistrement, puis cliquez sur Fetch Codes : l'éditeur crée un schéma par valeur trouvée et en devine les colonnes. Open the Multi Schema Editor (button of the Component tab). Set the file, its encoding, its separators and, if needed, the CSV options: these settings are only in the editor. In the preview, choose the column that holds the record type, then click Fetch Codes: the editor creates one schema per value found and guesses its columns.
  3. Renommez et typez les colonnes de chaque schéma (Edit Columns). Un schéma commence au premier champ de la ligne : il contient aussi la colonne du type. Pour une hiérarchie, placez un type sous un autre dans l'arbre, cochez la colonne clé du parent et, au besoin, donnez une cardinalité. Rename and type the columns of each schema (Edit Columns). A schema starts at the first field of the line: it also contains the type column. For a hierarchy, place a type under another one in the tree, check the key column of the parent and, if needed, give a cardinality.
  4. Validez, puis reliez chaque sortie (clic droit › Ligne › row_A_1…). Confirm, then connect each output (right-click › Row › row_A_1…).

Comment une ligne est lueHow a line is read

  • La ligne est découpée par le séparateur de champs ; les lignes vides sont sautées. Le champ de position Index des colonnes du schéma (0 pour le premier), sans ses espaces si Supprimer les espaces… est coché, est comparé au Type d'enregistrement lié de chaque ligne du tableau, dans l'ordre : la première qui correspond l'emporte. The line is split by the field separator; empty lines are skipped. The field at position Schema column index (0 for the first one), without its spaces if Trim all columns is checked, is compared with the Related record type of each row of the table, in order: the first one that matches wins.
  • Une ligne dont le type n'est dans aucune ligne du tableau est ignorée, sans message. A line whose type is in no row of the table is ignored, with no message.
  • Les champs remplissent les colonnes du schéma par position : le premier champ va dans la première colonne, qui est donc celle du type, et ainsi de suite. The fields fill the schema columns by position: the first field goes into the first column, which is thus the type one, and so on.
  • Pour un type enfant, la dernière colonne du schéma, que l'éditeur ajoute, n'est pas lue dans la ligne : elle reçoit la clé de la dernière ligne parente lue, c'est-à-dire le champ de la Clé d'index du parent, ou, sans clé, le numéro de la ligne parente (1, 2…) (voir l'exemple). For a child type, the last column of the schema, which the editor adds, is not read from the line: it receives the key of the last parent line read, that is the field of the Key Index of the parent, or, without a key, the number of the parent line (1, 2…) (see the example).
  • Une valeur qui ne se convertit pas, ou une cardinalité non respectée, fait perdre la ligne : son message est écrit sur la sortie d'erreur, et le composant passe à la suivante, sauf avec Arrêter en cas d'erreur. A value that does not convert, or a cardinality not met, loses the line: its message is written on the error output, and the component goes on with the next one, except with Die on error.

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. L'onglet ne montre que trois paramètres : le reste est réglé dans l'éditeur multi-schéma (tableau suivant). Labels are those of the Component tab; the technical name, in grey, is the parameter name in the job file. The tab only shows three settings: the rest is set in the multi-schema editor (next table).

ParamètreSetting DéfautDefault VisibleShown Description
Éditeur multi-schémaMulti Schema EditorMULTI — ToujoursAlways Bouton qui ouvre l'éditeur. À la validation, il écrit les réglages du fichier, le tableau Sortie et un schéma par type. Button that opens the editor. When confirmed, it writes the file settings, the Output table and one schema per type.
SortieOutputSCHEMAS videempty ToujoursAlways Une ligne par type d'enregistrement. Colonnes ci-dessous. One row per record type. Columns below.
Arrêter en cas d'erreurDie on errorDIE_ON_ERROR NonNo ToujoursAlways Arrête le job à la première erreur (valeur, cardinalité). Décoché, la ligne en erreur est perdue et son message écrit sur la sortie d'erreur (voir l'exemple). Stops the job at the first error (value, cardinality). Unchecked, the line in error is lost and its message written on the error output (see the example).

Colonnes du tableau SortieColumns of the Output table

L'éditeur écrit les valeurs comme des expressions Java, entre guillemets. Les trois colonnes cachées dans le Studio (SHOW_IF="false") ne se règlent que dans l'éditeur. The editor writes the values as Java expressions, in quotes. The three columns hidden in the Studio (SHOW_IF="false") are only set in the editor.

ParamètreSetting DéfautDefault VisibleShown Description
ConnexionConnectionSCHEMA A, B… ToujoursAlways Le libellé du schéma de la sortie. Le code cherche la sortie dont le schéma porte ce libellé : sans elle, les lignes de ce type sont lues puis perdues. The label of the schema of the output. The code looks for the output whose schema has this label: without it, the lines of this type are read and then lost.
Type d'enregistrement liéRelated record typeRECORD la valeur trouvéethe value found ToujoursAlways La valeur du champ de type qui désigne ce schéma, en expression Java : "H". Comparée telle quelle, casse comprise. The value of the type field that selects this schema, as a Java expression: "H". Compared as is, case included.
Parent de l'enregistrementRecord ParentPARENT_RECORD "" Jamais (éditeur)Never (editor) Le type parent, "H" ; "" pour un type sans parent. The parent type, "H"; "" for a type without a parent.
Clé d'indexKey IndexKEY_COLUMN_INDEX "" Jamais (éditeur)Never (editor) Pour un type parent : la position, à partir de 0, du champ qui sert de clé à ses enfants ("1"), cochée Key dans l'éditeur. Vide, les enfants reçoivent le numéro de la ligne parente. For a parent type: the position, from 0, of the field that serves as key to its children ("1"), checked Key in the editor. Empty, the children receive the number of the parent line.
CardinalitéCardinalityCARDINALITY "" Jamais (éditeur)Never (editor) Pour un type enfant : le nombre de lignes permis sous chaque parent, 1,2, 3 (exactement) ou 0,*. Vide, pas de contrôle. Plusieurs défauts : voir Cardinalité. For a child type: the number of lines allowed under each parent, 1,2, 3 (exactly) or 0,*. Empty, no check. Several flaws: see Cardinality.
Séparateur de champsField SeparatorFIELDDELIMITED celui du fichierthe file one ToujoursAlways Le séparateur des lignes de ce type, ";". Lu seulement avec Utiliser des séparateurs multiples (voir l'exemple). The separator of the lines of this type, ";". Only read with Use multiple separators (see the example).

Réglages de l'éditeur multi-schémaSettings of the multi-schema editor

Paramètres cachés de l'onglet Composant (SHOW="false") : l'éditeur les écrit dans le job. Settings hidden from the Component tab (SHOW="false"): the editor writes them into the job.

ParamètreSetting DéfautDefault VisibleShown Description
Nom de fichierFile NameFILENAME chemin par défaut + /in.csvdefault path + /in.csv ÉditeurEditor Le fichier lu, en expression Java. The file read, as a Java expression.
Séparateur de lignesRow SeparatorROWSEPARATOR "\n" ÉditeurEditor La fin de chaque ligne. Avec les options CSV, seul son premier caractère compte. The end of each line. With the CSV options, only its first character counts.
Séparateur de champsField SeparatorFIELDSEPARATOR ";" ÉditeurEditor Le séparateur de toutes les lignes, sans séparateurs multiples. Avec les options CSV, seul son premier caractère compte. The separator of all the lines, without multiple separators. With the CSV options, only its first character counts.
Index des colonnes du schémaSchema column indexCOLUMNINDEX "0" ÉditeurEditor La position, à partir de 0, du champ qui porte le type d'enregistrement : la colonne choisie dans l'aperçu. The position, from 0, of the field that holds the record type: the column chosen in the preview.
Options CSVCSV optionsCSV_OPTION NonNo ÉditeurEditor Lit les champs entourés : un séparateur peut y figurer, un entourage doublé y vaut un caractère (voir l'exemple). Reads enclosed fields: a separator can appear inside, a doubled enclosure stands for one character (see the example).
Caractère d'échappementEscape charESCAPE_CHAR "\"" Éditeur, options CSVEditor, CSV options D'après le code généré, seul "\\" change quelque chose (échappement par \) ; toute autre valeur revient à doubler l'entourage. Seule la valeur par défaut a été essayée. According to the generated code, only "\\" changes anything (escape with \); any other value means doubling the enclosure. Only the default value was tried.
Entourage du texteText enclosureTEXT_ENCLOSURE "\"" Éditeur, options CSVEditor, CSV options Le caractère qui entoure les champs. The character around the fields.
Utiliser des séparateurs multiplesUse multiple separatorsUSE_MULTISEPARATORS NonNo ÉditeurEditor Chaque type a son séparateur, la colonne Séparateur de champs du tableau. Chaque ligne est essayée avec le séparateur de chaque ligne du tableau, dans l'ordre, jusqu'à trouver un type qui va avec ce séparateur (voir l'exemple et son défaut). Each type has its separator, the Field Separator column of the table. Each line is tried with the separator of each row of the table, in order, until a type that goes with this separator is found (see the example and its flaw).
Séparateurs multiples :Mutliple Separators:MULTI_SEPARATORS videempty ÉditeurEditor Champs de l'éditeur, gardés dans le job pour le rouvrir. Le code généré ne les lit pas. Editor fields, kept in the job to open it again. The generated code does not read them.
Valeurs clés :Key Values:MULTI_KEYVALUES videempty ÉditeurEditor Comme le précédent. Like the previous one.
EncodageEncodingENCODING "ISO-8859-15" ÉditeurEditor L'encodage du fichier lu. The encoding of the file read.

Paramètres avancésAdvanced settings

ParamètreSetting DéfautDefault VisibleShown Description
Supprimer les espaces en début et fin de champ dans toutes les colonnesTrim all columnsTRIMALL OuiYes ToujoursAlways Retire les espaces autour de chaque champ, celui du type compris, avant la comparaison. Removes the spaces around each field, the type one included, before the comparison.
Valider la dateValidate dateCHECK_DATE NonNo ToujoursAlways Lit les dates de façon stricte : une date qui ne suit pas le modèle de sa colonne est une erreur. Reads the dates strictly: a date that does not follow the pattern of its column is an error.
Séparateur avancé (pour les nombres)Advanced separator (for numbers)ADVANCED_SEPARATOR NonNo ToujoursAlways Lit les nombres avec les séparateurs ci-dessous : 1.500 donne 1500 (voir l'exemple). Reads the numbers with the separators below: 1.500 gives 1500 (see the example).
Séparateur de milliersThousands separatorTHOUSANDS_SEPARATOR "," Séparateur avancé cochéAdvanced separator checked Un caractère, entre guillemets. One character, in quotes.
Séparateur décimalDecimal separatorDECIMAL_SEPARATOR "." Séparateur avancé cochéAdvanced separator checked Un caractère, entre guillemets. One character, in quotes.

Variables globalesGlobal variables

Défaut du modèle : NB_LINE n'est jamais rempliTemplate flaw: NB_LINE is never filled

NB_LINE (Integer, après l'exécution) est déclaré par le composant, mais ses modèles ne l'écrivent jamais : il vaut null dans tous les exemples de cette page. Pour compter les lignes lues, lisez le NB_LINE des composants qui suivent chaque sortie. NB_LINE (Integer, after the run) is declared by the component, but its templates never write it: it is null in all the examples of this page. To count the lines read, read the NB_LINE of the components that follow each output.

((Integer) globalMap.get("tFileInputMSDelimited_1_NB_LINE"))

ERROR_MESSAGE

(String) Le message de la dernière ligne en erreur, écrit à chaque erreur, que le job s'arrête ou non. (String) The message of the last line in error, written at each error, whether the job stops or not.

((String) globalMap.get("tFileInputMSDelimited_1_ERROR_MESSAGE"))

ExemplesExamples

Chaque sortie va dans un tLogRow, réglé pour afficher son nom devant chaque ligne ; un tJava relié par On Subjob Ok affiche ensuite NB_LINE. Les fichiers ont été écrits tels qu'ils sont montrés, en ISO-8859-15 sauf mention contraire. Les sorties sont celles de la console, copiées depuis une exécution du job ; les messages de la sortie d'erreur y sont mêlés aux lignes. Each output goes into a tLogRow, set to print its name in front of each line; a tJava connected with On Subjob Ok then prints NB_LINE. The files were written as shown, in ISO-8859-15 unless stated otherwise. The outputs are the console ones, copied from a run of the job; the messages of the error output are mixed with the lines.

Trois types d'enregistrementsThree record types

orders_flat.txt

H;1;Ada
L;1;Pen;3
L;1;Paper;10
H;2;Grace
L;2;Ink;1
X;unknown
T;2;3

Sortie : celui de l'utilisation, trois types sans parent. Schémas : A (rec, id Integer, customer) → tLogRow_1 ; B (rec, order_id Integer, product, qty Integer) → tLogRow_2 ; C (rec, orders Integer, lines Integer) → tLogRow_3. Autres réglages par défaut. Output: the one of the usage section, three types without a parent. Schemas: A (rec, id Integer, customer) → tLogRow_1; B (rec, order_id Integer, product, qty Integer) → tLogRow_2; C (rec, orders Integer, lines Integer) → tLogRow_3. Other settings by default.

[tLogRow_1] H|1|Ada
[tLogRow_2] L|1|Pen|3
[tLogRow_2] L|1|Paper|10
[tLogRow_1] H|2|Grace
[tLogRow_2] L|2|Ink|1
[tLogRow_3] T|2|3
NB_LINE: null

Les lignes sortent dans l'ordre du fichier, chacune par la sortie de son type. La ligne X, d'un type absent du tableau, est ignorée sans message. The lines come out in the order of the file, each one through the output of its type. The X line, of a type missing from the table, is ignored with no message.

Lignes rattachées à leur commandeLines attached to their order

orders_tree.txt

H;10;Ada
L;Pen;3
L;Paper;10
H;20;Grace
L;Ink;1

Les lignes L ne portent pas le numéro de leur commande : il vient de la ligne H qui les précède. Dans l'éditeur, L est placé sous H. Le schéma B a ainsi une dernière colonne de plus, order_id (String), qui n'est pas dans la ligne. The L lines do not hold the number of their order: it comes from the H line before them. In the editor, L is placed under H. The B schema thus has one more last column, order_id (String), which is not in the line.

ConnexionConnection TypeType ParentParent Clé d'indexKey Index
A"H""""1"
B"L""H"""

Schémas : A (rec, id Integer, customer) ; B (rec, product, qty Integer, order_id). Schemas: A (rec, id Integer, customer); B (rec, product, qty Integer, order_id).

Clé d'index "1" (le champ id de la commande) :Key Index "1" (the id field of the order):

[tLogRow_1] H|10|Ada
[tLogRow_2] L|Pen|3|10
[tLogRow_2] L|Paper|10|10
[tLogRow_1] H|20|Grace
[tLogRow_2] L|Ink|1|20
NB_LINE: null

Clé d'index vide :Empty Key Index:

[tLogRow_1] H|10|Ada
[tLogRow_2] L|Pen|3|1
[tLogRow_2] L|Paper|10|1
[tLogRow_1] H|20|Grace
[tLogRow_2] L|Ink|1|2
NB_LINE: null

Avec une clé, chaque ligne reçoit l'id de sa commande ; sans clé, le rang de la commande dans le fichier : 1, puis 2. With a key, each line receives the id of its order; without a key, the rank of the order in the file: 1, then 2.

Options CSVCSV options

Les types A et B du premier exemple, Options CSV coché, entourage et échappement par défaut. Le client contient un point-virgule et des guillemets : The A and B types of the first example, CSV options checked, default enclosure and escape. The customer contains a semicolon and quotes:

H;1;"Ada; ""AL"""
L;1;"Pen";3
L;1;Paper;10
[tLogRow_1] H|1|Ada; "AL"
[tLogRow_2] L|1|Pen|3
[tLogRow_2] L|1|Paper|10
NB_LINE: null

Les guillemets qui entourent sont retirés, les guillemets doublés en donnent un ; un champ peut être entouré ou non. The enclosing quotes are removed, doubled quotes give one; a field may be enclosed or not.

Un séparateur par typeOne separator per type

Les types A et B du premier exemple, Utiliser des séparateurs multiples coché ; Séparateur de champs du tableau : ";" pour A, "," pour B. Fichier en UTF-8, Encodage "UTF-8" : The A and B types of the first example, Use multiple separators checked; Field Separator of the table: ";" for A, "," for B. File in UTF-8, Encoding "UTF-8":

H;1;Hélène
L,1,Pen,3
L,1,Paper,10
[tLogRow_1] H|1|Hélène
[tLogRow_2] L|1|Pen|3
[tLogRow_2] L|1|Paper|10
NB_LINE: null

Le même fichier en ISO-8859-15, avec l'encodage par défaut, perd ses accents dans ce mode (voir le défaut). The same file in ISO-8859-15, with the default encoding, loses its accents in this mode (see the flaw).

Séparateur avancé pour les nombresAdvanced separator for numbers

Un seul type, N : rec, total (Integer), qty (Integer, non nullable), price (Double). Séparateur de milliers ".", décimal ",". A single type, N: rec, total (Integer), qty (Integer, not nullable), price (Double). Thousands separator ".", decimal ",".

N;1.500;1.500;1.234,5
[tLogRow_1] N|1500|1500|1234.5
NB_LINE: null

Les deux colonnes entières sont lues de la même façon, nullable ou non. Both integer columns are read the same way, nullable or not.

Une valeur invalideAn invalid value

Les types A et B du premier exemple ; une quantité n'est pas un nombre : The A and B types of the first example; a quantity is not a number:

H;1;Ada
L;1;Pen;abc
L;1;Paper;10

Arrêter en cas d'erreur décoché :Die on error unchecked:

[tLogRow_1] H|1|Ada
For input string: "abc"
[tLogRow_2] L|1|Paper|10
NB_LINE: null

Coché, le job s'arrête avec le code 1 (nom du job remplacé par MyJob, trace abrégée) :Checked, the job stops with exit code 1 (job name replaced with MyJob, trace shortened):

[tLogRow_1] H|1|Ada
Exception in component tFileInputMSDelimited_1 (MyJob)
java.lang.NumberFormatException: For input string: "abc"
	at java.base/java.lang.NumberFormatException.forInputString(NumberFormatException.java:67)
	…
	at routines.system.ParserUtils.parseTo_Integer(ParserUtils.java:137)
	at demo.myjob_0_1.MyJob.tFileInputMSDelimited_1Process(MyJob.java:1335)
	…

CardinalitéCardinality

La cardinalité d'un type enfant borne le nombre de ses lignes sous chaque parent. Le code compte les lignes enfants depuis la dernière ligne parente ; il vérifie le compte à chaque ligne enfant, et celui du parent précédent à chaque nouvelle ligne parente. Une cardinalité non respectée fait perdre la ligne en cours, avec le message Data error in file: The cardinality for … is …, but we have found …. Ce contrôle a plusieurs défauts dans les modèles de Talaxie (tFileInputMSDelimited_begin.javajet) : n'en comptez pas sur lui pour valider un fichier. Exemples sur la hiérarchie H / L de l'exemple, avec la clé ; nom du job remplacé par MyJob. The cardinality of a child type bounds the number of its lines under each parent. The code counts the child lines since the last parent line; it checks the count at each child line, and the one of the previous parent at each new parent line. A cardinality not met loses the current line, with the message Data error in file: The cardinality for … is …, but we have found …. This check has several flaws in the Talaxie templates (tFileInputMSDelimited_begin.javajet): do not rely on it to validate a file. Examples on the H / L hierarchy of the example, with the key; job name replaced with MyJob.

Défaut : après une erreur, tout est rejetéFlaw: after one error, everything is rejected

Cardinalité 1,2 ; la commande 1 a trois lignes : Cardinality 1,2; order 1 has three lines:

H;1;Ada
L;Pen;3
L;Paper;10
L;Glue;2
H;2;Grace
H;3;Alan
L;Ink;1
[tLogRow_1] H|1|Ada
[tLogRow_2] L|Pen|3|1
[tLogRow_2] L|Paper|10|1
Data error in file: The cardinality for L is 1,2, but we have found 3.
Data error in file: The cardinality for L is 1,2, but we have found 3.
Data error in file: The cardinality for L is 1,2, but we have found 3.
Data error in file: The cardinality for L is 1,2, but we have found 4.
NB_LINE: null

La troisième ligne, Glue, est rejetée comme prévu. Mais l'erreur levée sur une ligne parente arrive avant la remise à zéro du compte : les commandes 2 et 3, puis la ligne Ink, sont rejetées à leur tour, et ainsi jusqu'à la fin du fichier. The third line, Glue, is rejected as expected. But the error raised on a parent line comes before the count is reset: orders 2 and 3, then the Ink line, are rejected in turn, and so on until the end of the file.

Défaut : un minimum au-delà de 1Flaw: a minimum above 1

Cardinalité 2,3 ; chaque commande a deux lignes : Cardinality 2,3; each order has two lines:

H;1;Ada
L;Pen;3
L;Paper;10
H;2;Grace
L;Ink;1
L;Glue;2
[tLogRow_1] H|1|Ada
Data error in file: The cardinality for L is 2,3, but we have found 1.
[tLogRow_2] L|Paper|10|1
[tLogRow_1] H|2|Grace
Data error in file: The cardinality for L is 2,3, but we have found 1.
[tLogRow_2] L|Glue|2|2
NB_LINE: null

Le minimum est aussi vérifié à chaque ligne enfant : la première ligne de chaque commande, comptée 1, est toujours rejetée. Seuls les minimums 0 et 1 sont utilisables. The minimum is also checked at each child line: the first line of each order, counted 1, is always rejected. Only the minimums 0 and 1 are usable.

Défaut : un parent sans enfantFlaw: a parent without a child

Cardinalité 1,2 ; la commande 2 n'a pas de ligne : Cardinality 1,2; order 2 has no line:

H;1;Ada
L;Pen;3
H;2;Grace
H;3;Alan
L;Ink;1
[tLogRow_1] H|1|Ada
[tLogRow_2] L|Pen|3|1
[tLogRow_1] H|2|Grace
[tLogRow_2] L|Ink|1|3
Data error in file: The cardinality for L is 1,2, but we have found 0.
NB_LINE: null

L'erreur sur la commande 2 n'est vue qu'à la ligne parente suivante : c'est la commande 3, Alan, qui est perdue, et sa ligne Ink sort quand même, avec la clé 3. La dernière commande du fichier n'est jamais vérifiée : sans la ligne H;3;Alan, Grace sans ligne passe sans erreur. The error on order 2 is only seen at the next parent line: it is order 3, Alan, that is lost, and its Ink line still comes out, with key 3. The last order of the file is never checked: without the H;3;Alan line, Grace without a line passes with no error.

Défaut : le maximum *Flaw: the * maximum

Une cardinalité * seule est recopiée telle quelle dans le code, qui ne compile pas : A * cardinality alone is copied as is into the code, which does not compile:

MyJob.java:1311: error: illegal start of expression
int count_B_tFileInputMSDelimited_1 = *;
                                      ^
…
4 errors

0,* fonctionne, mais seulement sans options CSV ni séparateurs multiples. Avec l'un d'eux, le code compare au maximum sans l'avoir déclaré : 0,* works, but only without CSV options or multiple separators. With one of them, the code compares with the maximum without having declared it:

MyJob.java:1362: error: cannot find symbol
		if((count_B_tFileInputMSDelimited_1 < lowBound_B_tFileInputMSDelimited_1) || (count_B_tFileInputMSDelimited_1 > highBound_B_tFileInputMSDelimited_1)){
		                                                                                                                ^
  symbol:   variable highBound_B_tFileInputMSDelimited_1
…
2 errors

Pour « pas de maximum », laissez la cardinalité vide. For “no maximum”, leave the cardinality empty.

Autre défautOther flaw

Accents perdus avec les séparateurs multiplesAccents lost with multiple separators

Le fichier de l'exemple, écrit cette fois en ISO-8859-15, Encodage par défaut ("ISO-8859-15") : The file of the example, written in ISO-8859-15 this time, default Encoding ("ISO-8859-15"):

[tLogRow_1] H|1|HélÚne
[tLogRow_2] L|1|Pen|3
[tLogRow_2] L|1|Paper|10
NB_LINE: null

Dans ce mode, chaque ligne lue est reconvertie en octets dans l'encodage de la JVM (UTF-8), puis relue dans l'Encodage du composant. Le même fichier, avec un seul séparateur, est bien lu : H|1|Hélène. Avec des séparateurs multiples, n'utilisez que des fichiers en UTF-8, Encodage "UTF-8". In this mode, each line read is converted back into bytes in the JVM encoding (UTF-8), then read again in the Encoding of the component. The same file, with a single separator, is read correctly: H|1|Hélène. With multiple separators, only use files in UTF-8, Encoding "UTF-8".

Conseils et limitesTips and limits

Pas de sortie RejectNo Reject output

Une ligne d'un type inconnu disparaît sans message, une ligne en erreur avec un simple message. Pour repérer les lignes inconnues, relisez le fichier avec un tFileInputFullRow et gardez celles dont le type n'est pas dans le tableau. A line of an unknown type disappears with no message, a line in error with just a message. To spot the unknown lines, read the file again with a tFileInputFullRow and keep those whose type is not in the table.

La colonne du type fait partie du schémaThe type column is part of the schema

Les champs remplissent les colonnes par position, depuis le premier : retirer la colonne rec d'un schéma décale toutes les autres. Gardez-la, quitte à l'ignorer plus loin. The fields fill the columns by position, from the first one: removing the rec column from a schema shifts all the others. Keep it, even if you ignore it further on.

Pour écrire ce formatTo write this format

Le pendant en écriture est le tFileOutputMSDelimited, qui met chaque ligne enfant sous la ligne parente de même clé. The writing counterpart is tFileOutputMSDelimited, which puts each child line under the parent line with the same key.

Largeur fixe ou XMLFixed width or XML

Pour un fichier en colonnes de largeur fixe, prenez le tFileInputMSPositional, qui a en plus une sortie Reject ; pour un document XML à plusieurs niveaux, le tFileInputMSXML. For a file in fixed-width columns, take tFileInputMSPositional, which also has a Reject output; for a multi-level XML document, tFileInputMSXML.

Voir aussiSee also