Abonnieren

UiPath Studio

UiPath Studio-Anleitung

Ü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

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

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

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.

1562

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.

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.

Installieren von UiPath Remote Runtime

Aus dem Installer

  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:

618

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.

550

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 die Eingabeaufforderung(Command Prompt) und führen Sie sie als Administrator aus.
  3. Change the directory to the UiPathRemoteRuntime.msi folder (for example: cd C:\Tools\Studio).
  4. Installieren Sie mit dem Befehl UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask die UiPath-Komponente 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 – 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 – 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:

Parallele Unterstützung

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.

372

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

752

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.522.10.52.889222.10.52.889222.10.5
22.4.8
21.10.8
20.10.13
19.11.5
18.4.8
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.822.4.52.1140522.4.52.1140522.4.8
21.10.8
20.10.13
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.821.10.49.1343621.10.49.1343621.10.8
20.10.13
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.1320.10.8363.3284920.10.8363.3284920.10.13
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.

540

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.

Hinzufügen von Remote-Runtime-Abhängigkeiten

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.
Gehen Sie folgendermaßen vor:

  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.

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

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

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.

752

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.

Hard- und Softwareanforderungen

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

Aktualisiert vor 3 Tagen

Über UiPath Remote Runtime


Auf API-Referenzseiten sind Änderungsvorschläge beschränkt

Sie können nur Änderungen an dem Textkörperinhalt von Markdown, aber nicht an der API-Spezifikation vorschlagen.