UiPath Remote Runtime

À propos d'UiPath Remote Runtime

UiPath Remote Runtime est un composant qui permet la communication entre les postes de travail ou applications distants, tels que Citrix Virtual Apps et certaines extensions UiPath. Sont notamment incluses les extensions UiPath pour Citrix, Bureau à distance et applications Windows, pour VMware Horizon et pour Amazon Workspaces. Il recueille des informations sur les éléments d’IU ciblés d’applications distantes et transmet ces données à l’extension correspondante. Cela permet la génération native de sélecteurs dans UI Explorer.

Remarque :

À partir de Citrix Virtual Apps and Desktops 7 2109, tous les canaux virtuels personnalisés sont bloqués par défaut. Cela empêche UiPath Remote Runtime de fonctionner correctement. Pour résoudre ce problème, le canal virtuel UiPath doit être ajouté à la stratégie de liste d'autorisation : UIPCTX,C:\Program Files (x86)\UiPath\RemoteRuntime\UiPathRemoteRuntime.exe

Le composant Remote Runtime a obtenu la certification Citrix Ready, ce qui en fait une solution fiable et efficace pour utiliser les technologies Citrix.

Selon le type d'environnement sur lequel vous voulez créer vos projets d'automatisation, le composant UiPath Remote Runtime peut être installé comme suit :

• Sur les serveurs d'applications Citrix : communique avec l'extension UiPath pour Citrix.
• Sur les machines virtuelles VMware Horizon : communique avec l'extension UiPath pour VMware Horizon.
• Sur les machines Windows Remote Desktop - communique avec l'extension UiPath pour Windows Remote Desktop et les applications.
• Sur les machines Amazon WorkSpaces : communique avec l’extension UiPath pour Amazon WorkSpaces.
  Remarque :

  Amazon WorkSpaces prend en charge la configuration avec les protocoles DCV (Desktop Cloud Visualization) ou PCoIP (PC-over-IP).

  • L'automatisation d'Amazon WorkSpaces à l'aide du protocole PCoIP nécessite UiPath.UIAutomation.Activities, UiPath Studio et UiPath Remote Runtime v24.10 ou une version ultérieure.
  • L'automatisation d'Amazon WorkSpaces à l'aide du protocole DCV nécessite UiPath.UIAutomation.Activities, UiPath Studio et UiPath Remote Runtime v25.2 ou une version ultérieure.

Notez que les extensions UiPath correspondantes doivent être installées sur la machine cliente.

Le programme d'installation UiPathRemoteRuntime.msi peut être téléchargé à partir de :

• Téléchargements de produits sur le UiPath Customer Portal.
• Centre de ressources dans le UiPath Automation Cloud. Pour accéder au centre de ressources, vous devez vous connecter à votre organisation Automation Cloud et cliquer sur le bouton Aide (Help) dans la barre de navigation de gauche.

Une fois le composant UiPath Remote Runtime installé, il enregistre une tâche dans le Planificateur de tâches (Task Scheduler) afin que le processus UiPathRemoteRuntime.exe soit démarré à chaque connexion utilisateur, pour chaque utilisateur connecté au serveur à distance.

Le composant UiPath Remote Runtime est requis pour établir la connexion entre un serveur d'application et de poste de travail et une extension UiPath correspondante installée sur une machine cliente. De cette façon, les sélecteurs sont générés en mode natif sur la machine cliente sur laquelle Studio est installé, sans devoir s'appuyer sur des activités OCR et de reconnaissance d'images.

Prérequis logiciels et matériels

UiPath Remote Runtime possède les mêmes exigences que UiPath Robot. Consultez la liste complète des exigences dans le guide Robot.

Installation d'UiPath Remote Runtime

À partir du programme d'installation

1. Exécutez le fichier UiPathRemoteRuntime.msi pour installer UiPath Remote Runtime. Il doit être installé sur tous les serveurs d’applications Citrix, les machines virtuelles VMware Horizon, les machines Bureau à distance Windows ou les bureaux virtuels Amazon WorkSpaces sur lesquels s’exécutent les applications cibles de l’automatisation.
2. Déconnectez-vous de la fenêtre Citrix actuelle, de la fenêtre VMware Horizon, de la session RDP ou du bureau virtuel Amazon WorkSpaces sur la machine cliente et reconnectez-vous. Cela est nécessaire pour que vos modifications prennent effet.
3. Installez l’extension UiPath pour Citrix, pour VMware Horizon, pour le bureau à distance et les applications Windows ou pour Amazon WorkSpaces sur la machine cliente, selon la technologie sur laquelle vous souhaitez créer vos projets d’automatisation.

