ComposantsComponents › Fichier › LectureFile › Input
Lit les cellules d'une ou de plusieurs feuilles d'un classeur Excel : une ligne du flux par ligne de la feuille, une colonne du schéma par colonne de la feuille, à partir de la première colonne choisie. Le format par défaut est le .xls d'Excel 97-2003, lu avec la bibliothèque jxl ; case cochée, le .xlsx, lu avec Apache POI, soit en entier en mémoire, soit en mode événement, au fil du fichier, pour les gros classeurs. C'est le pendant du tFileOutputExcel.
Reads the cells of one or more sheets of an Excel workbook: one flow row per sheet row, one schema column per sheet column, from the chosen first column. The default format is the Excel 97-2003 .xls, read with the jxl library; box checked, the .xlsx, read with Apache POI, either fully in memory or in event mode, along the file, for large workbooks. It is the counterpart of tFileOutputExcel.
Nombres décimaux en .xls : sur une machine dont le séparateur décimal est la virgule (Windows en français), un nombre décimal lu dans une colonne numérique est refusé et la ligne est perdue. Le format xlsx n'a pas ce défaut. Voir la langue de la machine. Decimal numbers in .xls: on a machine whose decimal separator is the comma (Windows in French), a decimal number read into a numeric column is refused and the row is lost. The xlsx format does not have this defect. See the language of the machine.
EntréeInput
Aucune : il commence son sous-job. Sinon un lien Iterate (un classeur par tour). None: it starts its subjob. Otherwise one Iterate link (one workbook per turn).
SortieOutput
Main une ligne par ligne de feuille lueone row per sheet row read
Reject facultatif : les lignes dont une cellule ne se convertit pas (exemple)optional: the rows with a cell that cannot be converted (example)
Déclencheurs en sortieOutput triggers
On Subjob Ok On Subjob Error On Component Ok On Component Error Run if
En-tête 1 saute la ligne des titres, Pied de page 1 une ligne de total. Le schéma donne le type de chaque colonne ; le tMap les adapte à la table.
Header 1 skips the title row, Footer 1 a total row. The schema gives the type of each column; the tMap adapts them to the table.
Nom de fichier/Flux ((String) globalMap.get("tFileList_1_CURRENT_FILEPATH")) ; les classeurs doivent avoir les mêmes feuilles et les mêmes colonnes.
File name/Stream ((String) globalMap.get("tFileList_1_CURRENT_FILEPATH")); the workbooks must have the same sheets and the same columns.
.xlsx, cochez Lire le format de fichier Excel 2007 (xlsx).
Set the File name/Stream; for an .xlsx, check Read excel2007 file format (xlsx).
Les libellés sont ceux de l'onglet Composant ; le nom technique, en gris, est celui du paramètre dans le fichier du job. « xlsx » veut dire : Lire le format de fichier Excel 2007 (xlsx) coché ; « mode événement » : Mode de génération sur le mode événement. Labels are those of the Component tab; the technical name, in grey, is the parameter name in the job file. “xlsx” means: Read excel2007 file format (xlsx) checked; “event mode”: Generation mode set to the event mode.
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| Type de propriétéProperty TypePROPERTY | Built-in | ToujoursAlways | Built-in : les réglages sont saisis ici. Référentiel : le fichier, les feuilles, l'en-tête, le pied, la limite, les colonnes, les séparateurs, l'encodage, la lecture des valeurs réelles et le mode de génération viennent d'une métadonnée de fichier Excel du référentiel. Built-in: the settings are typed here. Repository: the file, the sheets, the header, the footer, the limit, the columns, the separators, the encoding, the reading of real values and the generation mode come from an Excel file metadata of the Repository. |
| Lire le format de fichier Excel 2007 (xlsx)Read excel2007 file format (xlsx)VERSION_2007 | NonNo | ToujoursAlways |
Décochée : classeur .xls (Excel 97-2003), lu avec jxl 2.6.12. Cochée : classeur .xlsx, lu avec Apache POI 4.1.2 (version modifiée par Talend). Un classeur de l'autre format est refusé (voir les erreurs). Les deux formats ne lisent pas les cellules tout à fait pareil (voir les valeurs lues).
Unchecked: .xls workbook (Excel 97-2003), read with jxl 2.6.12. Checked: .xlsx workbook, read with Apache POI 4.1.2 (version modified by Talend). A workbook of the other format is refused (see the errors). The two formats do not read cells quite the same way (see the values read).
|
| Nom de fichier/FluxFile name/StreamFILENAME | chemin par défaut + /in.xlsdefault path + /in.xls |
ToujoursAlways |
Expression Java qui donne le chemin du classeur, context.folder + "/orders.xls", ou un flux java.io.InputStream déjà ouvert (exemple). Tout autre objet arrête le job (The data source should be specified as Inputstream or File Path!).
Java expression that gives the path of the workbook, context.folder + "/orders.xls", or an already open java.io.InputStream (example). Any other object stops the job (The data source should be specified as Inputstream or File Path!).
|
| Mot de passePasswordPASSWORD | "" |
xlsx | Mot de passe d'ouverture d'un classeur xlsx chiffré, dans les deux modes ; vide : aucun (exemple). Sans lui, un classeur chiffré est refusé. Opening password of an encrypted xlsx workbook, in both modes; empty: none (example). Without it, an encrypted workbook is refused. |
| Toutes les feuillesAll sheetsALL_SHEETS | NonNo | ToujoursAlways | Lit toutes les feuilles, dans l'ordre du classeur, les unes à la suite des autres (exemple). D'après le modèle, les feuilles vides sont sautées. Reads all the sheets, in the order of the workbook, one after the other (example). From the template, empty sheets are skipped. |
| Liste des feuillesSheet listSHEETLIST · SHEETNAME · USE_REGEX | videempty | Toutes les feuilles décochéAll sheets unchecked |
Une ligne par feuille, lues dans l'ordre du tableau. Feuille (nom ou position) : un nom entre guillemets, "2023", ou une position sans guillemets, comptée à partir de 0 (1 : la deuxième feuille, exemple). Utiliser les expressions régulières coché : l'expression Java doit couvrir tout le nom, "20\\d\\d" prend 2023 et 2024 (exemple). Aucune feuille trouvée : le job s'arrête (Special sheets not exist!).
One line per sheet, read in the order of the table. Sheet (name or position): a name in quotes, "2023", or a position without quotes, counted from 0 (1: the second sheet, example). Use Regex checked: the Java expression must cover the whole name, "20\\d\\d" takes 2023 and 2024 (example). No sheet found: the job stops (Special sheets not exist!).
|
| En-têteHeaderHEADER | 0 |
ToujoursAlways | Nombre de lignes sautées au début. Avec plusieurs feuilles, seulement au début de la première, sauf avec Affecte chaque feuille (exemple). Number of rows skipped at the start. With several sheets, only at the start of the first one, except with Affect each sheet (example). |
| Pied de pageFooterFOOTER | 0 |
Sauf xlsx en mode événementExcept xlsx in event mode | Nombre de lignes sautées à la fin. Avec plusieurs feuilles, seulement à la fin de la dernière, sauf avec Affecte chaque feuille. Number of rows skipped at the end. With several sheets, only at the end of the last one, except with Affect each sheet. |
| LimiteLimitLIMIT | videempty | ToujoursAlways | Nombre maximal de lignes envoyées sur Main ; vide : toutes. D'après le modèle, les lignes en erreur ne comptent pas. En mode événement, la lecture du fichier s'arrête aussi. Maximum number of rows sent on Main; empty: all. From the template, the rows in error do not count. In event mode, the reading of the file stops too. |
| Affecte chaque feuille (en-tête et pied de page)Affect each sheet(header&&footer)AFFECT_EACH_SHEET | NonNo | Sauf xlsx en mode événementExcept xlsx in event mode | Applique l'en-tête et le pied de page à chaque feuille lue, et non à l'ensemble : indispensable quand chaque feuille a sa ligne de titres (exemple). Applies the header and the footer to each sheet read, not to the whole: required when each sheet has its own title row (example). |
| Première colonneFirst columnFIRST_COLUMN | 1 |
ToujoursAlways |
Colonne de la feuille qui remplit la première colonne du schéma, comptée à partir de 1 : 2 pour B (exemple).
Sheet column that fills the first schema column, counted from 1: 2 for B (example).
|
| Dernière colonneLast columnLAST_COLUMN | videempty | ToujoursAlways |
Dernière colonne lue, comptée à partir de 1, comprise : 3 pour C. Les colonnes du schéma au-delà sont nulles. Sans effet en mode événement, qui lit toujours autant de colonnes que le schéma en a (exemple).
Last column read, counted from 1, included: 3 for C. The schema columns beyond it are null. No effect in event mode, which always reads as many columns as the schema has (example).
|
| Arrêter en cas d'erreurDie on errorDIE_ON_ERROR | NonNo | ToujoursAlways | Concerne les cellules qui ne se convertissent pas au type de leur colonne. Coché : le job s'arrête, et le lien Reject n'est plus proposé. Décoché : la ligne part sur Reject s'il existe, sinon le message est écrit sur la sortie d'erreur et la ligne est perdue (exemple). En mode événement, une erreur de lecture du fichier n'arrête le job qu'avec cette case (voir les erreurs). Applies to the cells that cannot be converted to the type of their column. Checked: the job stops, and the Reject link is no longer offered. Unchecked: the row goes to Reject if there is one, otherwise the message is written to the error output and the row is lost (example). In event mode, an error while reading the file only stops the job with this box (see the errors). |
| SchémaSchemaSCHEMA | — | ToujoursAlways |
Une colonne par colonne de la feuille, par position, à partir de la Première colonne : le nom des colonnes de la feuille n'est pas lu. Le type choisit la conversion du texte de la cellule (voir les valeurs lues). Une cellule vide donne null, ou la valeur par défaut de la colonne. Le lien Reject a les mêmes colonnes, plus errorCode et errorMessage.
One column per sheet column, by position, from the First column: the names of the sheet columns are not read. The type chooses how the text of the cell is converted (see the values read). An empty cell gives null, or the default value of the column. The Reject link has the same columns, plus errorCode and errorMessage.
|
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| Séparateur avancé (pour les nombres)Advanced separator (for numbers)ADVANCED_SEPARATOR | NonNo | ToujoursAlways |
Le texte des colonnes numériques est lu avec les deux séparateurs ci-dessous : des montants écrits en texte, "1.250,50", deviennent des nombres (exemple). Sert aussi de contournement en xls sur une machine en français (voir).
The text of the numeric columns is read with the two separators below: amounts written as text, "1.250,50", become numbers (example). Also a workaround in xls on a French machine (see).
|
| Séparateur de milliersThousands separatorTHOUSANDS_SEPARATOR | "," |
Séparateur avancé cochéAdvanced separator checked | Caractère retiré entre les milliers. Character removed between the thousands. |
| Séparateur décimalDecimal separatorDECIMAL_SEPARATOR | "." |
Séparateur avancé cochéAdvanced separator checked | Caractère placé avant les décimales. Character placed before the decimals. |
| Supprimer les espaces en début et fin de champ dans toutes les colonnesTrim all columnsTRIMALL | NonNo | ToujoursAlways |
Retire les espaces autour du texte de chaque cellule, avant la conversion (exemple). D'après le modèle, une cellule faite d'espaces devient vide, donc null.
Removes the spaces around the text of each cell, before the conversion (example). From the template, a cell made of spaces becomes empty, so null.
|
| Sélectionner la colonne où supprimer les espaces entourant les champsCheck column to trimTRIMSELECT · TRIM | tout décochéall unchecked | Suppression dans toutes les colonnes décochéeTrim all columns unchecked | Une ligne par colonne du schéma : seules les colonnes cochées sont nettoyées. One line per schema column: only the checked columns are trimmed. |
| Convertir une colonne de date en chaîne de caractèresConvert date column to stringCONVERTDATETOSTRING | NonNo | xlsx, mode utilisateurxlsx, user mode |
Une cellule date lue dans une colonne String est écrite avec le modèle du tableau suivant, au lieu du texte de Date.toString() (exemple).
A date cell read into a String column is written with the pattern of the next table, instead of the Date.toString() text (example).
|
| Vérifier s'il faut convertir les colonnes de datesCheck need convert date columnDATESELECT · CONVERTDATE · PATTERN | décoché, "MM-dd-yyyy"unchecked, "MM-dd-yyyy" |
Convertir coché, xlsx, mode utilisateurConvert checked, xlsx, user mode |
Une ligne par colonne du schéma : Convertir et le Modèle de date Java de la colonne, "yyyy-MM-dd" par exemple.
One line per schema column: Convert and the Java Date pattern of the column, "yyyy-MM-dd" for example.
|
| EncodageEncodingENCODING | "ISO-8859-15" |
ToujoursAlways |
D'après le modèle : en xls, passé aux réglages de jxl (WorkbookSettings.setEncoding) ; en mode événement, au lecteur du classeur ; le mode utilisateur ne s'en sert pas pour lire. Sert aussi à convertir le texte d'une colonne byte[].
From the template: in xls, passed to the jxl settings (WorkbookSettings.setEncoding); in event mode, to the workbook reader; the user mode does not use it to read. Also used to convert the text of a byte[] column.
|
| Lire les valeurs réelles pour les nombresRead real values for numbersREAD_REAL_VALUE | NonNo | xlsx décochéxlsx unchecked |
xls : une cellule nombre (ou formule de résultat nombre) donne sa valeur enregistrée, et non le texte affiché selon son format : 3.14159 au lieu de 3.14 pour un format 0.00 (exemple). Le xlsx lit toujours la valeur enregistrée.
xls: a number cell (or a formula with a number result) gives its stored value, not the text displayed with its format: 3.14159 instead of 3.14 for a 0.00 format (example). The xlsx always reads the stored value.
|
| Terminer la lecture lorsqu'une ligne vide est rencontréeStop reading on encountering empty rowsSTOPREAD_ON_EMPTYROW | NonNo | Sauf xlsx en mode événementExcept xlsx in event mode |
S'arrête à la première ligne dont toutes les colonnes du schéma sont vides ; elle n'est pas envoyée. Décochée, une ligne vide donne une ligne de null (exemple).
Stops at the first row whose schema columns are all empty; it is not sent. Unchecked, an empty row gives a row of null (example).
|
| Ne pas valider les cellulesDon't validate the cellsNOVALIDATE_ON_CELL | NonNo | xlsx décochéxlsx unchecked |
xls : désactive la lecture des règles de validation des cellules par jxl (setCellValidationDisabled). Non essayé.
xls: turns off the reading of the cell validation rules by jxl (setCellValidationDisabled). Not tried.
|
| Ignorer l'avertissementIgnore the warningSUPPRESS_WARN | NonNo | xlsx décochéxlsx unchecked |
xls : jxl n'écrit plus ses avertissements sur le classeur lu (setSuppressWarnings). Non essayé.
xls: jxl no longer writes its warnings about the read workbook (setSuppressWarnings). Not tried.
|
| Mode de générationGeneration modeGENERATION_MODE | Mode utilisateurUser mode | xlsx | Consommateur de mémoire (Mode utilisateur) : tout le classeur est chargé avant la première ligne. Peu de mémoire consommée pour un grand fichier Excel (Mode Événement) : le classeur est lu au fil du fichier, dans un fil d'exécution à part, avec la bibliothèque simpleexcel 2.9. Ce mode n'a ni pied de page, ni Affecte chaque feuille, ni arrêt sur ligne vide, ignore la Dernière colonne et ne remplit pas CURRENT_SHEET (exemples). Memory-consuming (User mode): the whole workbook is loaded before the first row. Less memory consumed for large excel (Event mode): the workbook is read along the file, in a separate thread, with the simpleexcel 2.9 library. This mode has no footer, no Affect each sheet, no stop on empty row, ignores the Last column and does not fill CURRENT_SHEET (examples). |
| Inclure les exécutions phonétiquesInclude phonetic runsINCLUDE_PHONETICRUNS | OuiYes | xlsx, mode événementxlsx, event mode |
Passé au lecteur (setIncludePhoneticRuns) : d'après son nom, garde dans le texte les indications de lecture phonétique d'une cellule (texte japonais). Non essayé.
Passed to the reader (setIncludePhoneticRuns): from its name, keeps in the text the phonetic reading guides of a cell (Japanese text). Not tried.
|
| Configurer un taux d'inflation minimalSet minimum inflation rateCONFIGURE_INFLATION_RATIO · INFLATION_RATIO | Non, videNo, empty | xlsx |
Le champ qui apparaît (sans libellé) reçoit un nombre passé à ZipSecureFile.setMinInflateRatio avant l'ouverture. POI refuse un xlsx trop compressé, qu'il prend pour une « bombe zip » ; un taux plus bas, 0.001 par exemple, le fait accepter. Non essayé.
The field that appears (without a label) gets a number passed to ZipSecureFile.setMinInflateRatio before opening. POI refuses an xlsx that is too compressed, which it takes for a “zip bomb”; a lower ratio, 0.001 for example, makes it accepted. Not tried.
|
Le composant prend d'abord le texte de chaque cellule, puis le convertit au type de sa colonne. Ce texte dépend du format et du mode. Le tableau résume ce que montrent les exemples, JVM en anglais (en-US) ; « — » : cas non essayé. The component first takes the text of each cell, then converts it to the type of its column. This text depends on the format and the mode. The table sums up what the examples show, JVM in English (en-US); “—”: case not tried.
| Cellule → colonneCell → column | xls | xlsx, mode utilisateurxlsx, user mode | xlsx, mode événementxlsx, event mode |
|---|---|---|---|
Nombre au format 0.00, valeur 3.14159 → DoubleNumber with a 0.00 format, value 3.14159 → Double |
3.14 (texte affiché) ; 3.14159 avec Lire les valeurs réelles(displayed text); 3.14159 with Read real values |
3.14159 |
3.14159 |
| Nombre décimal, machine en françaisDecimal number, machine in French | refusé dans une colonne numérique ; 1250,5 dans une Stringrefused in a numeric column; 1250,5 in a String |
lu ; 1250,5 dans une Stringread; 1250,5 in a String |
— |
| Date → DateDate → Date | la datethe date | la datethe date | la datethe date |
Texte 2024-01-10 → Date (modèle "yyyy-MM-dd")Text 2024-01-10 → Date (pattern "yyyy-MM-dd") |
erreur : il faut une cellule dateerror: a date cell is needed | lu avec le modèle de la colonneread with the column pattern | — |
| Date → StringDate → String | 15-03-2023 (toujours dd-MM-yyyy)(always dd-MM-yyyy) |
Wed Mar 15 00:00:00 CET 2023 ; le modèle choisi avec Convertir une colonne de date; the chosen pattern with Convert date column |
10/01/2024 (texte affiché)(displayed text) |
Formule =SUM(C2:C3) → StringFormula =SUM(C2:C3) → String |
son résultat enregistré, 1349.5its stored result, 1349.5 |
son résultat enregistré, 1349.5 (point même en français)its stored result, 1349.5 (dot even in French) |
— |
| Booléen → Boolean, StringBoolean → Boolean, String | true, false |
true, false |
true, false (Boolean)(Boolean) |
| Cellule videEmpty cell | null |
null |
null |
| Ligne videEmpty row | une ligne de nulla row of null |
une ligne de nulla row of null |
— |
System.out.println("NB_LINE: " + globalMap.get("tFileInputExcel_1_NB_LINE"));
output_row.sheet = (String) globalMap.get("tFileInputExcel_1_CURRENT_SHEET"); // tJavaRow
Les classeurs orders.xls et orders.xlsx ont été écrits pour l'exemple par un tJava avec Apache POI : mêmes feuilles, mêmes cellules, formules calculées. Ils sont dans le dossier de la variable de contexte folder. Le tFileInputExcel envoie ses lignes à un tLogRow en mode Tableau, et un tJava relié par On Subjob Ok affiche NB_LINE. Sauf indication, le schéma est id Integer, customer String, amount Double, date Date ("dd-MM-yyyy"), paid Boolean. Les jobs sont lancés avec la JVM en anglais (-Duser.language=en -Duser.country=US dans les arguments JVM du job), sauf ceux de la section langue de la machine. En mode Tableau, le tLogRow affiche ses lignes à la fin : les messages d'erreur, écrits au fil de la lecture, apparaissent avant. Les sorties sont celles de la console, copiées depuis une exécution des jobs.
The orders.xls and orders.xlsx workbooks were written for the example by a tJava with Apache POI: same sheets, same cells, computed formulas. They are in the folder of the folder context variable. The tFileInputExcel sends its rows to a tLogRow in Table mode, and a tJava connected with On Subjob Ok prints NB_LINE. Unless stated, the schema is id Integer, customer String, amount Double, date Date ("dd-MM-yyyy"), paid Boolean. The jobs are run with the JVM in English (-Duser.language=en -Duser.country=US in the JVM arguments of the job), except those of the language of the machine section. In Table mode, the tLogRow prints its rows at the end: the error messages, written along the reading, appear before. The outputs are the console ones, copied from runs of the jobs.
Cinq feuilles, dans cet ordre : 2023, 2024, Notes, Messy, Text. Les dates sont des cellules date au format dd/mm/yyyy, paid des booléens, la ligne Total une formule.
Five sheets, in this order: 2023, 2024, Notes, Messy, Text. Dates are date cells in the dd/mm/yyyy format, paid booleans, the Total row a formula.
2023Sheet 2023| A | B | C | D | E | |
|---|---|---|---|---|---|
| 1 | id | customer | amount | date | paid |
| 2 | 1 | Ada | 1250.5 | 15/03/2023 | TRUE |
| 3 | 2 | Grace | 99 | 02/11/2023 | FALSE |
| 4 | Total | 1349.5 =SUM(C2:C3) |
2024Sheet 2024| A | B | C | D | E | |
|---|---|---|---|---|---|
| 1 | id | customer | amount | date | paid |
| 2 | 3 | Alan | 3.14 (3.14159) | 10/01/2024 | TRUE |
| 3 | 4 | Margaret | 30/06/2024 | FALSE | |
| 4 | 5 | Linus | 20 | 17/09/2024 | TRUE |
| 5 | Total | 23.14159 =SUM(C2:C4) |
C2 vaut 3.14159, affiché 3.14 par son format 0.00.
C2 holds 3.14159, displayed 3.14 by its 0.00 format.
MessySheet Messy| A | B | C | D | |
|---|---|---|---|---|
| 1 | id | customer | amount | date |
| 2 | 1 | " Ada " | 10 | "2024-01-10" |
| 3 | ||||
| 4 | 2 | Grace | "abc" | 15/03/2024 |
| 5 | 3 | Alan | 30 |
Entre guillemets : du texte. B2 a des espaces autour du nom, D2 est une date écrite en texte, la ligne 3 est vide. In quotes: text. B2 has spaces around the name, D2 is a date written as text, row 3 is empty.
Text et NotesSheets Text and Notes| A | B | |
|---|---|---|
| 1 | id | amount |
| 2 | 1 | "1.250,50" |
| 3 | 2 | "3,14" |
| A | |
|---|---|
| 1 | Orders by year |
| 2 | Amounts in euros |
orders.xls, feuille "2023", En-tête 1, Pied de page 1 :
orders.xls, sheet "2023", Header 1, Footer 1:
.--+--------+------+----------+-----. | tLogRow_1 | |=-+--------+------+----------+----=| |id|customer|amount|date |paid | |=-+--------+------+----------+----=| |1 |Ada |1250.5|15-03-2023|true | |2 |Grace |99.0 |02-11-2023|false| '--+--------+------+----------+-----' NB_LINE: 2
La ligne des titres et la ligne Total sont sautées. Le même réglage sur orders.xlsx, xlsx coché, donne la même sortie, y compris sur une machine en français.
The title row and the Total row are skipped. The same setting on orders.xlsx, xlsx checked, gives the same output, including on a machine in French.
orders.xls, Feuille 1 (sans guillemets), en-tête 1, pied 1, Limite 2 :
orders.xls, Sheet 1 (without quotes), header 1, footer 1, Limit 2:
.--+--------+------+----------+-----. | tLogRow_1 | |=-+--------+------+----------+----=| |id|customer|amount|date |paid | |=-+--------+------+----------+----=| |3 |Alan |3.14 |10-01-2024|true | |4 |Margaret|null |30-06-2024|false| '--+--------+------+----------+-----' NB_LINE: 2
La position compte à partir de 0 : 1 est la feuille 2024. La cellule vide de Margaret donne null. Le montant d'Alan est le texte affiché, 3.14, et non 3.14159 (voir les valeurs réelles).
The position counts from 0: 1 is the 2024 sheet. The empty cell of Margaret gives null. The amount of Alan is the displayed text, 3.14, not 3.14159 (see real values).
orders.xls, une ligne dans la Liste des feuilles : "20\\d\\d", Utiliser les expressions régulières coché ; en-tête 1, pied 1. Les feuilles 2023 et 2024 sont lues l'une après l'autre.
orders.xls, one line in the Sheet list: "20\\d\\d", Use Regex checked; header 1, footer 1. The 2023 and 2024 sheets are read one after the other.
.--+--------+------+----------+-----. | tLogRow_1 | |=-+--------+------+----------+----=| |id|customer|amount|date |paid | |=-+--------+------+----------+----=| |1 |Ada |1250.5|15-03-2023|true | |2 |Grace |99.0 |02-11-2023|false| |3 |Alan |3.14 |10-01-2024|true | |4 |Margaret|null |30-06-2024|false| |5 |Linus |20.0 |17-09-2024|true | '--+--------+------+----------+-----' .--+--------+------+----+----+---------+------------------------------------------------------. | tLogRow_2 | |=-+--------+------+----+----+---------+-----------------------------------------------------=| |id|customer|amount|date|paid|errorCode|errorMessage | |=-+--------+------+----+----+---------+-----------------------------------------------------=| |null|null |null |null|null|null |For input string: "Total" - Line: 2 column: id (No. 1)| |null|null |null |null|null|null |For input string: "id" - Line: 3 column: id (No. 1) | '--+--------+------+----+----+---------+------------------------------------------------------' NB_LINE: 5
L'en-tête ne saute que la ligne des titres de la première feuille, et le pied que la ligne Total de la dernière : le Total de 2023 et les titres de 2024 arrivent comme des données, et partent sur Reject ("Total" et "id" ne sont pas des Integer). NB_LINE ne les compte pas.
The header only skips the title row of the first sheet, and the footer only the Total row of the last one: the Total of 2023 and the titles of 2024 arrive as data, and go to Reject ("Total" and "id" are not Integers). NB_LINE does not count them.
Un tJavaRow ajoute devant les colonnes une colonne sheet : output_row.sheet = (String) globalMap.get("tFileInputExcel_1_CURRENT_SHEET");.
A tJavaRow adds a sheet column in front of the columns: output_row.sheet = (String) globalMap.get("tFileInputExcel_1_CURRENT_SHEET");.
.-----+--+--------+------+----------+-----. | tLogRow_1 | |=----+--+--------+------+----------+----=| |sheet|id|customer|amount|date |paid | |=----+--+--------+------+----------+----=| |2023 |1 |Ada |1250.5|15-03-2023|true | |2023 |2 |Grace |99.0 |02-11-2023|false| |2024 |3 |Alan |3.14 |10-01-2024|true | |2024 |4 |Margaret|null |30-06-2024|false| |2024 |5 |Linus |20.0 |17-09-2024|true | '-----+--+--------+------+----------+-----' NB_LINE: 5
orders.xls, Toutes les feuilles coché, en-tête 0, pied 0, Dernière colonne 1, schéma d'une colonne a String, nom de la feuille ajouté par le tJavaRow :
orders.xls, All sheets checked, header 0, footer 0, Last column 1, schema of one a String column, sheet name added by the tJavaRow:
.-----+----------------. | tLogRow_1 | |=----+---------------=| |sheet|a | |=----+---------------=| |2023 |id | |2023 |1 | |2023 |2 | |2023 |Total | |2024 |id | |2024 |3 | |2024 |4 | |2024 |5 | |2024 |Total | |Notes|Orders by year | |Notes|Amounts in euros| |Messy|id | |Messy|1 | |Messy|null | |Messy|2 | |Messy|3 | |Text |id | |Text |1 | |Text |2 | '-----+----------------' NB_LINE: 19
Les cinq feuilles, dans l'ordre du classeur. Les nombres d'une colonne String sont le texte affiché : 1, et non 1.0.
The five sheets, in the order of the workbook. The numbers of a String column are the displayed text: 1, not 1.0.
Feuille 2024, en-tête 1, pied 1, Première colonne 2, Dernière colonne 3. En xls, schéma customer String, amount Double :
2024 sheet, header 1, footer 1, First column 2, Last column 3. In xls, schema customer String, amount Double:
.--------+------. | tLogRow_1 | |=-------+-----=| |customer|amount| |=-------+-----=| |Alan |3.14 | |Margaret|null | |Linus |20.0 | '--------+------' NB_LINE: 3
En xlsx, avec une troisième colonne date String au schéma : en mode utilisateur, elle est au-delà de la colonne C, donc nulle ; en mode événement (Limite 3), la Dernière colonne est ignorée et D est lue :
In xlsx, with a third date String column in the schema: in user mode, it is beyond column C, so null; in event mode (Limit 3), the Last column is ignored and D is read:
.--------+-------+----. | tLogRow_1 | |=-------+-------+---=| |customer|amount |date| |=-------+-------+---=| |Alan |3.14159|null| |Margaret|null |null| |Linus |20.0 |null| '--------+-------+----' NB_LINE: 3
.--------+-------+----------. | tLogRow_1 | |=-------+-------+---------=| |customer|amount |date | |=-------+-------+---------=| |Alan |3.14159|10/01/2024| |Margaret|null |30/06/2024| |Linus |20.0 |17/09/2024| '--------+-------+----------' NB_LINE: 3
Feuille Messy, en-tête 1, pied 0, quatre colonnes String (id, customer, amount, date). À gauche, réglages par défaut ; à droite, Terminer la lecture lorsqu'une ligne vide est rencontrée et Supprimer les espaces… dans toutes les colonnes cochés :
Messy sheet, header 1, footer 0, four String columns (id, customer, amount, date). On the left, default settings; on the right, Stop reading on encountering empty rows and Trim all columns checked:
.--+--------+------+----------. | tLogRow_1 | |=-+--------+------+---------=| |id|customer|amount|date | |=-+--------+------+---------=| |1 | Ada |10 |2024-01-10| |null|null |null |null | |2 |Grace |abc |15-03-2024| |3 |Alan |30 |null | '--+--------+------+----------' NB_LINE: 4
.--+--------+------+----------. | tLogRow_1 | |=-+--------+------+---------=| |id|customer|amount|date | |=-+--------+------+---------=| |1 |Ada |10 |2024-01-10| '--+--------+------+----------' NB_LINE: 1
Sans arrêt, la ligne vide devient une ligne de null, et la lecture continue. Avec l'arrêt, la lecture finit sur elle : Grace et Alan ne sont pas lus. La date écrite en texte reste 2024-01-10 ; la cellule date de Grace devient 15-03-2024.
Without the stop, the empty row becomes a row of null, and the reading goes on. With the stop, the reading ends on it: Grace and Alan are not read. The date written as text stays 2024-01-10; the date cell of Grace becomes 15-03-2024.
Toutes les colonnes en String, pour voir le texte que le composant tire de chaque cellule avant la conversion. All columns as String, to see the text that the component takes from each cell before the conversion.
2023, pied 0, xls puis xlsx1. Formula: 2023 sheet, footer 0, xls then xlsx.-----+--------+------+----------+-----. | tLogRow_1 | |=----+--------+------+----------+----=| |id |customer|amount|date |paid | |=----+--------+------+----------+----=| |1 |Ada |1250.5|15-03-2023|true | |2 |Grace |99 |02-11-2023|false| |Total|null |1349.5|null |null | '-----+--------+------+----------+-----' NB_LINE: 3
.-----+--------+------+----------------------------+-----. | tLogRow_2 | |=----+--------+------+----------------------------+----=| |id |customer|amount|date |paid | |=----+--------+------+----------------------------+----=| |1 |Ada |1250.5|Wed Mar 15 00:00:00 CET 2023|true | |2 |Grace |99 |Thu Nov 02 00:00:00 CET 2023|false| |Total|null |1349.5|null |null | '-----+--------+------+----------------------------+-----' NB_LINE: 3
La formule donne le résultat enregistré dans le classeur, 1349.5 : le composant ne la recalcule pas. Une cellule date devient 15-03-2023 en xls (toujours ce modèle), le texte de Date.toString() en xlsx.
The formula gives the result stored in the workbook, 1349.5: the component does not compute it again. A date cell becomes 15-03-2023 in xls (always this pattern), the Date.toString() text in xlsx.
Feuille 2023, en-tête 1, pied 1 ; dans le tableau, date cochée avec le modèle "yyyy-MM-dd" (troisième sous-job du même job, d'où tLogRow_3) :
2023 sheet, header 1, footer 1; in the table, date checked with the "yyyy-MM-dd" pattern (third subjob of the same job, hence tLogRow_3):
.--+--------+------+----------+-----. | tLogRow_3 | |=-+--------+------+----------+----=| |id|customer|amount|date |paid | |=-+--------+------+----------+----=| |1 |Ada |1250.5|2023-03-15|true | |2 |Grace |99 |2023-11-02|false| '--+--------+------+----------+-----' NB_LINE: 2
Feuille 2024, en-tête 1, pied 1 ; à gauche par défaut, à droite Lire les valeurs réelles pour les nombres coché :
2024 sheet, header 1, footer 1; on the left by default, on the right Read real values for numbers checked:
.--+--------+------+----------+-----. | tLogRow_1 | |=-+--------+------+----------+----=| |id|customer|amount|date |paid | |=-+--------+------+----------+----=| |3 |Alan |3.14 |10-01-2024|true | |4 |Margaret|null |30-06-2024|false| |5 |Linus |20 |17-09-2024|true | '--+--------+------+----------+-----' NB_LINE: 3
.--+--------+-------+----------+-----. | tLogRow_2 | |=-+--------+-------+----------+----=| |id|customer|amount |date |paid | |=-+--------+-------+----------+----=| |3 |Alan |3.14159|10-01-2024|true | |4 |Margaret|null |30-06-2024|false| |5 |Linus |20 |17-09-2024|true | '--+--------+-------+----------+-----' NB_LINE: 3
Par défaut, le xls lit le texte affiché par le format de la cellule : deux décimales. Une colonne Double reçoit alors 3.14, la précision est perdue. Le xlsx lit toujours 3.14159.
By default, the xls reads the text displayed by the cell format: two decimals. A Double column then gets 3.14, the precision is lost. The xlsx always reads 3.14159.
Feuille Messy, en-tête 1, pied 0, schéma id Integer, customer String, amount Integer, date Date ("yyyy-MM-dd"), Reject vers un second tLogRow. En xls :
Messy sheet, header 1, footer 0, schema id Integer, customer String, amount Integer, date Date ("yyyy-MM-dd"), Reject to a second tLogRow. In xls:
.--+--------+------+----. | tLogRow_1 | |=-+--------+------+---=| |id|customer|amount|date| |=-+--------+------+---=| |null|null |null |null| |3 |Alan |30 |null| '--+--------+------+----' .--+--------+------+----+---------+-----------------------------------------------------------------------------------------. | tLogRow_2 | |=-+--------+------+----+---------+----------------------------------------------------------------------------------------=| |id|customer|amount|date|errorCode|errorMessage | |=-+--------+------+----+---------+----------------------------------------------------------------------------------------=| |1 | Ada |10 |null|null |The cell format is not Date in ( Row. 1 and ColumnNum. 4 ) - Line: 0 column: date (No. 4)| |2 |Grace |null |null|null |For input string: "abc" - Line: 2 column: amount (No. 3) | '--+--------+------+----+---------+-----------------------------------------------------------------------------------------' NB_LINE: 2
En xls, une colonne Date veut une cellule date : le texte 2024-01-10 est refusé, bien qu'il suive le modèle. Les colonnes lues avant l'erreur sont remplies, les suivantes et errorCode restent nulles. errorMessage nomme la colonne et son numéro dans la feuille (No. 4 : la colonne D). « Line » est le rang de la ligne parmi les lignes lues, compté à partir de 0, et « Row. » le nombre de lignes déjà envoyées sur Main plus un : aucun des deux n'est le numéro de la ligne dans la feuille. Le même job en xlsx :
In xls, a Date column wants a date cell: the 2024-01-10 text is refused, although it follows the pattern. The columns read before the error are filled, the next ones and errorCode stay null. errorMessage names the column and its number in the sheet (No. 4: column D). “Line” is the rank of the row among the rows read, counted from 0, and “Row.” the number of rows already sent on Main plus one: neither is the number of the row in the sheet. The same job in xlsx:
.--+--------+------+----------. | tLogRow_3 | |=-+--------+------+---------=| |id|customer|amount|date | |=-+--------+------+---------=| |1 | Ada |10 |2024-01-10| |null|null |null |null | |3 |Alan |30 |null | '--+--------+------+----------' .--+--------+------+----+---------+--------------------------------------------------------. | tLogRow_4 | |=-+--------+------+----+---------+-------------------------------------------------------=| |id|customer|amount|date|errorCode|errorMessage | |=-+--------+------+----+---------+-------------------------------------------------------=| |2 |Grace |null |null|null |For input string: "abc" - Line: 2 column: amount (No. 3)| '--+--------+------+----+---------+--------------------------------------------------------' NB_LINE: 3
Le xlsx lit le texte de la date avec le modèle de la colonne : seule la ligne de Grace est rejetée. Sans lien Reject (xls), les messages vont sur la sortie d'erreur et les lignes sont perdues : The xlsx reads the text of the date with the pattern of the column: only the row of Grace is rejected. Without a Reject link (xls), the messages go to the error output and the rows are lost:
The cell format is not Date in ( Row. 1 and ColumnNum. 4 ) For input string: "abc" .--+--------+------+----. | tLogRow_1 | |=-+--------+------+---=| |id|customer|amount|date| |=-+--------+------+---=| |null|null |null |null| |3 |Alan |30 |null| '--+--------+------+----' NB_LINE: 2
Feuille Text, en-tête 1, pied 0, schéma id Integer, amount Double, Séparateur avancé coché, milliers ".", décimales "," :
Text sheet, header 1, footer 0, schema id Integer, amount Double, Advanced separator checked, thousands ".", decimals ",":
.--+------. |tLogRow_1| |=-+-----=| |id|amount| |=-+-----=| |1 |1250.5| |2 |3.14 | '--+------' NB_LINE: 2
Les textes 1.250,50 et 3,14 deviennent des nombres.
The texts 1.250,50 and 3,14 become numbers.
secret.xlsx, chiffré par POI avec le mot de passe s3cret, feuille "Payroll" (id, name), en-tête 1, pied 0, xlsx coché, Mot de passe "s3cret" :
secret.xlsx, encrypted by POI with the s3cret password, "Payroll" sheet (id, name), header 1, footer 0, xlsx checked, Password "s3cret":
.--+-----. |tLogRow_1| |=-+----=| |id|name | |=-+----=| |1 |Ada | |2 |Grace| '--+-----' NB_LINE: 2
Même sortie en mode événement. Sans mot de passe, le job s'arrête (voir les erreurs). Same output in event mode. Without a password, the job stops (see the errors).
orders.xlsx, xlsx coché, Mode de génération en mode événement, feuille "2023", en-tête 1. Le pied de page n'existe pas dans ce mode : la ligne Total est lue et refusée. À droite, avec Limite 2 :
orders.xlsx, xlsx checked, Generation mode set to event mode, "2023" sheet, header 1. The footer does not exist in this mode: the Total row is read and refused. On the right, with Limit 2:
For input string: "Total" .--+--------+------+----------+-----. | tLogRow_1 | |=-+--------+------+----------+----=| |id|customer|amount|date |paid | |=-+--------+------+----------+----=| |1 |Ada |1250.5|15-03-2023|true | |2 |Grace |99.0 |02-11-2023|false| '--+--------+------+----------+-----' NB_LINE: 2
.--+--------+------+----------+-----. | tLogRow_1 | |=-+--------+------+----------+----=| |id|customer|amount|date |paid | |=-+--------+------+----------+----=| |1 |Ada |1250.5|15-03-2023|true | |2 |Grace |99.0 |02-11-2023|false| '--+--------+------+----------+-----' NB_LINE: 2
Les feuilles "20\\d\\d" (expression régulière) en mode événement, en-tête 1, nom de la feuille ajouté par le tJavaRow :
The "20\\d\\d" sheets (regular expression) in event mode, header 1, sheet name added by the tJavaRow:
For input string: "Total" For input string: "id" For input string: "Total" .-----+--+--------+-------+----------+-----. | tLogRow_1 | |=----+--+--------+-------+----------+----=| |sheet|id|customer|amount |date |paid | |=----+--+--------+-------+----------+----=| |null |1 |Ada |1250.5 |15-03-2023|true | |null |2 |Grace |99.0 |02-11-2023|false| |null |3 |Alan |3.14159|10-01-2024|true | |null |4 |Margaret|null |30-06-2024|false| |null |5 |Linus |20.0 |17-09-2024|true | '-----+--+--------+-------+----------+-----' NB_LINE: 5
L'en-tête ne saute que la première ligne de la première feuille : les deux Total et les titres de 2024 sont refusés. CURRENT_SHEET reste nul : défaut du modèle, le mode événement ne le remplit pas (tFileInputExcel_begin.javajet, à partir de la ligne 1220).
The header only skips the first row of the first sheet: both Total rows and the titles of 2024 are refused. CURRENT_SHEET stays null: defect of the template, the event mode does not fill it (tFileInputExcel_begin.javajet, from line 1220).
Nom de fichier/Flux new java.io.FileInputStream(context.folder + "/orders.xls"), réglages de l'exemple de base : la sortie est la même.
File name/Stream new java.io.FileInputStream(context.folder + "/orders.xls"), settings of the basic example: the output is the same.
.--+--------+------+----------+-----. | tLogRow_1 | |=-+--------+------+----------+----=| |id|customer|amount|date |paid | |=-+--------+------+----------+----=| |1 |Ada |1250.5|15-03-2023|true | |2 |Grace |99.0 |02-11-2023|false| '--+--------+------+----------+-----' NB_LINE: 2
Le flux peut venir d'un autre composant, rangé dans globalMap : (java.io.InputStream) globalMap.get("in").
The stream can come from another component, stored in globalMap: (java.io.InputStream) globalMap.get("in").
L'exemple de base, lancé cette fois sans arguments JVM, sur une machine Windows en français : The basic example, run this time without JVM arguments, on a Windows machine in French:
For input string: "1250,5" .--+--------+------+----------+-----. | tLogRow_1 | |=-+--------+------+----------+----=| |id|customer|amount|date |paid | |=-+--------+------+----------+----=| |2 |Grace |99.0 |02-11-2023|false| '--+--------+------+----------+-----' NB_LINE: 1
Défaut du modèle (tFileInputExcel_begin.javajet) : en xls, le texte d'une cellule nombre est écrit avec le séparateur décimal de la machine (1250,5), puis converti par Java, qui attend un point (ligne 551). Le séparateur de la machine est pourtant calculé (ligne 332, separatorChar_), mais jamais employé ; le xlsx, lui, en tient compte (lignes 1092 et 1456). La ligne d'Ada est perdue, comme toute ligne qui a un nombre décimal dans une colonne numérique. Les nombres entiers passent. Le texte d'une colonne String garde la virgule :
Defect of the template (tFileInputExcel_begin.javajet): in xls, the text of a number cell is written with the decimal separator of the machine (1250,5), then converted by Java, which expects a dot (line 551). The separator of the machine is computed (line 332, separatorChar_), but never used; the xlsx does take it into account (lines 1092 and 1456). The row of Ada is lost, like any row that has a decimal number in a numeric column. Whole numbers go through. The text of a String column keeps the comma:
.-----+--------+------+----------+-----. | tLogRow_1 | |=----+--------+------+----------+----=| |id |customer|amount|date |paid | |=----+--------+------+----------+----=| |1 |Ada |1250,5|15-03-2023|true | |2 |Grace |99 |02-11-2023|false| |Total|null |1349,5|null |null | '-----+--------+------+----------+-----' NB_LINE: 3
.-----+--------+------+----------------------------+-----. | tLogRow_2 | |=----+--------+------+----------------------------+----=| |id |customer|amount|date |paid | |=----+--------+------+----------------------------+----=| |1 |Ada |1250,5|Wed Mar 15 00:00:00 CET 2023|true | |2 |Grace |99 |Thu Nov 02 00:00:00 CET 2023|false| |Total|null |1349.5|null |null | '-----+--------+------+----------------------------+-----' NB_LINE: 3
À gauche le xls, à droite le xlsx, tout en String : en xlsx aussi, un nombre en String prend la virgule, mais le résultat d'une formule garde le point (1349.5).
On the left the xls, on the right the xlsx, all as String: in xlsx too, a number as String takes the comma, but the result of a formula keeps the dot (1349.5).
Même machine, Séparateur avancé coché, milliers " ", décimales "," :
Same machine, Advanced separator checked, thousands " ", decimals ",":
.--+--------+------+----------+-----. | tLogRow_1 | |=-+--------+------+----------+----=| |id|customer|amount|date |paid | |=-+--------+------+----------+----=| |1 |Ada |1250.5|15-03-2023|true | |2 |Grace |99.0 |02-11-2023|false| '--+--------+------+----------+-----' NB_LINE: 2
Le même réglage, JVM en anglais, donne la même sortie : la virgule est remplacée par un point, et un point déjà là reste. Non essayé avec des nombres affichés avec un séparateur de milliers. The same setting, JVM in English, gives the same output: the comma is replaced with a dot, and a dot already there stays. Not tried with numbers displayed with a thousands separator.
-Duser.language=en -Duser.country=US dans les arguments JVM (onglet Exécuter, Paramètres avancés), comme pour les exemples de cette page.
Run the job with the JVM in English: -Duser.language=en -Duser.country=US in the JVM arguments (Run tab, Advanced settings), as for the examples of this page.
.xlsx et cochez xlsx : la langue de la machine n'y change rien pour les colonnes numériques.
Save the workbook as .xlsx and check xlsx: the language of the machine changes nothing for the numeric columns.
Le nom du job est remplacé par MyJob, le dossier des classeurs par C:\data ; les traces d'exception sont abrégées. Sauf mention, le job s'arrête avec le code de sortie 1. La fin des messages de fichier vient de Windows, dans sa langue.
The job name is replaced with MyJob, the folder of the workbooks with C:\data; exception traces are shortened. Unless stated, the job stops with exit code 1. The end of the file messages comes from Windows, in its language.
Feuille "2025", que le classeur n'a pas :
Sheet "2025", which the workbook does not have:
Exception in component tFileInputExcel_1 (MyJob) java.lang.RuntimeException: Special sheets not exist! at demo.myjob_0_1.MyJob.tFileInputExcel_1Process(MyJob.java:1233) …
L'exemple du lien Reject en xls, Arrêter en cas d'erreur coché : la première ligne arrête le job. The Reject link example in xls, Die on error checked: the first row stops the job.
Exception in component tFileInputExcel_1 (MyJob) java.lang.RuntimeException: The cell format is not Date in ( Row. 1 and ColumnNum. 4 ) at demo.myjob_0_1.MyJob.tFileInputExcel_1Process(MyJob.java:1251) …
missing.xls, puis missing.xlsx en mode utilisateur :
missing.xls, then missing.xlsx in user mode:
Exception in component tFileInputExcel_1 (MyJob) java.io.FileNotFoundException: C:\data\missing.xls (Le fichier spécifié est introuvable) …
Exception in component tFileInputExcel_1 (MyJob) java.io.FileNotFoundException: C:\data\missing.xlsx at org.apache.poi.ss.usermodel.WorkbookFactory.create(WorkbookFactory.java:317) …
missing.xlsx en mode événement, Arrêter en cas d'erreur décoché : un message, aucune ligne, et le job finit avec le code 0.
missing.xlsx in event mode, Die on error unchecked: one message, no row, and the job ends with exit code 0.
org.apache.poi.openxml4j.exceptions.InvalidOperationException: Can't open the specified file input stream from file: 'C:\data\missing.xlsx' .--+--------+------+----+----. | tLogRow_1 | |=-+--------+------+----+---=| |id|customer|amount|date|paid| |=-+--------+------+----+---=| '--+--------+------+----+----' NB_LINE: 0
En mode événement, le classeur est lu par un autre fil d'exécution, dont l'erreur n'est relevée qu'à la fin ; elle n'arrête le job qu'avec Arrêter en cas d'erreur coché : In event mode, the workbook is read by another thread, whose error is only picked up at the end; it only stops the job with Die on error checked:
Exception in component tFileInputExcel_1 (MyJob) java.util.concurrent.ExecutionException: org.apache.poi.openxml4j.exceptions.InvalidOperationException: Can't open the specified file input stream from file: 'C:\data\missing.xlsx' at java.base/java.util.concurrent.FutureTask.report(FutureTask.java:122) at java.base/java.util.concurrent.FutureTask.get(FutureTask.java:191) at com.talend.excel.xssf.event.ExcelReader.handleException(ExcelReader.java:141) … Caused by: java.io.FileNotFoundException: C:\data\missing.xlsx (Le fichier spécifié est introuvable) …
orders.xlsx avec xlsx décoché, puis orders.xls avec xlsx coché, en mode utilisateur :
orders.xlsx with xlsx unchecked, then orders.xls with xlsx checked, in user mode:
Exception in component tFileInputExcel_1 (MyJob) jxl.read.biff.BiffException: Unable to recognize OLE stream at jxl.read.biff.CompoundFile.<init>(CompoundFile.java:116) …
Exception in component tFileInputExcel_1 (MyJob) java.lang.ClassCastException: class org.apache.poi.hssf.usermodel.HSSFWorkbook cannot be cast to class org.apache.poi.xssf.usermodel.XSSFWorkbook (…) …
En mode événement, le .xls donne un message (OLE2NotOfficeXmlFileException: The supplied data appears to be in the OLE2 Format…), aucune ligne, et le job continue, comme pour un fichier absent.
In event mode, the .xls gives a message (OLE2NotOfficeXmlFileException: The supplied data appears to be in the OLE2 Format…), no row, and the job goes on, as for a missing file.
secret.xlsx, Mot de passe vide, mode utilisateur :
secret.xlsx, empty Password, user mode:
Exception in component tFileInputExcel_1 (MyJob) org.apache.poi.EncryptedDocumentException: The supplied spreadsheet is protected, but no password was supplied at org.apache.poi.poifs.filesystem.DocumentFactoryHelper.getDecryptedStream(DocumentFactoryHelper.java:90) at org.apache.poi.ss.usermodel.WorkbookFactory.create(WorkbookFactory.java:146) …
Dès que plusieurs feuilles sont lues, cochez Affecte chaque feuille si chacune a ses titres ou son total ; sinon, ils arrivent comme des données. Le mode événement n'a pas cette case : préférez-y un composant par feuille. As soon as several sheets are read, check Affect each sheet if each one has its titles or its total; otherwise, they arrive as data. The event mode does not have this box: prefer one component per sheet there.
Par défaut, le xls lit le nombre tel que le format de la cellule l'affiche : un montant au format 0.00 perd ses décimales suivantes, même dans une colonne Double. Cochez Lire les valeurs réelles pour les nombres pour la valeur enregistrée.
By default, the xls reads the number as the cell format displays it: an amount in the 0.00 format loses its further decimals, even in a Double column. Check Read real values for numbers for the stored value.
En xls et en xlsx mode utilisateur, tout le classeur est chargé en mémoire avant la première ligne. Pour un gros xlsx, le mode événement lit au fil du fichier, avec ses limites : pas de pied de page, en-tête sur la première feuille seulement, Dernière colonne ignorée, CURRENT_SHEET nul, erreurs de lecture non bloquantes sans Arrêter en cas d'erreur. In xls and in xlsx user mode, the whole workbook is loaded into memory before the first row. For a large xlsx, the event mode reads along the file, with its limits: no footer, header on the first sheet only, Last column ignored, CURRENT_SHEET null, reading errors not blocking without Die on error.
Une formule donne le résultat enregistré dans le classeur, sans le recalculer : Excel l'enregistre, mais un classeur écrit par un autre programme doit avoir été calculé par lui. En xls, une colonne Date n'accepte que des cellules date ; une date écrite en texte se lit en String, puis se convertit dans un tMap. A formula gives the result stored in the workbook, without computing it again: Excel stores it, but a workbook written by another program must have been computed by it. In xls, a Date column only accepts date cells; a date written as text is read as String, then converted in a tMap.
tFileOutputExcel · écrire un classeur Excelwrite an Excel workbooktFileInputDelimited · lire un CSV exporté d'Excelread a CSV exported from ExceltFileList · lire tous les classeurs d'un dossierread all the workbooks of a foldertFileExist · tester si le classeur est là avant de le liretest whether the workbook is there before reading ittSchemaComplianceCheck · contrôler des colonnes lues en Stringcheck columns read as StringtConvertType · convertir des colonnes lues en Stringconvert columns read as StringtJavaRow · ajouter le nom de la feuille à chaque ligneadd the sheet name to each rowtLogRow · afficher les lignes luesdisplay the rows read