ComposantsComponents

ComposantsComponents › Traitement › ChampsProcessing › Fields

tSplitRow

tSplitRow

Traitement › ChampsProcessing › Fields

Scinde une ligne en plusieurs lignes : le Mapping des colonnes est un tableau dont chaque ligne décrit une ligne de sortie, une expression Java par colonne. Avec trois lignes dans le tableau, chaque ligne d'entrée en donne trois. Il sert à « dépivoter » des colonnes répétées (home, work, mobile) en lignes type / valeur. Splits one row into several rows: the Columns mapping is a table whose every line describes an output row, one Java expression per column. With three lines in the table, each input row gives three. It is used to “unpivot” repeated columns (home, work, mobile) into type / value rows.

EntréeInput

Main un flux, obligatoireone flow, required

SortieOutput

Main un flux, obligatoire : une ligne par ligne du tableauone flow, required: one row per table line

Déclencheurs en sortieOutput triggers

On Component Ok On Component Error Run if

UtilisationUsage

row1 (Main) row2 (Main) tFileInputDelimited_1 tSplitRow_1 tFileOutputDelimited_1

Pour chaque ligne entrante, le composant calcule d'abord toutes les lignes du tableau, dans l'ordre, puis les envoie l'une après l'autre. Les expressions lisent la ligne d'entrée par le nom de son lien (row1.id). For each incoming row, the component first computes all the lines of the table, in order, then sends them one after the other. The expressions read the input row through the name of its link (row1.id).

  1. Reliez la sortie d'un composant au tSplitRow, puis le tSplitRow au composant suivant. Connect the output of a component to the tSplitRow, then the tSplitRow to the next component.
  2. Modifier le schéma : les colonnes des lignes de sortie (par exemple id, kind, value). Le tableau prend une colonne par colonne du schéma. Edit schema: the columns of the output rows (for instance id, kind, value). The table takes one column per schema column.
  3. Ajoutez une ligne au Mapping des colonnes par ligne de sortie voulue, et remplissez chaque cellule d'une expression Java du type de la colonne : row1.id, "home", row1.home… Add one line to the Columns mapping per wanted output row, and fill every cell with a Java expression of the column type: row1.id, "home", row1.home…

ParamètresSettings

Tous dans les Paramètres simples ; le composant n'a pas de paramètres avancés. Le nom technique, en gris, est celui du paramètre dans le fichier du job. All in the Basic settings; the component has no advanced settings. The technical name, in grey, is the parameter name in the job file.

ParamètreSetting DéfautDefault VisibleShown Description
PropriétéPropertyPROPERTY videempty ToujoursAlways Le schéma de sortie (bouton Modifier le schéma), libre : il ne reprend pas celui de l'entrée. The output schema (Edit schema button), free: it does not take the input one.
Mapping des colonnesColumns mappingCOL_MAPPING videempty ToujoursAlways Une colonne par colonne du schéma, une ligne par ligne de sortie. Chaque cellule est une expression Java recopiée telle quelle dans le code : du texte se met entre guillemets, une cellule vide empêche la compilation. L'ordre des lignes du tableau est l'ordre de sortie. One column per schema column, one line per output row. Each cell is a Java expression copied as it is into the code: text goes between quotes, an empty cell prevents compilation. The order of the table lines is the output order.

Variable globaleGlobal variable

NB_LINE (Integer, disponible après le composant) : le nombre de lignes de sortie, soit le nombre de lignes d'entrée multiplié par celui des lignes du tableau. NB_LINE (Integer, available after the component): the number of output rows, that is the number of input rows multiplied by the number of table lines.

((Integer) globalMap.get("tSplitRow_1_NB_LINE"))

ExemplesExamples

Un tFixedFlowInput envoie deux lignes au tSplitRow par le lien row1, suivi d'un tLogRow en mode basique (une nulle y est écrite vide). Un tJava relié par On Subjob Ok affiche NB_LINE. Sorties copiées depuis une exécution des jobs dans Talaxie (Java 21). A tFixedFlowInput sends two rows to the tSplitRow through the row1 link, followed by a tLogRow in basic mode (a null is written empty there). A tJava connected with On Subjob Ok prints NB_LINE. Outputs copied from a run of the jobs in Talaxie (Java 21).

