Souscrire

UiPath Studio

Le guide de Studio UiPath

À propos d'UiPath Remote Runtime

UiPath Remote Runtime is a component which facilitates the communication between a remote application or desktop, such as Citrix Virtual Apps, and the dedicated UiPath extension – the UiPath Extension for Citrix, the UiPath Extension for Windows Remote Desktop and Apps, or the UiPath Extension for VMware Horizon. It gathers info about targeted UI elements of remote applications and sends them to the corresponding extension, so that selectors are natively generated in 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.
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

The Remote Runtime component was granted a Citrix Ready certification, making it a trusted, effective solution for working with Citrix technologies.

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 :

The corresponding UiPath extensions must be installed on the client machine.

You can obtain the UiPathRemoteRuntime.msi installer by contacting our Support Team.

Once the UiPath Remote Runtime component is installed, it registers a task in the Task Scheduler so that the UiPathRemoteRuntime.exe process is started at every user login.

15621562

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.

The Remote Runtime Task Scheduler entry can be added or removed via the installer or the Command Prompt, as you can see in the following sections.

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 servers, or the Windows Remote Desktop machines on which you want to create your automation projects.
  2. Log off from the current Citrix window, VMware Horizon window, or RDP session 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, UiPath Extension for VMware Horizon, or the UiPath Extension for Windows Remote Desktop and Apps 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, and Citrix from the installer, as well as the Task Scheduler entry, by selecting the corresponding options, as depicted below:

618618

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.

550550

À 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. Change the directory to the UiPathRemoteRuntime.msi folder (for example: 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, or RDP session 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, UiPath Extension for VMware Horizon, or the UiPath Extension for Windows Remote Desktop and Apps on the client machine, depending on the technology on which you want to create your automation projects.

Additionally, you can use the RemoteRuntimeTask, JavaBridge, ChromeExtension, EdgeChromium, or CitrixClient arguments to install the extension for Task Scheduler entry, Java, Chrome, Microsoft Edge, or Citrix extensions as exemplified below:

  • 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 installer UiPath Remote Runtime n'importe où à l'aide de l'option APPLICATIONFOLDER :

  • UiPathRemoteRuntime.msi APPLICATIONFOLDER="D:\UiPathRemoteRuntime" ADDLOCAL=RemoteRuntime,RemoteRuntimeTask /quiet – silently installs the Remote Runtime component in D:\UiPathRemoteRuntime, and adds the Task Scheduler entry.

You can now create processes to automate on Citrix Virtual Apps and Desktops, VMware Apps, 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.

UIAutomation Dependency

The UiPath Remote Runtime has a dependency on the version of the UiPath.UIAutomation.Activities package, not on the version of UiPath Studio/Robot.

The Remote Runtime installed on a remote machine must have the version of the latest UIAutomation package you want to use in your projects, and it is compatible with the previous UIAutomation releases (it is backwards compatible).

The UiPath.UIAutomation.Activities package and the UiPath Remote Runtime have the same UiPath driver dependency. For each UIAutomation package released version, a download link for the UiPath Remote Runtime component with the same version number is provided.

You can download the UiPathRemoteRuntime.msi installer from:

Prise en charge côte à côte

The UiPath Remote Runtime component is installed on the Citrix Application server, VMware server, or Remote Desktop machine in the %ProgramFiles(x86)\UiPath folder. All installed versions are visible in the %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath folder.

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.

The version of the UiPath driver dependency for the UiPath.UIAutomation.Activities package is displayed in Studio, in the Package Manager info section.

372372

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

752752

Each UiPathRemoteRuntime.msi installer contains the latest UiPath dependency, as well as the latest supported Long Term Support (LTS) UiPath dependencies.

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

UIAutomation package versionUiPathRemoteRuntime build numberUiPath driver dependencyUIAutomation compatible versions for UiPathRemoteRuntime
22.10.322.10.46.4763522.10.46.4763522.10.3
22.4.7
21.10.7
20.10.12
19.11.5
18.4.8
22.4.722.4.42.6195122.4.42.6195122.4.7
21.10.7
20.10.12
19.11.5
18.4.8
21.10.721.10.42.6490521.10.42.6490521.10.7
20.10.12
19.11.5
18.4.8
20.10.1220.10.8242.2323820.10.8242.2323820.10.12
19.11.5
18.4.8
19.11.519.10.7601.1536919.10.7601.1536919.11.5
18.4.8
18.4.810.0.7772.1918410.0.7772.1918419.11.5
18.4.8

You can verify the Remote Runtime build number from the UiPathRemoteRuntime.msi file Properties, in the Details tab, in the Comments field.

540540

If you use a version of the UiPath.UIAutomation.Activities package that has a UiPath dependency which is not part of the set of installed UiPath dependencies on the remote machine, selectors are not generated and the following exception is thrown: 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 server, or the Remote Desktop machine.

For example, if you want to build an automation project using the UiPath.UIAutomation.Activities package version 21.10.7, you also need to copy the corresponding UiPath dependency from the client machine (where Studio is installed) on the Citrix Application server, VMware server, or the Remote Desktop machine.
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. Copy the version which corresponds to the UiPath.UIAutomation.Activities package you want to use. You can view the list of dependencies shipped with the UiPath.UIAutomation.Activities package on the About UIAutomation Activities page or by checking the package dependencies in Studio > Manage Packages.
  3. On the Citrix Application server, VMware server, or the Remote Desktop machine, navigate to the %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath folder and paste the previously copied UiPath dependency version here.

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.

The Remote Runtime Dependencies described above are required both for the design time and execution time.

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.

752752

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.

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.

Mis à jour il y a 13 jours

À propos d'UiPath Remote Runtime


Les modifications suggérées sont limitées sur les pages de référence de l'API

Vous pouvez uniquement suggérer des modifications au contenu du corps de Markdown, mais pas aux spécifications de l'API.