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 (chaîne) : définit l'adresse par défaut que le robot utilise pour se connecter à Orchestrator. Exemple :

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

  • AutoSignIn (bool) : active la fonctionnalité de connexion automatique pour l'Assistant. La valeur par défaut est false. Exemple :

    bool AutoSignIn = true.

  • EnforceDefaultServiceUrl (bool) : applique l'adresse fournie en tant que DefaultServiceUrl à tous les utilisateurs. La valeur par défaut est 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.

    Si le système ne reçoit pas de réponse dans la période définie, il s’arrête et poursuit. Cela permet d’éviter les blocages du système. 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.

    Cela est utile pour réutiliser des données telles que des valeurs de variables ou des détails d’opérations, au lieu de les recréer ou de les récupérer. 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.

    Cela 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) : définit la liste des URL auxquelles le service de robot UiPath peut accéder. Cela permet de garantir que votre service de robot n’interagit qu’avec les services approuvés. 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

• UIPATH_HTTP_CONNECTION_LIFETIME – définit combien de temps la connexion à Orchestrator reste ouverte avant d'être fermée et actualisée. La durée par défaut est de 30 minutes, mais pour ajuster cette valeur, utilisez une valeur exprimée en secondes.

  Exemple :

  // to set 10 minutes                          
  UIPATH_HTTP_CONNECTION_LIFETIME = 600

• UIPATH_FILE_LOG_LEVEL : définit le niveau du journal d'exécution utilisé dans le fichier local. C'est différent du niveau de journal utilisé pour Orchestrator. Les options suivantes sont disponibles :
  • Détaillé (Verbose)
  • Traçage (Trace)
  • Information
  • Avertissement
  • Erreur
  • Critique (Critical)
  • Désactivé (Off)

  Exemple :

  // to set verbose level locally
  UIPATH_FILE_LOG_LEVEL = Verbose

• UIPATH_EXECUTOR_STARTUP_DELAY – définit le temps d’attente en secondes entre la création de la session et le démarrage de l’exécuteur. Cette option est utilisée lorsque votre infrastructure doit charger certains services (VPN, sécurité) avant que l'exécution de votre automatisation ne démarre.

  Exemple :

  // to set the delay to 5 seconds
  UIPATH_EXECUTOR_STARTUP_DELAY = 5