ComposantsComponents

ComposantsComponents › TraitementProcessing

tFilterRow

tFilterRow

TraitementProcessing

Sépare les lignes d'un flux en deux : celles qui remplissent des conditions sur leurs colonnes partent par le lien Filter, les autres par le lien Reject, avec la raison du rejet. Les conditions se choisissent dans un tableau, ou s'écrivent en Java. Splits the rows of a flow in two: those that meet conditions on their columns leave through the Filter link, the others through the Reject link, with the reason for the rejection. Conditions are chosen in a table, or written in Java.

EntréeInput

Main un fluxone flow

SortieOutput

Filter les lignes retenuesthe rows kept

Reject les autres, avec errorMessagethe others, with errorMessage

Un lien de chaque au plus, tous deux facultatifs. At most one link of each, both optional.

Déclencheurs en sortieOutput triggers

On Component Ok On Component Error Run if

UtilisationUsage

row1 (Main) row2 (Filter) row3 (Reject) tFileInputDelimited_1 tFilterRow_1 tDBOutput_1 tFileOutputDelimited_1

Chaque ligne reçue part par un seul des deux liens. Un lien absent fait simplement disparaître ses lignes : sans Reject, le tFilterRow ne garde que les lignes retenues. Each incoming row leaves through only one of the two links. A missing link simply drops its rows: without Reject, the tFilterRow only keeps the rows that pass.

  1. Reliez la sortie d'un composant au tFilterRow, puis, par un clic droit sur lui, Ligne › Filter vers le composant des lignes retenues et, au besoin, Ligne › Reject vers celui des lignes rejetées. Connect the output of a component to the tFilterRow, then, with a right-click on it, Row › Filter to the component of the rows kept and, if needed, Row › Reject to the one of the rejected rows.
  2. Ajoutez une ligne par condition dans le tableau Conditions : la colonne, une fonction si besoin, l'opérateur et la valeur à comparer. Add one line per condition in the Conditions table: the column, a function if needed, the operator and the value to compare with.
  3. Choisissez l'opérateur logique : Et retient une ligne qui remplit toutes les conditions, Ou une ligne qui en remplit au moins une. Choose the logical operator: And keeps a row that meets all the conditions, Or a row that meets at least one.
  4. Pour une condition que le tableau n'exprime pas, cochez Utiliser le mode avancé et écrivez une expression Java sur input_row. For a condition the table does not express, check Use advanced mode and write a Java expression on input_row.

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émaSchemaSCHEMA — ToujoursAlways Les colonnes du flux, reprises du lien entrant, en lecture seule ; le lien Filter a les mêmes. Le lien Reject a en plus la colonne errorMessage (String, 255). The flow columns, taken from the incoming link, read only; the Filter link has the same ones. The Reject link also has the errorMessage column (String, 255).
Opérateur logique utilisé pour combiner les conditionsLogical operator used to combine conditionsLOGICAL_OP EtAnd ToujoursAlways Et : la ligne est retenue si toutes les conditions sont vraies. Ou : si au moins une l'est. L'expression du mode avancé compte comme une condition de plus. And: the row is kept if all the conditions are true. Or: if at least one is. The advanced mode expression counts as one more condition.
ConditionsCONDITIONS videempty ToujoursAlways Une ligne par condition : Colonne d'entrée, Fonction appliquée à sa valeur (voir ci-dessous), Opérateur, et Valeur. La valeur est du code Java, inséré tel quel : un texte s'écrit entre guillemets ("London"), un nombre sans (40). One line per condition: InputColumn, Function applied to its value (see below), Operator, and Value. The value is Java code, inserted as is: a text is written in quotes ("London"), a number without (40).
Utiliser le mode avancéUse advanced modeUSE_ADVANCED NonNo ToujoursAlways Ajoute l'expression Java du champ Avancé aux conditions du tableau. Adds the Java expression of the Advanced field to the conditions of the table.
AvancéAdvancedADVANCED_COND un exemple à remplacera sample to replace Mode avancé cochéAdvanced mode checked Une expression Java vraie ou fausse, sans point-virgule. input_row y est remplacé par le nom du lien entrant : input_row.city != null && input_row.name.startsWith("A"). A true or false Java expression, without a semicolon. input_row is replaced in it with the name of the incoming link: input_row.city != null && input_row.name.startsWith("A").

FonctionsFunctions

