ComposantsComponents

ComposantsComponents › TraitementProcessing

tConvertType

tConvertType

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

UtilisationUsage

row1 (Main) row2 (Main) row3 (Rejects) tFileInputDelimited_1 tConvertType_1 tDBOutput_1 tFileOutputDelimited_1

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.

  1. Reliez la sortie d'un composant au tConvertType, puis le tConvertType au composant suivant. Connect the output of a component to the tConvertType, then the tConvertType to the next component.
  2. Donnez-lui son schéma de sortie : Synchroniser les colonnes recopie celui de l'entrée, puis changez le type des colonnes à convertir. Pour une Date, indiquez le modèle du texte à lire ("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").
  3. Cochez Conversion automatique pour convertir chaque colonne vers la colonne de sortie de même nom, ou remplissez le tableau Conversion manuelle. Check Auto Cast to convert each column to the output column of the same name, or fill the Manual Cast table.
  4. Pour garder les lignes en erreur, reliez Ligne › Rejects à un composant de sortie. To keep the rows in error, connect Row › Rejects to an output component.

Paramètres simplesBasic settings

Les libellés sont ceux de l'onglet Composant ; le nom technique, en gris, est celui du paramètre dans le fichier du job. Le composant n'a pas de 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.

Règles de conversionConversion rules

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.

  • Texte → nombre : le format Java strict. "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.
  • Texte → Date : lu avec le modèle de la colonne de sortie ; un texte vide donne une date nulle, sans erreur. Text → Date: read with the pattern of the output column; an empty text gives a null date, without error.
  • Date → texte : écrit avec le modèle de la colonne d'entrée. Date → text: written with the pattern of the input column.
  • Texte → Boolean : 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.
  • Décimal → entier : la partie décimale est coupée, sans arrondi. Decimal → whole number: the decimal part is cut, without rounding.
  • Conversion impossible (Boolean → Date…) : erreur de code 1, Can't support convert…. Impossible conversion (Boolean → Date…): error with code 1, Can't support convert….

La ligne rejetéeThe rejected row

  • Les colonnes converties sans erreur ont leur valeur, celles en erreur sont vides. The columns converted without error have their value, those in error are empty.
  • 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.

Variables globalesGlobal variables

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

ExemplesExamples

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.

row1 (Main) row2 (Main) row3 (Rejects) tFixedFlowInput_1 tConvertType_1 tLogRow_1 tLogRow_2
idString amountString bornString qtyString
"1""12.50""1815-12-10""3"
"2""8""1906-12-09"""
"3""abc"""" 4"

Avec le lien RejectsWith the Rejects link

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

Valeurs vides à NullEmpty values to Null

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

Sans lien RejectsWithout a Rejects link

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"

Arrêter en cas d'erreurDie on error

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

Conversion manuelleManual cast

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

Pièges et conseilsPitfalls and tips

Des lignes perdues sans bruitRows lost silently

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.

Espaces et textes videsSpaces and empty texts

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

Le numéro de ligne commence à 0The row number starts at 0

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.

Noms identiques en conversion automatiqueSame names in auto cast

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.

Voir aussiSee also