ComposantsComponents

ComposantsComponents › Fichier › SortieFile › Output

tFileOutputMSDelimited

tFileOutputMSDelimited

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

UtilisationUsage

Commandes et lignes de commandeOrders and order lines

orders (Merge order:1) lines (Merge order:2) tFixedFlowInput_1 tFileOutputMSDelimited_1 tFixedFlowInput_2

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.

Le tableau SchémasThe Schemas table

SchémaSchema Ligne parenteParent row Colonne de clé parenteParent key column Colonne cléKey column
orders
linesordersidorder_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.

  1. Déposez le tFileOutputMSDelimited depuis la famille Fichier › Sortie de la palette. Drop the tFileOutputMSDelimited from the File › Output family of the palette.
  2. Reliez-lui chaque flux (clic droit › Ligne › Main). Le lien devient un lien Merge, et le Studio ajoute au tableau Schémas une ligne au nom du lien (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.
  3. Dans Schémas, laissez Ligne parente vide pour un seul flux, la racine. Pour chaque autre flux, choisissez son parent dans la liste, puis écrivez le nom de la colonne du parent et celui de la colonne du flux qui portent la même valeur. In Schemas, leave Parent row empty for one flow only, the root. For each other flow, choose its parent in the list, then write the name of the parent column and the name of the flow column that hold the same value.
  4. Indiquez le Nom de fichier, puis les séparateurs. Set the File Name, then the separators.

Dans quel ordre les lignes sont écritesIn which order the rows are written

  • Rien n'est écrit tant que tous les flux ne sont pas arrivés : le composant range les lignes de la racine dans une liste, et celles de chaque flux enfant par valeur de sa Colonne clé. Nothing is written until all the flows have arrived: the component stores the root rows in a list, and those of each child flow by value of its Key column.
  • Il écrit ensuite chaque ligne de la racine, dans son ordre d'arrivée. Juste après une ligne, il écrit les lignes de ses flux enfants dont la Colonne clé vaut la Colonne de clé parente de cette ligne, dans leur ordre d'arrivée ; chacune est suivie de ses propres enfants, sur autant de niveaux que nécessaire. It then writes each root row, in its arrival order. Right after a row, it writes the rows of its child flows whose Key column equals the Parent key column of that row, in their arrival order; each one is followed by its own children, on as many levels as needed.
  • Quand une ligne a plusieurs flux enfants, ils sont écrits dans l'ordre des lignes du tableau Schémas, pas dans l'ordre des liens (voir l'exemple). L'ordre des liens (Merge order) ne change rien au fichier. When a row has several child flows, they are written in the order of the rows of the Schemas table, not in the order of the links (see the example). The order of the links (Merge order) changes nothing in the file.
  • Les deux clés sont comparées sous forme de texte (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).

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

Colonnes du tableau SchémasColumns of the Schemas table

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

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

Variable globaleGlobal variable

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

ExemplesExamples

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.

Commandes et lignes de commandeOrders and order lines

orders (Merge order:1) lines (Merge order:2) OnSubjobOk tFixedFlowInput_1 tFileOutputMSDelimited_1 tFixedFlowInput_2 tJava_1

orders

idInteger customerString
1Ada
2Grace
3Alan

lines

order_idInteger productString qtyInteger
2Ink1
1Pen3
9Glue2
1Paper10

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 niveauxThree levels

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
orderscustomers"code""customer"
linesorders"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.

Deux flux enfants du même parentTwo child flows of the same parent

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
paymentsordersidorder_id
linesordersidorder_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.

En-tête, détails et piedHeader, details and trailer

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.

Un séparateur par type d'enregistrementOne separator per record type

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

Options CSVCSV options

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

Séparateur avancé pour les nombresAdvanced separator for numbers

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.

Aucune ligne reçueNo row received

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

ErreursErrors

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.

Colonne clé videEmpty key column

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.

Lien absent du tableau SchémasLink missing from the Schemas table

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.

Deux racinesTwo roots

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.

PiègesPitfalls

Une clé parente en doubleA duplicated parent key

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.

Fin de ligne Windows avec les options CSVWindows line end with CSV options

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.

Conseils et limitesTips and limits

Tout est en mémoireEverything is in memory

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

Lignes sans parent perduesRows without a parent lost

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

Ordre des liens indifférentLink order does not matter

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.

Pas de ligne d'en-têteNo header line

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.

Voir aussiSee also