Description du fichier UiPath.Settings

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é d'API du flux NuGet. Lorsque vous n'êtes pas connecté à Orchestrator, si vous utilisez un flux local, une clé d'API n'est pas nécessaire. Si vous utilisez un flux privé MyGet, veuillez noter que ce paramètre est obligatoire. Lorsqu'elle est connectée à Orchestrator, cette valeur n'est pas prise en compte.
NuGetServerUrl	L'emplacement où les projets sont transmis et d'où ils sont récupérés. Il peut s'agir soit d'un flux local, comme un chemin d'accès au système de fichiers soit un flux Web utilisant 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. En savoir plus sur les flux d'activités sur cette page ainsi que sur les endroits où les packages sont installés en fonction du type de déploiement du robot.
UiPathServerUrl	L'adresse de votre instance d'Orchestrator. Lorsqu'il n'est pas connecté à Orchestrator, ce paramètre est vide. Lorsqu'il est connecté à Orchestrator, il est automatiquement renseigné avec l'URL que vous avez fournie dans la fenêtre Paramètres d'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 High-Density (High-Density Robots)) 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 :

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

  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)

  Exemple :

  UIPATH_LANGUAGE=French
  

• 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 d'accès. En l'absence de cette variable, le robot recherche les dossiers des packages de secours dans le fichierNuget.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
  

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