filter filter

Returns a listObject with objects having the key attribute matching one of the given key values.

Category

List

Function syntax

filter(<parameters>)

Parameters

Parameter
Type
Description
listToFilter
listObject
list of objects, to be filtered. It must be a field reference.
keyAttributeName
string
attribute name in the objects of the given list, used as key for filtering
keyValueList
list
array of key values for filtering

Signatures and returned types

filter(listObject, string, listString)

filter(listObject, string, listInteger)

filter(listObject, string, listDecimal)

filter(listObject, string, listDateTime)

filter(listObject, string, listDateTimeOnly)

filter(listObject, string, listDateOnly)

filter(listObject, string, listDuration)

filter(listObject, string, listBoolean)

Returns a listObject.

Examples

Here is an example of a payload passed in an incoming event “myevent”:

"productListItems": [{
   "id": "product1",
   "name": "the product 1",
   "price": 20
},{
   "id": "product2",
   "name": "the product 2",
   "price": 30
},{
   "id": "product3",
   "name": "the product 3",
   "price": 50
}]

You can use the following expression:

filter(
 @event{myevent.productListItems},
 "id",
 ["product2", "product3", "product4"]
)

Returns a listObject containing the two objects with “product2” and “product3” as id.

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76