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:

directly_in_the_KM.png

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)

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

    add_KM_variable.png
  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: ???

    • 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.

    KM_variable_options.png
  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:

edit_or_delete_KM_variable.png

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:

billing_relevance_variable.png

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)
example_of_input_box.png

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

variable_in_text_box_example.png

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

text_box_active_variable_example.png