ComposantsComponents

ComposantsComponents › Traitement › ChampsProcessing › Fields

tExtractPositionalFields

tExtractPositionalFields

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

UtilisationUsage

row1 (Main) row2 (Main) row3 (Reject) tFileInputFullRow_1 tExtractPositionalFields_1 tFileOutputDelimited_1 tLogRow_1

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.

  1. Reliez la sortie d'un composant au tExtractPositionalFields, puis le composant à la suite, et choisissez le Champ à découper. Connect the output of a component to the tExtractPositionalFields, then the component to the next one, and choose the Field to split.
  2. Modifier le schéma : les colonnes de l'entrée à garder, sous le même nom, puis une colonne par morceau, dans l'ordre. Edit schema: the input columns to keep, under the same name, then one column per piece, in order.
  3. Écrivez le Modèle : les largeurs séparées par des virgules, sans espace, la dernière pouvant être * (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.
  4. En général, cochez Supprimer les espaces… (Paramètres avancés) : les morceaux gardent sinon leurs espaces de remplissage, et un nombre entouré d'espaces ne se convertit pas. Usually, check Trim Column (Advanced settings): the pieces otherwise keep their padding spaces, and a number surrounded by spaces does not convert.

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. 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ètres avancésAdvanced settings

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

Le lien RejectThe Reject link

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.

Variables globalesGlobal variables

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

ExemplesExamples

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

Modèle "3,8,*" et données trop courtesPattern "3,8,*" and data too short

EntréeInput

id line
1"001Ada London"
2"002Bob"
3"003Charlie "
4null
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

Vérifier la structureCheck the structure

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

Une conversion qui échoueA failing conversion

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

PersonnaliserCustomize

Valeurs de lineValues of line

00012Ada.......--FR--
00007Margaret..-UK---
00000Zero......--DE--

Formats

ColonneColumn TailleSize RemplissagePadding AlignementAlignment
num (Integer)5'0'DroiteRight
name10'.'GaucheLeft
country6'-'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--]

DatesDates

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

Séparateurs de nombresNumber separators

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]

Pièges et conseilsPitfalls and tips

* 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

Le champ découpé n'est pas recopiéThe split field is not copied

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 zéro devient nulA zero becomes null

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.

Un espace dans le modèleA space in the pattern

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

Formats videEmpty Formats

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

Trop court, trop longToo short, too long

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.

Lire un fichier positionnelRead a positional file

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.

« Line » n'est pas le numéro de ligne“Line” is not the row number

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.

Voir aussiSee also