Ce qui est comparé à la valeur. Avec une fonction de texte, une colonne nulle rend la condition fausse. What is compared with the value. With a text function, a null column makes the condition false.

  • Vider (aucune fonction) : la valeur de la colonne elle-même. Un texte, une date ou un nombre qui accepte les nulles se compare par compareTo : sensible à la casse, et faux si la colonne est nulle. Empty (no function): the column value itself. A text, a date or a number that accepts nulls is compared with compareTo: case sensitive, and false if the column is null.
  • Valeur absolue : Math.abs d'une colonne numérique. Absolute value: Math.abs of a numeric column.
  • Minuscules, Majuscules : le texte en minuscules ou en majuscules, comparé à la valeur. Pratique pour ignorer la casse : "london". Lower case, Upper case: the text in lower or upper case, compared with the value. Handy to ignore the case: "london".
  • Minuscules en premier, Majuscules en premier : le premier caractère, en minuscule ou en majuscule. La valeur est un caractère Java : 'a'. Lower case first, Upper case first: the first character, in lower or upper case. The value is a Java character: 'a'.
  • Longueur : le nombre de caractères du texte. Length: the number of characters of the text.
  • Rapprochement : le texte entier correspond à l'expression régulière donnée en valeur ("[A-G].*"). Seuls Égal à et Différent de sont proposés. Match: the whole text matches the regular expression given as value ("[A-G].*"). Only Equals and Not equal to are offered.

OpérateursOperators

  • Égal à == · Différent de !=Equals == · Not equal to !=
  • Supérieur à > · Inférieur à <Greater than > · Lower than <
  • Supérieur ou égal à >= · Inférieur ou égal à <=Greater or equal to >= · Lower or equal to <=

Variables globalesGlobal variables

Integer, disponibles après le composant : NB_LINE (lignes reçues), NB_LINE_OK (lignes retenues), NB_LINE_REJECT (lignes rejetées). Elles sont comptées même sans lien Filter ou Reject. Integer, available after the component: NB_LINE (rows received), NB_LINE_OK (rows kept), NB_LINE_REJECT (rows rejected). They are counted even without a Filter or Reject link.

((Integer) globalMap.get("tFilterRow_1_NB_LINE_OK"))

ExemplesExamples

Un tFixedFlowInput envoie cinq lignes au tFilterRow. Le lien Filter mène à tLogRow_1, le lien Reject à tLogRow_2 ; tous deux affichent leur nom unique devant chaque ligne. Un tJava relié par On Subjob Ok affiche les trois variables. Sorties copiées depuis une exécution du job. A tFixedFlowInput sends five rows to the tFilterRow. The Filter link leads to tLogRow_1, the Reject link to tLogRow_2; both print their unique name in front of each row. A tJava connected with On Subjob Ok prints the three variables. Outputs copied from a run of the job.

row1 (Main) row2 (Filter) row3 (Reject) tFixedFlowInput_1 tFilterRow_1 tLogRow_1 tLogRow_2
idInteger nameString cityString ageInteger
1AdaLondon36
2Gracenull85
3AlanManchester41
4LinusHelsinkinull
5EdsgerNuenen30

Deux conditions, opérateur EtTwo conditions, And operator

age Supérieur à 40, et Longueur de name Inférieur ou égal à 5. errorMessage donne chaque condition non remplie, séparées par |. age Greater than 40, and Length of name Lower or equal to 5. errorMessage gives each condition not met, separated by |.

[tLogRow_2] 1|Ada|London|36|age.compareTo(40) > 0 failed
[tLogRow_1] 2|Grace||85
[tLogRow_1] 3|Alan|Manchester|41
[tLogRow_2] 4|Linus|Helsinki||age.compareTo(40) > 0 failed
[tLogRow_2] 5|Edsger|Nuenen|30|age.compareTo(40) > 0 failed| name.length() <= 5 failed
NB_LINE=5 NB_LINE_OK=2 NB_LINE_REJECT=3

Les mêmes conditions, opérateur OuThe same conditions, Or operator

Une condition remplie suffit : seule la ligne 5 n'en remplit aucune. One condition met is enough: only row 5 meets none.

[tLogRow_1] 1|Ada|London|36
[tLogRow_1] 2|Grace||85
[tLogRow_1] 3|Alan|Manchester|41
[tLogRow_1] 4|Linus|Helsinki|
[tLogRow_2] 5|Edsger|Nuenen|30|age.compareTo(40) > 0 failed| name.length() <= 5 failed
NB_LINE=5 NB_LINE_OK=4 NB_LINE_REJECT=1

Mode avancéAdvanced mode

Tableau vide, opérateur Et. Le message ne détaille pas l'expression. Empty table, And operator. The message does not detail the expression.

input_row.city != null && input_row.name.startsWith("A")
[tLogRow_1] 1|Ada|London|36
[tLogRow_2] 2|Grace||85|advanced condition failed
[tLogRow_1] 3|Alan|Manchester|41
[tLogRow_2] 4|Linus|Helsinki||advanced condition failed
[tLogRow_2] 5|Edsger|Nuenen|30|advanced condition failed
NB_LINE=5 NB_LINE_OK=2 NB_LINE_REJECT=3

