Configuration steps

Following the steps on this page enables you to build native selectors for Citrix technologies and create automation projects that work with Citrix Apps just as if they were local applications. Once completed, you can use UiPath Studio on the client machine to design and build automations using UI Automation activities and wizards.

Installation prerequisites

To generate native selectors for Citrix technologies, the following components are required:

• Studio v2018.4 or greater on the client machine to install the UiPath Extension for Citrix.
• Citrix Receiver or Citrix Workspace on the client machine.
• Citrix XenApp v6.5 or greater.
• Citrix XenDesktop v7.0 or greater.

Setting up the client

1. Open UiPath Studio.
2. Navigate to Home > Tools > UiPath Extensions.
3. Select Citrix > Install. A confirmation dialog box is displayed.

Result: The UiPath Extension for Citrix is installed.

If UiPath Studio is not installed on the client machine and only the UiPath Robot is present, you can install the UiPath Extension for Citrix from the Command Prompt. To learn more, refer to Extension for Citrix.

Setting up the server

1. Download the UiPathRemoteRuntime.msi installer from:
   • Product Downloads in the UiPath Customer Portal.
   • Download Center in the UiPath Automation Cloud.
2. Install UiPathRemoteRuntime.msi on the Citrix application servers where the applications to be automated are running.

To learn more, refer to UiPath Remote Runtime.

Adding the UiPath virtual channel to the allow list policy

Important:

Starting with Citrix Virtual Apps and Desktops 7 2109, all custom virtual channels are blocked by default. This prevents the UiPath Remote Runtime from working correctly.

To enable the UiPath virtual channel, you must add it to the allow list policy.

1. Follow the Citrix documentation to configure the allow list policy.

2. Add the following value for the UiPath virtual channel to the allow list policy:

   UIPCTX,C:\Program Files (x86)\UiPath\RemoteRuntime\UiPathRemoteRuntime.exe

Restarting active Citrix sessions

After you install the UiPath Remote Runtime and the UiPath Extension for Citrix, you need to restart your active Citrix sessions for the changes to take effect.

Warning:

Save or back up any important data before restarting. Logging off ends the active Citrix session and any unsaved work is lost.

1. Open the context menu for the Citrix Receiver tray icon and select Connection Center. The Citrix Connection Center window is displayed.

2. From the Connections pane, select an active session and select Log Off. Repeat for each active session.

3. Select Close to confirm the changes and close the window.

   

Updating project dependencies

Native selectors for Citrix technologies are only enabled if you add the UiPath.UIAutomation.Activities package v18.4.1 or greater as a dependency for your project.

1. In UiPath Studio, open the Package Manager.

2. From the Project Dependencies pane, select the UiPath.UIAutomation.Activities package.

3. Ensure that the selected package version is v18.4.1 or greater. If it is not, select it from the drop-down and select Update.

4. Select Save to update your dependencies.

   

Note:

If you encounter any issues during installation, refer to Known issues and limitations.