- Release Notes
- Getting Started
- Setup and Configuration
- Automation Projects
- Dependencies
- Types of Workflows
- File Comparison
- Automation Best Practices
- Source Control Integration
- Debugging
- The Diagnostic Tool
- Workflow Analyzer
- About Workflow Analyzer
- ST-NMG-001 - Variables Naming Convention
- ST-NMG-002 - Arguments Naming Convention
- ST-NMG-004 - Display Name Duplication
- ST-NMG-005 - Variable Overrides Variable
- ST-NMG-006 - Variable Overrides Argument
- ST-NMG-008 - Variable Length Exceeded
- ST-NMG-009 - Prefix Datatable Variables
- ST-NMG-011 - Prefix Datatable Arguments
- ST-NMG-012 - Argument Default Values
- ST-NMG-016 - Argument Length Exceeded
- ST-DBP-002 - High Arguments Count
- ST-DBP-003 - Empty Catch Block
- ST-DBP-007 - Multiple Flowchart Layers
- ST-DBP-020 - Undefined Output Properties
- ST-DBP-023 - Empty Workflow
- ST-DBP-024 - Persistence Activity Check
- ST-DBP-025 - Variables Serialization Prerequisite
- ST-DBP-026 - Delay Activity Usage
- ST-DBP-027 - Persistence Best Practice
- ST-DBP-028 - Arguments Serialization Prerequisite
- ST-USG-005 - Hardcoded Activity Arguments
- ST-USG-009 - Unused Variables
- ST-USG-010 - Unused Dependencies
- ST-USG-014 - Package Restrictions
- ST-USG-020 - Minimum Log Messages
- ST-USG-024 - Unused Saved for Later
- ST-USG-025 - Saved Value Misuse
- ST-USG-026 - Activity Restrictions
- ST-USG-027 - Required Packages
- ST-USG-028 - Restrict Invoke File Templates
- ST-USG-032 - Required Tags
- ST-USG-034 - Automation Hub URL
- Variables
- Arguments
- Imported Namespaces
- Trigger-based Attended Automation
- Recording
- UI Elements
- Control Flow
- Selectors
- Object Repository
- Data Scraping
- Image and Text Automation
- Citrix Technologies Automation
- RDP Automation
- Salesforce Automation
- SAP Automation
- VMware Horizon Automation
- Logging
- The ScreenScrapeJavaSupport Tool
- The WebDriver Protocol
- Studio testing
- Extensions
- Troubleshooting
- About troubleshooting
- Microsoft App-V support and limitations
- Internet Explorer X64 troubleshooting
- Microsoft Office issues
- Identifying UI elements in PDF with Accessibility options
- Repairing Active Accessibility support
- Automating Applications Running Under a Different Windows User
- Validation of large Windows-legacy projects takes longer than expected

Studio User Guide
This page explains how to fix issues you might encounter when running automation in Citrix environments.
Description
Starting with Citrix Virtual Apps and Desktops 7 2109, all the custom virtual channels are blocked by default.
If you upgrade to this new Citrix version, the existing automation in Citrix via UiPath Remote Runtime stops working.
Solution
The UiPath virtual channel must be added to the allow list policy. This can be done by following the instructions here.
The value below must be added to the allow list policy.
UIPCTX,<UiPathRemoteRuntime-Install_Path>\UiPathRemoteRuntime.exe
For example:
UIPCTX,C:\Program Files (x86)\UiPath\RemoteRuntime\UiPathRemoteRuntime.exe
Observed behavior
After you install the UiPath Extension for Citrix and try to select UI elements from a Citrix App, interactive selection freezes for one minute, and then nothing is selected.
Cause
This happens if the UiPath Remote Runtime is not running in the Citrix App session.
Solution
- Check if the UiPathRemoteRuntime.msi is installed on the Citrix application server from which the Citrix App is opened.
-
On the Citrix application server, check if the UiPathRemoteRuntime.exe process is running. If the UiPathRemoteRuntime.msi is installed, then the process is started automatically on the Citrix App session login.
Note: If you can not install the UiPathRemoteRuntime.msi on the Citrix application servers, it is recommended to uninstall the UiPath Extension for Citrix from the client machine, as described here.
Could not copy over file "C:\Program Files (x86)\Citrix\ICA Client\UIPathPluginCitrix.dll". It is being used by another process.
Observed behavior
When you try to install the UiPath Extension for Citrix, the following error is displayed:
Cause
This occurs when the UiPath Extension for Citrix is already installed and an open Citrix App is using it.
Solution
Close all your active Citrix App sessions, as described here and then try to install the UiPath Extension for Citrix again.
Observed behavior
When you try to install the UiPath Extension for Citrix, the following error is displayed:
Cause
This error message is displayed when the Citrix Receiver is not installed. It is also displayed if the Citrix Receiver for Universal Windows Platform is installed.
Solution
Download and install the Citrix Receiver or Citrix Workspace.
Observed behavior
Target Citrix App fails to launch and the Citrix ICA client crashes.
Cause
Activities which use the GetWindowText function (such as Element Exists) are executed before the Citrix App can load.
Solution
Allow time for the Citrix App to load by adding a delay before the activity.
Observed behavior
Starting with Citrix Workspace App (CWA) for Windows 2206, if no High DPI policy settings are applied, interactive selection and element identification might not work for Citrix Apps when the display DPI scaling is higher than 100%.
Cause
This is caused by the following change in Citrix: DPI support changes with Citrix Workspace App for Windows 2206.
Solution
Computer\HKEY_CURRENT_USER\SOFTWARE\Citrix\ICA Client\DPI
:
- Troubleshooting
- Virtual channels blocked by default
- Description
- Solution
- Interactive selection in Citrix apps freezes and nothing is selected
- Observed behavior
- Cause
- Solution
- Could not copy over file "C:\Program Files (x86)\Citrix\ICA Client\UIPathPluginCitrix.dll". It is being used by another process.
- Observed behavior
- Cause
- Solution
- Could not read Citrix registry key: 'SOFTWARECitrixInstallICA Client' Value: 'InstallFolder'
- Observed behavior
- Cause
- Solution
- Unhandled exception in Wfica32.exe 0xC0000094: Integer division by zero
- Observed behavior
- Cause
- Solution
- Interactive selection and element identification does not work with high DPI
- Observed behavior
- Cause
- Solution