ComposantsComponents

ComposantsComponents › Fichier › SortieFile › Output

tFileOutputDelimited

tFileOutputDelimited

Fichier › SortieFile › Output

Écrit les lignes d'un flux dans un fichier texte : une ligne du fichier par ligne du flux, les valeurs séparées par un séparateur de champs (; par défaut). Avec les options CSV, chaque valeur est entourée de guillemets et peut contenir le séparateur. C'est le composant à placer au bout d'un flux pour produire un fichier CSV ou délimité, lu ensuite par un autre outil ou un autre job. Writes the rows of a flow to a text file: one line of the file per row of the flow, the values separated by a field separator (; by default). With the CSV options, each value is enclosed in quotes and can hold the separator. It is the component to put at the end of a flow to produce a CSV or delimited file, read afterwards by another tool or another job.

EntréeInput

Main un flux : les lignes à écrireone flow: the rows to write

SortieOutput

Main un flux, facultatif : les lignes repartent telles quellesone flow, optional: the rows go on unchanged

Déclencheurs en sortieOutput triggers

On Component Ok On Component Error Run if

UtilisationUsage

Au bout d'un fluxAt the end of a flow

row1 (Main) row2 (Main) tFileInputDelimited_1 tMap_1 tFileOutputDelimited_1

Le cas courant : écrire le résultat d'une transformation dans un fichier. Le schéma du composant se remplit à partir du lien entrant. The common case: write the result of a transformation to a file. The component schema is filled from the incoming link.

Écrire, puis continuerWrite, then go on

row1 (Main) row2 (Main) tMap_1 tFileOutputDelimited_1 tLogRow_1

