Exécuteur Robot

Configurez et gérez l’exécuteur UiPath, le composant Robot qui exécute les workflows d’automatisation dans des sessions isolées.

UiPath Executor is a component of the UiPath software structure that is used to run automations or jobs. It is the component that actually executes the automation workflows, and you can identify it in the list of running processes as UiPath.Executor.exe.

Mode de fonctionnement

Pendant l'intégralité du cycle de vie d'une automatisation, l'exécuteur est en charge de l'étape d'exécution :

1. Phase de conception : après sa conception et sa création dans Studio, un workflow d'automatisation est publié dans Orchestrator.
2. Phase Orchestrator : l'Orchestrator est le composant qui gère, contrôle et consigne les opérations exécutées par les robots. Ici, vous pouvez planifier une tâche ou l'exécuter à la demande.
3. Phase d'exécution : lorsqu'une tâche est planifiée ou déclenchée, Orchestrator envoie un ordre au service de robot UiPath. Ensuite, le service de robot UiPath lance des instances d'exécuteur UiPath pour procéder à l'exécution de la tâche d'automatisation. Chaque instance fonctionne dans une session isolée. Ainsi, si une tâche échoue, les autres ne sont pas affectées.
4. Phase de post-exécution : lorsque la tâche est terminée, les instances de l'exécuteur sont résiliées et les résultats sont renvoyés à l'Orchestrator. Le délai d'exécution, le statut (réussite ou échec) et les exceptions éventuelles sont autant de détails qui sont consignés et peuvent être analysés le dépannage ou l'amélioration des processus.

Capabilities

Quelques-unes des capacités de l'exécuteur :

• Exécution de tâches locales ou à distance : l'exécuteur UiPath peut lancer des tâches non seulement sur l'appareil local sur lequel le service de robot UiPath est installé, mais également en se connectant à d'autres appareils à distance pour y exécuter des tâches.
• Exécution de tâches simultanées : l'exécuteur a la capacité d'accomplir plusieurs automatisations en parallèle, chacune fonctionnant comme une session indépendante.
• Équilibrage des charges et hiérarchisation des tâches : conjointement à l'Orchestrator UiPath, l'exécuteur peut contribuer à l'équilibrage des charges d'automatisation entre plusieurs robots et à hiérarchiser les tâches en fonction de règles prédéfinies.
• Maintien de l'isolement des workflows : chaque tâche de l'exécuteur est isolée, ce qui signifie que l'erreur ou la défaillance d'une tâche n'aura pas d'incidence sur les performances des autres.
  Remarque :

  L'exécuteur s'ajuste aux différents paramètres DPI, ce qui permet aux workflows de s'exécuter sur n'importe quelle résolution. Si certaines applications ne peuvent pas gérer les DPI, vous pouvez désactiver cette fonctionnalité.

Types d'exécuteurs basés sur les projets d'automatisation

En fonction du projet d'automatisation, le service de robot UiPath lance le type d'exécuteur adéquat pour exécuter l'automatisation. Les tableaux suivants résument les types de projets qu'un exécuteur peut lancer, en fonction de l'infrastructure cible utilisée.

Projet/type d'exécuteur	Architecture	Système d'exploitation pris en charge	Infrastructure utilisée
Windows - Héritage	32 bits	Windows (x64 et x86)	.NET Framework 4.7.2
Windows	64 bits	Windows x64	.NET 10 with Windows support (.NET Core - Windows)
Multiplateforme	64 bits	Windows, Linux (64-bit)	.NET 10 with cross-platform support (.NET Core)

Chaque ligne du tableau représente un type d'exécuteur différent, avec son mode de configuration pour exécuter des projets selon les exigences spécifiques du type de projet, le système d'exploitation cible et la version .NET Framework utilisée. Grâce à ces informations, déterminez le meilleur exécuteur pour chaque projet, assurez une bonne compatibilité avec l'environnement cible et exploitez le plein potentiel des fonctionnalités adéquates de l'infrastructure.

The Executor and executor packages

The Executor is the .NET executor of Unified Runtime, and runs RPA processes and test cases. By default, agents, functions, and API workflows don't run in UiPath.Executor.exe. They run in executor packages, in a separate host process that the Robot Service starts. The settings on this page, such as preloaded executors, Medium+ integrity, and UIPATH_HEADLESS_WITH_USER, apply to the Executor only.

Configurations utilisateur pour l'exécuteur

The Executor has a dedicated system variable UIPATH_HEADLESS_WITH_USER, which you can configure depending on the type of user that runs the automation.

When the user is Local Service, you can run background automations. Here, the setting for UIPATH_HEADLESS_WITH_USER should either be Falseor not set at all.

When the user running the automation has credentials specified in Orchestrator, there are two scenarios you should consider:

• For background automations, the UIPATH_HEADLESS_WITH_USER setting should be True.
• For foreground automations, there should be no UIPATH_HEADLESS_WITH_USER variable set.

Le tableau suivant résume les conditions utilisateur pour l'exécuteur.

Type d’utilisateur	Type d'automatisation	UIPATH_HEADLESS_WITH_USER Paramètre
Local Service	Arrière-plan	False or null
Utilisateur configuré dans Orchestrator	Arrière-plan	True
	Premier plan	Aucune variable nécessaire

Exécuteur préchargé

Usually, each process requires time to load the required workflow, packages, and libraries into memory before it can start processing. In a preloaded setup, those dependencies are already loaded into memory, in dedicated execution slots. A preloaded executor is enabled by default in User Mode. Preloaded executors exist only in User Mode: in Service Mode, the Robot doesn't start them, and the variables below have no effect.

Quelques informations cruciales concernant l'exécuteur préchargé :