Une ligne par coordonnéeOne row per contact detail

row1 (Main) row2 (Main) tFixedFlowInput_1 tSplitRow_1 tLogRow_1

EntréeInput

idInteger nameString homeString workString
1Ada01 2306 45
2Gracenull07 89

Mapping des colonnesColumns mapping

idInteger kindString valueString
row1.id"name"row1.name
row1.id"home"row1.home
row1.id"work"row1.work

Trois lignes de sortie par ligne d'entrée, dans l'ordre du tableau. La coordonnée nulle de Grace donne quand même sa ligne. Three output rows per input row, in the table order. Grace's null contact detail still gives its row.

1|name|Ada
1|home|01 23
1|work|06 45
2|name|Grace
2|home|
2|work|07 89
tSplitRow_1_NB_LINE = 6

Des expressions calculéesComputed expressions

Mêmes lignes ; deux lignes de tableau, avec des expressions quelconques : Same rows; two table lines, with any expressions:

  • row1.id * 10 + 1 · "home" · row1.home == null ? "-" : row1.home.replace(" ", "")
  • row1.id * 10 + 2 · "label" · row1.name.toUpperCase() + " (" + row1.id + ")"
11|home|0123
12|label|ADA (1)
21|home|-
22|label|GRACE (2)
tSplitRow_1_NB_LINE = 4

Une cellule videAn empty cell

Une ligne de tableau row1.id · "home" · (vide). Le job ne compile pas (chemin abrégé, nom du job remplacé par MyJob) : One table line row1.id · "home" · (empty). The job does not compile (path shortened, job name replaced with MyJob):

MyJob.java:1402: error: illegal start of expression
      rowTmp_tSplitRow_1.value = ;
                                 ^
1 error

Écrivez null pour une colonne nullable à laisser vide. Write null for a nullable column to leave empty.

Pièges et conseilsPitfalls and tips

Un tableau videAn empty table

Le Studio signale un Mapping des colonnes vide comme une erreur ; Talaxie 9.0.6 ne le signale pas (à partir de Talaxie 9.0.7, le composant porte une pastille rouge, comme dans le Studio). Le job tourne alors, et chaque ligne d'entrée envoie au composant suivant une ligne sans aucune valeur, alors que NB_LINE vaut 0 : The Studio reports an empty Columns mapping 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). The job then runs, and each input row sends the next component a row without any value, while NB_LINE is 0:

||
||
tSplitRow_1_NB_LINE = 0

Des valeurs nulles en sortieNull values in the output

Chaque ligne du tableau donne une ligne, que ses valeurs existent ou non (2|home| dans le premier exemple). Pour ne garder que les coordonnées remplies, placez un tFilterRow après le tSplitRow. Une expression qui échoue (méthode appelée sur une nulle) arrête le job : le composant n'a pas de lien Reject ; protégez-la comme dans l'exemple Des expressions calculées. Each table line gives a row, whether its values exist or not (2|home| in the first example). To keep only the filled contact details, put a tFilterRow after the tSplitRow. A failing expression (method called on a null) stops the job: the component has no Reject link; guard it as in the Computed expressions example.

Le nom du lien d'entréeThe name of the input link

Les cellules citent le lien d'entrée (row1). Si vous le renommez, ou reliez un autre composant, réécrivez les expressions. The cells refer to the input link (row1). If you rename it, or connect another component, rewrite the expressions.

Un nombre variable d'élémentsA variable number of items

Le nombre de lignes de sortie est fixé par le tableau. Pour une liste de longueur variable dans une colonne (a,b,c), prenez le tNormalize. The number of output rows is set by the table. For a list of variable length in a column (a,b,c), take the tNormalize.

Voir aussiSee also