Expression régulièreRegular expression

name, fonction Rapprochement, Égal à, valeur "[A-G].*" : les noms qui commencent par une lettre de A à G. name, Match function, Equals, value "[A-G].*": the names that start with a letter from A to G.

[tLogRow_1] 1|Ada|London|36
[tLogRow_1] 2|Grace||85
[tLogRow_1] 3|Alan|Manchester|41
[tLogRow_2] 4|Linus|Helsinki|| name.matches("[A-G].*") == true failed
[tLogRow_1] 5|Edsger|Nuenen|30
NB_LINE=5 NB_LINE_OK=4 NB_LINE_REJECT=1

Pièges et conseilsPitfalls and tips

Une valeur nulle ne remplit aucune conditionA null value meets no condition

Condition city Différent de "London" : Grace, dont la ville est nulle, est rejetée elle aussi. Une colonne nulle rend la condition fausse, quel que soit l'opérateur. Condition city Not equal to "London": Grace, whose city is null, is rejected too. A null column makes the condition false, whatever the operator.

[tLogRow_2] 1|Ada|London|36|city.compareTo("London") != 0 failed
[tLogRow_2] 2|Grace||85|city.compareTo("London") != 0 failed
[tLogRow_1] 3|Alan|Manchester|41
[tLogRow_1] 4|Linus|Helsinki|
[tLogRow_1] 5|Edsger|Nuenen|30
NB_LINE=5 NB_LINE_OK=3 NB_LINE_REJECT=2

Seule la valeur null elle-même se compare directement : city Égal à null retient les villes nulles. Pour garder les nulles avec une autre condition, testez-les dans le mode avancé : Only the null value itself is compared directly: city Equals null keeps the null cities. To keep the nulls with another condition, test them in advanced mode:

input_row.city == null || !input_row.city.equals("London")
[tLogRow_2] 1|Ada|London|36|advanced condition failed
[tLogRow_1] 2|Grace||85
[tLogRow_1] 3|Alan|Manchester|41
[tLogRow_1] 4|Linus|Helsinki|
[tLogRow_1] 5|Edsger|Nuenen|30
NB_LINE=5 NB_LINE_OK=4 NB_LINE_REJECT=1

Ou sans aucune condition : tout est rejetéOr without any condition: everything is rejected

Tableau vide, mode avancé décoché, opérateur Ou : aucune condition n'est vraie, toutes les lignes partent par Reject, avec un errorMessage nul. Avec Et, elles passent toutes. Empty table, advanced mode unchecked, Or operator: no condition is true, all the rows leave through Reject, with a null errorMessage. With And, they all pass.

[tLogRow_2] 1|Ada|London|36|
[tLogRow_2] 2|Grace||85|
[tLogRow_2] 3|Alan|Manchester|41|
[tLogRow_2] 4|Linus|Helsinki||
[tLogRow_2] 5|Edsger|Nuenen|30|
NB_LINE=5 NB_LINE_OK=0 NB_LINE_REJECT=5

input_row remplacé partoutinput_row replaced everywhere

Dans le mode avancé, input_row est remplacé sur le texte de l'expression, même dans une chaîne ou au milieu d'un nom, comme dans le tJavaRow. N'utilisez ce mot que pour désigner la ligne. In advanced mode, input_row is replaced on the text of the expression, even in a string or in the middle of a name, as in the tJavaRow. Only use this word to refer to the row.

Textes : la casse compteTexts: case matters

Sans fonction, "london" n'est pas égal à London. Choisissez la fonction Minuscules et écrivez la valeur en minuscules pour ignorer la casse. Without a function, "london" is not equal to London. Choose the Lower case function and write the value in lower case to ignore the case.

Le message de rejetThe reject message

Avec Et, errorMessage liste toutes les conditions non remplies. Avec Ou, une ligne rejetée n'en a remplie aucune : le message les liste toutes. Gardez cette colonne dans le fichier des rejets, elle dit pourquoi chaque ligne y est. With And, errorMessage lists all the conditions not met. With Or, a rejected row met none of them: the message lists them all. Keep this column in the reject file, it says why each row is there.

Plus de deux sortiesMore than two outputs

Le tFilterRow n'a qu'une sortie de lignes retenues. Pour envoyer les lignes vers plusieurs composants selon des conditions différentes, enchaînez des tFilterRow sur le lien Reject, ou utilisez un tMap et ses filtres de sortie. The tFilterRow has only one output of kept rows. To send rows to several components according to different conditions, chain tFilterRow components on the Reject link, or use a tMap and its output filters.

Voir aussiSee also