• Documentation >
• Scenarios >
• Filtering

Filtering

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.

Other operators

There are a number of other operators you can use: text comparison operators, numerical operators, time and date operators, and operators for working with arrays.

Copying a filter

Copying filters is currently not natively supported by the Scenario editor, though if you use the Google Chrome web browser, the following workaround can be employed:

1. Install Ibexa Connect DevTool Chrome extension.

2. In Ibexa Connect, open your scenario.

3. In Chrome, open the Developer tools. You can do so either by choosing the Developer tools command from the the Chrome main menu or just press Ctrl+Shift+I or F12:

   

4. In the Developer tools, click on the Ibexa Connect tab.

5. Click on the Tools icon in the left side bar.

6. .Click on the Copy filter tool and configure it in the right side panel.

7. Set the Source Module field - the module that's right after the filter you wish to copy.

8. Set the Target Module field - the module before which you wish to copy the filter.

9. Click on the Run button.