Fichiers de configuration

Description du fichier UiPath.Settings

Le fichier UiPath.Settings contient tous les détails nécessaires sur la façon dont le robot effectue les Processes.Vous pouvez modifier ces paramètres en modifiant directement le fichier et les champs correspondants. Vous pouvez toutefois les modifier via Orchestrator. Cela se fait depuis l'onglet Paramètres.

Remarque :

Please note that local system and administrator rights are required to modify these settings. You should restart the UiPath^® Robot service (admin rights are required to do this), and close the Robot tray for changes to take effect.

The UiPath.Settings file is stored in the %localappdata%\UiPath\ folder when the Robot is deployed in user mode, and %programdata%\UiPath\ when the Robot is deployed in service mode. It is created the first time the UiPath^® Robot service starts. It contains the following parameters:

Paramètre	Description
NuGetApiKey	La clé API du flux NuGet. Lorsque vous n’êtes pas connecté à Orchestrator, et si vous utilisez un flux local, il n’est nécessaire d’utiliser une clé API. Attention, si vous utilisez un flux MyGet privé, ce paramètre est alors requis. Lorsque vous êtes connecté à Orchestrator, cette valeur n'est pas prise en compte.
NuGetServerUrl	L’endroit où les projets sont envoyés et récupérés. Il peut s’agir d’un flux local, tel qu’un chemin d’accès au système de fichiers, ou d’un flux Web qui utilise le protocole NuGet (NuGet, MyGet, etc.). Lorsque l'utilisateur n'est pas connecté à Orchestrator, la valeur par défaut est %ProgramData%\UiPath\packages (mode utilisateur) ou `%. Si vous utilisez un flux MyGet privé, utilisez l'URL fournie dans Votre URL V2 pré-authentifiée (aucune authentification de base) (Your pre-authenticated V2 URL (no basic authentication)). Notez qu'il ne s'agit pas d'un service gratuit de MyGet. Lorsque vous êtes connecté à Orchestrator, cette valeur n'est pas prise en compte.
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	L’adresse de votre instance Orchestrator. Lorsqu’il n’est pas connecté à Orchestrator, ce paramètre est vide. 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. Vous pouvez également les modifier dans la fenêtre Paramètres d'Orchestrator (Orchestrator Settings), dans la liste déroulante Niveau (Level).
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	La clé de machine utilisée pour se connecter à Orchestrator. La clé est chiffrée dans le fichier UiPath.settings à l'aide de DPAPI. Cette valeur peut être également renseignée et modifiée dans la fenêtre Paramètres d'Orchestrator (Orchestrator Settings). Si non connecté à Orchestrator, ce paramètre doit être vide.
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	Largeur de résolution d'affichage de la machine. Cette option est définie sur 0 par défaut, ce qui signifie qu'elle récupère automatiquement et utilise la largeur de résolution détectée. Vous pouvez utiliser une valeur personnalisée, tant qu'elle est prise en charge par le poste de travail.
ResolutionHeight	Hauteur de résolution d'affichage de la machine. Cette option est définie sur 0 par défaut, ce qui signifie qu'elle récupère automatiquement et utilise la hauteur de résolution détectée. Vous pouvez utiliser une valeur personnalisée, tant qu'elle est prise en charge par le poste de travail.
ResolutionDepth	Profondeur de résolution d'affichage de la machine. Cette option est définie sur 0 par défaut, ce qui signifie qu'elle récupère automatiquement et utilise la profondeur de résolution détectée. Vous pouvez utiliser une valeur personnalisée, tant qu'elle est prise en charge par le poste de travail.
FontSmoothing	Ce paramètre permet d'optimiser la reconnaissance de texte. Lorsqu'il indique Vrai (True), l'option de Lissage des polices est activée pour les connexions RDP, ce qui signifie que l'option ClearType sera appliquée à la machine cible.
ConnectionString	Il s'agit d'une chaîne générée à partir d'Orchestrator qui permet d'enregistrer votre Robot sans avoir à renseigner le Nom de machine (Machine Name) et la Clé de machine (Machine Key).
DisableWorkflowExecution	Désactive l'option d'exécution des processus à partir de la ligne de commande, si activée. Par défaut, cette fonctionnalité est masquée et désactivée.
webProxySettings	Parameter used to configure Proxy Settings for the Robot. Find out more in the Redirecting Robots Through a Proxy document.

Variables système UiPath Robot

D’autres comportements personnalisés peuvent être configurés via des variables d’environnement système.

Important :

Après avoir modifié l’une des variables système, redémarrez le service de robot.

La liste suivante résume les cas d’utilisation les plus courants :

• UIPATH_SESSION_TIMEOUT - Modifie le délai d'attente par défaut de 60 secondes pour la création d'une session interactive. Ajustez cette valeur pour adapter le comportement du robot en fonction des performances et des temps de chargement du système avec lequel il interagit.

  Exemple :

  UIPATH_SESSION_TIMEOUT=75
  

• UIPATH_PIP_SESSION_TIMEOUT - Modifie le délai d'attente par défaut de 180 secondes pour le démarrage d'un processus dans une session de robot.

  Exemple :

  UIPATH_PIP_SESSION_TIMEOUT=60
  

• UIPATH_LANGUAGE - Définit la langue dans laquelle le robot fonctionne. L'ordre de priorité est le suivant :

  Exemple :

  UIPATH_LANGUAGE=French
  

  1. Valeur UIPATH_LANGUAGE
  2. Variable d'environnement de machine
  3. Culture de l'interface utilisateur du fil actuel
  4. Langue UiPath par défaut (anglais)

• UIPATH_HEADLESS_WITH_USER - Utilise les identifiants d'un utilisateur spécifique, qui ont été précédemment configurés dans Orchestrator.

  Exemple :

  UIPATH_HEADLESS_WITH_USER=True
  

• UIPATH_PRE_LOADED_EXECUTOR - Par défaut, un exécuteur pré-chargé est lancé lorsque le robot démarre.Pour modifier ce comportement et lancer l’exécuteur préchargé uniquement lorsque le premier processus s’exécute, définissez cette variable sur None.

  Exemple :

  UIPATH_PRE_LOADED_EXECUTOR=None
  

• UIPATH_DISABLE_PRE_LOADED_EXECUTOR - Désactive la fonctionnalité de l'exécuteur pré-chargé.

  Exemple :

  UIPATH_PRE_LOADED_EXECUTOR=None
  

• UIPATH_ROBOTJS_ALLOWLIST - Accepte automatiquement la boîte de dialogue de consentement du robot lors de l'établissement de la connexion entre le SDK Robot JS et l'exécuteur Robot.

  La variable accepte les URL d’application personnalisées, séparées par des points-virgules. Incluez le numéro de port dans l’URL s’il diffère des ports standard (80 ou 443).

  Exemple :

  UIPATH_ROBOTJS_ALLOWLIST=cloud.uipath.com;mydomain.com;
  

• UIPATH_DNS_MACHINENAME - Permet d'utiliser le nom d'hôte DNS pour Localhost lors de la création de sessions RDP. Pour exécuter des tâches Unattended dans des environnements avec l’authentification Kerberos pour RDP, définissez cette valeur sur Vrai.

  Exemple :

  UIPATH_DNS_MACHINENAME=True
  

• NUGET_FALLBACK_PACKAGES - Configure les chemins vers les dossiers des paquets de secours. Utilisez des points-virgules pour séparer plusieurs chemins.

  En l’absence de cette variable, le robot recherche les dossiers de packages de secours dans le fichier Nuget.config.

• NUGET_SCRATCH - Permet à plusieurs robots en mode utilisateur sur la même machine de partager un chemin local pour le stockage des packages.

  La valeur doit être un chemin d’accès différent vers le dossier d’installation de NuGet, qui fait office de dossier temporaire pour NuGet.

  Remarque :

  Seule la variable NUGET_SCRATCH doit utiliser le dossier temporaire configuré.

  Exemple :

  NUGET_SCRATCH=C:\NuGetTempFolder
  

• UIPATH_PRESERVE_CREDENTIALS_CASE - Préserve la casse d'origine des informations d'identification de journalisation (domaine\username).

  Exemple :

  UIPATH_PRESERVE_CREDENTIALS_CASE = True
  

• UIPATH_SESSION_BEHAVIOR - Configure le comportement de la restauration de la session après la fin d'une tâche. Les options suivantes sont disponibles :

  • TryReuseAndRestoreSession : l’option par défaut. Tente de réutiliser la session et de la restaurer à son état précédent après la fin d’une tâche. S’il n’y a aucune session initiale à réutiliser au moment de la restauration, la session est déconnectée.
  • ForceNew : crée une session complètement nouvelle, indépendamment de l’état de la session précédente. La session est toujours déconnectée au moment de la restauration.
  • LeaveSessionActive : empêche la restauration de l’état initial de la session.
  • LeaveSessionDisconnected : déconnecte toujours la session au moment de la restauration.

  Exemple :

  UIPATH_SESSION_BEHAVIOR = LeaveSessionDisconnected
  

Restarting Robot Components

N’oubliez pas d’enregistrer votre travail en cours avant de redémarrer pour éviter de perdre votre progression.

• Service de robots
  • Installation en mode service
    1. Ouvrez le Gestionnaire des tâches > Services.
    2. Recherchez le service UiPathRobotSvc.
    3. Cliquez avec le bouton droit sur le service et sélectionnez Redémarrer.
  • Installation en mode utilisateur - Quittez, puis redémarrez Assistant ou:
    1. Ouvrez le Gestionnaire des tâches > Détails.
    2. Sélectionnez le processus UiPath.Service.UserHost.exe.
    3. Sélectionnez Terminer la tâche.
• Service de mise à jour
  1. Ouvrez le Gestionnaire des tâches > Services.
  2. Recherchez le service UiPath.UpdateService.Agent.
  3. Cliquez avec le bouton droit sur le service et sélectionnez Redémarrer.
• Hôte de service UiPath RobotJS
  1. Ouvrez le Gestionnaire des tâches > Services.
  2. Recherchez le service UiPath.RobotJS.ServiceHost.
  3. Cliquez avec le bouton droit sur le service et sélectionnez Redémarrer.
• Assistant UiPath
  1. Dans l’Assistant, sélectionnez Préférences, puis Quitter.
  2. Relancez l’Assistant.
• Widgets - Redémarrez l'Assistant ou :
  1. Cliquez avec le bouton droit sur l’icône de l’Assistant dans la barre des tâches.
  2. Sélectionner Recharger les widgets