ComposantsComponents › Fichier › SortieFile › Output
Écrit dans un seul fichier délimité les lignes de plusieurs flux, chacun avec ses propres colonnes : des commandes et leurs lignes, un en-tête, des détails et un pied… Chaque ligne d'un flux enfant est écrite juste après la ligne de son parent, celle qui a la même valeur de clé. Le composant garde toutes les lignes en mémoire et écrit le fichier quand tous les flux sont arrivés. Writes the rows of several flows, each with its own columns, into one delimited file: orders and their lines, a header, details and a trailer… Each row of a child flow is written right after the row of its parent, the one with the same key value. The component keeps all the rows in memory and writes the file once all the flows have arrived.
EntréeInput
Merge un lien par type d'enregistrement, au moins un, sans limite ; chacun a son schémaone link per record type, at least one, no limit; each one has its schema
SortieOutput
Aucune : pas de flux de sortie. Le résultat est le fichier écrit. None: no output flow. The result is the written file.
Déclencheurs en sortieOutput triggers
On Component Ok On Component Error Run if
Un composant par source, un lien par type d'enregistrement. Les liens qui arrivent sur ce composant sont des liens Merge : le Studio les numérote dans leur libellé. One component per source, one link per record type. The links that arrive on this component are Merge links: the Studio numbers them in their label.
| SchémaSchema | Ligne parenteParent row | Colonne de clé parenteParent key column | Colonne cléKey column |
|---|---|---|---|
| orders | |||
| lines | orders | id | order_id |
Une ligne par lien entrant. orders n'a pas de parent : c'est la racine. Une ligne de lines va sous la commande dont id est égal à son order_id.
One row per incoming link. orders has no parent: it is the root. A lines row goes under the order whose id equals its order_id.
row1…). Supprimer le lien retire la ligne. Les exemples nomment les liens orders, lines… pour la lisibilité.
Connect each flow to it (right-click › Row › Main). The link becomes a Merge link, and the Studio adds to the Schemas table a row named after the link (row1…). Deleting the link removes the row. The examples name the links orders, lines… for readability.
String.valueOf). Une ligne enfant dont la clé ne correspond à aucun parent n'est pas écrite, sans message ; une ligne parente en double reçoit les mêmes enfants une fois par exemplaire (voir les pièges).
The two keys are compared as text (String.valueOf). A child row whose key matches no parent is not written, with no message; a duplicated parent row gets the same children once per copy (see the pitfalls).
Les libellés sont ceux de l'onglet Composant ; le nom technique, en gris, est celui du paramètre dans le fichier du job. Le composant n'a pas de schéma propre : il prend celui de chaque lien entrant. Labels are those of the Component tab; the technical name, in grey, is the parameter name in the job file. The component has no schema of its own: it takes the one of each incoming link.
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| Nom de fichierFile NameFILENAME | chemin par défaut + /out.csvdefault path + /out.csv |
ToujoursAlways |
Le fichier écrit, en expression Java : context.folder + "/orders.csv". Il est remplacé s'il existe.
The written file, as a Java expression: context.folder + "/orders.csv". It is replaced if it exists.
|
| Séparateur de lignesRow SeparatorROWSEPARATOR | "\n" |
ToujoursAlways |
Écrit après chaque ligne, quel que soit son type. Avec les Options CSV, seul son premier caractère compte : "\r\n" donne \r (voir les pièges).
Written after each row, whatever its type. With CSV options, only its first character counts: "\r\n" gives \r (see the pitfalls).
|
| Séparateur de champsField SeparatorFIELDSEPARATOR | ";" |
Séparateurs multi décochéMulti separators unchecked | Écrit entre les champs de toutes les lignes. Avec les Options CSV, seul son premier caractère compte. Written between the fields of all the rows. With CSV options, only its first character counts. |
| Utiliser des séparateurs multi champsUse Multi Field SeparatorsUSEMULTISEPARATOR | NonNo | ToujoursAlways | Un séparateur par type d'enregistrement : la colonne Séparateur de champs du tableau Schémas remplace le paramètre précédent (voir l'exemple). One separator per record type: the Field Separator column of the Schemas table replaces the previous setting (see the example). |
| SchémasSchemasSCHEMAS | une ligne par lienone row per link | ToujoursAlways | Le rôle de chaque flux : sa place dans la hiérarchie et sa clé. Colonnes ci-dessous. The role of each flow: its place in the hierarchy and its key. Columns below. |
Les noms de colonnes s'écrivent avec ou sans guillemets : id et "id" donnent le même résultat.
Column names are written with or without quotes: id and "id" give the same result.
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| SchémaSchemaSCHEMA | le nom du lienthe link name | ToujoursAlways | Le lien entrant que décrit la ligne, rempli par le Studio. Chaque lien doit avoir sa ligne : sans elle, la génération du code échoue (voir les erreurs). The incoming link that the row describes, filled by the Studio. Each link must have its row: without it, the code generation fails (see the errors). |
| Ligne parenteParent rowPARENT_ROW | videempty | ToujoursAlways | Le lien du flux parent, choisi parmi les liens entrants. Vide pour la racine, et pour elle seule : deux racines empêchent la compilation. The link of the parent flow, chosen among the incoming links. Empty for the root, and for it only: two roots prevent the compilation. |
| Colonne de clé parenteParent key columnPARENT_KEY_COLUMN | videempty | ToujoursAlways |
La colonne du flux parent qui identifie la ligne parente (id d'une commande). Ignorée pour la racine.
The column of the parent flow that identifies the parent row (id of an order). Ignored for the root.
|
| Colonne cléKey columnKEY_COLUMN | videempty | ToujoursAlways |
La colonne de ce flux qui contient la clé du parent (order_id d'une ligne de commande). Obligatoire pour un flux enfant : vide, le job ne compile pas. Ignorée pour la racine.
The column of this flow that holds the key of the parent (order_id of an order line). Required for a child flow: empty, the job does not compile. Ignored for the root.
|
| Séparateur de champsField SeparatorFIELD_SEPARATOR | videempty | Séparateurs multi cochéMulti separators checked |
Le séparateur des lignes de ce flux, en expression Java, donc entre guillemets : "|".
The separator of the rows of this flow, as a Java expression, so in quotes: "|".
|
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| Séparateur avancé (pour les nombres)Advanced separator (for numbers)ADVANCED_SEPARATOR | NonNo | ToujoursAlways |
Écrit les nombres avec les séparateurs ci-dessous. Seules les colonnes nombres nullables sont formatées ; une colonne non nullable (int) reste telle quelle (voir l'exemple).
Writes the numbers with the separators below. Only nullable number columns are formatted; a non-nullable column (int) stays as it is (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. |
| Options CSVCSV optionsCSV_OPTION | NonNo | ToujoursAlways | Écrit au format CSV : tous les champs sont entourés, un entourage dans une valeur est doublé (voir l'exemple). Les séparateurs ne gardent que leur premier caractère. Writes in CSV format: all the fields are enclosed, an enclosure inside a value is doubled (see the example). The separators keep only their first character. |
| Caractère d'échappementEscape charESCAPE_CHAR | "\"" |
Options CSV cochéesCSV options checked |
D'après le code généré, l'entourage est presque toujours échappé en le doublant : seule la valeur "\\\\" (deux barres obliques inverses) donne un échappement par \. Seule la valeur par défaut a été essayée.
According to the generated code, the enclosure is almost always escaped by doubling it: only the value "\\\\" (two backslashes) gives an escape with \. Only the default value was tried.
|
| Entourage du texteText enclosureTEXT_ENCLOSURE | "\"" |
Options CSV cochéesCSV options checked | Le caractère qui entoure chaque champ ; vide, le composant s'arrête. The character around each field; empty, the component stops. |
| Créer le répertoire s'il n'existe pasCreate directory if does not existCREATE | OuiYes | ToujoursAlways | Crée le dossier du fichier, avec ses parents, au démarrage du composant. Creates the folder of the file, with its parents, when the component starts. |
| EncodageEncodingENCODING | "ISO-8859-15" |
ToujoursAlways | L'encodage du fichier écrit. The encoding of the written file. |
| Ne pas générer de fichier videDon't generate empty fileDELETE_EMPTYFILE | NonNo | ToujoursAlways | Sans aucune ligne reçue, le fichier est supprimé à la fin. Décoché, il reste, vide (voir l'exemple). With no row received, the file is deleted at the end. Unchecked, it stays, empty (see the example). |
NB_LINE (Integer, disponible après l'exécution du composant) : nombre de lignes reçues, tous flux confondus. Ce n'est pas le nombre de lignes écrites : une ligne enfant sans parent compte sans être écrite, une ligne enfant sous deux parents identiques est écrite deux fois et compte une fois. NB_LINE (Integer, available after the component has run): number of rows received, all flows together. It is not the number of written rows: a child row without a parent counts without being written, a child row under two identical parents is written twice and counts once.
((Integer) globalMap.get("tFileOutputMSDelimited_1_NB_LINE"))
Les flux viennent de tFixedFlowInput en mode tableau. Le fichier est écrit dans le dossier de la variable de contexte folder ; un tJava relié par On Subjob Ok au premier tFixedFlowInput l'affiche, puis affiche NB_LINE. Les sorties sont celles de la console, copiées depuis une exécution du job.
The flows come from tFixedFlowInput components in table mode. The file is written in the folder of the folder context variable; a tJava connected with On Subjob Ok to the first tFixedFlowInput prints it, then prints NB_LINE. The outputs are the console ones, copied from a run of the job.
orders
| idInteger | customerString |
|---|---|
| 1 | Ada |
| 2 | Grace |
| 3 | Alan |
lines
| order_idInteger | productString | qtyInteger |
|---|---|---|
| 2 | Ink | 1 |
| 1 | Pen | 3 |
| 9 | Glue | 2 |
| 1 | Paper | 10 |
Schémas : celui de l'utilisation (lines sous orders, id / order_id). Nom de fichier : context.folder + "/orders.csv" ; autres paramètres par défaut.
Schemas: the one of the usage section (lines under orders, id / order_id). File Name: context.folder + "/orders.csv"; other settings by default.
Code du tJava_1 :tJava_1 code:
for (String l : java.nio.file.Files.readAllLines(java.nio.file.Paths.get(context.folder + "/orders.csv"), java.nio.charset.Charset.forName("ISO-8859-15"))) {
System.out.println(l);
}
System.out.println("NB_LINE: " + globalMap.get("tFileOutputMSDelimited_1_NB_LINE"));
1;Ada 1;Pen;3 1;Paper;10 2;Grace 2;Ink;1 3;Alan NB_LINE: 7
Chaque commande est suivie de ses lignes, dans leur ordre d'arrivée (Pen puis Paper). La commande 3 n'a pas de ligne. La ligne Glue (commande 9, absente) n'est pas écrite, mais NB_LINE la compte : 7 lignes reçues, 6 écrites.
Each order is followed by its lines, in their arrival order (Pen then Paper). Order 3 has no line. The Glue line (order 9, missing) is not written, but NB_LINE counts it: 7 rows received, 6 written.
Trois flux : customers (code, name) : C1 Ada, C2 Grace ; orders (id, customer) : 10 C2, 11 C1, 12 C1 ; lines (order_id, product) : 11 Pen, 10 Ink, 12 Paper, 11 Glue. Noms de colonnes écrits ici entre guillemets.
Three flows: customers (code, name): C1 Ada, C2 Grace; orders (id, customer): 10 C2, 11 C1, 12 C1; lines (order_id, product): 11 Pen, 10 Ink, 12 Paper, 11 Glue. Column names written in quotes here.
| SchémaSchema | Ligne parenteParent row | Clé parenteParent key | CléKey |
|---|---|---|---|
| customers | |||
| orders | customers | "code" | "customer" |
| lines | orders | "id" | "order_id" |
C1;Ada 11;C1 11;Pen 11;Glue 12;C1 12;Paper C2;Grace 10;C2 10;Ink NB_LINE: 9
Chaque commande est écrite sous son client, et suivie de ses propres lignes avant la commande suivante. Each order is written under its customer, and followed by its own lines before the next order.
Les flux du premier exemple, plus payments (order_id, method) : 1 card, 2 cash, 1 voucher, relié en troisième (Merge order:3). Dans Schémas, sa ligne est placée avant celle de lines :
The flows of the first example, plus payments (order_id, method): 1 card, 2 cash, 1 voucher, connected third (Merge order:3). In Schemas, its row is placed before the lines one:
| SchémaSchema | Ligne parenteParent row | Clé parenteParent key | CléKey |
|---|---|---|---|
| orders | |||
| payments | orders | id | order_id |
| lines | orders | id | order_id |
1;Ada 1;card 1;voucher 1;Pen;3 1;Paper;10 2;Grace 2;cash 2;Ink;1 3;Alan NB_LINE: 10
Sous chaque commande, les paiements passent avant les lignes, comme dans le tableau, bien que lines soit relié avant payments.
Under each order, the payments come before the lines, as in the table, although lines is connected before payments.
Un fichier à trois types d'enregistrements. Chaque flux a une colonne batch, qui vaut 1 partout : header (rec, batch, created), une ligne ; detail (rec, batch, product, qty), trois lignes ; trailer (rec, batch, count), une ligne. Schémas : header racine, puis detail et trailer sous header, clé batch / batch pour les deux.
A file with three record types. Each flow has a batch column, which is 1 everywhere: header (rec, batch, created), one row; detail (rec, batch, product, qty), three rows; trailer (rec, batch, count), one row. Schemas: header root, then detail and trailer under header, key batch / batch for both.
H;1;2026-11-11 D;1;Pen;3 D;1;Ink;1 D;1;Paper;10 T;1;3 NB_LINE: 5
Le pied vient après les détails parce que sa ligne suit celle de detail dans le tableau. Le nombre de détails du pied se calcule avant, par exemple avec un tAggregateRow.
The trailer comes after the details because its row follows the detail one in the table. The number of details in the trailer is computed beforehand, for example with a tAggregateRow.
Le premier exemple, avec Utiliser des séparateurs multi champs coché ; Séparateur de champs du tableau : "|" pour orders, "," pour lines.
The first example, with Use Multi Field Separators checked; Field Separator of the table: "|" for orders, "," for lines.
1|Ada 1,Pen,3 1,Paper,10 2|Grace 2,Ink,1 3|Alan NB_LINE: 7
Deux commandes, dont le client Ada; "AL" (avec un point-virgule et des guillemets), et les lignes du premier exemple ; Options CSV coché, entourage et échappement par défaut.
Two orders, including the customer Ada; "AL" (with a semicolon and quotes), and the lines of the first example; CSV options checked, default enclosure and escape.
"1";"Ada; ""AL""" "1";"Pen";"3" "1";"Paper";"10" "2";"Grace" "2";"Ink";"1" NB_LINE: 6
Tous les champs sont entourés, nombres compris, et les guillemets de la valeur sont doublés. Avec les séparateurs multiples cochés en plus, chaque type garde son séparateur : "1"|"Ada", "1","Pen","3".
All the fields are enclosed, numbers included, and the quotes of the value are doubled. With multiple separators checked too, each type keeps its separator: "1"|"Ada", "1","Pen","3".
Un seul flux, amounts, une ligne : id (Integer) 1, qty (Integer, non nullable) 1500, total (Integer) 1500, price (Double) 1234.5. Séparateur de milliers ".", décimal ",".
A single flow, amounts, one row: id (Integer) 1, qty (Integer, not nullable) 1500, total (Integer) 1500, price (Double) 1234.5. Thousands separator ".", decimal ",".
1;1500;1.500;1.234,5 NB_LINE: 1
qty, non nullable, n'est pas formatée ; total, même valeur mais nullable, l'est.
qty, not nullable, is not formatted; total, same value but nullable, is.
Deux composants reçoivent chacun un flux vide (tFixedFlowInput à 0 ligne) : le premier écrit empty_deleted.csv avec Ne pas générer de fichier vide coché, le second empty_kept.csv avec la case décochée. Le tJava regarde les deux fichiers :
Two components each receive an empty flow (tFixedFlowInput with 0 rows): the first one writes empty_deleted.csv with Don't generate empty file checked, the second one empty_kept.csv with the box unchecked. The tJava looks at both files:
empty_deleted.csv: absent empty_kept.csv: 0 bytes NB_LINE: 0
Les jobs du premier exemple, avec un réglage manqué. Le nom du job est remplacé par MyJob, les chemins et les traces sont abrégés.
The jobs of the first example, with a setting missed. The job name is replaced with MyJob, paths and traces are shortened.
Ligne lines du tableau sans Colonne clé. Le job ne compile pas :
The lines row of the table without a Key column. The job does not compile:
MyJob.java:1493: error: <identifier> expected
linesMap_tFileOutputMSDelimited_1.put(String.valueOf(lines.), lines_tFileOutputMSDelimited_1);
^
1 error
Le nom de colonne est collé tel quel dans le code : un nom vide donne lines.), un nom faux une erreur cannot find symbol.
The column name is pasted as is into the code: an empty name gives lines.), a wrong name a cannot find symbol error.
Le tableau n'a que la ligne orders ; le lien lines n'y est pas. La génération du code s'arrête dans le modèle du composant :
The table only has the orders row; the lines link is not in it. The code generation stops in the template of the component:
java.lang.NullPointerException: Cannot invoke "java.util.List.isEmpty()" because "<local16>" is null at org.talend.designer.codegen.translators.components.tfileoutputmsdelimited.TFileOutputMSDelimited_mainJava.generate(TFileOutputMSDelimited_mainJava.java:326) …
Le Schéma de chaque ligne doit être le nom exact d'un lien entrant. Après avoir renommé un lien, vérifiez le tableau. The Schema of each row must be the exact name of an incoming link. After renaming a link, check the table.
Les flux de l'exemple « Deux flux enfants », mais payments sans Ligne parente : deux lignes du tableau sont des racines. Le job ne compile pas :
The flows of the “Two child flows” example, but payments without a Parent row: two rows of the table are roots. The job does not compile:
MyJob.java:1617: error: <identifier> expected ordersMap_tFileOutputMSDelimited_1.put(String.valueOf(orders.), orders_tFileOutputMSDelimited_1); …
Une seule racine est possible : la seconde devient la vraie racine, et orders est traité comme un enfant sans clé. Pour des enregistrements sans lien naturel (en-tête, pied), donnez-leur une colonne commune, comme dans l'exemple En-tête, détails et pied.
Only one root is possible: the second one becomes the real root, and orders is handled as a child without a key. For records without a natural link (header, trailer), give them a common column, as in the Header, details and trailer example.
Commandes 1 Ada, 1 Ada again, 2 Grace ; lignes 1 Pen 3, 2 Ink 1. Orders 1 Ada, 1 Ada again, 2 Grace; lines 1 Pen 3, 2 Ink 1.
1;Ada 1;Pen;3 1;Ada again 1;Pen;3 2;Grace 2;Ink;1 NB_LINE: 5
La ligne Pen est écrite sous chacune des deux commandes 1 : 6 lignes écrites pour 5 reçues. Dédoublonnez le flux parent avant le composant si sa clé doit être unique.
The Pen line is written under each of the two orders 1: 6 rows written for 5 received. Remove duplicates from the parent flow before the component if its key must be unique.
Deux composants, deux lignes (1 Ada, 2 Grace), Séparateur de lignes "\r\n" : sans, puis avec les Options CSV. Le tJava affiche les octets des fichiers en hexadécimal :
Two components, two rows (1 Ada, 2 Grace), Row Separator "\r\n": without, then with CSV options. The tJava prints the bytes of the files in hexadecimal:
crlf.csv: 31 3B 41 64 61 0D 0A 32 3B 47 72 61 63 65 0D 0A crlf_csv.csv: 22 31 22 3B 22 41 64 61 22 0D 22 32 22 3B 22 47 72 61 63 65 22 0D
Avec les options CSV, seul le premier caractère, \r (0D), sépare les lignes : la plupart des outils y voient une seule ligne.
With CSV options, only the first character, \r (0D), separates the rows: most tools see a single line.
Toutes les lignes de tous les flux restent dans la mémoire du job jusqu'à l'écriture du fichier, à la fin. Pour un gros volume, prévoyez la mémoire de la JVM (-Xmx).
All the rows of all the flows stay in the job memory until the file is written, at the end. For a large volume, plan the JVM memory (-Xmx).
Une ligne enfant dont la clé ne trouve pas de parent disparaît sans message. Pour la repérer, faites la jointure avant (tJoin, avec ses rejets), ou comparez NB_LINE au nombre de lignes du fichier (tFileRowCount). A child row whose key finds no parent disappears with no message. To spot it, do the join beforehand (tJoin, with its rejects), or compare NB_LINE with the number of lines of the file (tFileRowCount).
Le fichier n'est écrit qu'une fois tous les flux reçus : relier les lignes avant les commandes (Merge order inversé) donne le même fichier. Seul compte l'ordre des lignes du tableau Schémas entre flux frères. The file is only written once all the flows are received: connecting the lines before the orders (reversed Merge order) gives the same file. Only the order of the rows of the Schemas table between sibling flows matters.
Le composant n'écrit pas les noms des colonnes. Pour une ligne de titres, ajoutez un flux d'en-tête, racine du fichier, comme dans l'exemple En-tête, détails et pied. The component does not write the column names. For a title line, add a header flow, root of the file, as in the Header, details and trailer example.
tFileOutputMSPositional · le même principe, en largeur fixethe same principle, in fixed widthtFileOutputMSXML · plusieurs flux dans un document XMLseveral flows into one XML documenttFileOutputDelimited · un seul flux, un seul type de lignea single flow, a single row typetAggregateRow · calculer les totaux d'un piedcompute the totals of a trailertFileRowCount · compter les lignes du fichier écritcount the lines of the written filetChangeFileEncoding · changer l'encodage du fichier après coupchange the encoding of the file afterwards