Fichiers de configuration

Description du fichier UiPath.Settings

Le fichier UiPath.Settings contient tous les détails nécessaires concernant la façon dont le Robot exécute les processus. Vous pouvez modifier ces paramètres en modifiant directement le fichier et les champs correspondants. Sinon, vous pouvez les modifier via Orchestrator. Cela se fait depuis l'onglet Paramètres (Settings).

Remarque : veuillez noter que le système local et les droits d'administrateur sont requis pour modifier ces paramètres. Vous devez redémarrer le service Robot UiPath (des droits d'administrateur sont requis pour ce faire) et fermer le panneau Robot pour que les modifications prennent effet.

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 vous n'êtes 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). 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	L'adresse de stockage des activités. Ce champ n'est renseigné que si vous n'êtes pas connecté à Orchestrator Par défaut, sa valeur est définie sur ~/NuGetPackages/Activities. Lorsque vous êtes connecté à Orchestrator, cette valeur n'est pas prise en compte. Apprenez-en davantage sur les flux d'activités sur cette page, ainsi que l'emplacement de l'installation des paquets selon le type de déploiement du Robot.
UiPathServerUrl	L’adresse de votre instance Orchestrator. Lorsqu’il n’est pas connecté à Orchestrator, ce paramètre est vide. Lorsqu’il est connecté à Orchestrator, il est automatiquement rempli avec l’URL que vous avez fournie dans la fenêtre Paramètres Orchestrator.
TracingLevel	Le niveau de journalisation des informations par le Robot. Les options suivantes sont disponibles : Verbose, Trace, Information, Warning, Error, Critical et Off. Vous pouvez également les modifier dans la fenêtre Paramètres d'Orchestrator (Orchestrator Settings), dans la liste déroulante Niveau (Level).
LowLevelTracing	Indique s'il faut consigner ou non les informations au niveau de la trace, pour vous aider à résoudre les incidents et les erreurs. Par défaut, ce paramètre est défini sur false. Pour démarrer le traçage de niveau inférieur, définissez la valeur de ce paramètre sur true. Vous pouvez également modifier cette valeur à partir de la ligne de commande.
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	Permet au Robot de se connecter à la session de console de la machine sur laquelle il est installé. De plus, il indique si vous pouvez connecter plusieurs Robots à Orchestrator en utilisant plusieurs utilisateurs (Robots haute-densité) ou non. Par défaut, la valeur est true. Pour activer les Robots High-Density, définissez la valeur sur 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	Paramètre utilisé pour configurer les paramètres du proxy pour le Robot. Pour en savoir plus, consultez le document Redirection des robots via un proxy.

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. Remarque : 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 Fin de 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