ComposantsComponents › 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
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.
input_row.
For a condition the table does not express, check Use advanced mode and write a Java expression on input_row.
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").
|
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.
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.
Math.abs d'une colonne numérique.
Absolute value: Math.abs of a numeric column.
"london".
Lower case, Upper case: the text in lower or upper case, compared with the value. Handy to ignore the case: "london".
'a'.
Lower case first, Upper case first: the first character, in lower or upper case. The value is a Java character: 'a'.
"[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.
== · Différent de !=Equals == · Not equal to !=> · Inférieur à <Greater than > · Lower than <>= · Inférieur ou égal à <=Greater or equal to >= · Lower or equal to <=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"))
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.
| idInteger | nameString | cityString | ageInteger |
|---|---|---|---|
| 1 | Ada | London | 36 |
| 2 | Grace | null | 85 |
| 3 | Alan | Manchester | 41 |
| 4 | Linus | Helsinki | null |
| 5 | Edsger | Nuenen | 30 |
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
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
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
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
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
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.
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.
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.
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.
tReplace · rechercher et remplacer dans les colonnessearch and replace in columnstConvertType · changer le type des colonnes, avec rejetschange the type of columns, with rejectstAggregateRow · regrouper les lignes et calculer par groupegroup rows and compute per grouptJoin · joindre un flux à un Lookupjoin a flow with a LookuptJavaRow · code Java pour chaque ligneJava code for each rowtLogRow · afficher les lignes d'un fluxdisplay the rows of a flow