ComposantsComponents › TraitementProcessing
Change le type des colonnes d'un flux : du texte en nombre, en date, en BigDecimal…, ou l'inverse. Une ligne dont une valeur ne se convertit pas part par le lien Rejects avec un code et un message d'erreur, est écartée, ou arrête le job, selon le réglage. Changes the type of the columns of a flow: text to number, to date, to BigDecimal…, or the other way. A row with a value that does not convert leaves through the Rejects link with an error code and message, is dropped, or stops the job, depending on the setting.
EntréeInput
Main un flux, obligatoireone flow, required
SortieOutput
Main les lignes convertiesthe converted rows
Rejects facultatif : les lignes en erreur, avec errorCode et errorMessageoptional: the rows in error, with errorCode and errorMessage
Déclencheurs en sortieOutput triggers
On Component Ok On Component Error Run if
Le cas courant : un fichier lu en texte (toutes les colonnes String), converti avant d'aller dans une base aux colonnes typées. Les valeurs fausses partent dans un fichier de rejets au lieu d'arrêter le chargement. The common case: a file read as text (all String columns), converted before going to a database with typed columns. The wrong values go to a reject file instead of stopping the load.
"yyyy-MM-dd").
Give it its output schema: Sync columns copies the input one, then change the type of the columns to convert. For a Date, give the pattern of the text to read ("yyyy-MM-dd").
Les libellés sont ceux de l'onglet Composant ; le nom technique, en gris, est celui du paramètre dans le fichier du job. Le composant n'a pas de paramètres avancés propres. Labels are those of the Component tab; the technical name, in grey, is the parameter name in the job file. The component has no advanced settings of its own.
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| SchémaSchemaIN_SCHEMA | videempty | ToujoursAlways |
Les colonnes de sortie, avec leur type cible. Le lien Rejects a les mêmes colonnes, plus errorCode et errorMessage (String).
The output columns, with their target type. The Rejects link has the same columns, plus errorCode and errorMessage (String).
|
| Conversion automatiqueAuto CastAUTOCAST | NonNo | ToujoursAlways | Chaque colonne de sortie reçoit la colonne d'entrée de même nom, convertie. Une colonne de sortie sans colonne d'entrée de même nom reste vide. Each output column gets the input column of the same name, converted. An output column without an input column of the same name stays empty. |
| Conversion manuelleManual CastMANUALTABLE | videempty | Conversion automatique décochéeAuto Cast unchecked | Une ligne par conversion : Position de la colonne d'entrée (la colonne lue, choisie par son nom) et Colonne de sortie. Seules ces colonnes de sortie sont remplies, les autres restent vides. One line per conversion: Input column position (the column read, chosen by its name) and Output column. Only these output columns are filled, the others stay empty. |
| Configurer les valeurs vides à Null avant conversionSet empty values to Null before convertingEMPTYTONULL | NonNo | ToujoursAlways |
Une valeur vide ("") d'une colonne String devient nulle avant la conversion : elle donne une sortie nulle au lieu d'une erreur.
An empty value ("") of a String column becomes null before the conversion: it gives a null output instead of an error.
|
| Arrêter en cas d'erreurDie on errorDIEONERROR | NonNo | ToujoursAlways | La première valeur qui ne se convertit pas arrête le job. Cochée, le lien Rejects n'est plus proposé. Décochée et sans lien Rejects, la ligne en erreur est écartée et son message écrit sur la sortie d'erreur. The first value that does not convert stops the job. Checked, the Rejects link is no longer offered. Unchecked and without a Rejects link, the row in error is dropped and its message written on the error output. |
Les conversions sont celles de la routine système TypeConvert. Une valeur nulle donne une sortie nulle.
The conversions are those of the TypeConvert system routine. A null value gives a null output.
"12.50" passe en BigDecimal ; "", " 4" (espace) ou "abc" sont des erreurs ; un Integer n'accepte pas de décimales.
Text → number: the strict Java format. "12.50" goes to BigDecimal; "", " 4" (space) or "abc" are errors; an Integer accepts no decimals.
true ou false, sans tenir compte de la casse ; tout autre texte est une erreur.
Text → Boolean: true or false, ignoring the case; any other text is an error.
Can't support convert….
Impossible conversion (Boolean → Date…): error with code 1, Can't support convert….
errorCode : 1 pour une conversion que la routine ne connaît pas, 2 pour toute autre erreur (format…).
errorCode: 1 for a conversion the routine does not know, 2 for any other error (format…).
errorMessage : colonne:message pour chaque colonne en erreur, séparés par ;, puis - Line: et le rang de la ligne, compté à partir de 0.
errorMessage: column:message for each column in error, separated by ;, then - Line: and the rank of the row, counted from 0.
NB_LINE (Integer, disponible après le composant) : les lignes reçues, rejetées comprises. Le code généré range aussi le message de la dernière erreur de conversion dans tConvertType_1_ERROR_MESSAGE.
NB_LINE (Integer, available after the component): the rows received, rejected ones included. The generated code also stores the message of the last conversion error in tConvertType_1_ERROR_MESSAGE.
((Integer) globalMap.get("tConvertType_1_NB_LINE"))
Un tFixedFlowInput envoie trois lignes en texte au tConvertType, en conversion automatique. Schéma de sortie : id Integer, amount BigDecimal, born Date ("yyyy-MM-dd"), qty Integer. Le lien Main mène à tLogRow_1, le lien Rejects à tLogRow_2, tous deux avec leur nom unique devant chaque ligne. Un tJava relié par On Subjob Ok affiche NB_LINE. Sorties copiées depuis une exécution du job ; dans les erreurs, le nom du job est remplacé par MyJob et les traces sont abrégées.
A tFixedFlowInput sends three text rows to the tConvertType, in auto cast. Output schema: id Integer, amount BigDecimal, born Date ("yyyy-MM-dd"), qty Integer. The Main link leads to tLogRow_1, the Rejects link to tLogRow_2, both with their unique name in front of each row. A tJava connected with On Subjob Ok prints NB_LINE. Outputs copied from a run of the job; in the errors, the job name is replaced with MyJob and the traces are shortened.
| idString | amountString | bornString | qtyString |
|---|---|---|---|
| "1" | "12.50" | "1815-12-10" | "3" |
| "2" | "8" | "1906-12-09" | "" |
| "3" | "abc" | "" | " 4" |
La ligne 2 est rejetée pour son qty vide, la ligne 3 pour amount et qty. Le born vide de la ligne 3 n'est pas une erreur.
Row 2 is rejected for its empty qty, row 3 for amount and qty. The empty born of row 3 is not an error.
[tLogRow_1] 1|12.50|1815-12-10|3 [tLogRow_2] 2|8|1906-12-09||2|qty:For input string: "" - Line: 1 [tLogRow_2] 3||||2|amount:Character a is neither a decimal digit number, decimal point, nor "e" notation exponential mark.;qty:For input string: " 4" - Line: 2 NB_LINE=3
Même job, Configurer les valeurs vides à Null avant conversion cochée : le qty vide de la ligne 2 devient nul, la ligne passe.
Same job, Set empty values to Null before converting checked: the empty qty of row 2 becomes null, the row goes through.
[tLogRow_1] 1|12.50|1815-12-10|3 [tLogRow_1] 2|8|1906-12-09| [tLogRow_2] 3||||2|amount:Character a is neither a decimal digit number, decimal point, nor "e" notation exponential mark.;qty:For input string: " 4" - Line: 2 NB_LINE=3
Les lignes 2 et 3 sont écartées. Le job se termine normalement ; seule la sortie d'erreur garde une trace, un message par valeur, sans colonne ni ligne. Rows 2 and 3 are dropped. The job ends normally; only the error output keeps a trace, one message per value, without column or row.
Sortie standardStandard output
1|12.50|1815-12-10|3 NB_LINE=3
Sortie d'erreurError output
For input string: "" Character a is neither a decimal digit number, decimal point, nor "e" notation exponential mark. For input string: " 4"
La ligne 1 est déjà passée ; la ligne 2 arrête le job (code de sortie 1). Row 1 has already gone through; row 2 stops the job (exit code 1).
1|12.50|1815-12-10|3 Exception in component tConvertType_1 (MyJob) java.lang.NumberFormatException: For input string: "" at java.base/java.lang.NumberFormatException.forInputString(NumberFormatException.java:67) … at routines.system.TypeConvert.String2Integer(TypeConvert.java:4506) …
Les lignes 1 et 2. Schéma de sortie : id Integer, price Double ; une seule conversion : amount → price. id n'est pas dans le tableau : il reste vide.
Rows 1 and 2. Output schema: id Integer, price Double; a single conversion: amount → price. id is not in the table: it stays empty.
|12.5 |8.0
Sans lien Rejects ni Arrêter en cas d'erreur, une ligne en erreur disparaît et le job se termine sans erreur. Reliez toujours le lien Rejects, ou cochez l'arrêt, sur des données qui comptent. Without a Rejects link or Die on error, a row in error disappears and the job ends without error. Always connect the Rejects link, or check die on error, on data that matters.
" 4" ne devient pas un nombre, "" non plus. Cochez Configurer les valeurs vides à Null pour les vides, et retirez les espaces avant, par exemple dans un tJavaRow avec trim().
" 4" does not become a number, nor does "". Check Set empty values to Null for the empty ones, and remove the spaces first, for example in a tJavaRow with trim().
Dans errorMessage, Line: 1 désigne la deuxième ligne reçue par le composant.
In errorMessage, Line: 1 means the second row received by the component.
La conversion automatique associe les colonnes par leur nom : renommer une colonne de sortie la laisse vide. Pour renommer en convertissant, passez par la conversion manuelle, en y listant toutes les colonnes. Auto cast matches the columns by their name: renaming an output column leaves it empty. To rename while converting, use the manual cast, listing all the columns in it.
tReplace · nettoyer le texte avant de le convertirclean the text before converting ittFilterRow · garder les lignes qui remplissent des conditionskeep the rows that meet conditionstJavaRow · une conversion sur mesure, en Javaa custom conversion, in JavatLogRow · afficher les lignes d'un fluxdisplay the rows of a flow