UiPath Studio Guide

Known Issues and Limitations

Native Citrix support makes it possible to automate Citrix Apps with UI Automation activities. There are, however, a few things you need to consider:

Interactive Selection With High DPI

Interactive selection with High DPI is natively performed in Citrix Apps. Please note that it is mandatory to restart your active Citrix sessions after you change DPI scaling options.

If you are using multiple displays with different DPI scaling options and you move the target window across the displays, UI element selection can appear offset. In this case, it is recommended to resize the target window and select UI elements again.

Upgrading to the Citrix Workspace v1810

After you upgrade the Citrix Receiver to the Citrix Workspace, the UiPath Citrix Extension is automatically uninstalled. In order to re-enable Native Citrix automation, you need to reinstall the UiPath Citrix Extension.

Please note that after upgrading to the Citrix Workspace v1810 the UiPath Citrix Extension becomes corrupted. This is a known issue with this particular version of Citrix Workspace, and prevents you from opening any Citrix Apps. The following error message is displayed:

You might be having an issue with a Citrix virtual driver (UiPathPluginCitrix). Contact your system administrator for further assistance.

To fix this issue, you need to reinstall the UiPath Citrix Extension and then restart the Citrix Workspace.

Please note that after every upgrade or installation of the Citrix Receiver or Workspace the UiPath Citrix Extension needs to be reinstalled.

The Citrix Receiver for Universal Windows Platform (UWP) is Not Supported

The UiPath Citrix Extension can not be installed for the Citrix Receiver for Universal Windows Platform. This also applies to Citrix Workspace for Universal Windows Platform. To use Native Citrix automation, please install the standard Citrix Receiver or Citrix Workspace instead.

The Citrix App Session May Enter The Idle State During Background Automation

If a Citrix App does not receive any input from the user for a while, the associated Citrix session enters the idle state and disconnects. The idle disconnect timeout value is configured on the Citrix application server, and is generally about 30 minutes.

By default, the Click and Type Into activities send hardware events to the Citrix App, just as a regular user would. This prevents the Citrix App from entering the idle state.

However, if you use only background automation (such as the Click activity with the SendWindowMessages property enabled) for more than 30 minutes, the Citrix App may enter the idle state, and the following message is displayed:

If you run into this issue, it is recommended to increase the idle timeout value on the Citrix application server.


Known Issues and Limitations


Suggested Edits are limited on API Reference Pages

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