UiPath Remote Runtime

À propos d'UiPath Remote Runtime

UiPath Remote Runtime est un composant qui facilite la communication entre une application ou un poste de travail distant, tel que Citrix Virtual Apps, et l'extension UiPath dédiée - Extension UiPath pour Citrix, l'Extension UiPath pour Bureau à distance Windows ou l'extension UIPath pour VMware Horizon. Il recueille des informations sur les éléments d'IU ciblés d'applications distantes et les envoie à l'extension correspondante afin que les sélecteurs soient générés en mode natif dans UIExplorer.

Remarque :

Depuis la version 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.

To solve this issue the UiPath virtual channel must be added to the allow list policy:

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 :

• On Citrix Application servers - communicates with the UiPath Extension for Citrix.
• On VMware Horizon virtual machines - communicates with the UiPath Extension for VMware Horizon.
• On Windows Remote Desktop machines - communicates with the UiPath Extension for Windows Remote Desktop.

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

The UiPathRemoteRuntime.msi installer is included in UiPathPlatformInstaller.exe, or you can obtain it by contacting our Support Team. Please note that UiPathPlatformInstaller.exe does not support command line arguments.

Une fois le composant UiPath Remote Runtime installé, il enregistre une tâche dans TaskScheduler afin que le processus UiPathRemoteRuntime.exe soit démarré à chaque connexion de l'utilisateur.

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.

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.

L'entrée Planification de tâches Remote Runtime peut être ajoutée ou supprimée via le programme d'installation ou l'invite de commande, comme vous pouvez le voir dans les sections suivantes.

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 ou les ordinateurs de bureau à distance Windows sur lesquels vous souhaitez créer vos projets d'automatisation.
2. Déconnectez-vous de la fenêtre Citrix ou de la session RDP en cours sur la machine cliente et reconnectez-vous. Cela est obligatoire pour appliquer les modifications.
3. Installe l'extension UiPath pour Citrix ou l'extension UiPath pour Bureau à distance Windows sur la machine cliente, selon la technologie sur laquelle vous voulez créer vos projets d'automatisation.

Vous pouvez également choisir de déployer l'extension pour Java, Chrome et Citrix à partir du programme d'installation, ainsi que l'entrée Planification de tâches, 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'administrateur.

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 ou de la session RDP en cours sur la machine cliente et reconnectez-vous. Cela est obligatoire pour appliquer les modifications.
6. Installe l'extension UiPath pour Citrix ou l'extension UiPath pour Bureau à distance Windows sur la machine cliente, selon la technologie sur laquelle vous voulez créer vos projets d'automatisation.

En outre, vous pouvez utiliser les arguments RemoteRuntimeTask, JavaBridge, ChromeExtension, EdgeChromium ou CitrixClient pour installer l'extension pour l'entrée Planificateur de tâches (Task Scheduler), les extensions Java, Chrome, Microsoft Edge ou Citrix, comme illustré ci-dessous :

• UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask,JavaBridge,ChromeExtension,EdgeChromium,CitrixClient : installe le composant Remote Runtime, l'entrée Planificateur de tâches (Task Scheduler), l'extension pour Java, l'extension pour Chrome, l'extension pour Microsoft Edge et l'extension pour Citrix.

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 à présent créer des processus à automatiser sur Citrix Virtual Apps and Desktops ainsi que sur les connexions RDP, comme vous le feriez sur une machine standard. En raison des extensions correspondantes, les activités OCR et de reconnaissance d'images ne sont plus requises pour identifier correctement les éléments d'IU. À la place, les éléments sont reconnus nativement et peuvent être utilisés avec toute activité.

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.

Dépendances de pilotes

La même version doit être attribuée à la dépendance des pilotes UiPath Remote Runtime et UiPath du paquet UiPath.UIAutomation.Activities. Cependant, lorsque UiPath Remote Runtime est mis à niveau pour correspondre à une nouvelle dépendance de pilote UiPath pour le package UiPath.UIAutomation.Activities, UiPath Remote Runtime reste rétrocompatible avec toutes les versions précédemment installées.

La version de Remote Runtime est régie par le champ Commentaires (Comments), situé dans l'onglet Détails (Details) des propriétés UiPathRemoteRuntime.msi.

La version de dépendance des pilotes UiPath est affichée dans le Gestionnaire de paquets (Package Manager) dans la section d'informations du paquet UiPathUIAutomation.Activities.

You can view the dependencies shipped with each version of the UiPath.UIAutomation.Activities package on this page.

Prise en charge côte à côte

Le composant UiPath Remote Runtime a été introduit pour la première fois dans v2018.4. Pour garantir la rétrocompatibilité, les versions plus récentes du Robot (comme Robot v2019.10.1) sont capables d'exécuter des processus créés avec le paquet d'UIAutomation version 18.4.5 et ultérieures sans aucun problème.

Il est installé sur le serveur d'applications Citrix ou sur l'ordinateur de bureau à distance dans le dossier %ProgramFiles(x86)%\UiPath. Toutes les versions installées sont visibles dans le dossier %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath.

Lorsque vous créez ou exécutez un processus, vous devez utiliser un paquet UiPath.UIAutomation.Activities compatible avec la version du pilote déployé d'UiPath Remote Runtime. Le pilote est représenté par la dépendance UiPath du paquet UiPath.UIAutomation.Activities.

This page displays which UiPath.UIAutomation.Activities package contains compatible driver versions for the UiPath Remote Runtime.

Chaque programme d'installation UiPathRemoteRuntime.msi contient la dernière dépendance UiPath, ainsi que la dernière dépendance UiPath Long Term Support (LTS) prise en charge.

Notez que si vous utilisez une version du paquet UiPath.UIAutomation.Activities qui ne contient aucune des dépendances UiPath mentionnées ci-dessus, les sélecteurs ne sont pas générés et une exception est levée, comme affiché ci-dessous.

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 paquet UiPath.UIAutomation.Activities correspond à la dépendance d'UiPath Remote Runtime sur le serveur d'applications Citrix ou sur l'ordinateur de bureau à distance.

Par exemple, si vous souhaitez créer un projet d'automatisation à l'aide du paquet UiPath.UIAutomation.Activities version 19.6.0, vous devez également copier la dépendance UiPath correspondante depuis la machine cliente (où Studio est installé) sur le serveur d'applications Citrix ou sur l'ordinateur de bureau à distance. Cela s'effectue comme suit :

1. Sur la machine cliente (où Studio est installé), accédez au dossier %UserProfile%\.nuget\packages\uipath. Toutes les dépendances installées d'UiPath se trouvent là.
2. Copy the version which corresponds to the UiPath.UIAutomation.Activities package you want to use. You can view the list of dependencies shipped the UiPath.UIAutomation.Activities package on this page.
3. Sur le serveur d'applications Citrix ou sur l'ordinateur de bureau à distance, accédez au dossier %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath et collez la version de la dépendance UiPath copiée auparavant.

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.

Prérequis logiciels et matériels

The UiPath Remote Runtime has the same requirements as the UiPath Robot. See the full list of requirements here.