Roboter-Executor

Konfigurieren und verwalten Sie den UiPath Executor, die Roboterkomponente, die Automatisierungsworkflows in isolierten Sitzungen ausführt.

UiPath Executor is a component of the UiPath software structure that is used to run automations or jobs. It is the component that actually executes the automation workflows, and you can identify it in the list of running processes as UiPath.Executor.exe.

Wie es funktioniert

Während eines Automatisierungslebenszyklus stellt der Executor die Ausführungsstufe dar:

1. Entwurfsphase – Sobald ein Automatisierungsworkflow entworfen und in Studio erstellt wurde, wird er in Orchestrator veröffentlicht.
2. Orchestrator-Ebene – Der Orchestrator ist die Komponente, die die von den Robotern ausgeführten Vorgänge verwaltet, steuert und protokolliert.Hier können Sie einen Auftrag planen oder auf Anfrage ausführen.
3. Ausführungsphase – Wenn eine Aufgabe geplant oder ausgelöst wird, sendet Orchestrator einen Befehl an den Roboterdienst.Der Roboterdienst startet dann Instanzen von UiPath Executor, um die Automatisierungsaufgabe auszuführen.Jede Instanz wird in einer isolierten Sitzung ausgeführt, sodass ein Fehlschlagen einer Aufgabe keine Auswirkungen auf die anderen hat.
4. Phase nach der Ausführung – Wenn die Aufgabe abgeschlossen ist, werden Executor-Instanzen beendet und die Ergebnisse werden an den Orchestrator zurückgesendet. Details wie Ausführungszeit, Status (Erfolg oder Misserfolg) und etwaige Ausnahmen werden protokolliert und können zur Fehlerbehebung oder Prozessverbesserung analysiert werden.

Capabilities

Zu den Funktionen von Executor gehören:

• Ausführen von lokalen oder Remote-Aufgaben – Roboterdienst kann Aufgaben entweder auf dem lokalen Gerät ausführen, auf dem der Roboterdienst installiert ist, oder er kann eine Verbindung zu anderen Geräten herstellen und dort Aufgaben ausführen.
• Gleichzeitige Ausführung von Aufträgen – Der Executor kann mehrere Automatisierungen gleichzeitig durchführen, von denen jede als unabhängige Sitzung ausgeführt wird.
• Lastausgleich und Priorisierung von Aufgaben – Zusammen mit UiPath Orchestrator kann der Executor dazu beitragen, die Automatisierungslasten über mehrere Roboter hinweg auszugleichen und Aufgaben auf Grundlage vordefinierter Regeln zu priorisieren.
• Beibehaltung der Isolierung des Workflows – Jede Ausführung im Executor ist isoliert, was bedeutet, dass ein Fehler in einem Auftrag keine Auswirkung auf die Leistung des anderen Auftrags hat.
  Hinweis:

  Der UiPath Executor passt sich verschiedenen DPI-Einstellungen an, sodass Workflows mit jeder Auflösung ausgeführt werden können.Wenn einige Anwendungen nicht mit DPI umgehen können, können Sie diese bestimmte Funktion deaktivieren.

Ausführende Typen basierend auf Automatisierungsprojekten

Basierend auf dem Automatisierungsprojekt startet der Roboterdienst den entsprechenden Typ der Ausführungsinstanz zur Ausführung der Automatisierung.In den folgenden Tabellen sind die Projektarten auf Basis des verwendeten Zielframeworks zusammengefasst, die eine Ausführungsinstanz ausführen kann.

Projekt-/Executor-Typ	Architektur	Unterstützte Betriebssysteme	Verwendetes Framework
Windows – Legacy	32-Bit	Windows (x64 und x86)	.NET Framework 4.7.2
Windows	64-Bit	Windows x64	.NET 10 with Windows support (.NET Core - Windows)
Plattformübergreifend	64-Bit	Windows, Linux (64-bit)	.NET 10 with cross-platform support (.NET Core)

Jede Zeile in der Tabelle repräsentiert einen anderen Typ, der zeigt, wie er für die Ausführung von Projekten konfiguriert ist, basierend auf den spezifischen Anforderungen des Projekttyps, des Zielbetriebssystems und der verwendeten Version von .NET Framework.Diese Informationen helfen zu verstehen, welcher Ausführer für jedes Projekt geeignet ist, um die Kompatibilität mit der Zielumgebung zu gewährleisten und die relevanten Framework-Funktionen zu nutzen.

