Konfigurationsdateien

Sobald Sie Konfigurationsdateien bearbeitet haben, müssen Sie die entsprechenden Roboterkomponenten 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 UiPath 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 Development, Staging oder Production. Seien Sie beim Bearbeiten dieser Datei immer vorsichtig, da eine ungenaue Konfiguration Anwendungsprobleme verursachen kann.

Zugriff 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:

Konfigurationsabschnitt	Datentyp + 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, hält es an 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 Aufforderung an 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	Legt fest, wie lange die Daten einer bestimmten Sitzung im Cache 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 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, die Robot.js auf eingehende Verbindungen überwacht. 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.

Starten Sie nach dem Ändern einer Systemvariablen den UiPath-Roboterdienst neu.

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 Roboterverhalten basierend auf der Leistung und den Ladezeiten des Systems anzupassen, mit dem er interagiert.	UIPATH_SESSION_TIMEOUT=75
UIPATH_SESSION_LEGACY
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_DISABLE_MARKETPLACE_WIDGET	Von Assistant benötigt, deaktiviert das UiPath-Marktplatz-Widget.	// On Windows OS UIPATH_DISABLE_MARKETPLACE_WIDGET=True //On Mac OS, run the following command: launchctl setenv UIPATH_DISABLE_MARKETPLACE_WIDGET TRUE
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 beim Start des Roboters ein vorab geladener Executor gestartet. Diese Variable überschreibt das Standardverhalten und ein vorab geladener Executor wird gestartet, wenn der erste Prozess ausgeführt wird. Optionen sind: Windows Legacy Portabel Keine	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 das Roboterzustimmungsdialogfeld, wenn die Verbindung zwischen dem Robot JS SDK und dem Roboter-Executor hergestellt wird. Die Variable akzeptiert benutzerdefinierte Anwendungs-URLs, getrennt durch Semikolon. Wenn nicht standardmäßige Ports verwendet werden, stellen Sie sicher, dass Sie die Portnummern angeben.
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 Ausweichpaketordnern. 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 es mehreren Robotern im Benutzermodus auf derselben Maschine, einen lokalen Pfad zum Speichern von Paketen gemeinsam zu nutzen. 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 Anmeldeinformationen für die Protokollierung (Domäne\Benutzername) wird beibehalten.	UIPATH_PRESERVE_CREDENTIALS_CASE = True