Filters

Video Guide: Filters and Branching Logic 

In some scenarios, you may need to only work with bundles that fit specific criteria. Filters will help you to select those bundles.

You can add a filter between two modules and check whether bundles received from the preceding modules fulfill specific filter conditions or not. If yes, the bundles will be passed on to the next module in the scenario. If not, their processing will be terminated.

For example, if you want to create a scenario with the Facebook trigger Watch posts and you want to work only with posts containing a specific word or posts written by a specific author, a filter would make sure you receive only these posts and nothing else.

Adding a filter

To add a filter between two modules, click on the connecting line between them.

This brings up a panel where you can enter the name for the filter that is to be created and define one or more filter conditions.

For each condition, you can enter one or two operands and an operator that will determine the relation between them. In the operand field, you can enter values in the same way as you would map them.

In the example above, you can see how to connect the Gmail trigger Watch emails and the Google Drive action Upload a file. The filter automatically applies the condition to incoming bundles from the first module and only bundles containing attachments are allowed to pass on to the next module.

Operators

For each condition, you can use one of several different operators.

Basic operators

Exists: checks whether a specific bundle item is filled in. Using this operator, you can create a filter that permits, for example, only Facebook posts that contain a photo to go through to the next module in a scenario.

Not Exists: The opposite of exists. It permits only those bundles where a specific item is not filled in.

Text Operators

Equal to: Compares text fields for an exact match.

Equal to (case insensitive): Compares text fields for an exact match regardless of letter case.

Not equal to: Selects bundles where the text field does not match the specified text exactly.

Not equal to (case insensitive): Selects bundles where the text field does not match the specified text, irrespective of letter case.

Contains: Permits bundles where the text field contains a specified substring.

Contains (case insensitive): Similar to "Contains", but the search is case insensitive.

Does not contain: Allows bundles that do not contain a specified substring in the text field.

Does not contain (case insensitive): Allows bundles that do not contain a specified substring in the text field, without considering letter case.

Starts with: Filters bundles where the text field starts with specified characters.

Starts with (case insensitive): Filters bundles where the text field starts with specified characters, ignoring case.

Does not start with: Filters out bundles where the text field starts with specified characters.

Does not start with (case insensitive): Filters out bundles where the text field starts with specified characters, ignoring case.

Ends with: Selects bundles where the text field ends with specified characters.

Ends with (case insensitive): Selects bundles where the text field ends with specified characters, regardless of letter case.

Does not end with: Excludes bundles where the text field ends with specified characters.

Does not end with (case insensitive): Excludes bundles where the text field ends with specified characters, without considering letter case.

Matches pattern: Filters bundles based on a regex pattern match within the text field.

Matches pattern (case insensitive): Filters bundles based on a case-insensitive regex pattern match within the text field.

Does not match pattern: Filters out bundles that match a regex pattern within the text field.

Does not match pattern (case insensitive): Filters out bundles that match a case-insensitive regex pattern within the text field.

Numeric Operators

Equal to: Filters bundles where the number exactly matches the specified value.

Not equal to: Selects bundles where the number does not match the specified value.

Greater than: Allows bundles with a number greater than the specified value.

Less than: Permits bundles with a number less than the specified value.

Greater than or equal to: Filters for bundles where the number is greater than or equal to the specified value.

Less than or equal to: Selects bundles where the number is less than or equal to the specified value.

Datetime Operators

Equal to: Matches dates that are exactly the same as the specified date.

Not equal to: Selects dates that are different from the specified date.

Later than: Filters for dates that are later than the specified date.

Earlier than: Allows dates that are earlier than the specified date.

Later than or equal to: Selects dates that are the same as or later than the specified date.

Earlier than or equal to: Filters for dates that are the same as or earlier than the specified date.

Time Operators

Equal to: Matches times that are exactly the same as the specified time.

Not equal to: Selects times that are different from the specified time.

Greater than: Filters for times that are later than the specified time.

Less than: Allows times that are earlier than the specified time.

Greater than or equal to: Selects times that are the same as or later than the specified time.

Less than or equal to: Filters for times that are the same as or earlier than the specified time.

Boolean Operators

Equal to: Filters for fields where the boolean value matches true or false as specified.

Not equal to: Selects fields where the boolean value is the opposite of the specified value.

Array Operators

Contains: Filters for arrays that contain a specified element.

Contains (case insensitive): Filters for arrays that contain a specified element, ignoring case differences.