Sessions Windows

Types de sessions Windows pour le robot UiPath: console et RDP, contrôlés par le paramètre LoginToConsole, avec des notes sur le comportement des sessions du robot haute densité.

Le robot exécute des automatisations dans une session Windows, en lançant une console ou une session RDP en fonction du paramètre LoginToConsole dans Orchestrator. Bien que tous les robots puissent se connecter aux deux types de session, les robots haute densité utilisent uniquement les sessions RDP.

Mode de fonctionnement

Une session Windows est toujours créée sur la machine physique ou virtuelle sur laquelle le robot est installé. Orchestrator ne crée pas directement de sessions Windows. Au lieu de cela, lorsqu'une tâche démarre dans Orchestrator, la séquence suivante est déployée :

1. Orchestrator envoie un message contenant les détails du processus au service de robot UiPath sur la machine.
2. Le service de robot UiPath demande de créer ou d'accéder à une session Windows existante sur la machine.
3. Le service de robot UiPath démarre l'exécuteur Robot dans la session créée au préalable.
4. L'exécuteur Robot lance ensuite l'exécution de l'automatisation dans cette session.

Le service de robot UiPath relie la commande d'exécution d'une automatisation à l'exécution réelle.

Si aucune tâche n'est en attente, le service de robot UiPath entre dans un état d'inactivité et ne nécessite pas qu'une session Windows soit entièrement active pour exécuter une automatisation. La session de service sous-jacente reste active pour préserver la communication avec Orchestrator par le biais de WebSockets (SignalR). Cela garantit que les commandes sont exécutées dès qu'elles sont reçues.

Session de console

Il s'agit de l'environnement d'exécution par défaut.

Dans une session de console, le robot exécute des tâches lorsqu'un utilisateur est connecté à la machine d'hébergement. Ce type de session est généralement recommandé dans les cas suivants :

• Automatisations utilisant la résolution d'affichage de l'ordinateur hôte. Bien que vous puissiez spécifier une résolution personnalisée, elle est limitée aux résolutions prises en charge par l'ordinateur hôte.
• Dans une automatisation séquentielle, une nouvelle exécution démarre dès que la précédente se termine et le robot en cours d'exécution se déconnecte de la session active.
  Important :

  Seule une session de console peut être active à la fois.

Session RDP

Dans une session RDP (Remote Desktop Protocol), le robot crée ou se connecte à un environnement de bureau virtuel distant sur la machine où il s'exécute. Ce type de session est généralement recommandé pour :

• Les automatisations qui nécessitent une résolution d'écran personnalisée, en définissant la largeur, la hauteur et la profondeur de la résolution dans l'onglet Robot Settings (Paramètres du robot) d'Orchestrator.
• Les stations de travail Windows, pour exécuter une automatisation à la fois, alors qu'une nouvelle exécution démarre dès que la précédente se termine et que le robot en cours d'exécution se déconnecte de la session active.
• Machines sous Windows Server, pour exécuter plusieurs automatisations en simultané :
  • for multiple users, each in their own RDP session; each user can run one foreground automation at a time.
• Exécutions de robots haute densité.
  Important :

  Si une tâche est lancée à partir d'Orchestrator alors qu'une session RDP est déjà active, le processus s'exécute dans cette session.

L'option LoginToConsole dans Orchestrator

Lorsque vous définissez ou modifiez un compte de robot dans Orchestrator, vous pouvez sélectionner le type de session utilisé par vos robots pour exécuter des automatisations. Pour ce faire, utilisez l'option Login To Console (connexion à la console).

Dans Orchestrator, à la page Locataire > Gérer l'accès > Comptes Robots > Paramètres des robots, l'option Connexion à la console est désactivée par défaut. Toutefois, le robot exécute des tâches dans une session de console par défaut.

To activate the console session, turn on the Login To Console option and select Yes.

Pour activer la session RDP, choisissez l'option Login To Console (connexion à la console) et sélectionnez Non. Si une tâche démarre à partir d'Orchestrator et qu'une session RDP est déjà active, le robot exécute la tâche dans cette session RDP.

Exécution de processus avec RDP

L'image suivante illustre l'exécution du processus avec RDP :

1. Le service de robot UiPath reçoit la commande de lancement d'exécution de la part d'Orchestrator, via le protocole HTTPS, appelé WebSockets (SignalR).
2. Le service de robot UiPath crée ensuite une session Windows sur la machine à l'aide de RDP. Cette session RDP est créée pour l'utilisateur affecté au robot.
3. Une fois la session RDP créée, le service de robot UiPath génère un exécuteur Robot en son sein. Le service de robot UiPath et l'exécuteur Robot communiquent entre eux par le biais de canaux nommés. Grâce à cette méthode, l'exécuteur Robot sait exactement quelles tâches doivent être exécutées.
4. Les tâches sont exécutées dans la session Windows générée.
   Remarque :

   • Le service de robot UiPath utilise exclusivement le protocole RDP pour démarrer une session Windows sur la machine sur laquelle le robot est installé. Il n'utilise pas le protocole RDP pour connecter Orchestrator à la machine sur laquelle le processus est exécuté, ni pour communiquer avec d'autres composants extérieurs à la machine.
   • Pour exécuter des automatisations unattended dans des environnements dans lesquels les sessions RDP nécessitent une authentification Kerberos, vous devez utiliser le nom d'hôte DNS comme valeur pour le localhost. Pour ce faire, ajoutez la variable d'environnement suivante sur votre machine :

     UIPATH_DNS_MACHINENAME=True
     

   • L'exécution d'automatisations dans des environnements qui appliquent le protocole TCP n'affecte pas vos sessions RDP.

Dépannage des sessions Windows

The Robot Service captures a series of session screenshots while setting up your windows session and deletes them once the session is successfully created. If the session setup fails, it saves the screenshots in the %ProgramData%\UiPath\SessionScreenshots directory for future troubleshooting. The Robot keeps the 100 most recent files in that directory, and each screenshot is saved as an image file and a log file. To change this limit, set the UIPATH_FAILED_SESSION_SCREENSHOTS environment variable to the number of files to keep.