Skip to main content

Task Mining Configuration Editor

Task Mining Configuration Editor settings

Important

The settings given are for version 2.19 of the Configuration Editor. If you're using an older version, the sections and fields may be slightly different but the possible and default values should be the same.

Menu item

Menu option

Description

File

New

Creates a new Task Mining configuration file.

File

Open

Opens an existing Task Mining configuration file.

File

Save

Saves the Task Mining configuration file that is currently open.

File

Save as

Saves the Task Mining configuration file that is currently open under a name and to a location of your choice.

File

Quit

Exits Configuration Editor.

Tools

Generate SQL 'CREATE TABLE' query

Generates a SQL query from the Task Mining configuration file. The SQL query is copied to the clipboard.

Running this script in a transformation creates the target table in the Celonis Platform. For more information, see Extracting and transforming data.

Tools

Export JSON (base64 encoded)

Generates a Base64 encoded JSON representation of the Task Mining configuration file and copies it to the clipboard.

Tools

Import JSON (base64 encoded)

Opens a dialog to import and open a Base64 encoded JSON representation of a Task Mining configuration file.

About

--

Contains information about the Task Mining Configuration Editor version and third-party licensing.

Section

Field

Description

Possible values

Default value

IBC Upload

Send Data to IBC

Sets whether the captured Task Mining events should be:

  • Pushed to the Celonis Platform (enabled), or

  • Stored locally as parquet files (disabled).

Enabled

Disabled

Enabled

Note

If IBC Upload is disabled, the other IBC Upload fields are not displayed.

IBC Upload

Data Pool ID

Identifier of the Celonis Platform Data Pool where captured Task Mining events are stored.

Usually a UUID with this format:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

IBC Upload

IBC Team Subdomain

Celonis Platform team subdomain.

Usually the first part of the Celonis Platform URL, for example:

<teamname>

IBC Upload: Send Data to IBC

Server ID

Celonis Platform realm.

Usually the second part of the Celonis Platform URL for example:

eu-1

IBC Upload: Send Data to IBC

Target Table Name

Note

The Generate SQL Query button performs the same function as the Generate SQL 'CREATE TABLE' query option in Configuration Editor Application menu > Tools.

Name of the Celonis Platform database table where captured Task Mining events are stored.

--

IBC Upload: Send Data to IBC

Image Service Bucket Name

Name of the bucket where Task Mining screenshots are stored.

FROM 1.2.1

Usually a UUID with this format:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

IBC Upload: Send Data to IBC

Update Cloud Period (in Minutes)

Time period (in minutes) during which captured Task Mining events stored in parquet files are sent to the Celonis Platform.

Min value: 1

2

Caching

Encrypt Local Data

Sets whether captured Task Mining events temporarily stored on local disk are encrypted.

FROM 2.0.4

Enabled (encrypted)

Disabled (not encrypted)

Disabled

Caching

Path for Transfer File Cache

Directory where temporary parquet files are stored. If a valid directory isn't specified, the parquet files are stored in the user's temp folder (managed by Windows).

Important

While UNC paths (e.g. \\server\share) are not supported by default due to security considerations, we can enable them on request if your organization accepts the associated security risk. You can use Windows system variables (like %HOMEPATH% or %USERPROFILE%) to create a generic configuration file for different users.

%USERPROFILE%\CelonisTaskMining

Caching

Number of Entries Limit

Maximum number of captured Task Mining events that are cached. If the number of cached events exceeds this value, the cached events are written to a parquet file.

Min value: 1

100

Caching

Time Limit in Minutes

Time limit for writing cached events into parquet files (in minutes). If the time limit is exceeded, all cached events are written to parquet.

Min value: 1

5

Caching

Timeout in seconds

Time limit for uploading data to the Celonis Platform before terminating the Task Mining Client software.

FROM 2.0.4

Min value: 1

5

Caching

Auto Upload Old Cached Files

Sets whether cached files from prevous runs that failed to load are:

  • Checked and automatically uploaded (enabled).

  • Not checked for and not uploaded (disabled).

FROM 2.4.1

Enabled

Disabled

Enabled

Caching

Maximum Cached File Age (optional)

Number of days cached files are retained before deletion.

FROM 2.4.1

Min value: 1

30

Caching

Maximum Cached File Size (optional)

Maximum size of cached image files (in gigabytes). Cached image files are deleted if the maximum size is exceeded.

FROM 2.4.1

Min value: 1

25

Compatibility

Use Old Data Push API

Old Data Push API implementation.

Important

This is included for backwards compatibility only and will be removed in future releases.

FROM 1.1.1

DEPRECATED AFTER 1.1.1

Enabled

Disabled

Disabled

Compatibility

Use Old Image Upload API

Old Image Upload API.

Important

This is included for backwards compatibility only and will be removed in future releases.

FROM 1.2.1

DEPRECATED AFTER 1.2.1

Enabled

Disabled

Disabled

