ComposantsComponents › 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
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.
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).
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è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). |
"dd-MM-yyyy"…).
Date: following the column pattern in the schema ("dd-MM-yyyy"…).
"" avec les options CSV, comme une valeur vide.
Null value: nothing between the two separators; "" with the CSV options, like an empty value.
String.valueOf).
Other types: their Java text (String.valueOf).
/, 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"))
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.
| idInteger | nameString | cityString | amountBigDecimal, précisionprecision 2 | sinceDate, "dd-MM-yyyy" |
|---|---|---|---|---|
| 1 | Ada | London | 1250.5 | 2021-03-15 |
| 2 | Grace | null | 80 | 2023-11-02 |
| 3 | Alan | Manchester | 3.14159 | null |
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"));
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.
","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é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
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.
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.
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.
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 |
|---|---|---|
| 1 | Ada | London; UK |
| 2 | Grace "Amazing" | null |
| 3 | Alan | (vide)(empty) |
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
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
"\\""\\" 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
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 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
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;
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
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).
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: []
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
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.
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.
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) …
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.
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).
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).
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.
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).
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.
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.
tFileOutputPositional · fichier à positions fixesfixed-width filetFileOutputMSDelimited · fichier délimité à plusieurs schémasdelimited file with several schemastFileOutputExcel · classeur ExcelExcel workbooktFileOutputRaw · une valeur écrite telle quelle dans un fichierone value written as is to a filetChangeFileEncoding · changer l'encodage du fichier écritchange the encoding of the written filetFileArchive · archiver plusieurs fichiersarchive several filestFileRowCount · compter les lignes du fichier écritcount the lines of the written filetLogRow · afficher les lignes d'un fluxdisplay the rows of a flow