Vous pouvez également choisir de déployer l’extension pour Java, Chrome, Microsoft Edge, Firefox, le bureau à distance et les applications Microsoft, VMware, Citrix et Amazon WorkSpacesà partir du programme d’installation, ainsi que l’entrée Planificateur de tâches (Task Scheduler), en sélectionnant les options correspondantes, comme illustré ci-dessous :

L'entrée Planification de tâches pour Remote Runtime peut être ajoutée ou supprimée à tout moment. Exécutez simplement le programme d'installation UiPathRemoteRuntime.msi et choisissez l'option correspondante.

À partir d'une ligne de commande

Remarque :

L'installation de UiPathRemoteRuntime.msi nécessite des droits d'Administrator.

1. Cliquez sur le bouton Démarrer de Windows et tapez cmd dans le champ de recherche.
2. Cliquez avec le bouton droit de la souris sur l'outil Invite de commandes et exécutez-le en tant qu'administrateur.
3. Passez le répertoire au dossier UiPathRemoteRuntime.msi (par exemple : cd C:\Tools\Studio).
4. Utilisez la commande UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask pour installer le composant UiPath Remote Runtime.
5. Déconnectez-vous de la fenêtre Citrix actuelle, de la fenêtre VMware Horizon, de la session RDP ou du bureau virtuel Amazon Workspaces sur la machine cliente et reconnectez-vous. Cela est nécessaire pour que vos modifications prennent effet.
6. Installez l’extension UiPath pour Citrix, pour VMware Horizon, pour le bureau à distance et les applications Windows ou pour Amazon WorkSpaces sur la machine cliente, selon la technologie sur laquelle vous souhaitez créer vos projets d’automatisation.

Vous pouvez en outre utiliser les options suivantes pour installer les extensions :

• UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask,JavaBridge,ChromeExtension,EdgeChromium,CitrixClient,FirefoxExtension,WindowsRdpExtension,VMwareExtension,AmazonWorkSpacesClient : installe le composant Remote Runtime, l’entrée Planificateur de tâches (Task Scheduler) et les extensions pour Java, pour Chrome, pour Microsoft Edge, pour Citrix, pour Firefox, pour le bureau à distance et les applications Microsoft, pour VMware Horizon et pour Amazon WorkSpaces.

Vous pouvez également effectuer une installation silencieuse en utilisant le paramètre /quiet :

• UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask /quiet : installe en mode silencieux le composant Remote Runtime et l'entrée Planificateur de tâches (Task Scheduler).

Vous pouvez installer UiPath Remote Runtime n'importe où à l'aide de l'option APPLICATIONFOLDER :

• UiPathRemoteRuntime.msi APPLICATIONFOLDER="D:\UiPathRemoteRuntime" ADDLOCAL=RemoteRuntime,RemoteRuntimeTask /quiet : installe en mode silencieux le composant Remote Runtime dans D:\UiPathRemoteRuntime, et ajoute l'entrée Planificateur de tâches (Task Scheduler).

Vous pouvez désormais créer des processus à automatiser sur les applications et bureaux virtuels Citrix, les applications VMware, les bureaux virtuels Amazon WorkSpaces, ainsi que des connexions RDP, comme vous le feriez sur une machine standard. En raison des extensions correspondantes, les activités OCR et de reconnaissance d’image ne sont plus nécessaires pour identifier correctement les éléments d’IU. Au lieu de cela, les éléments sont reconnus nativement et peuvent être utilisés avec n’importe quelle activité.

Planificateur de tâches

Par défaut, le composant UiPath Remote Runtime crée une entrée dans le Planificateur de tâches Windows pour démarrer automatiquement chaque fois que l'utilisateur correspondant se connecte. Cette fonctionnalité est représentée par l'option Créer une tâche de lancement UiPathRemoteRuntime (Create Launch UiPathRemoteRuntime task) dans le programme d'installation UiPathRemoteRuntime.msi, que vous pouvez choisir de désactiver, si nécessaire.

The Remote Runtime Task Scheduler entry can be added or removed via the installer or the Command Prompt, as explained in the following sections. If the entry is removed, you must launch the UiPathRemoteRuntime.exe process using another method, like a startup script.

