Skip to main content

Celonis Product Documentation

Knowledge Model - Filters

One of the most powerful capabilities of Studio and the Process Query Language (PQL) engine is data filtering using filters. Filters provide a way to select only those data records that match certain criteria. Filters are used in various places and Studio services. By storing and maintaining filters in a Knowledge Model, they can be easily reused and managed in one place.

What do they do?

Filters apply a refining condition to a data object in Studio to show a result that complies with this condition. The refining condition is defined using PQL and is known as a Filter Statement. Once a filter is applied to a component, the component will only show data that complies with the condition specified on the filter.

How are they used?

Filters are used to refine the data shown across a multitude of components within Views. These can be applied to all components of the following types:

  • KPIs & Attributes

  • Charts & Tables

  • Anomalies & Root Causes

  • Execution & Action Components

  • Filter Components

  • Explorers

  • Design Components

  • Form Components

Filters can be created as individual filters or as global filters. Individual filters impact only the components in which they are activated, whereas global filters are used to refine the PQL statements of all the objects within the Knowledge Model in which they are activated. If there is a global filter active in your Knowledge Model you will see the "Global filters applied" tag above the Knowledge Model preview:

Screenshot_2022-11-08_at_14_22_05.png
How are they built?

In the Visual Editor, filters are created from the Filters Tab in the Knowledge Model. The Filter section contains all the filters that exist in the Knowledge Model. You can create a new filter by clicking on the plus button on the top right of the Filter section:

Screenshot_2022-11-08_at_14_20_13.png

This will lead you to the Create Filter window, which contains all filter associated value assignments. These associated value assignments are the following:

General Settings:

  • Display Name: A human-readable label used in the user interface.

  • Short Display Name: Shorter human readable label for the object shown automatically on the Views whenever the Display Name is truncated. Can contain max 20 characters.

  • ID: A technical identifier used for unique referencing of this filter.

  • Description: A human-readable description for the filter.

  • Filter Statement: Defines the criteria which will be used to filter the data this filter is applied to. This criterion is defined using PQL statements.

  • Global Filter: Indicates whether the filter is a global filter.

Screenshot_2022-11-08_at_13_13_13.png
Defining filters with YAML

In YAML, filters are defined by using the following value declaration formats:

- id: COUNTRY_FILTER
  displayName: "Country filter"
  description: "Filters down to DE and US data"
  pql: FILTER "TABLE"."Country" IN ('DE','US')
  global: true
  • id: A unique technical identifier used to reference this filter. Must be unique within all filters in the Knowledge Model.

  • displayName: A human-readable label used in the user interface.

  • shortDisplayName: Shorter human readable label for the object shown automatically on the Views whenever the displayName is truncated. Can contain a max of 20 characters (optional).

  • description (optional): A human-readable description for the flag.

  • pql: Contains the PQL query that states the condition used to synthesize the data.

  • global: Indicates whether the filter is a global filter that will be applied to the PQL of all the objects in the Knowledge Model. Standards PQL filter propagation applies.