Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
title:Warning
title:Warning
borderColorblack
bgColor#ffff00
borderStylesolid

(warning) PLEASE NOTE: This documentation applies to Pentaho 8.2 and earlier. For Pentaho 8.3 and later, see Switch/Case on the Pentaho Enterprise Edition documentation site.


Description

What this step does is implement the Switch/Case statement found in popular programming languages like Java.

In our case we route rows of data to one or more target steps based on the value encountered in a certain field. 


Version

This step was first introduced in version 3.1.0-RC1 (trunk revision 7777, PDI-1217)

Options

Option

Description

Step name

The name that uniquely identifies the step.

Field name to switch

The field name that contains the value to use as a bases for the row routing.

Use string contains comparison

If checked, the comparison will be true if the value is found anywhere in the field being tested. Unchecked and the value has to exactly match the field.

Case value data type

The data type of the values specified in this dialog

Case value conversion mask

The conversion mask of the values specified in this dialog (numeric / date values)

Case value decimal symbol

The decimal symbol of the values specified in this dialog (numeric values)

Case value grouping symbol

The grouping symbol of the values specified in this dialog (numeric values)

Case values

Here you can specify a value-target step pair, one per row.
To specify a null value, simply leave the value column blank while entering a target step.
Please note that it is possible to specify the same target step more than once.

Default target step

All the rows that don't match any of the case values above are sent to this target step.


 

 



Example

A sample transformation demonstrating the capabilities of this step is available in the distribution package (in samples folder)

Code Block

samples/transformations/Switch-Case - basic sample.ktr

...