ComposantsComponents › Traitement › ChampsProcessing › Fields
Découpe une colonne de texte à positions fixes (001Ada London) en plusieurs colonnes, d'après une liste de largeurs : "3,8,*" donne les caractères 1 à 3, 4 à 11, puis le reste. Chaque morceau est converti dans le type de sa colonne. En mode Personnaliser, chaque colonne a sa largeur, son caractère de remplissage et son alignement. Une ligne d'entrée donne une ligne de sortie ; une ligne en erreur peut partir par un lien Reject.
Splits a column of fixed-position text (001Ada London) into several columns, according to a list of widths: "3,8,*" gives characters 1 to 3, 4 to 11, then the rest. Each piece is converted to the type of its column. In Customize mode, each column has its width, its padding character and its alignment. One input row gives one output row; a row in error can leave through a Reject link.
EntréeInput
Main un fluxone flow
SortieOutput
Main un flux, obligatoireone flow, required
Reject facultatif, Arrêter en cas d'erreur décoché : lignes en erreuroptional, Die on error unchecked: rows in error
Déclencheurs en sortieOutput triggers
On Component Ok On Component Error Run if
Les largeurs se comptent en caractères. Les colonnes de sortie qui portent le nom d'une colonne d'entrée sont recopiées, sauf le champ découpé lui-même ; les autres, les colonnes à remplir, reçoivent les morceaux dans leur ordre. Si la valeur est trop courte, le morceau qui commence au-delà de sa fin est absent (null) ; ce qui dépasse la dernière largeur est ignoré.
Widths are counted in characters. The output columns that have the name of an input column are copied, except the split field itself; the others, the columns to fill, get the pieces in their order. If the value is too short, a piece that starts beyond its end is missing (null); what goes beyond the last width is ignored.
* (le reste). Ou cochez Personnaliser et remplissez Formats.
Write the Pattern: the widths separated by commas, without spaces, the last one can be * (the rest). Or check Customize and fill Formats.
Les libellés sont ceux de l'onglet Composant ; le nom technique, en gris, est celui du paramètre dans le fichier du job. Labels are those of the Component tab; the technical name, in grey, is the parameter name in the job file.
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| ChampFieldFIELD | 1re colonne d'entrée1st input column | ToujoursAlways | La colonne String du flux entrant à découper. The String column of the incoming flow to split. |
| Ignorer les nulls dans les données sourceIgnore NULL as the source dataIGNORE_SOURCE_NULL | OuiYes | ToujoursAlways |
Coché : une ligne dont le champ est nul ne produit rien et n'est pas comptée. Décoché : la nulle est lue comme "" ; la 1re colonne à remplir reçoit "", les suivantes null (exemple).
Checked: a row whose field is null produces nothing and is not counted. Unchecked: the null is read as ""; the 1st column to fill gets "", the following ones null (example).
|
| PersonnaliserCustomizeADVANCED_OPTION | NonNo | ToujoursAlways | Remplace le Modèle par la table Formats. Replaces the Pattern with the Formats table. |
| ModèlePatternPATTERN | "5,4,5" |
Personnaliser décochéCustomize unchecked |
Une chaîne Java : les largeurs des colonnes à remplir, dans l'ordre, séparées par des virgules. * prend tout le reste de la valeur ; placé ailleurs qu'en dernier, il avale les morceaux suivants. Un espace ("3, 8") arrête le job avant la première ligne. Une colonne à remplir sans largeur reste nulle.
A Java string: the widths of the columns to fill, in order, separated by commas. * takes all the rest of the value; placed elsewhere than last, it swallows the following pieces. A space ("3, 8") stops the job before the first row. A column to fill without a width stays null.
|
| FormatsFORMATS | videempty | Personnaliser cochéCustomize checked |
Une ligne par colonne à remplir, dans l'ordre des positions : Colonne, Taille (10 ; * seulement sur la dernière ligne), Caractère de remplissage (' ') et Alignement (Gauche : le remplissage est retiré à droite ; Droite : à gauche ; Centre : des deux côtés). Une colonne absente de la table reste nulle.
One line per column to fill, in the order of the positions: Column, Size (10; * only on the last line), Padding char (' ') and Alignment (Left: the padding is removed on the right; Right: on the left; Center: on both sides). A column missing from the table stays null.
|
| Arrêter en cas d'erreurDie on errorDIE_ON_ERROR | NonNo | ToujoursAlways | Coché : la première erreur arrête le job. Décoché (défaut) : la ligne en erreur part par le lien Reject ; sans lien, son message est écrit sur la sortie d'erreur et elle est perdue. Le lien Reject n'est proposé que décoché. Checked: the first error stops the job. Unchecked (default): the row in error leaves through the Reject link; without a link, its message is written on the error output and it is lost. The Reject link is only offered when unchecked. |
| SchémaSchemaSCHEMA | videempty | ToujoursAlways |
Les colonnes de sortie. Celles qui ont le nom d'une colonne d'entrée sont recopiées ; une colonne qui a le nom du Champ reste nulle (Pièges). Un morceau vide donne "" à une colonne String, et à une autre sa valeur par défaut du schéma, sinon null (0 pour un type non nullable).
The output columns. Those with the name of an input column are copied; a column with the name of the Field stays null (Pitfalls). An empty piece gives "" to a String column, and to another one its schema default value, otherwise null (0 for a non-nullable type).
|
| ParamètreSetting | DéfautDefault | VisibleShown | Description |
|---|---|---|---|
| Séparateur avancé (pour les nombres)Advanced separator (for numbers)ADVANCED_SEPARATOR | NonNo | ToujoursAlways |
Les colonnes numériques sont lues avec les deux séparateurs suivants (1.250,50).
The number columns are read with the next two separators (1.250,50).
|
| Séparateur de milliersThousands separatorTHOUSANDS_SEPARATOR | "," |
Séparateur avancé cochéAdvanced separator checked | Un caractère, retiré avant la conversion. One character, removed before the conversion. |
| Séparateur décimalDecimal separatorDECIMAL_SEPARATOR | "." |
Séparateur avancé cochéAdvanced separator checked | Un caractère, lu comme la virgule décimale. One character, read as the decimal point. |
| Supprimer les espaces en début et en fin de champ dans la colonneTrim ColumnTRIM | NonNo | ToujoursAlways | Retire les espaces autour de chaque morceau, avant le caractère de remplissage et la conversion. Removes the spaces around each piece, before the padding character and the conversion. |
| Vérifier la structure de chaque ligne par rapport au schémaCheck each row structure against schemaCHECK_FIELDS_NUM | NonNo | ToujoursAlways |
Une valeur trop courte pour atteindre le début d'un morceau est en erreur, Column(s) missing (exemple). Une valeur trop longue n'en est pas une. Coché, les dates sont aussi lues strictement (exemple).
A value too short to reach the start of a piece is in error, Column(s) missing (example). A value too long is not. Checked, dates are also read strictly (example).
|
Son schéma est celui de la sortie, suivi de errorCode et errorMessage. Une ligne rejetée garde les colonnes remplies avant l'erreur, dans l'ordre du schéma ; errorMessage vaut le message de Java suivi de - Line: n, le nombre de lignes déjà traitées par le composant, à partir de 0, sans les nulles ignorées. errorCode n'est jamais rempli.
Its schema is the output one, followed by errorCode and errorMessage. A rejected row keeps the columns filled before the error, in schema order; errorMessage is the Java message followed by - Line: n, the number of rows already processed by the component, from 0, without the ignored nulls. errorCode is never filled.
NB_LINE (Integer, après le composant) : les lignes sorties sans erreur. Le code généré range aussi le message de la dernière erreur dans ERROR_MESSAGE, que le composant ne déclare pas. NB_LINE (Integer, after the component): the rows sent without error. The generated code also stores the message of the last error in ERROR_MESSAGE, which the component does not declare.
((Integer) globalMap.get("tExtractPositionalFields_1_NB_LINE"))
((String) globalMap.get("tExtractPositionalFields_1_ERROR_MESSAGE"))
Un tFixedFlowInput envoie les lignes (id Integer, line String) ; la sortie va dans un tJavaRow qui écrit chaque valeur entre crochets (city=null : nulle ; city=[] : vide), ou dans un tLogRow en mode basique. Avec un lien Reject, il mène à tLogRow_2 et les tLogRow affichent leur nom. Un tJava relié par On Subjob Ok affiche les variables globales du composant. Sorties copiées depuis une exécution des jobs dans Talaxie (Java 21).
A tFixedFlowInput sends the rows (id Integer, line String); the output goes to a tJavaRow that writes each value between brackets (city=null: null; city=[]: empty), or to a tLogRow in basic mode. With a Reject link, it leads to tLogRow_2 and the tLogRow print their name. A tJava connected with On Subjob Ok prints the global variables of the component. Outputs copied from a run of the jobs in Talaxie (Java 21).
"3,8,*" et données trop courtesPattern "3,8,*" and data too shortEntréeInput
| id | line |
|---|---|
| 1 | "001Ada London" |
| 2 | "002Bob" |
| 3 | "003Charlie " |
| 4 | null |
| 5 | "04" |
Champ : line ; schéma de sortie id (recopiée), code, name, city (String).
Field: line; output schema id (copied), code, name, city (String).
SortieOutput
id=[1] code=[001] name=[Ada ] city=[London] id=[2] code=[002] name=[Bob] city=null id=[3] code=[003] name=[Charlie ] city=[] id=[5] code=[04] name=null city=null tExtractPositionalFields_1_NB_LINE = 4
Ligne 2 : name prend ce qui reste, et city, qui commencerait après la fin, est nulle. Ligne 3 : la valeur finit pile au début de city, qui reçoit "". Ligne 4, nulle : rien. Ligne 5 : seul code est rempli. Avec Supprimer les espaces…, name devient Ada et Charlie.
Row 2: name takes what remains, and city, which would start after the end, is null. Row 3: the value ends exactly at the start of city, which gets "". Row 4, null: nothing. Row 5: only code is filled. With Trim Column, name becomes Ada and Charlie.
Ignorer les nulls dans les données source décoché, la ligne 4 sort aussi : Ignore NULL as the source data unchecked, row 4 goes out too:
id=[4] code=[] name=null city=null
Mêmes lignes, Vérifier la structure de chaque ligne par rapport au schéma coché, lien Reject. Les lignes 2 et 5, qui n'atteignent pas tous les morceaux, sont rejetées ; la ligne 3 passe (city vide).
Same rows, Check each row structure against schema checked, Reject link. Rows 2 and 5, which do not reach all the pieces, are rejected; row 3 passes (empty city).
[tLogRow_1] 1|001|Ada |London [tLogRow_2] 2|002|Bob|||Column(s) missing - Line: 1 [tLogRow_1] 3|003|Charlie | [tLogRow_2] 5|04||||Column(s) missing - Line: 3 tExtractPositionalFields_1_ERROR_MESSAGE = Column(s) missing tExtractPositionalFields_1_NB_LINE = 2
Lignes 001Ada London, 0X2Bob Paris, 003Cy Nice ; code en Integer ; Supprimer les espaces… coché ; lien Reject. 0X2 est rejetée ; ses colonnes après code ne sont pas encore remplies.
Rows 001Ada London, 0X2Bob Paris, 003Cy Nice; code as Integer; Trim Column checked; Reject link. 0X2 is rejected; its columns after code are not filled yet.
[tLogRow_1] 1|1|Ada|London [tLogRow_2] 2|||||For input string: "0X2" - Line: 1 [tLogRow_1] 3|3|Cy|Nice tExtractPositionalFields_1_ERROR_MESSAGE = For input string: "0X2" tExtractPositionalFields_1_NB_LINE = 2
Sans lien Reject, le message part sur la sortie d'erreur et la ligne est perdue : Without a Reject link, the message goes to the error output and the row is lost:
1|1|Ada|London 3|3|Cy|Nice For input string: "0X2" tExtractPositionalFields_1_ERROR_MESSAGE = For input string: "0X2" tExtractPositionalFields_1_NB_LINE = 2
Avec Arrêter en cas d'erreur (nom du job remplacé par MyJob, trace abrégée) :
With Die on error (job name replaced with MyJob, trace shortened):
1|1|Ada|London Exception in component tExtractPositionalFields_1 (MyJob) java.lang.NumberFormatException: For input string: "0X2" at java.base/java.lang.NumberFormatException.forInputString(NumberFormatException.java:67) at java.base/java.lang.Integer.parseInt(Integer.java:662) …
Valeurs de lineValues of line
00012Ada.......--FR-- 00007Margaret..-UK--- 00000Zero......--DE--
Formats
| ColonneColumn | TailleSize | RemplissagePadding | AlignementAlignment |
|---|---|---|---|
| num (Integer) | 5 | '0' | DroiteRight |
| name | 10 | '.' | GaucheLeft |
| country | 6 | '-' | CentreCenter |
SortieOutput
id=[1] num=[12] name=[Ada] country=[FR] id=[2] num=[7] name=[Margaret] country=[UK] id=[3] num=null name=[Zero] country=[DE] tExtractPositionalFields_1_NB_LINE = 3
Le remplissage est retiré selon l'alignement. 00000 perd tous ses zéros : le morceau devient vide, et num nulle (voir Pièges).
The padding is removed according to the alignment. 00000 loses all its zeros: the piece becomes empty, and num null (see Pitfalls).
Formats num 5 et rest * : rest prend le reste.
Formats num 5 and rest *: rest takes the rest.
id=[1] num=[12] rest=[Ada.......--FR--] id=[2] num=[7] rest=[Margaret..-UK---] id=[3] num=null rest=[Zero......--DE--]
Modèle "10,*" ; lignes 10-12-2020Ada et 32-01-2020Bob ; born de type Date, modèle "dd-MM-yyyy" ; lien Reject. Par défaut, le 32 janvier devient le 1er février :
Pattern "10,*"; rows 10-12-2020Ada and 32-01-2020Bob; born of type Date, pattern "dd-MM-yyyy"; Reject link. By default, January 32nd becomes February 1st:
[tLogRow_1] 1|10-12-2020|Ada [tLogRow_1] 2|01-02-2020|Bob
Avec Vérifier la structure…, la date est refusée : With Check each row structure…, the date is refused:
[tLogRow_1] 1|10-12-2020|Ada [tLogRow_2] 2||||Unparseable date: "32-01-2020" - Line: 1
Modèle "1,*" ; lignes A1.250,50 et B 12,05 ; amount en BigDecimal ; Supprimer les espaces… et Séparateur avancé (milliers ".", décimal ",") cochés :
Pattern "1,*"; rows A1.250,50 and B 12,05; amount as BigDecimal; Trim Column and Advanced separator (thousands ".", decimal ",") checked:
id=[1] code=[A] amount=[1250.50] id=[2] code=[B] amount=[12.05]
* ailleurs qu'en dernier* elsewhere than last
En mode Personnaliser, une taille * suivie d'une autre ligne empêche la compilation (défaut du modèle de Talaxie, tExtractPositionalFields_begin.javajet, qui oublie la virgule après -1). Première erreur, chemin abrégé, nom du job remplacé par MyJob :
In Customize mode, a * size followed by another line prevents compilation (defect of the Talaxie template, tExtractPositionalFields_begin.javajet, which forgets the comma after -1). First error, path shortened, job name replaced with MyJob:
MyJob.java:1219: error: '}' expected -1 ^ …
Avec un Modèle, "3,*,4" compile, mais le * avale la suite et la colonne d'après reste nulle :
With a Pattern, "3,*,4" compiles, but the * swallows the rest and the next column stays null:
id=[1] code=[001] name=[Ada London] city=null
Contrairement au tExtractDelimitedFields, une colonne de sortie qui porte le nom du Champ n'est ni recopiée ni remplie : elle reste nulle. Modèle "3,8", sortie id, line, code, name :
Unlike the tExtractDelimitedFields, an output column with the name of the Field is neither copied nor filled: it stays null. Pattern "3,8", output id, line, code, name:
id=[1] line=null code=[001] name=[Ada ]
Pour garder la valeur d'origine, copiez-la avant dans une autre colonne (tMap, tJavaRow). To keep the original value, copy it first into another column (tMap, tJavaRow).
Un nombre complété par des '0' à gauche perd tous ses zéros s'il vaut 0 : 00000 devient vide, puis null (exemple Personnaliser). Prenez le remplissage ' ' avec Supprimer les espaces… : Integer lit 00012 comme 12 et 00000 comme 0.
A number padded with '0' on the left loses all its zeros if it is 0: 00000 becomes empty, then null (Customize example). Take the ' ' padding with Trim Column: Integer reads 00012 as 12 and 00000 as 0.
"3, 8,*" : le job s'arrête avant la première ligne (nom du job remplacé, trace abrégée).
"3, 8,*": the job stops before the first row (job name replaced, trace shortened).
Exception in component tExtractPositionalFields_1 (MyJob) java.lang.NumberFormatException: For input string: " 8" at java.base/java.lang.NumberFormatException.forInputString(NumberFormatException.java:67) at java.base/java.lang.Integer.parseInt(Integer.java:648) at java.base/java.lang.Integer.valueOf(Integer.java:989) …
Le Studio signale une table Formats vide comme une erreur ; Talaxie 9.0.6 ne la signale pas (à partir de Talaxie 9.0.7, le composant porte une pastille rouge, comme dans le Studio). Personnaliser coché sans aucune ligne, le job tourne et toutes les colonnes à remplir restent nulles : The Studio reports an empty Formats table as an error; Talaxie 9.0.6 does not report it (from Talaxie 9.0.7, the component carries a red badge, as in the Studio). Customize checked without any line, the job runs and all the columns to fill stay null:
id=[1] num=null name=null country=null id=[2] num=null name=null country=null id=[3] num=null name=null country=null tExtractPositionalFields_1_NB_LINE = 3
Sans vérification, une valeur trop courte laisse ses derniers morceaux nuls (ou vides s'ils commencent pile à la fin), et ce qui dépasse la dernière largeur est perdu sans erreur, même avec la vérification. Terminez le modèle par * pour garder ce reste dans une colonne et le contrôler. Une colonne à remplir sans largeur dans le modèle ("3,8" pour trois colonnes) reste nulle.
Without the check, a value that is too short leaves its last pieces null (or empty if they start exactly at the end), and what goes beyond the last width is lost without error, even with the check. End the pattern with * to keep this rest in a column and check it. A column to fill without a width in the pattern ("3,8" for three columns) stays null.
Pour un fichier entier à positions fixes, le tFileInputPositional lit et découpe en une étape, et sait compter en octets. Le tExtractPositionalFields sert quand la colonne vient d'ailleurs, ou qu'une ligne contient plusieurs formats. For a whole fixed-position file, the tFileInputPositional reads and splits in one step, and can count in bytes. The tExtractPositionalFields is used when the column comes from elsewhere, or when a line holds several formats.
Dans le rejet, n compte à partir de 0 les lignes déjà traitées, sans les nulles ignorées (la 5e ligne donne Line: 3 quand la 4e est nulle). Gardez une colonne d'identifiant dans la sortie : elle passe dans le rejet.
In the reject, n counts from 0 the rows already processed, without the ignored nulls (the 5th row gives Line: 3 when the 4th is null). Keep an identifier column in the output: it goes into the reject.
tExtractDelimitedFields · découper une colonne délimitéesplit a delimited columntExtractRegexFields · découper une colonne avec une expression régulièresplit a column with a regular expressiontFileInputPositional · lire un fichier à positions fixesread a fixed-position filetFileInputFullRow · lire chaque ligne d'un fichier en une seule colonneread each line of a file into a single columntLogRow · afficher les lignes d'un fluxdisplay the rows of a flow