UiPath Process Mining

The UiPath Process Mining Guide

Release date: April 26th 2021

This page provides more information about the newly released functionality, improvements and bug fixes in UiPath Process Mining 2021.4. Features and improvements marked with (v.2021.1) were already released in UiPath Process Mining 2021.1 (Preview).



UiPath Process Mining collects usage and performance data to help diagnose problems and improve its products. The information we collect can include data on UiPath product information, the operating system, and browser versions. Telemetry data is always sent anonymously.
For more details about UiPath’s privacy practices, please review the UiPath Privacy Policy.



For a correct working of telemetry, and to ensure that the diagnostic data is sent correctly, it is recommended to make sure that your Firewall is configured properly for the UiPath Process Mining Server.

By default, usage data collection is enabled in UiPath Process Mining for apps that are opened within a release with the 21.4 build. However, you can deactivate telemetry at any time by defining the SendTelemetryData setting in the Server Settings.
See Disabling UiPath Process Mining to send telemetry data.

New Features

Sending automation ideas to UiPath Automation Hub

Different UiPath products work together to discover, investigate, and build automation and communicate process improvements. UiPath Automation Hub is used to turn ideas for automation that are discovered from UiPath Process Mining into real automated implementations. You can configure UiPath Process Mining for integration with UiPath Automation Hub to make it possible for end-users to send ideas for process improvements that are subject for automation directly from the Process Graph to UiPath Automation Hub.


See Set up Integration with UiPath Automation Hub for a detailed description on how to enable end-users to send automation opportunities to UiPath Automation Hub.


The new Submit as Automation Idea option has been enabled for the following process graphs in AppOne:

  • Overview - Automation;
  • Process - Process;
  • Process - Repetitions;
  • Timing - Timing.

By pressing the icon on the top right of the process graph, the user can select an activity to submit to UiPath Automation Hub as a potential automation idea. The user needs to fill in general information and automation details in the Submit As Automation Idea dialog. Besides this information, the User, Event cost , and Event processing time for all the non-automated events in this automation idea are sent to UiPath Automation Hub.



To enable end-users to send ideas for automation from AppOne to UiPath Automation Hub:

  • the values of Manual processing time and User should be filled in, and cannot be equal to 0.
  • the value of Manual event cost can be equal to 0, which implies that it is an optional field.

See Sending Automation Ideas to UiPath Automation Hub for an overview of how to send automation opportunities from AppOne.

Performing root cause analysis

A new dashboard Conformance - Root cause analysis is added to AppOne, which allows end-users to perform root cause analysis. See illustration below.


A set of Reference cases is defined based on the Case end and Case status filters. Within this set of cases, the user selects behavior to analyze. For example, cases with a certain tag. This selection is called the Selected cases. Root cause analysis compares the occurrence of Selected cases with the Reference cases.

See also Conformance - Root cause analysis.

Single Sign-On authentication

It is now possible for Superadmin users and end-users to make use of Single Sign-On (SSO) to login to UiPath Process Mining.

After configuring Azure Active Directory or Integrated Windows Authentication to recognize a UiPath Process Mining instance, the ExternalAuthenticationProviders setting of the Server Settings must be configured by adding the required Azure AD or Integrated Windows Authentication settings in the ExternalAuthenticationProviders object. See ExternalAuthenticationProviders in the Server Settings Help for a detailed description.



Single Sign-On authentication is:

  • the recommended authentication method for UiPath Process Mining.
  • supported with Microsoft Azure Active Directory and Integrated Windows Authentication.

Set up Single Sign-On through Azure Active Directory.
Set up Single Sign-On through Integrated Windows Authentication.



While it will still be possible to switch the Superadmin build to a previous version of UiPath Process Mining after upgrading to v2021.4, it will no longer be possible to add new Superadmin users with previous versions (deleting users will still work). To add new users, always use the latest version of UiPath Process Mining.

SSO for App Developers

When setting the ExternalAuthenticationProviders setting in the Server Settings the AD groups panel becomes available on the Superadmin users tab. Here you can add new AD user groups. App developers who are a member of a group defined in the Superadmin users tab can log in the UiPath Process Mining with their Microsoft account using single sign-on. A Sign in with Microsoft button will be present on the Superadmin Login dialog. See illustration below.


On the Superadmin users tab AD groups can be granted admin access rights. See illustration below.

See Adding Superadmin AD Groups for a description on how to enable SSO for app developers.



