UiPath Remote Runtime

Über 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.

Hinweis:

Ab Citrix Virtual Apps und Desktops 7 2109 werden standardmäßig alle benutzerdefinierten virtuellen Kanäle blockiert. Das verhindert, dass die UiPath Remote Runtime korrekt funktioniert. Um dieses Problem zu beheben, muss der virtuelle UiPath-Kanal zur Zulassungslistenrichtlinie hinzugefügt werden:

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

Die Remote Runtime-Komponente wurde mit einer Citrix Ready-Zertifizierung ausgezeichnet, was sie zu einer vertrauenswürdigen, effektiven Lösung für die Arbeit mit Citrix-Technologien macht.

Je nach dem Typ der Umgebung, auf der Sie Ihre Automationsprojekte aufbauen möchten, kann die Komponente UiPath Remote Runtime folgendermaßen installiert werden:

• Auf Citrix-Anwendungsservern: Kommuniziert mit der UiPath-Erweiterung für Citrix.
• Auf virtuellen Maschinen von VMware Horizon – Kommuniziert mit der UiPath-Erweiterung für VMware Horizon.
• Auf Windows-Remotedesktopmaschinen: Kommuniziert mit der UiPath-Erweiterung für Windows-Remotedesktop und -anwendungen.

Bitte beachten Sie, dass die entsprechenden UiPath-Erweiterungen auf der Client-Maschine installiert werden müssen.

Das UiPathRemoteRuntime.msi-Installationsprogramm kann heruntergeladen werden von:

• Produktdownloads im UiPath Customer Portal.
• Ressourcenzentrum in der UiPath Automation Cloud. Um auf das Ressourcenzentrum zuzugreifen, müssen Sie sich bei Ihrer Automation Cloud-Organisation anmelden und auf die Hilfe-Schaltfläche in der linken Navigationsleiste klicken.

Sobald die Komponente UiPath Remote Runtime installiert ist, registriert sie eine Aufgabe im Taskplaner, sodass der UiPathRemoteRuntime.exe-Prozess bei jeder Benutzeranmeldung für jeden Benutzer gestartet wird, der beim Remoteserver angemeldet ist.

Die Komponente UiPath Remote Runtime ist erforderlich, um die Verbindung zwischen einer Anwendung oder dem Desktop-Server und einer entsprechenden auf einem Client-Computer installierten UiPath-Erweiterung herzustellen. Auf diese Weise werden Selektoren nativ auf dem Client-Computer generiert, auf dem Studio installiert ist, ohne dass Sie auf OCR- und Bilderkennungsaktivitäten zurückgreifen müssen.

Taskplaner

Standardmäßig erstellt die UiPath Remote Runtime-Komponente einen Eintrag im Windows-Taskplaner, der automatisch jedes Mal gestartet wird, wenn sich der entsprechende Benutzer anmeldet. Diese Funktion wird durch die Taskoption UiPathRemoteRuntime starten im UiPathRemoteRuntime.msi-Installationsprogramm dargestellt, das Sie bei Bedarf deaktivieren können.

Der Eintrag Remote Runtime Task Scheduler kann über das Installationsprogramm oder die Eingabeaufforderung hinzugefügt oder entfernt werden, wie Sie in den folgenden Abschnitten sehen können. Wenn der Eintrag entfernt wird, müssen Sie den UiPathRemoteRuntime.exe-Prozess mit einer anderen Methode starten, z. B. mit einem Startskript.

Der Remote Runtime Task Scheduler-Eintrag kann auch bearbeitet werden, um nur für einen bestimmten Benutzer zu starten, indem Sie auf die Schaltfläche Bearbeiten auf der Registerkarte Trigger klicken. Mehrere Aufgaben können für mehrere Benutzer erstellt werden.

Installieren von UiPath Remote Runtime

Aus dem Installer

1. Führen Sie die Datei UiPathRemoteRuntime.msi aus, um UiPath Remote Runtime zu installieren. Sie muss auf allen Citrix-Anwendungsservern, virtuellen VMware Horizon-Maschinen oder Windows-Remotedesktopmaschinen installiert sein, auf denen Sie Ihre Automatisierungsprojekte erstellen möchten.
2. Melden Sie sich von der aktuellen Citrix-Fenster-, VMware Horizon-Fenster oder RDP-Sitzung auf dem Client-Computer ab und wieder an, damit Ihre Änderungen wirksam werden.
3. Installieren Sie abhängig von der Technologie, für die Sie Ihre Automatisierungsprojekte erstellen möchten, entweder die UiPath-Erweiterung für Citrix, die UiPath-Erweiterung für VMware Horizon oder die UiPath-Erweiterung für Windows-Remotedesktop und -anwendungen auf der Client-Maschine.