The Executor and executor packages

The Executor is the .NET executor of Unified Runtime, and runs RPA processes and test cases. By default, agents, functions, and API workflows don't run in UiPath.Executor.exe. They run in executor packages, in a separate host process that the Robot Service starts. The settings on this page, such as preloaded executors, Medium+ integrity, and UIPATH_HEADLESS_WITH_USER, apply to the Executor only.

Benutzerkonfigurationen für den Executor

The Executor has a dedicated system variable UIPATH_HEADLESS_WITH_USER, which you can configure depending on the type of user that runs the automation.

When the user is Local Service, you can run background automations. Here, the setting for UIPATH_HEADLESS_WITH_USER should either be Falseor not set at all.

When the user running the automation has credentials specified in Orchestrator, there are two scenarios you should consider:

• For background automations, the UIPATH_HEADLESS_WITH_USER setting should be True.
• For foreground automations, there should be no UIPATH_HEADLESS_WITH_USER variable set.

In der folgenden Tabelle sind die Benutzerbedingungen für den Executor zusammengefasst.

Benutzertyp	Automatisierungstyp	UIPATH_HEADLESS_WITH_USER Einstellung
Local Service	Hintergrund	False oder null
In Orchestrator konfigurierter Benutzer	Hintergrund	True
	Vordergrund	Keine Variable erforderlich

Vorgeladener Executor

Usually, each process requires time to load the required workflow, packages, and libraries into memory before it can start processing. In a preloaded setup, those dependencies are already loaded into memory, in dedicated execution slots. A preloaded executor is enabled by default in User Mode. Preloaded executors exist only in User Mode: in Service Mode, the Robot doesn't start them, and the variables below have no effect.

Hier sind einige wichtige Details zum vorgeladenen Executor:

• Schnellere Ausführung: Durch das Vorladen des Prozesses können Ihre Roboter viel schneller mit der Arbeit an ihren Aufgaben beginnen.
• Ressourcennutzung: Mit einem vorinstallierten Executor verbrauchen Roboter weniger Ressourcen, da die erforderlichen Workflows bereits im Speicher geladen sind.
• Verfügbarkeit: Vorgeladene Ausführungsinstanzen sind in erster Linie für beaufsichtigte Automatisierungen konzipiert, die von Assistant, RobotJS, Studio oder der Befehlszeilenschnittstelle gestartet werden.Unbeaufsichtigte Aufträge aus Orchestrator initiieren einen einzelnen, nicht vorgeladenen Ausführungsinstanz.

Systemvariablen für das vorgeladene Setup

You can manage the behavior of preloaded executors by setting specific environment variables on the robot machine, as follows. They apply to User Mode robots only:

Umgebungsvariable	Wert	Beschreibung
UIPATH_PRE_LOADED_EXECUTOR	Keine	Überschreibt das Standardverhalten und startet den vorgeladenen Executor nur, wenn der erste Auftrag gestartet wird.
UIPATH_DISABLE_PRE_LOADED_EXECUTOR	True	Deaktiviert den vorgeladenen Executor.

Wie es funktioniert

Wenn Sie die Variable UIPATH_PRE_LOADED_EXECUTOR zu Ihrem System hinzufügen, konfigurieren Sie ein vorgeladenes Setup.Dadurch werden zwei Ausführungsmodule gestartet: eines, wenn ein Auftrag gestartet wird, und ein anderes, das auf zukünftige Aufträge wartet – der vorgeladene Executor.Wenn ein weiterer Auftrag startet, wird der vorgeladene Executor verwendet und ein weiterer vorgeladener Executor generiert, der auf den nächsten Auftrag wartet. Kurz gesagt, ein vorgeladenes Setup stellt immer sicher, dass ein verfügbarer Executor auf Aufträge wartet.

Vorgeladene Ausführungsprogramme und Betriebssysteme

For Windows devices, when UiPath.Service.UserHost.exe starts in User Mode, it launches two preloaded executors: one for Windows projects, and another for Windows-Legacy projects.

Medium+-Integritätsstufenerhöhung

