studio
2024.10
true
Guide de l’utilisateur de Studio
Last updated 30 oct. 2024

UiPath Remote Runtime

À propos d'UiPath Remote Runtime

UiPath Remote Runtime is a component which enables the communication between a remote desktops or applications, such as Citrix Virtual Apps, and certain UiPath extensions. These include the UiPath Extension for Citrix, for Windows Remote Desktop and Apps, for VMware Horizon, and for Amazon WorkSpaces. It gathers information about targeted UI elements of remote applications and passes this data to the corresponding extension. This allows for native generation of selectors in the UI Explorer.

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. Pour résoudre ce problème, le canal virtuel UiPath doit être ajouté à la stratégie de liste d'autorisations:

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 :

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 via 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 a les mêmes exigences que UiPath Robot. Consultez la liste complète des exigences dans Prérequis logiciels et matériels (Hardware and Software Requirements).

Installation d'UiPath Remote Runtime

À partir du programme d'installation

  1. Run the UiPathRemoteRuntime.msi file to install the UiPath Remote Runtime. It needs to be installed on all the Citrix Application servers, VMware Horizon virtual machines, Windows Remote Desktop machines, or the Amazon WorkSpaces virtual desktops where the target applications for automation run.
  2. Log off from the current Citrix window, VMware Horizon window, RDP session, or the Amazon WorkSpaces virtual desktop on the client machine and log back in. This is required so that your changes take effect.
  3. Install either the UiPath Extension for Citrix, for VMware Horizon, for Windows Remote Desktop and Apps, or for Amazon WorkSpaces on the client machine, depending on the technology on which you want to create your automation projects.

You can also choose to deploy the extension for Java, Chrome, Microsoft Edge, Firefox, Microsoft Remote Desktop and Apps, VMware, Citrix, and Amazon WorkSpaces from the installer, as well as the Task Scheduler entry, by selecting the corresponding options, as depicted below:



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

Note: Installing the UiPathRemoteRuntime.msi requires administrator rights.
  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. Log off from the current Citrix window, VMware Horizon window, RDP session, or the Amazon Workspaces virtual desktop on the client machine and log back in. This is required so that your changes take effect.
  6. Install either the UiPath Extension for Citrix, for VMware Horizon, for Windows Remote Desktop and Apps, or for Amazon WorkSpaces on the client machine, depending on the technology on which you want to create your automation projects.

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 – installs the Remote Runtime component, the Task Scheduler entry, and the extensions for Java, for Chrome, for Microsoft Edge, for Citrix, for Firefox, for Microsoft Remote Desktop and Apps, for VMware Horizon, and for 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).

You can now create processes to automate on Citrix Virtual Apps and Desktops, VMware Apps, Amazon WorkSpaces virtual desktops, as well as over RDP connections just as you would on a standard machine. Because of the corresponding extensions, OCR and image recognition activities are no longer required to properly identify UI elements. Instead, elements are natively recognized and can be used with any activity.

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 de tâche Créer un lancement UiPathRemoteRuntime dans le programme d'installation UiPathRemoteRuntime.msi, que vous pouvez choisir de désactiver, si nécessaire.
L'entrée Planificateur de tâches Remote Runtime (Remote Runtime Task Scheduler) 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. Si l'entrée est supprimée, vous devez lancer le processus UiPathRemoteRuntime.exe à l'aide d'une autre méthode, comme un script de démarrage.
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 :

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.

Lorsque vous générez ou exécutez un processus, vous devez utiliser un package UiPath.UIAutomation.Activities compatible avec la version du pilote déployé de 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.
docs image
La même version UiPath doit être présente sur la machine à distance, dans le dossier %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath.
docs image
docs image
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.

La table ci-dessous répertorie les dépendances entre le package UiPath.UIAutomation.Activities et UiPath Remote Runtime :

Version du package UIAutomation

Numéro de build UiPathRemoteRuntime

Dépendance du pilote UiPath

Versions compatibles UIAutomation pour UiPathRemoteRuntime

24.10.724.10.108.1609624.10.108.16096

24.10.7

23.10.13

23.4.11

22.10.9

22.4.11

21.10.10

20.10.15

23.10.13

23.10.97.53968

23.10.97.53968

23.10.13

23.4.11

22.10.10

22.4.12

21.10.10

20.10.15

23.4.11

23.10.86.3201

23.4.81.50665

23.10.11

23.4.11

22.10.10

22.4.12

21.10.10

20.10.15

22.10.1023.4.67.6318322.10.67.59238

23.4.10

22.10.10

22.4.12

21.10.10

20.10.15

22.4.1223.4.67.6318322.4.67.58669

23.4.10

22.10.10

22.4.12

21.10.10

20.10.15

21.10.1023.4.67.6318323.4.67.63183

23.4.10

22.10.10

22.4.12

21.10.10

20.10.15

20.10.1523.4.67.6318320.10.8676.29744

23.4.10

22.10.10

22.4.12

21.10.10

20.10.15

19.11.5

22.4.43.27553

19.10.7601.15369

22.4.7

21.10.7

20.10.12

19.11.5

18.4.8

18.4.8

22.4.43.27553

10.0.7772.19184

22.4.7

21.10.7

20.10.12

19.11.5

18.4.8

Vous pouvez vérifier le numéro de build de Remote Runtime dans les Propriétés (Properties) du fichier UiPathRemoteRuntime.msi, dans l'onglet Détails (Details), dans le champ Commentaires (Commentaires).
docs image
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

Interactive selection on the target application does not build correct selectors unless the UiPath.UIAutomation.Activities matches the UiPath Remote Runtime dependency on the Citrix Application server, VMware virtual machine, the Remote Desktop machine, or the Amazon WorkSpaces virtual desktop,

For example, if you want to build an automation project using the UiPath.UIAutomation.Activities package version 23.10.8, you need to copy the corresponding UiPath dependency from the client machine (where Studio/Robot is installed) on the Citrix Application server, VMware virtual machine, the Remote Desktop machine, or the Amazon WorkSpaces virtual desktop.

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 UiPath installées se trouvent ici.
  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 fournies avec le package UiPath.UIAutomation.Activities sur la page À propos des activités UIAutomation ou en cochant les dépendances du package comme décrit dans Prise en charge côte à côte.


  3. On the Citrix Application server, VMware virtual machine, the Remote Desktop machine, or the Amazon WorkSpaces virtual desktop, navigate to the %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath folder and paste the previously copied UiPath dependency version here.
    • 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.

Cette page vous a-t-elle été utile ?

Obtenez l'aide dont vous avez besoin
Formation RPA - Cours d'automatisation
Forum de la communauté UiPath
Uipath Logo White
Confiance et sécurité
© 2005-2024 UiPath Tous droits réservés.