Konfigurationsdateien

Sobald Sie Konfigurationsdateien bearbeitet haben, müssen Sie die entsprechenden Robot-Komponenten neu starten, damit die Änderungen wirksam werden. In der folgenden Tabelle ist zusammengefasst, wie mehrere Komponenten basierend auf dem Robot-Installationsmodus neu gestartet werden.

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

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

uipath.config

Die Datei UiPath.config enthält wichtige Konfigurationsparameter für den Roboter. Als Administrator können Sie das Verhalten Ihrer Roboter anpassen, indem Sie die Liste der Parameter in der Konfigurationsdatei bearbeiten.

Hinweis:

Jede Umgebung kann bestimmte Hinweise benötigen, sodass Sie mit UiPath verschiedene Konfigurationen basierend auf der aktuellen Umgebung des Roboters anwenden können, sei es Entwicklung, Staging oder Produktion. Seien Sie beim Bearbeiten dieser Datei immer vorsichtig, da eine ungenaue Konfiguration Anwendungsprobleme verursachen kann.

Zugreifen auf die Datei

Wenn Sie Ihren Roboter installieren, erstellt das System die UiPath.config-Datei.

Um darauf zuzugreifen, navigieren Sie zu C:\Program Files\UiPath\Studio\UiPath.config.

Anpassbare Einstellungen

Die UiPath.config-Datei besteht aus den folgenden Parametern:

Config section	Datentyp und Parametername	Beschreibung	Standard	Beispiel
connectionSettings	Zeichenfolge DefaultServiceUrl	Legt die Standardadresse fest, die der Roboter für die Verbindung mit Orchestrator verwendet.	Nicht zutreffend	string DefaultServiceUrl = "https://cloud.uipath.com"
	Bool AutoSignIn	Aktiviert die Funktion zur automatischen Anmeldung für Assistant.	False	bool AutoSignIn = true.
	Bool EnforceDefaultServiceUrl	Erzwingt die Verwendung der Adresse, die als „DefaultServiceUrl“ angegeben wird, für alle Benutzer.	False	bool EnforceDefaultServiceUrl = true.
communicationSettings	Byte MaxMessageSizeInMegabytes	Legt die maximale Größe einer Nachricht in MB fest, die das System senden oder empfangen kann. Dies wird verwendet, um Überlastung oder Prozessabstürze aufgrund der Verarbeitung zu großer Nachrichten zu vermeiden.	10 MB	byte MaxMessageSizeInMegabytes = 10;
	TimeSpan InstallPackageTimeout	Legt das Zeitlimit für Paketinstallationen fest. Wenn eine Paketinstallation länger als die definierte Zeit dauert, bricht das System die Installation ab. Ausgedrückt als TimeSpan.	20 Minuten	TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);
	TimeSpan RequestTimeout	Definiert, wie lange das System auf eine Kommunikationsantwort wartet. Wenn das System innerhalb des festgelegten Zeitraums keine Antwort erhält, wird es angehalten und rückt vor. Dadurch werden Systemaufhänger vermieden. Ausgedrückt als TimeSpan.	40 Sekunden	TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);
packageSettings	Zeichenfolge PackagesInstallationFolder	Legt das Standardverzeichnis fest, in dem Pakete installiert werden.	C:\UiPath\Packages
	Bool SkipHttpConfigurationSources	Ermöglicht dem System, über HTTP konfigurierte Paketquellen wie NuGet-Feeds zu ignorieren. Das bedeutet, dass das System keine Pakete aus diesen Quellen abruft, was nützlich ist, wenn die Quellen nicht zuverlässig oder sicher sind.	False
	Bool DisableSecureXaml	Ermöglicht dem Roboter die Ausführung potenziell unsicherer Workflows.	False
	Bool DirectDownload	Ermöglicht das direkte Herunterladen von Paketen ohne Eingabeaufforderung für den Benutzer.	False
	Bool PackageSaveWithoutNupkg	Ermöglicht das Speichern der Pakete ohne die Datei .nupkg. Dies ist hilfreich, um die Downloadgröße zu reduzieren.	False