To enable Single Sign-on for Superadmin users the latest version of the Dispatcher build must be used. (At least v2021.4)

SSO for End-Users

When setting the ExternalAuthenticationProviders setting of the Server Settings the Groups tab becomes available in the End-user administration page. Here you can add new AD user groups. End-users who are a member of a group defined in the Groups tab can log in the UiPath Process Mining with their Microsoft account using single sign-on. Similar to the Superadmin Login, a Sign in with Microsoft button will be present on the Login dialog.

In the Applications tab in the End-user administration page all users of an Azure AD group can be granted access to open specific apps. See illustration below.


Access rights for a user who logs in through SSO are determined by combining all rights granted for each group that a user is a member of. Additionally the same per-user access rights such as the Admin property can be configured for groups. A user will have such property if he is a member of at least one group with the given property.

See Adding End-user AD Groups for a description on how to enable SSO for end-users.



To enable Single Sign-on for end-users the latest version of the Dispatcher build must be used.

sync-endusers script

The sync-endusers script that can be used in a connection string when setting the driver parameter of the connection string to {mvscript} and the script parameter to sync-endusers also allows syncing of groups. See also Adding End-user AD Groups.

Finding automation opportunities (v2021.1)

A new dashboard Automation is added to the Overview menu in AppOne. This dashboard allows you to find automation opportunities in your process. For the selected attribute the Automation rate is displayed for the current and the previous period. Together with the context metrics Manual processing time, Manual event cost, and Number of (manual) events this dashboard guides you in deciding which activities can best be automated. See illustration below.




The previous Automation dashboard in the Process menu is marked as deprecated and made invisible in AppOne. As an alternative, you can use the new Overview - Automation dashboard. The Process - Automation dashboard is still available on the background and can be enabled by a developer if needed.

Together with this dashboard, the attribute Event cost has changed to Manual event cost and the Manual processing time is a new available attribute.

  • Manual event cost is the cost that is involved in the manual execution of the event, such as employee wages.
  • Manual processing time is the time that is actually worked on the event without taking into account any waiting time.
    The attribute Processing time that was already available in AppOne on the Timing - Timing dashboard is renamed to Cycle time and represents the time between the start and the end of the event execution.



Since the event costs are now visible in the Overview - Automation dashboard, Event costs is no longer available as a metric in the metric selector on the Timing - Timing - Cases dashboard in AppOne.

See Overview - Automation.

Creating an app from a Base app (v2021.1)

It is possible to create an app from an existing released app, a so-called Base app. This enables you to use the released app as a template for your app to which you can make modifications to your own needs. Moreover, you can upgrade your app and merge any modifications you made when a new version of the Base app is released.
See Creating apps.

Upgrading a customized version of AppOne (v2021.1)

When a new version of AppOne is released you should update your app to the new version. You can now easily upgrade your customized version of AppOne to the new version without losing any customizations you have made to AppOne. When both the released version of AppOne on which your app is based (the Base release) and the released version of AppOne to which you want to upgrade (the New release) are uploaded, you can upgrade to the new version from you workspace by just selecting the Base release and the New release of your app.

See Updating a Customized Version of AppOne.

As a result of this new functionality the Delete unused releases option on the Releases tab now also does not delete any releases that are used as base app in a workspace in addition to releases that are active on an environment, or have any active data instances.

Custom labels for the Process Graph legend (v2021.1)

For a Process graph with the color mode set to Compare and for a Process graph with the color mode set to Reference the default labels of the Process graph legend can now be changed. Depending on the selected color mode the Advanced Process Graph Settings dialog now contains expression fields that enable you to customize the appropriate Process graph legend labels. See illustration below.


See Customizing the Process Graph Legend.

Detail slider in the Process graph (v2021.1)

For the Process graph the Activities and Edges sliders are replaced by a single Detail slider. The Detail slider enables end users to reduce the complexity of the Process graph, which will increase the readability of the graph. By default, the detail is set to AUTO but end users can change the level of detail by changing the slider value. See illustration below.


Developers can decide whether or not the Detail slider is visible on the Process graph. Moreover, the default complexity percentage can be set.
See Customizing the Detail Slider.



If you have defined either an Activities slider or Edges slider for a Process graph in an earlier version of UiPath Process Mining, this will be replaced by the new Detail slider when upgrading to UiPath Process Mining 2021.4.

The value of the new Detail slider will be adjusted according to the setting of the Activities slider. If the Activities slider was set to 100% the Detail slider will be set to AUTO. If you have set a default percentage for the Activities slider, the Detail slider will be set to this percentage.