Einige Windows-Anwendungen laufen auf einer höheren Integritätsstufe als die Standardbenutzersitzung.Ein gängiges Beispiel ist das Dialogfeld „Windows CredentialBroker“, das erscheint, wenn Sie einen Benutzernamen und ein Kennwort eingeben, um eine Verbindung mit einer Remotedesktopsitzung (RDP) herzustellen.Da der CredentialBroker mit Medium+-Integrität ausgeführt wird, kann der Executor standardmäßig nicht mit ihm interagieren, und Ihre Automatisierung kann keine Anmeldeinformationen in das Dialogfeld eingeben.

Um dem Executor die Automatisierung solcher Fenster zu ermöglichen, setzen Sie die UIPATH_MEDIUMPLUS_EXECUTOR System-Umgebungsvariable der Maschine auf 1. Wenn diese Variable festgelegt ist, startet der UiPath-Roboterdienst den Executor auf der Integritätsebene Medium+, sodass er mit Fenstern interagieren kann, auf die er andernfalls nicht zugreifen kann.

Um alternativ nur bestimmte Aufrufe anstelle des gesamten Executors mit erhöhten Rechten auszuführen, setzen Sie die UIPATH_MEDIUMPLUS_INVOKE Maschinen- (System-) Umgebungsvariable auf 1.Wenn diese Variable aktiviert ist, können die Aktivitäten Invoke Workflow File und Invoke Process pro Aufruf auf der Integritätsebene von Medium+ ausgeführt werden, während der Rest der Automatisierung auf der Standardintegritätsebene verbleibt.

Die Erhöhung gilt nur für Aufrufe, die sie anfordern – die Erhöhungsoption der Aktivität muss ebenfalls aktiviert sein. Die Variable allein erhöht nichts.

Die Erhöhungsoption erfordert UiPath.System.Activities 26.6.0 oder höher und gilt für Invoke Workflow File nur, wenn der Workflow isoliert aufgerufen wird.Wie bei UIPATH_MEDIUMPLUS_EXECUTOR ist diese Funktion nur unter Windows verfügbar und erfordert, dass UAC aktiviert ist.

Anforderungen

• Windows only — this feature is not available on Linux.
• UAC muss aktiviert sein – die Erhöhung hängt davon ab, dass die Benutzerkontensteuerung auf der Maschine aktiv ist. Wenn UAC deaktiviert ist, ignoriert das System die Variable und der Executor startet auf der Standardintegritätsstufe.
• Installationsmodus – installieren Sie den Roboter entweder im Dienstmodus oder im Benutzermodus mit einer Installation pro Maschine (installiert in Program Files).Installationen pro Benutzer unterstützen keine Erhöhung auf Medium+.
• Variable auf Maschinenebene – Die Variable muss als Maschinen-(System)-Umgebungsvariable festgelegt werden, sowohl für beaufsichtigte als auch für unbeaufsichtigte Automatisierungen. Eine Variable auf Benutzerebene hat keine Auswirkung. Die Berechtigungserhöhung wird nur aktiviert, wenn die Variable auf Maschinenebene festgelegt ist.

So wird es aktiviert

1. Öffnen Sie Systemeigenschaften > Umgebungsvariablen auf der Robotermaschine.
2. Wählen Sie im Abschnitt Systemvariablen die Option Neu aus. Die Variable muss auf Maschinen-(System)-Ebene festgelegt werden. Eine Variable auf Benutzerebene hat keine Auswirkung.
3. Legen Sie den Variablennamen auf UIPATH_MEDIUMPLUS_EXECUTOR und den Wert auf 1 fest.
4. Wählen Sie OK aus, um die Variable zu speichern.
5. Starten Sie den UiPath-Roboterdienst neu, damit die Änderung wirksam wird.

Ergebnis

Nachdem Sie die Erhöhung auf Medium+ aktiviert haben, können Ihre Automatisierungen mit dem Dialogfeld „CredentialBroker“ und anderen Fenstern interagieren, die Medium+-Integrität erfordern. Wenn UIPATH_MEDIUMPLUS_EXECUTOR festgelegt ist, wird der Executor für die gesamte Automatisierung mit erhöhten Rechten ausgeführt. Wenn UIPATH_MEDIUMPLUS_INVOKE festgelegt ist, werden nur Aufrufe, die eine Erhöhung anfordern, mit erhöhten Rechten ausgeführt. Wenn der Executor nicht auf der erhöhten Stufe starten kann (z. B. weil UAC deaktiviert ist), kehrt er zur Standardintegritätsstufe zurück und protokolliert eine Warning.