Konfigurationsdateien

Beschreibung der Datei UiPath.Settings

Die UiPath.Settings Datei enthält alle erforderlichen Details dazu, wie der Roboter Prozesse ausführt. Sie können diese Einstellungen ändern, indem Sie die Datei und die entsprechenden Felder direkt bearbeiten. Andererseits können Sie sie über Orchestrator ändern. Dies geschieht über die Registerkarte Einstellungen.

Hinweis:

Bitte beachten Sie, dass lokale System- und Administratorrechte erforderlich sind, um diese Einstellungen zu ändern. Sie müssen den UiPath Robot-Dienst neu starten (hierfür sind Administratorrechte erforderlich) und den Roboter-Tray schließen, damit die Änderungen wirksam werden.

Die Datei UiPath.Settings wird im Ordner %localappdata%\UiPath\ gespeichert, wenn der Robot im Benutzermodus bereitgestellt wird, und im Ordner %programdata%\UiPath\, wenn er im Dienstmodus bereitgestellt wird. Sie wird erstellt, wenn der UiPath Roboterdienst zum ersten Mal gestartet wird. Sie enthält die folgenden Parameter:

Parameter	Beschreibung
NuGetApiKey	Der API-Schlüssel des NuGet-Feeds. Wenn keine Verbindung mit Orchestrator besteht, ist kein API-Schlüssel erforderlich, wenn Sie einen lokalen Feed verwenden. Wenn Sie einen privaten MyGet-Feed verwenden, beachten Sie bitte, dass dieser Parameter erforderlich ist. Wenn eine Verbindung zum Orchestrator besteht, wird dieser Wert nicht berücksichtigt.
NuGetServerUrl	Der Ort, an den Projekte verschoben werden und von wo sie abgerufen werden. Dabei kann es sich entweder um einen lokalen Feed, z. B. einen Dateisystempfad oder um einen Web-Feed handeln, der das NuGet-Protokoll (NuGet, MyGet usw.) verwendet. Wenn keine Verbindung mit dem Orchestrator besteht, ist der Standardwert %ProgramData%\UiPath\packages (Benutzermodus) oder `%. Wenn Sie einen privaten MyGet-Feed verwenden, nehmen Sie bitte die unter Ihre vorauthentifizierte V2-URL (keine Basisauthentifizierung)(Your pre-authenticated V2 URL (no basic authentication)) angegebene URL. Bitte beachten Sie, dass dies kein kostenloser Dienst von MyGet ist. Wenn eine Verbindung zum Orchestrator besteht, wird dieser Wert nicht berücksichtigt.
ActivitiesFeed	The address where the activities are stored. This field is only populated if you are not connected to Orchestrator. By default, the value is ~/NuGetPackages/Activities. If you connect to Orchestrator, this field is not taken into account. Find out more about the activities feeds on this page, as well as where packages are installed based on the Robot deployment type.
UiPathServerUrl	Die Adresse Ihrer Orchestrator-Instanz. Wenn keine Verbindung mit Orchestrator besteht, ist dieser Parameter leer. When connected to Orchestrator, it is automatically filled in with the URL you provided in the Orchestrator Settings window.
TracingLevel	The level at which the Robot should log information. The following options are available: Verbose,Trace,Information,Warning,Error,Critical and Off. Dies kann auch im Fenster Orchestrator-Einstellungen (Orchestrator Settings) in der Dropdownliste Stufe (Level) geändert werden.
LowLevelTracing	Indicates whether or not to log information at a trace level, to help you with troubleshooting crashes and errors. By default, this parameter is set to false. To start low level tracing, set the value of this parameter to true. You can also change this value from the command line.
SecureLicenseKey	Der Computerschlüssel, mit dem Sie sich mit Orchestrator verbinden können. Der Schlüssel ist in der Datei UiPath.settings mit DPAPI verschlüsselt. Dieser Wert kann ebenfalls im Fenster Orchestrator-Einstellungen (Orchestrator Settings) ausgefüllt und geändert werden. Wenn keine Verbindung zum Orchestrator besteht, muss dieser Wert leer sein.
LoginToConsole	Enables the Robot to connect to the console session of the machine where it is installed. Additionally, it indicates if you can connect multiple Robots to Orchestrator using multiple users (High-Density Robots) or not. By default, the value is true. To enable High-Density Robots, set the value to false.
ResolutionWidth	Die Breite der Bildschirmauflösung der Maschine. Diese Option ist standardmäßig auf 0 eingestellt, was bedeutet, dass die erkannte Auflösungsbreite automatisch abgerufen und verwendet wird. Sie können einen benutzerdefinierten Wert verwenden, sofern dieser vom Arbeitsplatzsystem unterstützt wird.
ResolutionHeight	Die Höhe der Bildschirmauflösung der Maschine. Diese Option ist standardmäßig auf 0 eingestellt, was bedeutet, dass die erkannte Auflösungshöhe automatisch abgerufen und verwendet wird. Sie können einen benutzerdefinierten Wert verwenden, sofern dieser vom Arbeitsplatzsystem unterstützt wird.
ResolutionDepth	Die Bildschirmauflösung (Tiefe) des Computers. Diese Option ist standardmäßig auf 0 eingestellt, was bedeutet, dass die erkannte Auflösung automatisch abgerufen und verwendet wird. Sie können einen benutzerdefinierten Wert verwenden, sofern dieser vom Arbeitsplatzsystem unterstützt wird.
FontSmoothing	Verbessert die Texterkennung. Falls auf Wahr (True) gesetzt, wird die Option Font Smoothing über RDP-Verbindungen aktiviert. Dies bedeutet, dass auf dem Zielcomputer ClearType aktiviert wird.
ConnectionString	Eine vom Orchestrator erzeugte Zeichenfolge, die Ihnen ermöglicht, dort einen Roboter zu registrieren, ohne dass Sie den Computernamen (Machine Name) und Computerschlüssel (Machine Key) angeben müssen.
DisableWorkflowExecution	Deaktiviert die Möglichkeit der Ausführung von Prozessen aus der Kommandozeile. Standardmäßig ist diese Funktion ausgeblendet und deaktiviert.
webProxySettings	Parameter used to configure Proxy Settings for the Robot. Find out more in the Redirecting Robots Through a Proxy document.

UiPath Robot-Systemvariablen

Weiteres benutzerdefiniertes Verhalten kann über Systemumgebungsvariablen konfiguriert werden.

Wichtig:

Starten Sie den UiPath-Roboterdienst neu, nachdem Sie eine der Systemvariablen geändert haben.

Die folgende Liste fasst die häufigsten Anwendungsfälle zusammen:

Systemvariable	Nutzung	Beispiel
UIPATH_SESSION_TIMEOUT	Ändert das standardmäßige 60-Sekunden-Timeout für die Erstellung einer interaktiven Sitzung. Passen Sie diesen Wert an, um das Verhalten des Roboters basierend auf der Leistung und den Ladezeiten des Systems, mit dem er interagiert, anzupassen.	UIPATH_SESSION_TIMEOUT=75
UIPATH_PIP_SESSION_TIMEOUT	Ändert das standardmäßige 180-Sekunden-Timeout für den Start eines Prozesses in einer Robotersitzung.	UIPATH_PIP_SESSION_TIMEOUT=60
UIPATH_LANGUAGE	Legt die Sprache fest, in der der Roboter arbeitet. Die Reihenfolge zur Bestimmung der Sprache ist: UIPATH_LANGUAGE-Wert Die Maschinenumgebungsvariable Die aktuelle Thread-UI-Kultur UiPath-Standardsprache (Englisch)	UIPATH_LANGUAGE=French
UIPATH_HEADLESS_WITH_USER	Verwendet die Anmeldeinformationen eines bestimmten Benutzers, der zuvor im Orchestrator konfiguriert wurde.	UIPATH_HEADLESS_WITH_USER=True
UIPATH_PRE_LOADED_EXECUTOR	Standardmäßig wird ein vorinstallierter Executor gestartet, wenn der Roboter startet. Um dieses Verhalten zu ändern und den vorab geladenen Executor nur zu starten, wenn der erste Prozess ausgeführt wird, legen Sie diese Variable auf None fest.	UIPATH_PRE_LOADED_EXECUTOR=None
UIPATH_DISABLE_PRE_LOADED_EXECUTOR	Deaktiviert die vorab geladene Executor-Funktion.	UIPATH_DISABLED_PRE_LOADED_EXECUTOR=True
UIPATH_ROBOTJS_ALLOWLIST	Akzeptiert automatisch den Robotzustimmungsdialog, wenn die Verbindung zwischen dem Robot JS SDK und dem Robot-Executor hergestellt wird. Die Variable akzeptiert benutzerdefinierte Anwendungs-URLs, getrennt durch Semikolons. Fügen Sie die Portnummer in die URL ein, wenn sie von den Standardports (80 oder 443) abweicht.	UIPATH_ROBOTJS_ALLOWLIST=cloud.uipath.com;mydomain.com;
UIPATH_DNS_MACHINENAME	Ermöglicht die Verwendung des DNS-Hostnamens für Localhost beim Erstellen von RDP-Sitzungen. Um Unattended-Aufträge in Umgebungen mit Kerberos-Authentifizierung für RDP auszuführen, legen Sie diesen Wert auf „True“ fest.	UIPATH_DNS_MACHINENAME=True
UIPATH_PROXY_USE_DEFAULT_CREDENTIALS	Ermöglicht dem Roboter die Verarbeitung von Proxykonfigurationen, die Windows-Anmeldeinformationen für die Authentifizierung verwenden.	UIPATH_PROXY_USE_DEFAULT_CREDENTIALS=True
NUGET_FALLBACK_PACKAGES	Konfiguriert die Pfade zu den Ordnern der Ausweichpakete. Verwenden Sie Semikolons, um mehrere Pfade zu trennen. Wenn diese Variable nicht vorhanden ist, sucht der Roboter nach Ausweichpaketordnern in der Datei Nuget.config.
NUGET_SCRATCH	Ermöglicht mehreren Benutzermodusrobotern auf derselben Maschine die gemeinsame Nutzung eines lokalen Pfads zum Speichern von Paketen. Der Wert muss ein anderer Pfad als der Nuget-Installationsordner sein und fungiert als temporärer Ordner für NuGet. Nur die Variable NUGET_SCRATCH sollte den konfigurierten temporären Ordner verwenden.	NUGET_SCRATCH=C:\NuGetTempFolder
UIPATH_PRESERVE_CREDENTIALS_CASE	Die ursprüngliche Groß-/Kleinschreibung der Zugriffsrechte für die Protokollierung (Domain\Benutzername) wird beibehalten.	UIPATH_PRESERVE_CREDENTIALS_CASE = True

Neustarten von Roboterkomponenten

Denken Sie daran, alle laufenden Arbeiten vor dem Neustart zu speichern, um zu vermeiden, dass ungespeicherter Fortschritt verloren geht.

• UiPath-Roboterdienst
  • Installation im Dienstmodus
    1. Öffnen Sie den Aufgabenmanager > Dienste.
    2. Suchen Sie nach dem Dienst UiPathRobotSvc.
    3. Klicken Sie mit der rechten Maustaste auf den Dienst und wählen Sie neu starten aus.
  • Installation im Benutzermodus – Beenden Sie den Assistant und starten Sie ihn dann neu oder:
    1. Öffnen Sie den Aufgabenmanager > Details.
    2. Wählen Sie den Prozess UiPath.Service.UserHost.exe aus.
    3. Wählen Sie Aufgabe beenden aus.
• Aktualisierungsdienst
  1. Öffnen Sie den Aufgabenmanager > Dienste.
  2. Suchen Sie nach dem Dienst UiPath.UpdateService.Agent.
  3. Klicken Sie mit der rechten Maustaste auf den Dienst und wählen Sie neu starten aus.
• UiPath RobotJS ServiceHost
  1. Öffnen Sie den Aufgabenmanager > Dienste.
  2. Suchen Sie nach dem Dienst UiPath.RobotJS.ServiceHost.
  3. Klicken Sie mit der rechten Maustaste auf den Dienst und wählen Sie neu starten aus.
• UiPath Assistant
  1. Wählen Sie im Assistant Einstellungen und dann Beenden aus.
  2. Starten Sie Assistant neu.
• Widgets – Starten Sie den Assistant neu oder
  1. Klicken Sie mit der rechten Maustaste auf das Assistant-Symbol in der Taskleiste.
  2. Widgets neu laden