Beschreibung der Datei UiPath.Settings

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-Feed. Wenn Sie nicht mit dem Orchestrator verbunden sind und einen lokaler Feed verwenden, ist kein API-Schlüssel erforderlich.Wenn Sie einen privaten MyGet-Feed verwenden, beachten Sie bitte, dass dieser Parameter erforderlich ist. Bei einer Verbindung mit Orchestrator wird dieser Wert nicht berücksichtigt.
NuGetServerUrl	Der Speicherort, an den Projekte verschoben werden und von wo sie abgerufen werden. Dies kann entweder ein lokaler Feed sein, z. B. ein Dateisystempfad, oder ein Webfeed, der das NuGet-Protokoll verwendet (NuGet, MyGet usw.). 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) 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	Die Adresse, an der die Aktivitäten gespeichert sind. Dieses Feld wird nur ausgefüllt, wenn Sie nicht mit dem Orchestrator verbunden sind. Standardmäßig ist der Standardwert ~/NuGetPackages/Activities.Wenn Sie eine Verbindung mit Orchestrator herstellen, wird dieses Feld nicht berücksichtigt. Erfahren Sie auf dieser Seite mehr über die Aktivitätsfeeds und wo Pakete basierend auf dem Bereitstellungstyp des Robot installiert werden.
UiPathServerUrl	Die Adresse Ihrer Instanz von Orchestrator. Wenn keine Verbindung mit Orchestrator besteht, ist dieser Parameter leer. Wenn eine Verbindung mit Orchestrator hergestellt wird, wird er automatisch mit der URL ausgefüllt, die Sie im Fenster Orchestrator-Einstellungen angegeben haben.
TracingLevel	Die Ebene, auf der der Roboter Informationen protokollieren soll. Die folgenden Optionen sind verfügbar: Verbose, Nachverfolgen (Trace), Informationen (Information), Warnung (Warning), Fehler (Error), Kritisch (Critical) und Aus (Off). Dies kann auch im Fenster Orchestrator-Einstellungen (Orchestrator Settings) in der Dropdownliste Stufe (Level) geändert werden.
LowLevelTracing	Gibt an, ob Informationen auf einer Ablaufverfolgungsebene protokolliert werden sollen, um Sie bei der Fehlerbehebung bei Abstürzen und Fehlern zu unterstützen. Standardmäßig ist dieser Parameter auf false festgelegt. Um die Nachverfolgung auf niedriger Ebene zu starten, legen Sie den Wert dieses Parameters auf true. Sie können diesen Wert auch über die Befehlszeile ändern.
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	Ermöglicht es dem Roboter, eine Verbindung mit der Konsolensitzung der Maschine herzustellen, auf der er installiert ist. Darüber hinaus zeigt es an, ob Sie mehrere Roboter mit dem Orchestrator verbinden können, indem Sie mehrere Benutzer (High-Density Robots) verwenden oder nicht.Standardmäßig ist der Standardwert true.Um High-Density Robots zu aktivieren, setzen Sie den Wert auf 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, der zum Konfigurieren von Proxy-Einstellungen für den Roboter verwendet wird. Weitere Informationen finden Sie im Dokument Umleiten von Robotern über einen Proxy.

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 die Standard-60-Sekunden-Timeout für das Erstellen 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 die Standard-180-Sekunden-Timeout für das Starten eines Prozesses in einer Roboter-Sitzung.

  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 Thread-UI-Kultur
  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 vorgeladener Executor gestartet, wenn der Roboter gestartet wird. 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.

  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 das Dialogfeld für die Roboter-Zustimmung, wenn die Verbindung zwischen dem Robot JS SDK und dem Roboter-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 unbeaufsichtigte 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 Fallback-Paketordnern. Verwenden Sie Semikolons, um mehrere Pfade zu trennen. Wenn diese Variable nicht vorhanden ist, sucht der Roboter in der Datei nach Ordnern für Fallback-PaketeNuget.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 Installationsordner von Nuget sein, und er dient als temporärer Ordner für NuGet.

  Hinweis:

  Nur die NUGET_SCRATCH Variable sollte den konfigurierten temporären Ordner verwenden.

  Beispiel:

  NUGET_SCRATCH=C:\NuGetTempFolder
  

• UIPATH_PRESERVE_CREDENTIALS_CASE – Behält die ursprüngliche Form der Protokollierungsanmeldeinformationen bei (Domäne\Benutzername).

  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
  

Neustart 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