Sie können auch die Erweiterung für Java, Chrome, Microsoft Edge und Citrix aus dem Installationsprogramm sowie den Eintrag „Taskplaner“ bereitstellen, indem Sie die entsprechenden Optionen auswählen, wie unten dargestellt:

Der Eintrag „Taskplaner“ für die Remote-Runtime kann jederzeit hinzugefügt oder entfernt werden. Führen Sie einfach das UiPathRemoteRuntime.msi-Installationsprogramm aus und wählen Sie die entsprechende Option aus.

Aus der Eingabeaufforderung

Hinweis: Für die Installation von UiPathRemoteRuntime.msi sind Administratorrechte erforderlich.

1. Klicken Sie auf die Schaltfläche Windows Start und geben Sie cmd in das Suchfeld ein.
2. Klicken Sie mit der rechten Maustaste auf Eingabeaufforderung (Command Prompt) und führen Sie sie als Administrator aus.
3. Ändern Sie das Verzeichnis in den Ordner UiPathRemoteRuntime.msi (Beispiel): cd C:\Tools\Studio).
4. Installieren Sie mit dem Befehl UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask die UiPath-Komponente Remote Runtime.
5. Melden Sie sich von der aktuellen Citrix-Fenster-, VMware Horizon-Fenster oder RDP-Sitzung auf dem Client-Computer ab und wieder an, damit Ihre Änderungen wirksam werden.
6. Installieren Sie abhängig von der Technologie, für die Sie Ihre Automatisierungsprojekte erstellen möchten, entweder die UiPath-Erweiterung für Citrix, die UiPath-Erweiterung für VMware Horizon oder die UiPath-Erweiterung für Windows-Remotedesktop und -anwendungen auf der Client-Maschine.

Zudem können Sie die Argumente RemoteRuntimeTask, JavaBridge, ChromeExtension, EdgeChromium oder CitrixClient verwenden, um die Erweiterung für den Taskplaner-Eintrag und die Java-, Chrome-, Microsoft Edge- oder Citrix-Erweiterung zu installieren, wie nachfolgend beschrieben:

• UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask,JavaBridge,ChromeExtension,EdgeChromium,CitrixClient – Installiert die Remote Runtime-Komponente, den Taskplaner-Eintrag, die Erweiterung für Java, die Erweiterung für Chrome, die Erweiterung für Microsoft Edge und die Erweiterung für Citrix.

Mit dem Parameter /quiet können Sie die Installation auch im Hintergrund durchführen:

• UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask /quiet – Installiert die Remote Runtime-Komponente und den Taskplaner-Eintrag im Hintergrund.

Sie können die UiPath Remote Runtime an einem beliebigen Speicherort mit der Option APPLICATIONFOLDER installieren:

• UiPathRemoteRuntime.msi APPLICATIONFOLDER="D:\UiPathRemoteRuntime" ADDLOCAL=RemoteRuntime,RemoteRuntimeTask /quiet – Installiert die Remote Runtime-Komponente im Hintergrund unter D:\UiPathRemoteRuntime und fügt den Taskplaner-Eintrag hinzu.

Jetzt können Sie Prozesse zum Automatisieren auf Citrix virtuellen Apps und Desktops, VMware Apps sowie über RDP-Verbindungen genauso wie auf einem Standardcomputer erstellen. Aufgrund der entsprechenden Erweiterungen brauchen die Aktivitäten OCR- und Bilderkennung UI-Elemente nicht mehr ordnungsgemäß zu erkennen. Stattdessen werden die Elemente nativ erkannt und können mit beliebigen Aktivitäten verwendet werden.

UIAutomation-Abhängigkeit

Die UiPath Remote Runtime ist von der Version des UiPath.UIAutomation.Activities-Pakets abhängig, nicht von der Version von UiPath Studio/Robot.

Die auf einer Remotemaschine installierte Remote Runtime muss über die Version des neuesten UIAutomation-Pakets verfügen, das Sie in Ihren Projekten verwenden möchten, und sie ist mit den vorherigen UIAutomation-Releases kompatibel (abwärtskompatibel).

Das UiPath.UIAutomation.Activities-Paket und die UiPath Remote Runtime haben die gleiche UiPath-Treiberabhängigkeit. Für jede veröffentlichte Version des UIAutomation-Pakets wird ein Downloadlink für die UiPath Remote Runtime-Komponente mit derselben Versionsnummer bereitgestellt.

