exclude by field value

This block is part of the array group and was last modified in core v10.4.28.

Field Selection Required

This block relies on a field that you select to perform its data actions. You must manually select the field you want to use in your flow using the field selector modal. To access the modal, click the white button on the block.

Field Selection Required

This block requires field selection (in). You must manually select the fields you want to work with using the field selector modal. To access the modal, click the white button on the block.

exclude by field value array v10.4.28

Removes the items whose given field equals the given value. Returns all items that do NOT match; items without the field always pass.

In pins 1

Array required
array
The array to be filtered.

Out pins 1

Array
array
All items whose field does NOT match the given value.

EXCLUDES items whose selected field equals the value on the type-named comparison pin; the output is every item that does NOT match, in order. Non-object items are always kept; items lacking the field are kept unless the comparison value is null (a missing field compares equal to null). Numbers match across int/float, but numeric strings do NOT equal numbers. Example: [{a:1},{a:2}] field=a value=1 -> [{a:2}]. With no field selected the array passes through unchanged.

key

filter

A typical wiring for exclude by field value: with values feeds the given_array pin; the array out pin feeds foreach.

Commonly used with

In production blueprints, this block is most often wired together with:

false: feeds into this block. Gives the condition false hard-coded.
execute: feeds into this block. Executes the given funcion and waits for it to be executed.
foreach: this block feeds into it.

Version history

Introduced in v10.4.28.

Back to array Return to the main group to view all sub-groups Back to array Return to the group to view all blocks within this group