Konfigurationsdateien

Sobald Sie Konfigurationsdateien bearbeitet haben, müssen Sie die entsprechenden Robot-Komponenten neu starten, damit die Änderungen wirksam werden. In der folgenden Liste 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.

• UiPath-Roboterdienst
  • Installation im Dienstmodus
    1. Öffnen Sie Task-Manager > 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 Vorgang und starten Sie den Assistant dann neu oder:
    1. Öffnen Sie Task-Manager > Details.
    2. Wählen Sie den Prozess UiPath.Service.UserHost.exe aus.
    3. Wählen Sie Task beenden aus.
• Aktualisierungsdienst
  1. Öffnen Sie Task-Manager > 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 Task-Manager > 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. 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:

• Im Abschnitt connectionSettings -Konfiguration
  • DefaultServiceUrl (string) - Legt die Standardadresse fest, die der Roboter zur Verbindung mit Orchestrator verwendet. Beispiel:

    string DefaultServiceUrl = "https://cloud.uipath.com"

  • AutoSignIn (bool) – Aktiviert die automatische Anmeldefunktion für Assistant. Der Standardwert ist false. Beispiel:

    bool AutoSignIn = true.

  • EnforceDefaultServiceUrl (bool) - Erzwingt, dass die Adresse, die als DefaultServiceUrl angegeben wird, für alle Benutzer verfügbar ist. Der Standardwert ist false. Beispiel:

    bool EnforceDefaultServiceUrl = true.

• Im Abschnitt communicationSettings -Konfiguration
  • MaxMessageSizeInMegabytes (Byte) - Legt die maximale Größe einer Nachricht, die das System senden oder empfangen kann, in MB fest. Der Standardwert ist 10.

    Dies wird verwendet, um Überlastungen oder Prozessabstürze aufgrund der Verarbeitung zu großer Nachrichten zu vermeiden. Beispiel:

    byte MaxMessageSizeInMegabytes = 10;

  • InstallPackageTimeout (TimeSpan) – Legt das Zeitlimit für Paketinstallationen fest. Der Standardwert ist 20 Minuten.

    Wenn eine Paketinstallation länger als die definierte Zeit dauert, bricht das System die Installation ab. Beispiel:

    TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);

  • RequestTimeout (TimeSpan) – Definiert, wie lange das System auf eine Kommunikationsantwort wartet. Der Standardwert beträgt 40 Sekunden.

    Wenn das System innerhalb des festgelegten Zeitraums keine Antwort erhält, wird es angehalten und rückt vor. Dadurch werden Systemausfälle vermieden. Beispiel:

    TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);

• Im Abschnitt packageSettings -Konfiguration
  • PackagesInstallationFolder (string) – Legt das Standardverzeichnis fest, in dem Pakete installiert werden. Der Standardwert ist C:\UiPath\Packages.
  • SkipHttpConfigurationSources (bool) – Ermöglicht das Ignorieren von über HTTP konfigurierten Paketquellen, z. B. NuGet-Feeds. Der Standardwert ist false.

    Das bedeutet, dass das System keine Pakete aus diesen Quellen abruft, was nützlich ist, wenn die Quellen nicht zuverlässig oder sicher sind.

  • DisableSecureXaml (bool) – Ermöglicht dem Roboter die Ausführung potenziell unsicherer Workflows. Der Standardwert ist false.
  • DirectDownload (bool) – Ermöglicht das direkte Herunterladen von Paketen ohne Eingabeaufforderung für den Benutzer. Der Standardwert ist false.
  • PackageSaveWithoutNupkg (bool) – Ermöglicht das Speichern der Pakete ohne die Datei .nupkg . Der Standardwert ist false.

    Dies ist hilfreich, um die Downloadgröße zu reduzieren.

• Im Abschnitt analyticsSettings -Konfiguration
  • Telemetry.Enabled (bool) – Ermöglicht es UiPath, Nutzungsdaten zur Analyse zu sammeln und zu senden. Der Standardwert ist false.
• Im Abschnitt robotCacheSettings -Konfiguration
  • SessionCacheDuration (TimeSpan) – Definiert, wie lange die Daten einer bestimmten Sitzung im Zwischenspeicher aufbewahrt werden sollen, bevor sie verworfen werden. Der Standardwert beträgt 30 Sekunden.

    Dies ist nützlich, um Daten wie Variablenwerte oder Details von Vorgängen wiederzuverwenden, anstatt sie neu zu erstellen oder erneut abzurufen. Beispiel:

    TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);

  • GetResourceUrlCacheDuration (TimeSpan) – Definiert, wie lange die URLs für Ressourcen, z. B. APIs oder Webseiten, im Cache gespeichert werden. Der Standardwert ist eine (1) Stunde.

    Dies ist nützlich, um die Leistung zu optimieren, wenn Ihre Roboter regelmäßig auf bestimmte Ressourcen zugreifen müssen. Beispiel:

    TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);

