Skip to main content

Celonis Product Documentation

Creating and managing enhanced Knowledge Model variables

Enhanced Knowledge Model variables allow you to centrally create and manage information that is referenced and reused across Views where that Knowledge Model is in use. Like with enhanced View variables, you can use enhanced Knowledge Model variables in buttons, KPI lists, tables, and input dropdowns.

Enhanced Knowledge Model variables can be created either directly in the Knowledge Model:

A screenshot showing how to access the variables menu from within a knowledge model.

Or by using the PQL editor. To access the PQL editor and create enhanced Knowledge Model variables from within a View:

  1. Open the PQL editor using View components where data fields can be selected:

    1. Either: Click the PQL editor button directly.

    2. Or: Add data to a setting (such as a table column)

    a screenshot showing how to access the PQL editor from within a component settings menu.

  2. Locate the Knowledge Model variable section and click Add:

    A screenshot show how to add a knowledge model variable from the view variables dropdown.

  3. Enter a variable name, select a variable type, and optionally enter a description.

    • Key: This should be a unique ID, allowing for the variable to be referenced across components. Avoid using special characters here.

      Your variable key can then be referenced in your View as:

      ${KEY}

    • Type: Choose between string (text), number (#), boolean (true /false), and object.

      For object variables, see: Object variables

    • Default Value (optional): This is the value that will be referenced unless otherwise stated.

  4. Optional: Enable Advanced Options and enter a variable description and choose the variable and user scope.

    • Description: Provide further information here, giving your team added context where needed.

    • Variable Scope: Choose whether this variable is saved at a View level only, within the knowledge model (which can be referenced by all Views created using that model), or for all assets within the existing package.

    • User Scope: Choose whether this variable is specific to your account or is available for all users within your team.

    A screenshot showing how to add a knowledge model variable.

  5. Click Save.

Once saved, your enhanced Knowledge Model variables are then displayed in the variables menu for all Studio assets that use this Knowledge Model.

To edit or delete an existing variable, click Edit:

A screenshot showing how to edit a knowledge model variable.
Enhanced variable use case example using an input box

Input boxes allow you to record a manually entered value from users and then use that value throughout your View. This saves the input as either a View variable or a Knowledge Model variable. This variable can then be used in other components to adjust the View based on the manual value entered by the user.

In this example, the input box allows users to enter the minimum net value:

A screenshot showing an example knowledge model variable being used.

This input box example is configured by saving the user input as a Knowledge Model variable. In this case, the variable is a number type:

${minimum_value_threshold_unbilledcurrency)
A screenshot showing an example knowledge model variable being created.

This variable can then be used in other components, such as a text box:

A screenshot showing an example of a knowledge model variable being used with a component.

With the published version of the app showing the value entered (10):

A screenshot showing an example of a knowledge model variable being used.