Switch Operator (String Input)

The Switch Operator (String Input) is a StreamPipes data processor that allows you to route events based on the value of a selected string field. You can define multiple "switch cases," each with a specific string value and a corresponding output value. If the input string field matches a case, the defined output value will be added to the event. A default output value is used if no case matches or an error occurs during processing.

Configuration

Input Stream Requirements

This processor requires an input stream with at least one string property.

Output Strategy

This processor appends a new field to the event with the processed output value. The name of the output field is switch-output.

Static Properties

• Switch Field: Select the string field from the input stream that will be used for the switch condition.
• Output Type: Choose the data type of the output value. Available options are:
  • String
  • Boolean
  • Integer
• Switch Cases: Define the different switch conditions and their corresponding output values. Each switch case consists of:
  • Case Value: The string value to match against the selected switch field.
  • Output Value: The value to output if this case matches. This value will be converted to the selected Output Type.
• Default Output Value: The value to use if none of the defined switch cases match the input or if an error occurs during processing. This value will also be converted to the selected Output Type.

Example

Let's say you have an event with a string field status and you want to output a "Severity" integer based on its value:

Original Event
{ "status": "Warning" }

Configuration:

• Switch Field: status
• Output Type: Integer
• Switch Cases:
  • Case Value: Critical, Output Value: 3
  • Case Value: Warning, Output Value: 2
  • Case Value: Info, Output Value: 1
• Default Output Value: 0

Output Event when status is Warning:

Processed Event
{ "status": "Warning", "switch-output": 2 }

Output Event when status is Error (and not explicitly defined):

Processed Event
{ "status": "Error", "switch-output": 0 }