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.

  1. Tables: Choose a table from your data source.

  2. Columns: Once you have selected a table, you can see the suggested KPIs/dimensions identified by the Celonis engine. Below the suggestions, the columns of the table 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 select the 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 you actually set your KPI.

  3. KPIs: View the KPIs (or, analogously, the dimensions) currently assigned to this component or add new ones. Read items 6 to 10 to learn more about this tab.

  4. Switch view: Toggles 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.

  11. Sort: Use to apply a sorting rule. You can choose between descending and ascending order (click this icon again to reverse the order).

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

Set up "% 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.