Column sorting (v2021.1)

By default the data is sorted alphabetically by category in ascending order. As a developer, you can now use the options in the Grid panel to define the sorting of columns and/or the direction.
See Bar charts: Column sorting.



Since the sorting applies to columns, the Sort columns and Sort direction options are only available if the the Column attribute is set in the Grid panel.

Basic Connector updates (v2021.1)

The new event attribute Event processing time is added to the Basic Connector. If this information is not stored in your source system, an estimation of the processing time can be given per activity. To provide the estimations, the separate .csv file in the workspace should be filled in. Also an estimation for the Event cost can be defined in this file.

See Adding Automation Estimates.


Conflict handling while updating workspace

When a conflict occurred in a file other than the .mvp file while updating a workspace, the update was aborted. Now handling conflicts in text files while updating has improved by adding default Git merge conflict markers in the text file (>>>>>>>>>>>>). This enables you to resolve the conflicts after the update has finished.



All file types that can be opened in a text editor are considered as text files. For example .Json, .txt, .csv, etc.

Title of Message action removed

The Message title is no longer displayed when the Show Message action is used to display a message box. See illustration below.


Rename Action center to Actionable insights (v2021.1)

The integration with UiPath Orchestrator to create actions and queue items from UiPath Process Mining has been renamed to Actionable insights. This new term describes the integration in a better way.



If you have set up Actionable Insights in earlier versions of UiPath Process Mining you must update the folder name in the installation from actioncenter to orchestrator. You must also make sure to update all the files from the Basic Connector relating to Actionable insights, including the python scripts.

See Setting up Actionable Insights.

Release Signing (v2021.1)

UiPath Process Mining software is now signed using the UiPath signing key, allowing the software to be white-listed in security tools such as firewalls and virus scanners, if needed.



This implied a change in the structure of the released files. The files and AppOne_v21.4.x.exe now include the Basic Connector, the Profiler, and any other related files.

Stretched and flat charts (v2021.1)

Charts in columns sometimes were too stretched and some were also too flat. If there is only one chart column in a table, the maximum width is set to 400 pixels. See illustration below.


Default active filters on a chart (v2021.1)

When creating a new chart, any existing filters on the dashboard will be now active for this new chart as well. The available filters on the Filters panel will be applied in the following way:

  • The same filters from an existing chart that is created on the same table as the new chart will be applied.
  • If there is no existing chart based on the table for the new chart, any defined filters for the first chart will be applied.
  • If this is the first chart on the dashboard, all existing filters are activated for the new chart.

Current period indication in history chart (v2021.1)

The dot indicating the current period is now shown in a history chart if the X-axis contains a period filter. See illustration below.


0-point in charts (v2021.1)

The start value of the y-axis was not displayed in charts. This is now fixed. See illustration below for some examples.


When resizing the scales are updated as well. See animation below.


Selections (v2021.1)

It is possible to do selections on row values of other columns. In this case the entire row is highlighted and the actual selected value is made bold. See illustration below for an example.


It is also possible to select columns. Columns are only selectable if a column attribute is set for a table, and only the resulting columns are selectable. A filter is added to the Filters panel. See illustration below for an example.


Details number fixed in AppOne (v2021.1)

The number that is displayed on the Details dashboards in AppOne now take the From activity and To activity filters into account if put on the dashboards.

Default maximum number of values in a List box filter (v2021.1)

When you have a lot of items in a List box filter, the List box filter may not respond or completely freeze the user interface. This was caused by the limit being 200.000 items, and this is now limited to 20.000 by default. In AppOne the default maximum number of values in List box filters was already at 20.000. If you have a custom project that is not based on AppOne you may have to update the limit manually.



It is recommended to set the default maximum number of values for List box filters in the Application Settings of your projects to 20.000 or use the Search box filter instead.


Native SAP extraction: limit parameter

It is now possible to retrieve only a fixed number of records from the table by specifying the (optional) limit parameter in the Query field when defining the SAP connection string.

See Connection String Types: SAP

Known issue

Cache generation

When generating a cache for a release that is built with UiPath Process Mining 2021.4 from a Superadmin build that is of an older version, for example UiPath Process Mining 2020.10, it might occur that the following message is displayed: QEventDispatcherWin32::wakeUp: Failed to post a message. This does not affect the cache generation and you can ignore this message.

Updated 6 months ago


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.