• Exécution plus rapide : en préchargeant le processus, vos robots peuvent commencer à travailler sur leurs tâches beaucoup plus rapidement.
• Utilisation des ressources : les workflows ayant déjà été chargés en mémoire, les robots consomment moins de ressources.
• Disponibilité : les exécuteurs préchargés sont principalement conçus pour les automatisations attended lancées à partir de l'Assistant, de RobotJS, de Studio ou de l'interface de ligne de commande. Les tâches Unattended provenant d'Orchestrator lancent un unique exécuteur non préchargé.

Variables système pour la configuration préchargée

You can manage the behavior of preloaded executors by setting specific environment variables on the robot machine, as follows. They apply to User Mode robots only:

Variable d'environnement	Valeur (Value)	Description
UIPATH_PRE_LOADED_EXECUTOR	Aucun (None)	Écrase le comportement par défaut et lance l'exécuteur préchargé uniquement au démarrage de la première tâche.
UIPATH_DISABLE_PRE_LOADED_EXECUTOR	Vrai	Désactive l'exécuteur préchargé.

Mode de fonctionnement

En ajoutant la variable UIPATH_PRE_LOADED_EXECUTOR à votre système, vous configurez un paramétrage préchargé. Deux exécuteurs démarrent : un lorsqu'une tâche démarre et un autre pour attendre les tâches futures (l'exécuteur préchargé). Lorsqu'une autre tâche démarre, elle utilise l'exécuteur préchargé et génère un autre exécuteur préchargé qui attendra la tâche suivante. En bref, une configuration préchargée garantit toujours qu'un exécuteur est disponible et attend une tâche.

Exécuteurs et systèmes d'exploitation préchargés

For Windows devices, when UiPath.Service.UserHost.exe starts in User Mode, it launches two preloaded executors: one for Windows projects, and another for Windows-Legacy projects.

Élévation de l'intégrité Medium+

Certaines applications Windows s'exécutent à un niveau d'intégrité plus élevé que la session utilisateur standard. Un exemple courant est la boîte de dialogue Windows CredentialBroker, qui apparaît lorsque vous entrez un nom d'utilisateur et un mot de passe pour vous connecter à une session Bureau à distance (RDP). Étant donné que CredentialBroker s'exécute à l'intégrité Medium+, l'exécuteur ne peut pas interagir avec lui par défaut et votre automatisation ne saisit pas les identifiants dans la boîte de dialogue.

Pour permettre à l'exécuteur d'automatiser ces fenêtres, définissez la variable d'environnement de la machine (système) UIPATH_MEDIUMPLUS_EXECUTOR sur 1. Lorsque cette variable est définie, le service de robot UiPath lance l'exécuteur au niveau d'intégrité Medium+, ce qui lui permet d'interagir avec des fenêtres qui seraient autrement inaccessibles.

À défaut, pour n'élever que certaines invocations plutôt que l'exécuteur dans son ensemble, définissez la variable d'environnement de la machine UIPATH_MEDIUMPLUS_INVOKE (système) sur 1. Lorsque cette variable est activée, les activités Invoke Workflow File et Invoke Process peuvent s'exécuter au niveau d'intégrité Medium+ par invocation, laissant le reste de l'automatisation au niveau d'intégrité standard.

L'élévation de privilèges ne s'applique qu'aux invocations qui la demandent ; l'option d'élévation de privilèges de l'activité doit également être activée ; la variable seule ne provoque aucune élévation de privilèges.

L'option d'élévation nécessite UiPath.System.Activities 26.6.0 ou une version ultérieure, et pour Invoke Workflow File, elle s'applique uniquement lorsque le workflow est invoqué de manière isolée. Comme pour UIPATH_MEDIUMPLUS_EXECUTOR, cette fonctionnalité s'applique uniquement à Windows et nécessite l'activation d'UAC.

Prérequis

• Windows only — this feature is not available on Linux.
• UAC doit être activé : l'élévation dépend du contrôle de compte utilisateur actif sur la machine. Si UAC est désactivé, la variable est ignorée et l'exécuteur démarre au niveau d'intégrité par défaut.
• Mode d'installation : le robot doit être installé soit en mode service, soit en mode utilisateur avec une installation par machine (installé dans Program Files). Les installations par utilisateur ne prennent pas en charge l'élévation Medium+.
• Variable au niveau de la machine - la variable doit être définie comme variable d'environnement de machine (système), pour les automatisations assistées et non assistées. Une variable au niveau de l'utilisateur n'a aucun effet ; l'élévation n'est activée que lorsque la variable est définie au niveau de la machine.

Comment activer

1. Ouvrez Propriétés système > Variables d'environnement sur la machine robot.
2. Dans la section Variables système, sélectionnez Nouveau. La variable doit être définie au niveau de la machine (système) ; une variable au niveau de l'utilisateur n'a aucun effet.
3. Définissez le nom de la variable sur UIPATH_MEDIUMPLUS_EXECUTOR et la valeur sur 1.
4. Sélectionnez OK pour enregistrer la variable.
5. Redémarrez le service de robot UiPath pour que la modification prenne effet.

Résultat

Après avoir activé l'élévation Medium+, vos automatisations peuvent interagir avec la boîte de dialogue CredentialBroker et d'autres fenêtres qui nécessitent l'intégrité Medium+. Si UIPATH_MEDIUMPLUS_EXECUTOR est définie, l'exécuteur s'exécute avec des privilèges élevés pendant toute la durée de l'automatisation ; si UIPATH_MEDIUMPLUS_INVOKE est définie, seules les invocations qui demandent une élévation de privilèges s'exécutent avec des privilèges élevés. Si l'exécuteur ne peut pas démarrer au niveau élevé (par exemple, parce qu'UAC est désactivé), il revient au niveau d'intégrité par défaut et enregistre un avertissement.