Beispielsweise kann für das UiPath.UIAutomation.Activities-Paket, Version 23.10.8, das erforderliche UiPath Remote Runtime-Installationsprogramm von https://download.uipath.com/versions/23.10.8/UiPathRemoteRuntime.msi heruntergeladen werden.

Sie können das UiPathRemoteRuntime.msi-Installationsprogramm herunterladen von:

• Produktdownloads im UiPath Customer Portal.
• Ressourcenzentrum in der UiPath Automation Cloud. Um auf das Ressourcenzentrum zuzugreifen, müssen Sie sich bei Ihrer Automation Cloud-Organisation anmelden, auf die Schaltfläche Hilfe in der Symbolleiste klicken und Ressourcen > Downloads auswählen.
• Alternativ ist eine Anforderung über die Seite Kontakt zum technischen Support möglich.

Parallele Unterstützung

Die UiPath Remote Runtime-Komponente wird auf dem Citrix-Anwendungsserver, der virtuellen VMware-Maschine oder der Remotedesktopmaschine im Ordner %ProgramFiles(x86)\UiPath installiert. Alle installierten Versionen sind im %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath-Ordner sichtbar.

Wenn Sie einen Prozess erstellen oder ausführen, müssen Sie ein UiPath.UIAutomation.Activities-Paket verwenden, das mit der bereitgestellten Treiberversion von UiPath Remote Runtime kompatibel ist.

Die Version der UiPath-Treiberabhängigkeit für das Paket UiPath.UIAutomation.Activities wird in Studio im Paketmanager-Infoabschnitt angezeigt.

Dieselbe UiPath-Version muss auf der Remotemaschine im Ordner %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath vorhanden sein.

Jedes UiPathRemoteRuntime.msi-Installationsprogramm enthält die neueste UiPath-Abhängigkeit sowie die neueste unterstützte Long Term Support (LTS)-UiPath-Abhängigkeit.

In der folgenden Tabelle sind die Abhängigkeiten zwischen dem UiPath.UIAutomation.Activities-Paket und UiPath Remote Runtime aufgeführt:

Version des UIAutomation-Pakets	UiPathRemoteRuntime-Buildnummer	UiPath-Treiberabhängigkeit	UIAutomation-kompatible Versionen für UiPathRemoteRuntime
23.4.11	23.10.86.3201	23.4.81.50665	23.10.11 23.4.11 22.10.8 22.4.10 21.10.9 20.10.14
22.10.8	23.4.62.63969	22.10.60.25726	23.4.8 22.10.8 22.4.10 21.10.9 20.10.14
22.4.10	23.4.62.63969	22.4.62.58438	23.4.8 22.10.8 22.4.10 21.10.9 20.10.14
21.10.9	23.4.60.36194	21.10.60.24919	23.4.7 22.10.7 22.4.9 21.10.9 20.10.14
20.10.14	23.4.60.36194	20.10.8558.20688	23.4.7 22.10.7 22.4.9 21.10.9 20.10.14
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

Sie können die Remote Runtime-Buildnummer in den Eigenschaften der UiPathRemoteRuntime.msi-Datei auf der Registerkarte Details im Feld Kommentare überprüfen.

Wenn Sie eine Version des UiPath.UIAutomation.Activities-Pakets mit einer UiPath-Abhängigkeit verwenden, die nicht Teil der installierten UiPath-Abhängigkeiten auf der Remotemaschine ist, werden keine Selektoren generiert und die folgende Ausnahme wird ausgelöst: Das UiPath.UIAutomation.Activities-Paket ist nicht mit der UiPath Remote Runtime kompatibel, die auf dem Server ausgeführt wird.

Hinzufügen von Remote-Runtime-Abhängigkeiten

Mit der interaktiven Auswahl der Zielanwendung werden erst richtige Selektoren erstellt, wenn UiPath.UIAutomation.Activities mit der UiPath Remote Runtime-Abhängigkeit auf dem Citrix-Anwendungsserver, auf der virtuellen VMware-Maschine oder der Remotedesktopmaschine übereinstimmt.

Wenn Sie beispielsweise ein Automatisierungsprojekt mithilfe von Version 23.10.8 des Pakets UiPath.UIAutomation.Activities erstellen möchten, müssen Sie die entsprechende UiPath-Abhängigkeit von der Clientmaschine (auf der Studio/Robot installiert ist) auf den Citrix-Anwendungsserver, auf die virtuelle VMware-Maschine oder die Remotedesktopmaschine kopieren.