Specifies the event processing rules that define which events, attributes and screenshots are captured in Task Mining. For more information, see Event Processing Rules - Text Editor and Event Processing Rules - Visual Editor.

Specifies regex patterns to redact sensitive content, such as personal data, from captured Task Mining data. For more information, see Custom data redaction.

FROM 2.13.0.

Section

Field

Description

Possible values

Default value

General

Snippet Split Time

Time period (in seconds) used to split event sequences into snippets. If the elapsed time between two consecutive events exceeds this limit, the later event will be assigned to a new snippet.

Min value: 1

20

General

Idle Waiting Time

Time period (in minutes) after which the user is considered absent due to no keyboard or mouse input.

FROM 2.4.1

Min value: 1

10

General

Alive Interval

Time between events that are added periodically to the data uploaded to the Celonis Platform to indicate the Task Mining Client is running (in minutes).

FROM 2.4.1

Min value: 1

15

General

Use Native URL Retrieval

Sets whether URLs are extracted directly from browsers:

  • Without additional Chrome and Edge  browser extensions (enabled).

  • With additional Chrome and Edge browser extensions required (disabled).

FROM 2.4.1

Note

For more information about Chrome and Edge browser extensions, see Browser extensions (optional),

Enabled

Disabled

Enabled

General

Show Live Event Monitor in Client

Sets whether the Live Event Monitor menu item in the Task Mining Client software:

  • Displays (enabled).

  • Is hidden (disabled).

Caution

When enabled, all users connected to the Task Mining project will have access to the Live Event Monitor. We therefore advise that this is not enabled for productive rollouts but for testing or during the setup phase only. For more information, see the Live Event Monitor.

FROM 2.8.1

Enabled

Disabled

Disabled

General

Use UIAA

Sets whether additional information on controls is:

  • Extracted using Microsoft UI Automation (UIAA) (enabled).

  • Not extracted (disabled).

FROM 2.0.4

Enabled

Disabled

Enabled

General

Applications to exclude from UIAA

Applications excluded from additional information extraction by Microsoft UI Automation (UIAA).

Tip

he application name must exactly match the process name displayed in Windows Task Manager without the .exe extension. The application name is case sensitive.

FROM 2.0.4

--

EXCEL

Startup Mode

Minimize Task Mining's Window When It Starts

Defines whether the Celonis Task Mining Desktop software starts:

  • With a minimized application window (enabled).

  • With a standard size application window (disabled).

Note

The application window can always be restored by clicking the system tray icon.

Enabled

Disabled

Disabled

Startup Mode

Startup Mode

Sets whether the Task Mining Desktop software starts the data capture:

  • Manually (Start Task Mining manually).

  • Automatically (Start Task Mining automatically on application start).

Important

The Task Mining Desktop software will start to capture data only if the user has already accepted the legal terms. The user can always start or stop Task Mining manually, even if Start Task Mining automatically on application start has been selected here. For more information, see User Consent section in Task Mining basic client settings.

Start Task Mining manually

Start Task Mining automatically on application start

Start Task Mining manually

Allow users to specify up to five custom attributes, like team or geographic location, that can be used for analysis purposes. For more information, see Task Mining Team Insights.

Important

To capture event data from the Chrome or or Edge browser, you must have Receive Data From All Extensions enabled here and have installed the Chrome or Edge browser extension.

Allows custom rules to be defined so specific event data is captured from the Chrome and Edge browser extensions. For more information, see Web page extractions.

FROM 2.6.0

Section

Description

Possible values

Default value

Retrieve SAP Data

Sets the Task Mining Client software to:

  • Retrieve detailed information from the SAP GUI (enabled).

  • Not retrieve information from the SAP GUI (disabled).

Note

SAP GUI scripting must be enabled for this to work. For more information, see How to prepare SAP for integration with Task Mining.

FROM 1.2.1

Enabled

Disabled

Enabled

Number of Retry Attempts

Number of times the Task Mining Client software tries to re-establish a lost connection to the SAP GUI.

FROM 1.2.1

Min value: 1

4

Waiting Time for Retry

Time the Task Mining  Client software waits before trying to re-establish a lost connection to the SAP GUI (in miliseconds).

FROM 1.2.1

Min value: 1

1000

SAP Process Monitor Interval

Time interval between Task Mining Client software checks for a running SAP GUI instance.

FROM 1.2.1

Min value: 1

100

Dynamically Enable Native Windows Dialogs for SAP GUI Scripting

Sets whether native Windows dialogs for SAP GUI scripting is:

  • Dynamically enabled (enabled).

  • Not enabled (disabled)

Note

This setting affects how the SAP GUI works. We recommended enabling it only if users are recording and executing SAP GUI scripts while running Task Mining.

Enabled

Disabled

Disabled

Section

Possible values

Default value

Consent Text

--

Placeholder text.

Link to Additional Information (optional)

--

--

Label of Consent Checkbox

I have read and agree to the above