L'entrée Planificateur de tâches Remote Runtime (Remote Runtime Task Scheduler) peut également être modifiée pour démarrer uniquement pour un utilisateur spécifique, en cliquant sur le bouton Modifier (Edit) dans l'onglet Déclencheurs (Triggers). Plusieurs tâches peuvent être créées pour plusieurs utilisateurs.

Dépendance UIAutomation

UiPath Remote Runtime dépend de la version du package UiPath.UIAutomation.Activities, et non de la version de UiPath Studio/Robot.

Le Remote Runtime installé sur une machine à distance doit avoir la version du dernier package UIAutomation que vous voulez utiliser dans vos projets, et il est compatible avec les versions précédentes d'UIAutomation (il est rétrocompatible).

Les packages UiPath.UIAutomation.Activities et UiPath Remote Runtime ont la même dépendance de pilote UiPath. Pour chaque version publiée de package UI Automation, un lien de téléchargement pour le composant UiPath Remote Runtime avec le même numéro de version est fourni.

Par exemple, pour le package UiPath.UIAutomation.Activities version 23.10.8, le programme d'installation UiPath Remote Runtime requis peut être téléchargé à partir de https://download.uipath.com/versions/23.10.8/UiPathRemoteRuntime.msi.

Vous pouvez télécharger le programme d'installation UiPathRemoteRuntime.msi à partir de :

• Téléchargements de produits sur le UiPath Customer Portal.
• Centre de ressources dans UiPath Automation Cloud.Pour accéder au Centre de ressources, vous devez vous connecter à votre Organization Automation Cloud, cliquer sur le bouton Aide dans la barre d'outils et choisir Ressources > Téléchargements.
• Vous pouvez également le demander via la page Contacter le support technique.

Prise en charge côte à côte

Le composant UiPath Remote Runtime est installé sur le serveur d'applications Citrix, le machine virtuelle VMware ou la machine Bureau à distance dans le dossier %ProgramFiles(x86)\UiPath. Toutes les versions installées sont visibles dans le dossier %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath.

When you build or execute a process, you need to use a UiPath.UIAutomation.Activities package which is compatible with the deployed driver version of the UiPath Remote Runtime.

La version de la dépendance de pilote UiPath pour le package UiPath.UIAutomation.Activities s'affiche dans Studio, dans la section d'informations Dépendances du projet.

The same UiPath version must be present on the remote machine, in the %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath folder.

Chaque programme UiPathRemoteRuntime.msi d’installation contient la dernière dépendance UiPath ainsi que les dernières dépendances UiPath prises en charge pour l’assistance longue durée.Les versions du package UiPath.UIAutomation.Activities compatible pour un programme d'installation UiPath Remote Runtime spécifique peuvent être vérifiées dans la fenêtre Propriétés du fichierUiPathRemoteRuntime.msi.

The table below enlists the dependencies between the UiPath.UIAutomation.Activities package and UiPath Remote Runtime:

Dernière version du package UI Automation	Dépendance du pilote UiPath	Versions compatibles UIAutomation pour UiPathRemoteRuntime	Numéro de build UiPathRemoteRuntime
25.10.26	25.10.168.53295	25.10.26 25.10.16 25.10.13 25.10.6 25.10.4 25.10.3 25.10.2 24.10.16 23.10.19 23.4.11	25.10.26
24.10.16	24.10.163.64928	24.10.16 23.10.19 23.4.11 22.10.11 22.4.12 22.4.11 21.10.10	24.10.16
23.10.19	23.10.163.64942	23.10.19 23.4.11 22.10.11 22.4.12 22.4.11 21.10.10 20.10.15	23.10.19
23.4.11	23.4.81.50665	23.10.11 23.4.11 22.10.10 22.4.12 22.4.11 21.10.10 20.10.15	23.10.86.3201
22.10.11	22.10.136.43035	25.10.6 25.10.4 25.10.3 25.10.2 24.10.13 24.10.12 23.10.17 23.4.11 22.10.11 22.4.12 22.4.11 21.10.10 20.10.15	22.10.11
22.4.12	22.4.67.58669	23.4.10 22.10.10 22.4.12 22.4.11 21.10.10 20.10.15	23.4.67.63183
21.10.10	21.10.67.58666	23.4.10 22.10.10 22.4.12 22.4.11 21.10.10 20.10.15	23.4.67.63183
20.10.15	20.10.8676.29744	23.4.10 22.10.10 22.4.12 22.4.11 21.10.10 20.10.15	23.4.67.63183
19.11.5	19.10.7601.15369	22.4.7 21.10.7 20.10.12 19.11.5 18.4.8	22.4.43.27553
18.4.8	10.0.7772.19184	22.4.7 21.10.7 20.10.12 19.11.5 18.4.8	22.4.43.27553