• Im Abschnitt robotJsSettings -Konfiguration
  • ListenerPort (int) – Legt die Portnummer fest, auf der Robot.js auf eingehende Verbindungen wartet. Der Standardwert ist 2323.

    Dadurch kann der UiPath-Roboterdienst mit Webanwendungen interagieren, die auf lokalen oder Remote-Servern ausgeführt werden. Beispiel:

    int ListenerPort = 2323;

  • TokenExpiryInDays (int) – Legt die Gültigkeitsdauer der vom Roboterdienst generierten Authentifizierungstoken in Tagen fest. Der Standardwert beträgt 30 Tage.

    Der Roboterdienst verwendet diese Token, um sich bei der Interaktion mit anderen Softwarekomponenten oder Diensten zu authentifizieren. Beispiel:

    int TokenExpiryInDays = 30;

  • AllowUrlList (string) – Legt die Liste der URLs fest, auf die der Roboterdienst zugreifen kann. Dadurch wird sichergestellt, dass Ihr Roboterdienst nur mit genehmigten Diensten interagiert. Beispiel:

    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:

• 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.

  Beispiel:

  UIPATH_SESSION_TIMEOUT=75

• UIPATH_PIP_SESSION_TIMEOUT – Ändert das standardmäßige 180-Sekunden-Timeout für den Start eines Prozesses in einer Robotersitzung.

  Beispiel:

  UIPATH_PIP_SESSION_TIMEOUT=60

• UIPATH_LANGUAGE – Legt die Sprache fest, in der der Roboter arbeitet. Die Rangfolge ist:
  1. UIPATH_LANGUAGE-Wert
  2. Maschinenumgebungsvariable
  3. Aktuelle UI- Kultur des Threads
  4. UiPath-Standardsprache (Englisch)

  Beispiel:

  UIPATH_LANGUAGE=French

• UIPATH_HEADLESS_WITH_USER – Verwendet die Anmeldeinformationen eines bestimmten Benutzers, die zuvor im Orchestrator konfiguriert wurden.

  Beispiel:

  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 vorgeladenen Executor nur zu starten, wenn der erste Prozess ausgeführt wird, legen Sie diese Variable auf None fest.

  Beispiel:

  UIPATH_PRE_LOADED_EXECUTOR=None

• UIPATH_DISABLE_PRE_LOADED_EXECUTOR – Deaktiviert die vorgeladene Executor-Funktion.

  Beispiel:

  UIPATH_PRE_LOADED_EXECUTOR=None

• 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.

  Beispiel:

  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.

  Beispiel:

  UIPATH_DNS_MACHINENAME=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 Robotern im Benutzermodus auf derselben Maschine, einen lokalen Pfad zum Speichern von Paketen zu teilen.

  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.

  Beispiel:

  NUGET_SCRATCH=C:\NuGetTempFolder

• UIPATH_PRESERVE_CREDENTIALS_CASE : Die ursprüngliche Groß-/Kleinschreibung der Zugriffsrechte für die Protokollierung (domain\username) wird beibehalten.

  Beispiel:

  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.
  • ForceNew– 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.

  Beispiel:

  UIPATH_SESSION_BEHAVIOR = LeaveSessionDisconnected

• UIPATH_HTTP_CONNECTION_LIFETIME - Definiert, wie lange die Verbindung zu Orchestrator offen bleibt, bevor sie geschlossen und erneuert wird. Die Standarddauer beträgt 30 Minuten. Um diesen Wert anzupassen, geben Sie den Wert in Sekunden ein.

  Beispiel:

  // to set 10 minutes                          
  UIPATH_HTTP_CONNECTION_LIFETIME = 600

• UIPATH_FILE_LOG_LEVEL – Definiert die Ausführungsprotokollebene, die in der lokalen Datei verwendet wird. Diese unterscheidet sich von der für den Orchestrator verwendeten Protokollebene. Die folgenden Optionen sind verfügbar:
  • Ausführlich
  • Ablaufverfolgung
  • Informationen
  • Warnung
  • Fehler (Error)
  • Kritisch
  • Aus

  Beispiel:

  // to set verbose level locally
  UIPATH_FILE_LOG_LEVEL = Verbose

• UIPATH_EXECUTOR_STARTUP_DELAY - Definiert die Wartezeit in Sekunden zwischen der Sitzungserstellung und dem Executor-Start. Diese Option wird verwendet, wenn Ihre Infrastruktur einige Dienste (VPN, Sicherheit) laden muss, bevor die Ausführung Ihrer Automatisierung beginnt.

  Beispiel:

  // to set the delay to 5 seconds
  UIPATH_EXECUTOR_STARTUP_DELAY = 5