Skip to main content

Celonis Product Documentation

Formula Editor

  • The Formula Editor creates Dimensions and KPIs to be used in a component.

  • The Formula Editor can be accessed by the analyst.


The Formula Editor is opened via the component settings screen.

  1. Dimensions: Opens the dimensions formula editor screen.

  2. KPIs: Opens the KPIs formula editor screen.



The Formula Editor can edit Dimensions and KPIs. The overview screen can be used to select dimensions or KPIs according to table columns and pre-defined dimensions/KPIs. The Celonis engine automatically analyses the data in your tables and suggests relevant dimensions and KPIs for you to choose from them.

  1. Tables: You can choose a table from your data source.

  2. Columns: After you have clicked one entry of this table list, you can see the suggested KPIs/dimensions that the Celonis engine identified from it. Below the suggestions, the columns of the tables are also available for selection to calculate KPIs/dimensions from them.

    If you select a column, a third area 'Choose Function' might appear (depending on the data type of your selected column). For example, if you would like to select Year of Credit Applications as a Dimension, you might choose the EventTime column from the Cases table. If you are choosing a KPI, a third column will appear after choosing a column. This is where we actually set our KPI.

  3. KPIs: Here you can view the KPIs (or, analogously, the dimensions) you have currently assigned to this component or add new ones. Read items 6 to 10 to know more about this tab.

  4. Switch view: Switches the view between dimensions and KPIs.

  5. Preview: Displays a preview of the KPIs/dimensions you have created.

  6. Add KPI: Click here to add a new KPI. This will open the Visual Editor or Code Editor screens.


After you click a KPI, the following sections will appear:

7. Activity name: Click to edit the activity name.

8. Formatting: Change the dimension formatting options.

9. Formula box: Displays the formula for your KPI/dimension with its PQL statement.

10. Formula editor: Click here to open the Visual Editor or Code Editor screens to define your KPI/dimension formula more easily.

11. Sort: Use to apply a sorting rule. You can choose between a descending and ascending order (re-click this icon to change).

12. Delete: Use to delete this dimension/KPI.

Setup '% Share' KPI

We address the use case of percentage type ('% Share') of KPIs, where the count of the column is divided by the total of the column. This feature is available for KPIs in tables, pie charts, and bar charts.

  1. Navigate to the Data Series: kpi_name settings of the respective component.

  2. Check the Calculate share in percentages checkbox.

Additionally, for example, when you put COUNT_TABLE("EKPO") underneath, it returns the percentage in the table or chart.