analyticsSettings	Bool Telemetry.Enabled	Ermöglicht UiPath das Sammeln und Senden von Nutzungsdaten zur Analyse.	False
webProxySettings	Zeichenfolge ScriptAddress	Legt die Adresse des Skripts fest, das bestimmt, wie und wann der Proxy verwendet wird.
	Zeichenfolge ProxyAddress	Legt die Adresse des Proxyservers fest, entweder IP oder Domänennamen.
	Zeichenfolge BypassList	Enthält die Liste der Adressen, die unter Umgehung des Proxyservers eine direkte Verbindung mit dem Internet herstellen.
	Bool BypassLocalAddresses	Ermöglicht eine direkte Verbindung für lokale Adressen unter Umgehung des Proxyservers.	False
	Zeichenfolge UserName	Legt die Anmeldeinformationen des Benutzernamens für die Proxyserver-Authentifizierung fest.
	Zeichenfolge Password	Legt das mit dem Benutzernamen verbundene Passwort für die Proxy-Server-Authentifizierung fest.
	Zeichenfolge Domain	Legt die für die Authentifizierung erforderliche Domäne fest, in der sich der Proxyserver befindet.
robotCacheSettings	TimeSpan SessionCacheDuration	Definiert, wie lange die Daten einer bestimmten Sitzung im Zwischenspeicher aufbewahrt werden sollen, bevor sie verworfen werden. Dies ist nützlich, um Daten wie Variablenwerte oder Details von Vorgängen wiederzuverwenden, anstatt sie neu zu erstellen oder erneut abzurufen. Ausgedrückt als TimeSpan.	30 Sekunden	TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);
	TimeSpan GetResourceUrlCacheDuration	Definiert, wie lange die URLs für Ressourcen, z. B. APIs oder Webseiten, im Cache gespeichert werden. Dies ist nützlich zur Optimierung der Leistung in Szenarien, in denen Ihre Roboter regelmäßig auf bestimmte Ressourcen zugreifen müssen. Ausgedrückt als TimeSpan.	1 Stunde	TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);
robotJsSettings	int ListenerPort	Legt die Portnummer fest, auf der Robot.js auf eingehende Verbindungen wartet. Dadurch kann der Roboterdienst mit Webanwendungen interagieren, die auf lokalen oder Remote-Servern ausgeführt werden.	2323	int ListenerPort = 2323;
	int TokenExpiryInDays	Legt den Gültigkeitszeitraum der vom UiPath-Roboterdienst generierten Authentifizierungstokens in Tagen fest. Der Roboterdienst verwendet diese Token, um sich bei der Interaktion mit anderen Softwarekomponenten oder Diensten zu authentifizieren.	30 Tage	int TokenExpiryInDays = 30;
	Zeichenfolge AllowUrlList	Legt die Liste der URLs fest, auf die der Roboterdienst zugreifen kann. Dadurch wird sichergestellt, dass Ihr Roboterdienst nur mit genehmigten Diensten interagiert.		string AllowUrlList = "https://cloud.uipath.com";

Wichtig:

• Erstellen Sie immer eine Sicherung der ursprünglichen UiPath.config-Datei, bevor Sie Änderungen vornehmen. Dies kann helfen, die ursprünglichen Einstellungen wiederherzustellen, wenn etwas schief läuft.
• Um die an der UiPath.config-Datei vorgenommenen Aktualisierungen anzuwenden, starten Sie den UiPath-Dienst oder das System neu.
• Lokale Einstellungen in der Datei UiPath.config haben Vorrang vor den im Orchestrator konfigurierten Einstellungen.
• Vertrauliche Daten in der Datei UiPath.config können für zusätzliche Sicherheit verschlüsselt werden.

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_USER_SERVICE_PATH	Legt den Installationspfad des Benutzerdiensts fest.	UIPATH_USER_SERVICE_PATH=C://installation/folder/UiPath.Service.UserHost.exe
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. Hinweis: 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
UIPATH_SESSION_BEHAVIOR	Konfiguriert das Verhalten der Sitzungswiederherstellung nach Abschluss eines Auftrags. Die folgenden Optionen sind verfügbar: TryReuseAndRestoreSession– Die Standardoption. Versucht, die Sitzung wiederzuverwenden und in den vorherigen Zustand zurückzuversetzen, nachdem ein Auftrag abgeschlossen wurde. Wenn es keine anfängliche Sitzung zur Wiederverwendung gibt, meldet es sich bei der Wiederherstellung ab. ForceNewSession– Erstellt eine völlig neue Sitzung, unabhängig vom vorherigen Sitzungsstatus. Meldet sich bei der Wiederherstellung immer ab. LeaveSessionActive– Verhindert die Wiederherstellung des ursprünglichen Sitzungsstatus. LeaveSessionDisconnected– Trennt die Sitzung bei der Wiederherstellung immer.	UIPATH_SESSION_BEHAVIOR = LeaveSessionDisconnected