Si vous utilisez une version du package UiPath.UIAutomation.Activities dont la dépendance UiPath ne fait pas partie de l'ensemble des dépendances UiPath installées sur la machine distante, les sélecteurs ne sont pas créés et l'exception suivante est générée : The UiPath.UIAutomation.Activities package is incompatible with the UiPath Remote Runtime running on the server.

Ajout de dépendances de Remote Runtime

La sélection interactive sur l’application cible ne génère pas de sélecteurs corrects, sauf si le package UiPath.UIAutomation.Activities correspond à la dépendance de UiPath Remote Runtime sur le serveur d’applications Citrix, la machine virtuelle VMWare, la machine de bureau à distance ou le bureau à distance Amazon WorkSpaces.

Par exemple, si vous souhaitez créer un projet d’automatisation à l’aide du package UiPath.UIAutomation.Activities version 23.10.8, vous devez copier la dépendance UiPath correspondante de la machine cliente (où Studio/Robot est installé) sur le serveur d’applications Citrix, la machine virtuelle VMware, la machine Bureau à distance ou le bureau virtuel Amazon WorkSpaces.

Cela s'effectue comme suit :

1. On the client machine (where Studio is installed), navigate to the %UserProfile%\.nuget\packages\uipath folder. All installed UiPath dependencies are located here.
2. Copiez le dossier avec la version qui correspond au package UiPath.UIAutomation.Activities que vous souhaitez utiliser. Vous pouvez afficher la liste des dépendances livrées avec le package UiPath.UIAutomation.Activities sur la page À propos des activités UIAutomation ou en vérifiant les dépendances du package comme décrit dans l'assistance côte à côte.

1. Sur le serveur d’applications Citrix, la machine virtuelle VMware, la machine Bureau à distance ou le bureau virtuel Amazon WorkSpaces, accédez au dossier %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath et collez la version de la dépendance UiPath copiée auparavant.
   • Par exemple, pour UiPath.UIAutomation.Activities version 23.10.8, la dépendance UiPath correspondante est 23.10.71.64399. Il s’agit du nom du dossier que vous devez copier depuis la machine Studio/Robot vers la machine distante.

Les sélecteurs sont maintenant correctement générés avec votre version actuelle du paquet UiPath.UIAutomation.Activities. Les modifications prennent effet dès que la dépendance est copiée.

Les dépendances de Remote Runtime décrites ci-dessus sont requises à la fois pour la conception et pour l'exécution.

Architecture de Remote Runtime

Lorsque vous démarrez un processus, le Robot envoie les commandes nécessaires à l'extension pour Citrix ou Bureau à distance Windows via un canal RPC. Ce paquet d’informations contient également des détails sur la version du paquet UIAutomation utilisé pour générer le processus.

L'extension correspondante transmet ensuite le paquet d'informations via un canal virtuel ICA au composant UiPath Remote Runtime, qui se trouve sur les serveurs d'applications Citrix ou l'ordinateur de bureau à distance.

En fonction de la version du paquet UIAutomation avec lequel le processus a été créé, le composant UiPath Remote Runtime indique à l'exécuteur du Robot quel pilote utiliser.

Plusieurs canaux ICA

La communication entre le composant Remote Runtime et l'extension correspondante s'effectue via un canal ICA développé en interne. Plusieurs canaux ICA peuvent être utilisés, mais Citrix Receiver, par exemple, utilise déjà plusieurs canaux pour le Presse-papiers, l'audio, etc.

Considérations de transfert de données et de bande passante

Une fois le composant Remote Runtime installé, vous pouvez créer vos projets d'automatisation sans devoir créer de règles de pare-feu.

Le transfert de données entre Remote Runtime et l’extension nécessite une utilisation réduite de la bande passante. Par exemple, chaque action effectuée par le Robot (telle qu'une activité Click) transfère environ 3 Ko de données.

Plusieurs connexions distantes

Si vous passez par plusieurs connexions distantes (RDP, Citrix ou VMware) pour atteindre un ordinateur distant de destination où l’automatisation est développée, vous devez installer Remote Runtime sur chaque ordinateur distant intermédiaire, et non uniquement sur l’ordinateur cible. Pour plus de détails, consultez la page Configurer une connexion multi-sauts.