Filter block

The filter_on_condition block passes only the records that meet a defined condition to downstream blocks. It acts as a transformation block in a Connect+ dataflow, evaluating each record against the condition. Records that meet the condition move to the next block; all others are dropped. Write conditions using the ${field:function(value)} syntax.

When to use this block

Use this block when you want to process only a specific subset of records. For example:

  • Pass only transactions where status is paid
  • Pass only customers where source is INSTORE
  • Pass only records where loyaltyType is loyalty

Prerequisites

Before configuring this block, make sure you have:

  • Identified the header field and value to filter on
  • Familiarity with JSON expression language syntax

Configuration fields

Field name

Required

Description

Block name

Yes

A name for the block instance. The name must be alphanumeric. There is no character limit.

Filter Condition

Yes

The expression used to filter records. Only records that satisfy the condition are passed downstream.
Default value: ${header_value:notNull()}.
For example, use ${header_value:equals('paid')} to pass only records where the header value is paid.