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 :

Remarque : des droits système et administrateur locaux sont requis pour modifier ces paramètres. Pour que les modifications prennent effet, il faut redémarrer le service Robot UiPath (vous devez disposer de droits administrateur) et fermer la barre d'état du Robot.

Le fichier UiPath.Settings est enregistré dans le dossier %localappdata%\UiPath\ lorsque le Robot est déployé en mode utilisateur et %programdata%\UiPath\ lorsque le Robot est déployé en mode service. Il est créé lorsque le service de robot UiPath est démarré pour la première fois. Il contient les paramètres suivants :

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 :

Variable système	Utilisation	Exemple
UIPATH_SESSION_TIMEOUT	Modifie le délai d’attente par défaut de 60 secondes pour créer une session interactive. Ajustez cette valeur pour adapter le comportement du robot en fonction des performances et des temps de charge du système avec lequel il interagit.	UIPATH_SESSION_TIMEOUT=75
UIPATH_PIP_SESSION_TIMEOUT	Modifie le délai d’attente par défaut de 180 secondes pour démarrer un processus dans une session Robot.	UIPATH_PIP_SESSION_TIMEOUT=60
UIPATH_LANGUAGE	Définit la langue dans laquelle fonctionne le robot. L’ordre pour déterminer la langue est le suivant : Valeur UIPATH_LANGUAGE La variable d’environnement de la machine La culture actuelle de l’IU du fil de discussion Langue UiPath par défaut (anglais)	UIPATH_LANGUAGE=French
UIPATH_HEADLESS_WITH_USER	Utilise les informations d’identification d’un utilisateur spécifique, qui ont été précédemment configurées dans Orchestrator.	UIPATH_HEADLESS_WITH_USER=True
UIPATH_PRE_LOADED_EXECUTOR	Par défaut, un exécuteur préchargé est lancé au démarrage du robot. 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.	UIPATH_PRE_LOADED_EXECUTOR=None
UIPATH_DISABLE_PRE_LOADED_EXECUTOR	Désactive la fonctionnalité d’exécuteur préchargé.	UIPATH_DISABLED_PRE_LOADED_EXECUTOR=True
UIPATH_ROBOTJS_ALLOWLIST	Accepte automatiquement la boîte de dialogue de consentement du robot lors de l’établissement de la connexion entre le SDK du 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).	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.	UIPATH_DNS_MACHINENAME=True
UIPATH_PROXY_USE_DEFAULT_CREDENTIALS	Permet au robot de gérer les configurations de proxy qui utilisent les informations d’identification Windows pour l’authentification.	UIPATH_PROXY_USE_DEFAULT_CREDENTIALS=True
NUGET_FALLBACK_PACKAGES	Configure les chemins d’accès aux dossiers de packages 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. Seule la variable NUGET_SCRATCH doit utiliser le dossier temporaire configuré.	NUGET_SCRATCH=C:\NuGetTempFolder
UIPATH_PRESERVE_CREDENTIALS_CASE	Préserve la casse d’origine des informations d’identification de journalisation (domaine/nom d’utilisateur).	UIPATH_PRESERVE_CREDENTIALS_CASE = True

Redémarrage des composants du Robot

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