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. Le tableau suivant résume comment redémarrer plusieurs composants, selon le mode d'installation du Robot.

N'oubliez pas d'enregistrer tout travail en cours avant de redémarrer pour éviter de perdre toute progression non sauvegardée.

Composant (Component)	Installation en mode service	Installation en mode utilisateur
Service de robots	Ouvrez le Gestionnaire des tâches (Task Manager) > Services(Services). Recherchez le service UiPathRobotSvc . Cliquez avec le bouton droit sur le service et sélectionnez Redémarrer(Restart).	Quitter, puis relancer l'Assistant ou Ouvrez le Gestionnaire des tâches > Détails(Details). Sélectionnez le processus UiPath.Service.UserHost.exe . Sélectionnez Fin de la tâche.
Service de mise à jour	Ouvrez le Gestionnaire des tâches (Task Manager) > Services(Services). Recherchez le service UiPath.UpdateService.Agent . Cliquez avec le bouton droit sur le service et sélectionnez Redémarrer(Restart).
Hôte de service UiPath RobotJS	Ouvrez le Gestionnaire des tâches (Task Manager) > Services(Services). Recherchez le service UiPath.RobotJS.ServiceHost . Cliquez avec le bouton droit sur le service et sélectionnez Redémarrer(Restart).
Assistant UiPath	Dans UiPath Assistant, sélectionnez Préférences, puis Quitter. Relancez l'Assistant.
Widgets	Redémarrez UiPath Assistant. ou Cliquez avec le bouton droit sur l'icône de l'Assistant dans la barre des tâches. Sélectionnez 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 notifications spécifiques. UiPath vous permet donc d'appliquer différentes configurations en fonction de l'environnement actuel du robot, qu'il s'agisse de Développement (Development), de Staging (Staging) ou de Production (Production). Soyez toujours prudent lorsque vous modifiez ce fichier, car une configuration inexacte peut entraîner des problèmes d'application.

Accéder au fichier

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

Pour y accéder, rendez-vous sur C:\Program Files\UiPath\Studio\UiPath.config.

Paramètres personnalisables

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

Section Configuration	Type de données + nom du paramètre	Description	Default	Exemple
connectionSettings	chaîne DefaultServiceUrl	Définit l'adresse par défaut que le Robot utilise pour se connecter à Orchestrator.	NA	string DefaultServiceUrl = "https://cloud.uipath.com"
	bool AutoSignIn	Active la fonctionnalité de connexion automatique pour UiPath Assistant.	False	bool AutoSignIn = true.
	bool EnforceDefaultServiceUrl	Applique l'adresse fournie en tant qu'URL de service par défaut à tous les utilisateurs.	False	bool EnforceDefaultServiceUrl = true.
communicationSettings	octet MaxMessageSizeInMegabytes	Définit la taille maximale d'un message que le système peut envoyer ou recevoir, en Mo. Cela est utilisé pour éviter les surcharges ou les plantages de processus dus au traitement de messages trop volumineux.	10 Mo	byte MaxMessageSizeInMegabytes = 10;
	TimeSpan InstallPackageTimeout	Définit la limite de temps pour les installations de packages. Si l'installation d'un package prend plus de temps que le temps défini, le système abandonne l'installation. Exprimé sous la forme TimeSpan.	20 minutes	TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);
	TimeSpan RequestTimeout	Définit la durée pendant laquelle le système attend une réponse de communication. 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. Exprimé sous la forme TimeSpan.	40 secondes	TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);
packageSettings	chaîne PackagesInstallationFolder	Définit le répertoire par défaut dans lequel les packages sont installés.	C:\UiPath\Packages
	bool SkipHttpConfigurationSources	Permet au système d'ignorer les sources de paquets configurées sur HTTP, telles que les flux NuGet. 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.	False
	bool DisableSecureXaml	Permet au Robot d'exécuter des workflows potentiellement non sécurisés.	False
	bool DirectDownload	Permet le téléchargement direct de packages, sans inviter l'utilisateur.	False
	bool PackageSaveWithoutNupkg	Permet d'enregistrer les packages sans le fichier .nupkg . Cela permet de réduire la taille du téléchargement.	False
analyticsSettings	bool Telemetry.Enabled	Permet à UiPath de collecter et d'envoyer des données d'utilisation pour analyse.	False
webProxySettings	chaîne ScriptAddress	Définit l'adresse du script qui détermine comment et quand utiliser le proxy.
	chaîne ProxyAddress	Définit l'adresse du serveur proxy, soit IP, soit le nom de domaine.
	chaîne BypassList	Contient la liste des adresses qui se connectent directement à Internet, sans passer par le serveur proxy.
	bool BypassLocalAddresses	Permet une connexion directe pour les adresses locales, sans passer par le serveur proxy.	False
	chaîne UserName	Définit les informations d’identification du nom d’utilisateur pour l’authentification du serveur proxy.
	chaîne Password	Définit le mot de passe associé au nom d'utilisateur pour l'authentification du serveur proxy.
	chaîne Domain	Définit le domaine où réside le serveur proxy, requis pour l'authentification.
robotCacheSettings	TimeSpan SessionCacheDuration	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. 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. Exprimé sous la forme TimeSpan.	30 secondes	TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);
	TimeSpan GetResourceUrlCacheDuration	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. Ceci est utile pour optimiser les performances dans les scénarios où vos robots doivent accéder régulièrement à certaines ressources. Exprimé sous la forme TimeSpan.	1 heure	TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);
robotJsSettings	int ListenerPort	Définit le numéro de port sur lequel Robot.js écoute les connexions entrantes. Cela permet au service de robot UiPath d'interagir avec les applications Web exécutées sur des serveurs locaux ou distants.	2 323	int ListenerPort = 2323;
	int TokenExpiryInDays	Définit la durée de validité, en jours, des jetons d'authentification générés par le service de robot UiPath. Le service de Robot utilise ces jetons pour s'authentifier lors des interactions avec d'autres composants ou services logiciels.	30 jours	int TokenExpiryInDays = 30;
	chaîne AllowUrlList	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.		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.

Après avoir modifié l'une des variables système, redémarrez le service 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_SESSION_LEGACY
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_USER_SERVICE_PATH	Définit le chemin d'installation du service utilisateur.	UIPATH_USER_SERVICE_PATH=C://installation/folder/UiPath.Service.UserHost.exe
UIPATH_LANGUAGE	Définit la langue dans laquelle le Robot fonctionne. L'ordre pour déterminer la langue est : UIPATH_LANGUAGE Valeur 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_DISABLE_MARKETPLACE_WIDGET	Requis par UiPath Assistant, désactive le widget Marketplace.	// On Windows OS UIPATH_DISABLE_MARKETPLACE_WIDGET=True //On Mac OS, run the following command: launchctl setenv UIPATH_DISABLE_MARKETPLACE_WIDGET TRUE
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. Cette variable remplace le comportement par défaut et un exécuteur préchargé démarre lorsque le premier processus s'exécute. Les options sont les suivantes : Windows Héritage Portable Aucun (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 Robot JS SDK et l'exécuteur Robot. La variable accepte les URL d'application personnalisées, séparées par des points-virgules. Si des ports non standard sont utilisés, assurez-vous d'inclure les numéros de port.
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 (True).	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, et il s'agit d'un 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 identifiants de journalisation (domaine/nom d’utilisateur).	UIPATH_PRESERVE_CREDENTIALS_CASE = True