- Introduction and getting started
- Maestro landing page
- Process modeling
- Process implementation
- Process operations
- Instance management view
- Variables and element filtering
- Process monitoring
- Process optimization
- Licensing
- Reference information
Maestro user guide
Variable filtering enables process owners and analysts to filter instances based on variable values captured during execution (e.g., invoice amount, region, outcome). This helps segment execution results, troubleshoot behavior, or analyze process outcomes by business criteria—not just technical metadata.
Before you can filter on a variable, it must be explicitly configured as searchable in the Maestro canvas. Only configured variables appear in the Variable filter builder.
You can apply both basic filters (like version and date range) and advanced filters (like element- and variable-level filters) to refine the data shown on the Monitoring tab.
- Version: allows you to choose the version of the project for which you want to visualize data.
- Date range: allows you to choose the time period for which the information is displayed.
- Status: allows you to filter the
information based on the following project statuses, divided by active and inactive
instances:
- Active instances:
- Running
- Paused
- Faulted
- Inactive instances:
- Cancelled
- Completed
- Active instances:
- All filters: provides a more
user-friendly filtering experience, only displaying the available filtering options for
your project.
In addition to the regular filter, the All filters view offers you the option to filter by:
- Element: Filters data to only show process instances that executed a specific element in the BPMN model. Only elements that have been executed by at least one instance are available for filtering.
- Variable: This option
allows you to do some advanced filtering according to variables.
From the Monitoring tab, select the Configure filtering button from the top of the screen.
- Select the Variable
text box.
- Select specific variables from the canvas, and choose Select. This will open the Variable filter builder.
- From the drop-down menu at the top of the Variable filter builder, select whether you want all the conditions to be met.
- In the first column you can add several filters and choose from the drop-down menus that contain all the variables you selected at step 2.
- In the second column, based on the type of variable, you get filtering suggestions like equals, contains, starts with, ends with, not equal, is null, is not null.
- In the third column, choose
the text you want to be filtered.
Note:- Only variables which have been configured for filtering will appear in the filter builder. Configuring variables for filtering defines how variables can be used for search, filtering, and instance management visibility. Variables that are not configured as searchable will not be available for filtering.
- Once you configure the filtering, only instances that run after enablement will support variable filtering.
- The Variable filters are off by default, and you have to select them to become active. Contrary to the other filters, which are temporary, the Variable filters persist from the selection moment forward, until they are de-selected.
- Select the Variable
text box.
