Fichiers de configuration

Une fois que vous avez modifié les fichiers de configuration, vous devez redémarrer les composants Robot concernés pour que les modifications prennent effet. La liste suivante résume comment redémarrer plusieurs composants, selon le mode d’installation 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 relancez l'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

uipath.config

Le fichier UiPath.config contient les paramètres de configuration essentiels du Robot. En tant qu’administrateur, vous pouvez personnaliser le comportement de vos robots en modifiant la liste des paramètres dans le fichier de configuration.

Remarque :

Chaque environnement peut nécessiter des avis spécifiques. UiPath vous permet ainsi d’appliquer différentes configurations en fonction de l’environnement actuel du robot (Développement, Organisation ou Production. Faites toujours preuve de prudence lorsque vous modifiez ce fichier, car une configuration inexacte peut entraîner des problèmes au niveau de l’application.

Accès au fichier

Lorsque vous installez votre Robot, le système crée le fichier UiPath.config.

Pour le retrouver, accédez à C:\Program Files\UiPath\Studio\UiPath.config.

Paramètres personnalisables

Le fichier UiPath.config comprend les paramètres suivants :

• Dans la section de configuration connectionSettings

  • DefaultServiceUrl (string) - Sets the default address the Robot uses to connect to Orchestrator.

    Exemple :

    string DefaultServiceUrl = "https://cloud.uipath.com"
    

  • AutoSignIn (bool) - Enables the auto sign-in feature for Assistant. Default value is false.

    Exemple :

    bool AutoSignIn = true.
    

  • EnforceDefaultServiceUrl (bool) - Enforces the address provided as DefaultServiceUrl to all users. Default value is false.

    Exemple :

    bool EnforceDefaultServiceUrl = true.
    

• Dans la section de configuration communicationSettings

  • MaxMessageSizeInMegabytes (octet) : définit la taille maximale d’un message que le système peut envoyer ou recevoir, en Mo. La valeur par défaut est 10.
    
    Cela permet d’éviter les surcharges ou les plantages de processus dus au traitement de messages trop volumineux.

    Exemple :

    byte MaxMessageSizeInMegabytes = 10;
    

  • InstallPackageTimeout (TimeSpan) : définit la limite de temps pour les installations de packages. La valeur par défaut est 20 minutes.
    
    Si l’installation d’un package prend plus de temps que défini, le système abandonne l’installation.

    Exemple :

    TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);
    

  • RequestTimeout (TimeSpan) : définit la durée pendant laquelle le système attend une réponse de communication. La valeur par défaut est 40 secondes.
    
    If the system does not receive a response in the set period, it stops and moves forward. This prevents system hang-ups.

    Exemple :

    TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);
    

• Dans la section de configuration packageSettings
  • PackagesInstallationFolder (string) : définit le répertoire par défaut où les packages sont installés. La valeur par défaut est C:\UiPath\Packages.
  • SkipHttpConfigurationSources (bool) : permet au système d’ignorer les sources de packages configurées sur HTTP, telles que les flux NuGet. La valeur par défaut est false.
    
    Cela signifie que le système ne récupère pas les packages à partir de ces sources, ce qui est utile lorsque les sources ne sont pas fiables ou sécurisées.
  • DisableSecureXaml (bool) : permet au robot d'exécuter des workflows potentiellement non sécurisés. La valeur par défaut est false.
  • DirectDownload (bool) : permet le téléchargement direct de packages, sans inviter l’utilisateur. La valeur par défaut est false.
  • PackageSaveWithoutNupkg (bool) : permet d’enregistrer les packages sans le fichier .nupkg . La valeur par défaut est false.
    
    Cela permet de réduire la taille du téléchargement.
• Dans la section de configuration analyticsSettings
  • Telemetry.Enabled (bool) : permet à UiPath de collecter et d'envoyer des données d'utilisation pour analyse. La valeur par défaut est false.
• Dans la section de configuration robotCacheSettings

  • SessionCacheDuration (TimeSpan) : définit la durée pendant laquelle les données d’une session spécifique doivent être conservées dans le cache avant d’être supprimées. La valeur par défaut est 30 secondes.
    
    This is useful for reusing data such as variable values or details of operations, instead of recreating or refetching it.

    Exemple :

    TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);
    

  • GetResourceUrlCacheDuration (TimeSpan) : définit la durée pendant laquelle les URL des ressources, telles que les API ou les pages Web, sont stockées dans le cache. La valeur par défaut est une (1) heure.
    
    Ceci est utile pour optimiser les performances dans les scénarios où vos robots doivent accéder régulièrement à certaines ressources.

    Exemple :

    TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);
    

• Dans la section de configuration robotJsSettings

  • ListenerPort (int) : définit le numéro de port sur lequel Robot.js écoute les connexions entrantes. La valeur par défaut est 2323.
    
    Cela permet au service de robot UiPath d’interagir avec les applications Web exécutées sur des serveurs locaux ou distants.

    Exemple :

    int ListenerPort = 2323;
    

  • TokenExpiryInDays (int) : définit la durée de validité, en jours, des jetons d’authentification générés par le service de robot UiPath. La valeur par défaut est de 30 jours.
    
    Le service de robot utilise ces jetons pour s’authentifier lors des interactions avec d’autres composants ou services logiciels.

    Exemple :

    int TokenExpiryInDays = 30;
    

  • AllowUrlList (string) - Sets the list of URLS that the robot service can access. This helps ensure your robot service only interacts with approved services.

    Exemple :

    string AllowUrlList = "https://cloud.uipath.com";
    

Important :

• Créez toujours une sauvegarde du fichier UiPath.config d’origine avant d’apporter des modifications. Cela peut vous aider à restaurer les paramètres d’origine en cas de problème.
• Pour appliquer les mises à jour apportées au fichier UiPath.config, redémarrez le service UiPath ou le système.
• Les paramètres locaux du fichier UiPath.config sont prioritaires sur les paramètres configurés dans Orchestrator.
• Les données sensibles dans le fichier UiPath.config peuvent être chiffrées pour plus de sécurité.

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’expiration 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 chargement du système avec lequel il interagit.

  Exemple :

  UIPATH_SESSION_TIMEOUT=75
  

• UIPATH_PIP_SESSION_TIMEOUT : modifie le délai d'expiration par défaut de 180 secondes pour démarrer un processus dans une session Robot.

  Exemple :

  UIPATH_PIP_SESSION_TIMEOUT=60
  

• UIPATH_LANGUAGE : définit la langue dans laquelle fonctionne le robot. L’ordre de priorité est le suivant :

  1. Valeur UIPATH_LANGUAGE
  2. Variable d'environnement de la machine
  3. Culture actuelle de l’IU du fil de discussion
  4. Langue UiPath par défaut (anglais)

  Exemple :

  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.

  Exemple :

  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.

  Exemple :

  UIPATH_PRE_LOADED_EXECUTOR=None
  

• UIPATH_DISABLE_PRE_LOADED_EXECUTOR : désactive la fonctionnalité d’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 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).

  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 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 une même machine de partager un chemin local sur une même machine 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\_nom d’utilisateur).

  Exemple :

  UIPATH_PRESERVE_CREDENTIALS_CASE = True
  

• UIPATH_SESSION_BEHAVIOR – configure le comportement de la restauration de 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