Gehen Sie folgendermaßen vor:

1. Navigieren Sie auf der Clientmaschine (auf der Studio installiert ist) zum Ordner %UserProfile%\.nuget\packages\uipath. Alle installierten UiPath-Abhängigkeiten befinden sich hier.
2. Kopieren Sie den Ordner mit der Version, die dem UiPath.UIAutomation.Activities-Paket entspricht, das Sie verwenden möchten. Sie können die Liste der enthaltenen Abhängigkeiten vom UiPath.UIAutomation.Activities-Paket auf der Seite Über UIAutomation-Aktivitäten einsehen oder die Paketabhängigkeiten unter Parallele Unterstützung überprüfen.
   
   

   

   
   
3. Navigieren Sie auf dem Citrix-Anwendungsserver, der virtuellen VMware-Maschine oder der Remotedesktopmaschine zum Ordner %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath und fügen Sie die zuvor kopierte UiPath-Abhängigkeitsversion hier ein.
   • Beispiel: Für die UiPath.UIAutomation.Activities-Version 23.10.8 ist die entsprechende UiPath-Abhängigkeit 23.10.71.64399. Das ist der Name des Ordners, den Sie von der Studio-/Robotermaschine auf die Remotemaschine kopieren müssen.
   
   

   

   
   

Selektoren werden mit der aktuellen Version der UiPath.UIAutomation.Activities korrekt generiert. Änderungen werden wirksam, sobald die Abhängigkeit kopiert ist.

Die oben beschriebenen Remote Runtime-Abhängigkeiten sind sowohl für die Entwurfszeit als auch für die Ausführungszeit erforderlich.

Architektur von Remote Runtime

Wenn Sie einen Prozess starten, sendet der Roboter über einen RPC-Kanal die erforderlichen Befehle an die Erweiterung für Citrix oder an Windows-Remotedesktop. Dieses Informationspaket enthält auch Details über die Version des UIAutomation-Pakets, das für die Erstellung des Prozesses verwendet wurde.

Die entsprechende Erweiterung leitet dann das Informationspaket über einen virtuellen ICA-Kanal an die UiPath Remote Runtime-Komponente weiter, die sich auf den Citrix-Anwendungsservern oder auf der Remotedesktopmaschine befindet.

Abhängig von der Version des UIAutomation-Pakets, mit dem der Prozess erstellt wurde, weist die UiPath Remote Runtime-Komponente den Robot Executor an, welchen Treiber er verwenden soll.

Mehrere ICA-Kanäle

Die Kommunikation zwischen der Remote-Runtime-Komponente und der zugehörigen Erweiterung läuft über einen intern entwickelten ICA-Kanal. Die Verwendung mehrerer ICA-Kanäle ist möglich, aber der Citrix Receiver beispielsweise verwendet bereits mehrere Kanäle, u. a. für die Zwischenablage und Audio.

Überlegungen zu Datenübertragung und Bandbreite

Sobald die Remote-Runtime-Komponente installiert ist, können Sie Ihre Automationsprojekte erstellen, ohne Firewall-Regeln erstellen zu müssen.

Die Datenübertragung zwischen der Remote Runtime und der Erweiterung erfordert nur wenig Bandbreite. Beispielsweise überträgt jede Aktion des Roboters (z. B. eine Click-Aktivität) etwa 3 KB an Daten.

Mehrere RDP-Verbindungen

Wenn Sie durch mehrere RDP-Verbindungen springen, um einen Ziel-Remotecomputer zu erreichen, auf dem die Automatisierung entwickelt wird, müssen Sie Remote Runtime auf jedem zwischengeschalteten Remote-Computer installieren, nicht nur auf dem Zielcomputer.

Stellen Sie sich das folgende Szenario vor: Maschine A (mit Roboter) verbindet sich über RDP mit Maschine B und von Maschine B wird eine weitere RDP-Verbindung mit Maschine C geöffnet, auf der die Automatisierung durchgeführt werden muss. In diesem Beispiel ist die folgende Konfiguration erforderlich:

1. Maschine A – Installieren Sie die RDP-Erweiterung.

2. Maschine B – Installieren Sie die RDP-Erweiterung und RemoteRuntime.msi.
3. Maschine C – Installieren Sie RemoteRuntime.msi.

Hard- und Softwareanforderungen

Die UiPath Remote Runtime hat dieselben Anforderungen wie UiPath Robot. Die vollständige Liste der Anforderungen finden Sie unter Hardware- und Softwareanforderungen.