Fichiers de configuration

Une fois que vous avez modifié les fichiers de configuration, vous devez redémarrer les composants de robot pertinents pour que les modifications prennent effet. La liste suivante résume comment redémarrer plusieurs composants en fonction du 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 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

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 connectionSettingsconfig
  • DefaultServiceUrl (string) - 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 Assistant.La valeur par défaut est false. Exemple :

    bool AutoSignIn = true.

  • EnforceDefaultServiceUrl (bool) - Applique l'adresse fournie comme DefaultServiceUrl à tous les utilisateurs. La valeur par défaut est false. Exemple :

    bool EnforceDefaultServiceUrl = true.

• Dans la section communicationSettingsconfig
  • MaxMessageSizeInMegabytes (byte) - 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 package.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 combien de temps le système attend une réponse de communication.La valeur par défaut est de 40 secondes.

    Si le système ne reçoit pas de réponse dans la période définie, il s'arrête et avance.Cela évite les blocages du système.Exemple :

    TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);

• Dans la section packageSettingsconfig
  • 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 package 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 dangereux.La valeur par défaut est false.
  • DirectDownload (bool) - Permet le téléchargement direct des 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 analyticsSettingsconfig
  • 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 robotCacheSettingsconfig
  • SessionCacheDuration (TimeSpan) - Définit pendant combien de temps les données d'une session spécifique doivent être conservées dans le cache avant d'être éliminé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 pendant combien de temps 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 robotJsSettingsconfig
  • 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 période de validité, en jours, des jetons d'authentification générés par le service de robot UiPath.La valeur par défaut est 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 URLs auxquelles le service de robot UiPath peut accéder.Cela aide à garantir que votre service de robot UiPath interagit uniquement 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'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 non assistées dans des environnements avec 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.
  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 NUGET_SCRATCH variable 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

• UIPATH_HTTP_CONNECTION_LIFETIME - Définit pendant combien de temps la connexion à Orchestrator reste ouverte avant qu'elle ne soit 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. Cela 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. Cela est utilisé lorsque votre infrastructure doit charger certains services (VPN, sécurité) avant que l'exécution de votre automatisation ne commence.

  Exemple :

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