Chaque ligne est écrite puis passée au composant suivant, sans changement (voir l'exemple). Each row is written then passed to the next component, unchanged (see the example).

  1. Déposez le tFileOutputDelimited depuis la famille Fichier › Sortie de la palette. Drop the tFileOutputDelimited from the File › Output family of the palette.
  2. Reliez-lui le flux à écrire (clic droit › Ligne › Main) : son schéma se remplit à partir du lien. Connect the flow to write to it (right-click › Row › Main): its schema is filled from the link.
  3. Indiquez le Nom de fichier, le Séparateur de champs, et cochez Inclure l'en-tête si le fichier doit commencer par le nom des colonnes. Set the File Name, the Field Separator, and check Include Header if the file must start with the column names.
  4. Dans les Paramètres avancés, choisissez l'Encodage (ISO-8859-15 par défaut) et décochez Retourner une erreur si le fichier existe déjà si le job doit remplacer le fichier à chaque exécution (voir les erreurs). In the Advanced settings, choose the Encoding (ISO-8859-15 by default) and uncheck Throw an error if the file already exist if the job must replace the file at each run (see the errors).

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. Les noms de fichiers et les séparateurs sont des expressions Java : gardez les guillemets (";", "\t" pour une tabulation) ; une variable de contexte est acceptée. Labels are those of the Component tab; the technical name, in grey, is the parameter name in the job file. File names and separators are Java expressions: keep the quotes (";", "\t" for a tab); a context variable is accepted.

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, les séparateurs, les options CSV et l'encodage viennent d'une métadonnée de fichier délimité du Référentiel. Built-In: the settings are typed in the component. Repository: the file name, the separators, the CSV options and the encoding come from a delimited file metadata of the Repository.
Utiliser le flux de sortieUse Output StreamUSESTREAM NonNo ToujoursAlways Écrit dans un flux Java (java.io.OutputStream) au lieu d'un fichier. À la fin, le composant vide le flux mais ne le ferme pas. Masque les réglages propres au fichier : Écrire à la suite de, la création du répertoire, la division en plusieurs fichiers, le fichier vide, l'erreur si le fichier existe. Voir l'exemple. Writes to a Java stream (java.io.OutputStream) instead of a file. At the end, the component flushes the stream but does not close it. Hides the settings that are about a file: Append, the directory creation, the split into several files, the empty file, the error if the file exists. See the example.
Flux de sortieOutput StreamSTREAMNAME outputStream Flux de sortie cochéOutput stream checked Une expression Java qui donne le flux : System.out (la console), ou un flux rangé avant par un tJava, comme (java.io.OutputStream) globalMap.get("stream"). A Java expression that gives the stream: System.out (the console), or a stream stored before by a tJava, such as (java.io.OutputStream) globalMap.get("stream").
Nom de fichierFile NameFILENAME chemin par défaut + /out.csvdefault path + /out.csv Flux de sortie décochéOutput stream unchecked Le fichier écrit : "C:/data/out.csv", context.folder + "/out/people.csv". Par défaut, s'il existe déjà, le composant s'arrête en erreur (paramètre avancé Retourner une erreur si le fichier existe déjà). The written file: "C:/data/out.csv", context.folder + "/out/people.csv". By default, if it already exists, the component stops with an error (advanced setting Throw an error if the file already exist).
Séparateur de lignesRow SeparatorROWSEPARATOR "\n" Options CSV décochéesCSV options unchecked Texte écrit après chaque ligne, tel quel, sur tous les systèmes : "\n" (LF) ou "\r\n" (CRLF, l'habitude sous Windows). Text written after each row, as is, on every system: "\n" (LF) or "\r\n" (CRLF, the habit on Windows).
Utiliser le séparateur de lignes du système d'exploitation lorsque la valeur du champ Séparateur de lignes CSV est CR, LF ou CRLF.Use OS line separator as row separator when CSV Row Separator is set to CR,LF or CRLF.OS_LINE_SEPARATOR_AS_ROW_SEPARATOR OuiYes Options CSV cochéesCSV options checked Cochée, la fin de ligne est celle du système qui exécute le job, quel que soit le choix LF, CR ou CRLF : \r\n dans nos essais sous Windows. Décochez-la pour que le Séparateur de lignes CSV s'applique (voir les exemples). Checked, the line end is the one of the system that runs the job, whatever the LF, CR or CRLF choice: \r\n in our tests on Windows. Uncheck it for the CSV Row Separator to apply (see the examples).
Séparateur de lignes CSVCSV Row SeparatorCSVROWSEPARATOR LF("\n") Options CSV cochéesCSV options checked LF("\n"), CR("\r") ou CRLF("\r\n"), ou une valeur saisie dont seul le premier caractère compte. Sans effet pour LF, CR et CRLF tant que la case précédente est cochée. LF("\n"), CR("\r") or CRLF("\r\n"), or a typed value whose first character only counts. No effect for LF, CR and CRLF while the previous box is checked.
Séparateur de champsField SeparatorFIELDSEPARATOR ";" ToujoursAlways Texte placé entre deux valeurs : ";", ",", "\t". Plusieurs caractères sont écrits tels quels ; avec les options CSV, seul le premier compte (";;" donne ;). Text placed between two values: ";", ",", "\t". Several characters are written as is; with the CSV options, only the first one counts (";;" gives ;).
Écrire à la suite deAppendAPPEND NonNo Flux de sortie décochéOutput stream unchecked Ajoute les lignes à la fin du fichier au lieu de le remplacer ; il est créé s'il n'existe pas. L'en-tête n'est écrit que si le fichier est vide (voir l'exemple). Masque la compression et l'erreur si le fichier existe. Adds the rows at the end of the file instead of replacing it; it is created if it does not exist. The header is only written if the file is empty (see the example). Hides the compression and the error if the file exists.
Inclure l'en-têteInclude HeaderINCLUDEHEADER NonNo ToujoursAlways Écrit d'abord une ligne avec le nom des colonnes, séparés par le séparateur de champs. Avec les options CSV, ces noms ne sont pas entourés de guillemets. First writes a line with the column names, separated by the field separator. With the CSV options, these names are not enclosed in quotes.
Compresser en tant que fichier zipCompress as zip fileCOMPRESS NonNo Écrire à la suite et Diviser décochésAppend and Split unchecked Écrit une archive zip à la place du fichier : même nom avec l'extension .zip (people.csv donne people.zip), qui contient une entrée au nom du fichier. Le fichier lui-même n'est pas créé. Voir l'exemple. Writes a zip archive instead of the file: same name with the .zip extension (people.csv gives people.zip), holding one entry named after the file. The file itself is not created. See the example.
SchémaSchemaSCHEMA — ToujoursAlways Les colonnes écrites, dans leur ordre. Elles viennent du lien entrant ; voir l'écriture des valeurs. The written columns, in their order. They come from the incoming link; see how values are written.

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 deux séparateurs ci-dessous : avec "." et ",", 1250.50 devient 1.250,50. Vaut pour toutes les colonnes numériques. Writes numbers with the two separators below: with "." and ",", 1250.50 becomes 1.250,50. Applies to all the number columns.
Séparateur de milliersThousands separatorTHOUSANDS_SEPARATOR "," Séparateur avancé cochéAdvanced separator checked Placé tous les trois chiffres de la partie entière. Placed every three digits of the integer part.
Séparateur décimalDecimal separatorDECIMAL_SEPARATOR "." Séparateur avancé cochéAdvanced separator checked Remplace le point décimal. Avec ",", gardez un séparateur de champs autre que la virgule. Replaces the decimal point. With ",", keep a field separator other than the comma.
Options CSVCSV optionsCSV_OPTION NonNo ToujoursAlways Chaque valeur est entourée de l'Entourage du texte, qui est doublé (ou échappé) à l'intérieur d'une valeur ; une valeur peut alors contenir le séparateur. Une valeur nulle et une valeur vide s'écrivent toutes deux "". Remplace le Séparateur de lignes par les deux réglages de fin de ligne CSV des paramètres simples. Voir les exemples. Each value is enclosed in the Text enclosure, which is doubled (or escaped) inside a value; a value can then hold the separator. A null value and an empty value are both written "". Replaces the Row Separator with the two CSV line end settings of the basic settings. See the examples.
Caractère d'échappementEscape charESCAPE_CHAR """ Options CSV cochéesCSV options checked Avec "\\", un guillemet dans une valeur est précédé d'une barre oblique inverse (\"). Toute autre valeur double le guillemet (""). With "\\", a quote inside a value is preceded by a backslash (\"). Any other value doubles the quote ("").
Entourage du texteText enclosureTEXT_ENCLOSURE """ Options CSV cochéesCSV options checked Le caractère placé autour de chaque valeur, le guillemet par défaut (le Studio l'écrit """). Il ne peut pas être vide : "" arrête le composant (voir les erreurs). The character placed around each value, the double quote by default (the Studio writes it """). It cannot be empty: "" stops the component (see the errors).
Créer le répertoire s'il n'existe pasCreate directory if does not existCREATE OuiYes Flux de sortie décochéOutput stream unchecked Crée le dossier du fichier, avec ses parents. Décochée, un dossier absent arrête le composant (voir les erreurs). Creates the folder of the file, with its parents. Unchecked, a missing folder stops the component (see the errors).
Diviser la sortie en plusieurs fichiersSplit output in several filesSPLIT NonNo Flux de sortie décochéOutput stream unchecked Commence un nouveau fichier toutes les N lignes. Les fichiers prennent un numéro avant l'extension, à partir de 0 : part.csv donne part0.csv, part1.csv… ; part.csv lui-même n'est pas écrit. L'en-tête est répété en tête de chaque fichier. Voir l'exemple. Starts a new file every N rows. The files get a number before the extension, from 0: part.csv gives part0.csv, part1.csv…; part.csv itself is not written. The header is repeated at the top of each file. See the example.
Lignes dans chaque fichier de sortieRows in each output fileSPLIT_EVERY 1000 Diviser cochéSplit checked Nombre de lignes de données par fichier, en-tête non compté. Number of data rows per file, header not counted.
Personnaliser la taille de la mémoire tamponCustom the flush buffer sizeFLUSHONROW NonNo ToujoursAlways Vide la mémoire tampon dans le fichier toutes les N lignes (Nombre de lignes), au lieu d'attendre qu'elle soit pleine : le fichier se remplit pendant l'exécution, au prix d'écritures plus fréquentes. D'après les modèles du composant, non essayé ici. Flushes the buffer to the file every N rows (Row number), instead of waiting for it to be full: the file fills up during the run, at the cost of more frequent writes. From the component templates, not tried here.
Nombre de lignesRow numberFLUSHONROW_NUM 1 Taille personnalisée cochéeCustom size checked Le N ci-dessus. The N above.
Sortie en mode ligneOutput in row modeROW_MODE NonNo ToujoursAlways Utilise une mémoire tampon qui ne coupe jamais une ligne entre deux écritures (routines.system.BufferedOutput) : pour plusieurs composants qui écrivent le même fichier en même temps. D'après les modèles du composant, non essayé ici. Uses a buffer that never cuts a row between two writes (routines.system.BufferedOutput): for several components that write the same file at the same time. From the component templates, not tried here.
EncodageEncodingENCODING "ISO-8859-15" ToujoursAlways L'encodage du fichier écrit. Le défaut n'est pas UTF-8 : é s'écrit sur un octet, E9 (voir l'exemple). Choisissez "UTF-8" pour la plupart des outils actuels. The encoding of the written file. The default is not UTF-8: é is written as one byte, E9 (see the example). Choose "UTF-8" for most current tools.
Ne pas générer de fichier videDon't generate empty fileDELETE_EMPTYFILE NonNo Flux de sortie décochéOutput stream unchecked Si aucune ligne n'a été écrite, supprime le fichier à la fin, même s'il contient l'en-tête. Un fichier qui existait déjà, complété avec Écrire à la suite de, est gardé. Voir l'exemple. If no row was written, deletes the file at the end, even if it holds the header. A file that already existed, completed with Append, is kept. See the example.
Retourner une erreur si le fichier existe déjàThrow an error if the file already existFILE_EXIST_EXCEPTION OuiYes Écrire à la suite et Flux de sortie décochésAppend and Output stream unchecked Arrête le composant si le fichier existe déjà, avant d'y écrire : l'ancien fichier reste intact. Avec les réglages par défaut, la deuxième exécution d'un même job échoue. Décochez-la pour remplacer le fichier à chaque exécution (voir les erreurs). Stops the component if the file already exists, before writing to it: the old file stays intact. With the default settings, the second run of the same job fails. Uncheck it to replace the file at each run (see the errors).

Valeurs et variables globalesValues and global variables

Écriture des valeursHow values are written

  • Date : selon le modèle de la colonne dans le schéma ("dd-MM-yyyy"…). Date: following the column pattern in the schema ("dd-MM-yyyy"…).
  • BigDecimal : arrondi à la précision de la colonne (au plus proche, 0,5 vers le haut), sans notation scientifique. BigDecimal: rounded to the column precision (half up), without scientific notation.
  • byte[] : décodé en texte avec l'Encodage du composant. byte[]: decoded to text with the component Encoding.
  • Valeur nulle : rien entre les deux séparateurs ; "" avec les options CSV, comme une valeur vide. Null value: nothing between the two separators; "" with the CSV options, like an empty value.
  • Autres types : leur texte Java (String.valueOf). Other types: their Java text (String.valueOf).

Variables globalesGlobal variables

NB_LINE Integer
Nombre de lignes écrites, en-tête non compté ; disponible après l'exécution du composant.Number of rows written, header not counted; available after the component has run.
FILE_NAME String
Chemin absolu du fichier, avec des /, connu dès le début du flux. C'est le nom saisi, même avec la compression ou la division en plusieurs fichiers. Avec un flux de sortie : vide, ou null avec les options CSV.Absolute path of the file, with /, known from the start of the flow. It is the typed name, even with the compression or the split into several files. With an output stream: empty, or null with the CSV options.
((Integer) globalMap.get("tFileOutputDelimited_1_NB_LINE"))
((String) globalMap.get("tFileOutputDelimited_1_FILE_NAME"))

ExemplesExamples

Un tFixedFlowInput envoie trois lignes au tFileOutputDelimited. Les chemins sont écrits à partir de la variable de contexte folder, raccourcie ici en C:/data. Un tJava relié par On Subjob Ok affiche ensuite le fichier ; les sorties sont celles de la console, copiées depuis une exécution du job. A tFixedFlowInput sends three rows to the tFileOutputDelimited. Paths are written from the folder context variable, shortened here to C:/data. A tJava connected with On Subjob Ok then prints the file; the outputs are the console ones, copied from a run of the job.

row1 (Main) OnSubjobOk tFixedFlowInput_1 tFileOutputDelimited_1 tJava_1
idInteger nameString cityString amountBigDecimal, précisionprecision 2 sinceDate, "dd-MM-yyyy"
1AdaLondon1250.52021-03-15
2Gracenull802023-11-02
3AlanManchester3.14159null

Code du tJava_1 : il affiche le fichier en rendant visibles les fins de ligne, \n (LF) ou \r\n (CRLF). tJava_1 code: it prints the file with the line ends made visible, \n (LF) or \r\n (CRLF).

String text = new String(java.nio.file.Files.readAllBytes(java.nio.file.Paths.get(context.folder + "/out/people.csv")));
System.out.print(text.replace("\r", "\\r").replace("\n", "\\n\n"));
System.out.println("NB_LINE: " + globalMap.get("tFileOutputDelimited_1_NB_LINE"));
System.out.println("FILE_NAME: " + globalMap.get("tFileOutputDelimited_1_FILE_NAME"));

Réglages par défautDefault settings

Nom de fichier context.folder + "/out/people.csv", rien d'autre de changé. File name context.folder + "/out/people.csv", nothing else changed.

1;Ada;London;1250.50;15-03-2021\n
2;Grace;;80.00;02-11-2023\n
3;Alan;Manchester;3.14;\n
NB_LINE: 3
FILE_NAME: C:/data/out/people.csv

Une valeur nulle n'écrit rien. Le montant est arrondi à sa précision, la date suit le modèle de sa colonne. Chaque ligne finit par \n, même sous Windows. A null value writes nothing. The amount is rounded to its precision, the date follows the pattern of its column. Each line ends with \n, even on Windows.

En-tête et séparateur ","Header and "," separator

Inclure l'en-tête coché, Séparateur de champs ",". Include Header checked, Field Separator ",".

id,name,city,amount,since\n
1,Ada,London,1250.50,15-03-2021\n
2,Grace,,80.00,02-11-2023\n
3,Alan,Manchester,3.14,\n

Séparateurs des nombresNumber separators

Séparateur avancé (pour les nombres) coché, milliers ".", décimal ",". Advanced separator (for numbers) checked, thousands ".", decimal ",".

1;Ada;London;1.250,50;15-03-2021\n
2;Grace;;80,00;02-11-2023\n
3;Alan;Manchester;3,14;\n

EncodageEncoding

Une ligne, 1 et Café 10 €, écrite dans latin.csv avec l'encodage par défaut, puis dans utf8.csv avec "UTF-8". Le tJava affiche les octets en hexadécimal : One row, 1 and Café 10 €, written to latin.csv with the default encoding, then to utf8.csv with "UTF-8". The tJava prints the bytes in hexadecimal:

for (String f : new String[] {"/out/latin.csv", "/out/utf8.csv"}) {
    StringBuilder sb = new StringBuilder();
    for (byte b : java.nio.file.Files.readAllBytes(java.nio.file.Paths.get(context.folder + f))) {
        sb.append(String.format("%02X ", b));
    }
    System.out.println(f.substring(f.lastIndexOf('/') + 1) + ": " + sb.toString().trim());
}
latin.csv: 31 3B 43 61 66 E9 20 31 30 20 A4 0A
utf8.csv: 31 3B 43 61 66 C3 A9 20 31 30 20 E2 82 AC 0A

En ISO-8859-15, é vaut E9 et € vaut A4 ; en UTF-8, C3 A9 et E2 82 AC. In ISO-8859-15, é is E9 and € is A4; in UTF-8, C3 A9 and E2 82 AC.

Écrire à la suiteAppend

row1 (Main) OnSubjobOk row2 (Main) tFixedFlowInput_1 tFileOutputDelimited_1 tFixedFlowInput_2 tFileOutputDelimited_2

Les deux composants écrivent append.csv, en-tête coché. Le premier reçoit les lignes 1 et 2 ; le second, Écrire à la suite de coché, la ligne 3. Le fichier après chacun : Both components write append.csv, header checked. The first one receives rows 1 and 2; the second one, Append checked, row 3. The file after each one:

id;name;city;amount;since\n
1;Ada;London;1250.50;15-03-2021\n
2;Grace;;80.00;02-11-2023\n
id;name;city;amount;since\n
1;Ada;London;1250.50;15-03-2021\n
2;Grace;;80.00;02-11-2023\n
3;Alan;Manchester;3.14;\n

Le fichier n'étant pas vide, le second composant n'a pas répété l'en-tête. The file not being empty, the second component did not repeat the header.

Remplacer un fichier existantReplace an existing file

old.csv contient la ligne old line. Composant réglé par défaut, sauf Retourner une erreur si le fichier existe déjà, décoché : old.csv holds the line old line. Component with the default settings, except Throw an error if the file already exist, unchecked:

1;Ada;London;1250.50;15-03-2021\n
2;Grace;;80.00;02-11-2023\n
3;Alan;Manchester;3.14;\n

L'ancien contenu est remplacé. Case cochée (le défaut), le job s'arrête : voir les erreurs. The old content is replaced. Box checked (the default), the job stops: see the errors.

Options CSVCSV options

Autres données : un nom avec des guillemets, une note avec le séparateur, une note nulle et une vide. Chaque fichier est affiché par le même code que plus haut, après une ligne --- fichier. Other data: a name with quotes, a note with the separator, a null note and an empty one. Each file is printed by the same code as above, after a --- file line.

idInteger nameString noteString
1AdaLondon; UK
2Grace "Amazing"null
3Alan(vide)(empty)

Sans options CSVWithout CSV options

En-tête coché. La ligne 1 a maintenant quatre champs : le ; de la note n'est pas protégé. Header checked. Row 1 now has four fields: the ; of the note is not protected.

--- /out/plain.csv
id;name;note\n
1;Ada;London; UK\n
2;Grace "Amazing";\n
3;Alan;\n

Options CSV, réglages par défautCSV options, default settings

En-tête coché. Valeurs entre guillemets, guillemet doublé, nulle et vide écrites "", en-tête sans guillemets, fin de ligne \r\n (Windows). Header checked. Values in quotes, quote doubled, null and empty written "", header without quotes, line end \r\n (Windows).

--- /out/csv.csv
id;name;note\r\n
"1";"Ada";"London; UK"\r\n
"2";"Grace ""Amazing""";""\r\n
"3";"Alan";""\r\n

Échappement "\\""\\" escape

Caractère d'échappement "\\", sans en-tête : Escape char "\\", without header:

--- /out/backslash.csv
"1";"Ada";"London; UK"\r\n
"2";"Grace \"Amazing\"";""\r\n
"3";"Alan";""\r\n

Fins de ligneLine ends

Case du séparateur du système décochée, Séparateur de lignes CSV LF : OS line separator box unchecked, CSV Row Separator LF:

--- /out/lf.csv
"1";"Ada";"London; UK"\n
"2";"Grace ""Amazing""";""\n
"3";"Alan";""\n

Case décochée et CRLF : \r\n. Case cochée et CR : \r\n aussi, le choix CR est ignoré. Box unchecked and CRLF: \r\n. Box checked and CR: \r\n too, the CR choice is ignored.

Séparateur de deux caractèresTwo-character separator

Séparateur de champs ";;", avec puis sans options CSV : Field Separator ";;", with then without CSV options:

--- /out/csv2.csv
"1";"Ada";"London; UK"\r\n
"2";"Grace ""Amazing""";""\r\n
"3";"Alan";""\r\n
--- /out/plain2.csv
1;;Ada;;London; UK\n
2;;Grace "Amazing";;\n
3;;Alan;;\n

Plusieurs fichiersSeveral files

Nom context.folder + "/out/split/part.csv", en-tête coché, Diviser la sortie en plusieurs fichiers coché, 2 lignes par fichier. Le tJava affiche chaque fichier du dossier : Name context.folder + "/out/split/part.csv", header checked, Split output in several files checked, 2 rows per file. The tJava prints each file of the folder:

java.io.File[] files = new java.io.File(context.folder + "/out/split").listFiles();
java.util.Arrays.sort(files);
for (java.io.File f : files) {
    System.out.println("--- " + f.getName());
    for (String line : java.nio.file.Files.readAllLines(f.toPath())) {
        System.out.println(line);
    }
}
--- part0.csv
id;name;city;amount;since
1;Ada;London;1250.50;15-03-2021
2;Grace;;80.00;02-11-2023
--- part1.csv
id;name;city;amount;since
3;Alan;Manchester;3.14;

Compresser en zipCompress as zip

Nom context.folder + "/out/zip/people.csv", Compresser en tant que fichier zip coché. Le tJava affiche le dossier, puis les entrées de l'archive : Name context.folder + "/out/zip/people.csv", Compress as zip file checked. The tJava prints the folder, then the entries of the archive:

System.out.println(java.util.Arrays.toString(new java.io.File(context.folder + "/out/zip").list()));
try (java.util.zip.ZipFile zip = new java.util.zip.ZipFile(context.folder + "/out/zip/people.zip")) {
    java.util.Enumeration<? extends java.util.zip.ZipEntry> entries = zip.entries();
    while (entries.hasMoreElements()) {
        java.util.zip.ZipEntry entry = entries.nextElement();
        System.out.println(entry.getName() + ": " + entry.getSize() + " bytes");
    }
}
System.out.println("FILE_NAME: " + globalMap.get("tFileOutputDelimited_2_FILE_NAME"));
[people.zip]
people.csv: 82 bytes
FILE_NAME: C:/data/out/zip/people.csv

Flux videEmpty flow

Deux composants reçoivent zéro ligne, en-tête coché : default.csv avec les réglages par défaut, none.csv avec Ne pas générer de fichier vide coché. Le tJava affiche leur taille et le NB_LINE du second : Two components receive zero rows, header checked: default.csv with the default settings, none.csv with Don't generate empty file checked. The tJava prints their size and the NB_LINE of the second one:

for (String name : new String[] {"default.csv", "none.csv"}) {
    java.io.File f = new java.io.File(context.folder + "/out/empty/" + name);
    System.out.println(name + ": " + (f.exists() ? f.length() + " bytes" : "absent"));
}
System.out.println("NB_LINE: " + globalMap.get("tFileOutputDelimited_4_NB_LINE"));
default.csv: 26 bytes
none.csv: absent
NB_LINE: 0

Par défaut, le fichier est créé avec le seul en-tête (25 caractères et la fin de ligne). By default, the file is created with the header only (25 characters and the line end).

Flux de sortie vers la consoleOutput stream to the console

Utiliser le flux de sortie coché, Flux de sortie System.out, en-tête coché. Le tJava suivant affiche NB_LINE, puis FILE_NAME entre crochets : Use Output Stream checked, Output Stream System.out, header checked. The next tJava prints NB_LINE, then FILE_NAME in brackets:

id;name;city;amount;since
1;Ada;London;1250.50;15-03-2021
2;Grace;;80.00;02-11-2023
3;Alan;Manchester;3.14;
NB_LINE: 3
FILE_NAME: []

Avec un lien de sortieWith an output link

row1 (Main) row2 (Main) tFixedFlowInput_1 tFileOutputDelimited_1 tLogRow_1

Les trois lignes du premier exemple. Le tLogRow les affiche telles quelles, puis le tJava affiche le fichier : The three rows of the first example. The tLogRow prints them unchanged, then the tJava prints the file:

1|Ada|London|1250.50|15-03-2021
2|Grace||80.00|02-11-2023
3|Alan|Manchester|3.14|
1;Ada;London;1250.50;15-03-2021\n
2;Grace;;80.00;02-11-2023\n
3;Alan;Manchester;3.14;\n

ErreursErrors

Le nom du job est remplacé par MyJob, le dossier de travail par C:\data ; les traces d'exception sont abrégées. La fin des messages de fichier vient de Windows, dans sa langue. The job name is replaced with MyJob, the working folder with C:\data; exception traces are shortened. The end of the file messages comes from Windows, in its language.

Le fichier existe déjàThe file already exists

Un job réglé par défaut, nom context.folder + "/out/twice.csv", lancé deux fois. La première exécution écrit le fichier ; la seconde s'arrête (code 1) : A job with the default settings, name context.folder + "/out/twice.csv", run twice. The first run writes the file; the second one stops (exit code 1):

Exception in component tFileOutputDelimited_1 (MyJob)
java.lang.RuntimeException: The particular file "C:\data\out\twice.csv" already exist. If you want to overwrite the file, please uncheck the "Throw an error if the file already exist" option in Advanced settings.
	at doch.myjob_0_1.MyJob.tFixedFlowInput_1Process(MyJob.java:970)
	…

Le contrôle a lieu avant toute écriture : un tJava relié par On Component Error retrouve l'ancien fichier intact. Pour remplacer le fichier à chaque exécution, décochez Retourner une erreur si le fichier existe déjà ; pour le compléter, cochez Écrire à la suite de. Les fichiers zip et les fichiers numérotés de la division ne sont pas contrôlés : c'est le nom saisi qui l'est. The check happens before any writing: a tJava connected with On Component Error finds the old file intact. To replace the file at each run, uncheck Throw an error if the file already exist; to complete it, check Append. Zip files and the numbered files of the split are not checked: the typed name is.

Dossier absentMissing folder

Nom context.folder + "/out/new/people.csv", dossier new absent, Créer le répertoire s'il n'existe pas décoché : le job s'arrête (code 1). Name context.folder + "/out/new/people.csv", new folder missing, Create directory if does not exist unchecked: the job stops (exit code 1).

Exception in component tFileOutputDelimited_1 (MyJob)
java.io.FileNotFoundException: C:\data\out\new\people.csv (Le chemin d’accès spécifié est introuvable)
	at java.base/java.io.FileOutputStream.open0(Native Method)
	…

Entourage du texte videEmpty text enclosure

Options CSV cochées, Entourage du texte "", Caractère d'échappement "\\" : le job s'arrête (code 1). CSV options checked, Text enclosure "", Escape char "\\": the job stops (exit code 1).

Exception in component tFileOutputDelimited_1 (MyJob)
java.lang.RuntimeException: unvalid quote char
	at com.talend.csv.CSVWriter.setQuoteChar(CSVWriter.java:94)
	…

Avec le caractère d'échappement par défaut, le message est unvalid escape char. Pour écrire sans guillemets, décochez les options CSV. With the default escape char, the message is unvalid escape char. To write without quotes, uncheck the CSV options.

Conseils et limitesTips and limits

Un job qui tourne tous les joursA job that runs every day

Retourner une erreur si le fichier existe déjà est coché par défaut : le job échoue dès qu'il retrouve le fichier de la veille. Décochez la case, mettez la date dans le nom du fichier, ou supprimez l'ancien fichier avant (tFileDelete). Throw an error if the file already exist is checked by default: the job fails as soon as it finds the file of the day before. Uncheck the box, put the date in the file name, or delete the old file first (tFileDelete).

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

Un fichier lu comme UTF-8 par l'outil suivant affichera mal les accents. Réglez l'Encodage sur l'attente du destinataire, ou convertissez le fichier ensuite (tChangeFileEncoding). A file read as UTF-8 by the next tool will show accents wrongly. Set the Encoding to what the receiver expects, or convert the file afterwards (tChangeFileEncoding).

Séparateur dans les valeursSeparator inside values

Sans options CSV, rien ne protège une valeur qui contient le séparateur ou un saut de ligne : le fichier n'a plus le bon nombre de colonnes. Cochez les options CSV dès que les valeurs viennent de saisies libres. Without CSV options, nothing protects a value that holds the separator or a line break: the file no longer has the right number of columns. Check the CSV options as soon as values come from free input.

Nulle ou videNull or empty

Le fichier ne distingue pas une valeur nulle d'une valeur vide : rien sans options CSV, "" avec. Si la différence compte, remplacez les nulles par une valeur convenue en amont (tMap, tReplace). The file does not tell a null value from an empty one: nothing without CSV options, "" with them. If the difference matters, replace nulls with an agreed value upstream (tMap, tReplace).

Fins de ligneLine ends

Sans options CSV, la fin de ligne est le Séparateur de lignes, tel quel : \n par défaut, même sous Windows. Avec, c'est par défaut le séparateur de lignes du système qui exécute le job (\r\n sous Windows dans nos essais) : décochez la case pour le choisir vous-même. Without CSV options, the line end is the Row Separator, as is: \n by default, even on Windows. With them, it is by default the line separator of the system that runs the job (\r\n on Windows in our tests): uncheck the box to choose it yourself.

Compter ou relireCount or read back

NB_LINE donne le nombre de lignes écrites. Pour vérifier le fichier lui-même, comptez ses lignes avec tFileRowCount. NB_LINE gives the number of rows written. To check the file itself, count its lines with tFileRowCount.

Voir aussiSee also