Incrustation d'image - Session enfant

L'incrustation d'image - Session enfant vous permet d'exécuter des processus Attended dans une session Windows isolée sans devoir interrompre votre travail en cours.

Lorsqu'un processus est démarré en mode incrustation d'image, une nouvelle session est générée. Si vous exécutez une automatisation dans PiP pour la première fois, vous êtes invité à authentifier la nouvelle session à l'aide de vos informations d'identification Windows.

Une fois la session créée, une fenêtre d'aperçu apparaît sur votre bureau, fournissant des commentaires en temps réel sur l'exécution du processus. Cette fenêtre peut être redimensionnée, déplacée, placée en plein écran ou placée au-dessus d'autres fenêtres. Vous pouvez quitter le mode Incrustation d'image à tout moment en cliquant avec le bouton droit sur l'entrée de la barre des tâches Windows Incrustation d'image et en sélectionnant Fermer la fenêtre ou en fermant simplement la fenêtre. Une boîte de dialogue de confirmation apparaît et le fait de fermer la fenêtre PiP arrête le processus en cours.

Remarque :

The default timeout to start a process in a PiP session is 180 seconds. If the login in the Picture-in-Picture session takes longer than that, a timeout error is thrown. This default timeout can be changed using UIPATH_PIP_SESSION_TIMEOUT environment variable on the machine. When using the Robot in Service Mode, make sure to set the UIPATH_PIP_SESSION_TIMEOUT variable as a system environment variable and restart the Robot Service.

Les droits d’administrateur sont nécessaires pour activer la fonctionnalité Picture-in-Picture (Incrustation d’image) sur la machine. Cela n’est nécessaire que la première fois que Picture-in-Picture (Incrustation d’image) est utilisé. Ensuite, le processus réel peut être démarré dans Picture-in-Picture (Incrustation d’image) sans privilèges élevés.

Identifiants de la session Robot

Les identifiants utilisés pour la session Robot sont gérés par le mécanisme Session enfant de Windows. Pour plus d’informations, consultez la documentation sur les sessions enfants Microsoft.

Une fois l'incrustation d'image activée, ces informations d'identification sont requises lorsqu'une session enfant Incrustation d'image est lancée jusqu'à ce que l'utilisateur se reconnecte à la machine ou dans des scénarios spécifiques tels que l'utilisation d'une carte à puce ou d'un code PIN au lieu d'une combinaison nom d'utilisateur/mot de passe.

Activation de l'incrustation d'image sur la machine

La fonctionnalité Incrustation d'image de la machine peut être activée via la ligne de commande ou manuellement lors du premier démarrage de la session d'incrustation d'image sur la machine.

Method	Commande	Description
Manuellement		La première fois que vous démarrez une session d'incrustation d'image à partir de Studio ou de UiPath Assistant, vous êtes invité à activer la fonctionnalité d'incrustation d'image sur la machine. Pour cela, des droits d'administrateur sont nécessaires.
Ligne de commande	UiRobot.exe PiP	Permet d'activer ou de désactiver la fonctionnalité Incrustation d’image (Picture-in-Picture) sur la machine. Ce paramètre est appliqué sur la machine locale et affecte tous les utilisateurs, et est utilisé pour modifier les installations existantes. Les paramètres suivants peuvent y être indiqués : PiP --enable Active la fonctionnalité Incrustation d’image (Picture-in-Picture) de la machine. PiP --disable Désactive la fonctionnalité Incrustation d’image (Picture-in-Picture) de la machine. Exemple : UiRobot.exe PiP --Enable Vous devez disposer de droits d'administrateur pour exécuter ces commandes.
Ligne de commande	UiPathStudio.msi ENABLE_PIP	Permet d’activer la fonctionnalité Incrustation d’image (Picture-in-Picture) de la machine lors de l’installation de la ligne de commande UiPath. Pour l’activer, utilisez le paramètre suivant : ENABLE_PIP=1 Exemple : UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages ENABLE_PIP=1

Problèmes connus et limitations

Il y a quelques éléments à prendre en compte lors de l’utilisation de la fonctionnalité Picture in picture :

• Si vous utilisez un code PIN pour vous connecter à la session Windows principale, vous êtes invité à saisir vos informations d’identification chaque fois que vous démarrez une session Robot.
• Lorsque la session Robot est active, elle lance également des programmes de démarrage dans la même session. Cela peut réinitialiser les paramètres de vos périphériques, tels que les paramètres de lumière du clavier et de la souris, en rétablissant leurs valeurs par défaut.
• L’activation de la session Bureau à distance pendant une session Robot active nécessite la déconnexion et la reconnexion à la session Windows principale pour que les modifications prennent effet.
• Vous ne pouvez pas redémarrer ou arrêter votre machine tant que la session Robot est active. Fermez d’abord la session Robot.
• Les restrictions du système d’exploitation empêchent la prise en charge de l’Incrustation d’image pour les éditions Famille de Windows 8 et 10.
• Le presse-papiers est partagé entre la session Robot et la session principale.
• L’exécution en tant qu’administrateur ne peut pas être utilisée dans la session Robot.
• Vous pouvez démarrer une seule session de robot à la fois.
• Pour démarrer une session Robot, vous avez besoin des autorisations Autoriser l’ouverture de session localement (Allow Log On Locally).

Automatisation de Microsoft Office

Les automatisations qui utilisent les ressources Microsoft Office ne peuvent pas s'exécuter avec succès dans l'Incrustation d'image si les ressources sont déjà ouvertes dans la session principale. Afin de vous assurer que les automatisations fonctionnent bien dans PiP, vous pouvez suivre les étapes suivantes :

• Fermez la ressource utilisée par les applications Microsoft Office dans la session principale afin qu’elles puissent être ouvertes dans la session PiP.

• Utilisez une activité Invoquer le workflow isolé (Invoke Isolated Workflow) pour invoquer la partie de l’automatisation à l’aide de Microsoft Office et définir sa session cible sur Incrustation d’image à partir de Studio.

Utilisation du navigateur Web dans les sessions PIP

Les données du navigateur d'une session d'incrustation d'image sont enregistrées par défaut dans la session principale de la machine. Si une instance Google Chrome ou Microsoft Edge est déjà ouverte sur la session principale, elle devra utiliser un autre profil utilisateur dans la session PiP. Cette action est automatiquement effectuée par l'activité Ouvrir le navigateur (Open Browser). Il est impossible d'avoir un navigateur spécifique (disons Chrome) ouvert avec le même profil utilisateur dans la session PiP et la session principale en même temps.

Cependant, le mode et l'emplacement des données du navigateur peuvent être configurés depuis les propriétés de l'activité Ouvrir le navigateur.

La définition de la propriété UserDataFolderMode sur Automatic permet au navigateur d'utiliser des dossiers de données utilisateur séparés dans les sessions principale et PiP.

Notez que si vous effacez les données utilisateur du dossier %LocalAppData%\UiPath\PIP Browser Profiles dans ce mode, l'extension de navigateur correspondante doit être à nouveau activée.

Si vous devez utiliser des données de la session principale (comme des cookies ou des mots de passe enregistrés), envisagez de définir la propriété UserDataFolderMode sur DefaultFolder. Dans ce cas, la session principale et la session PiP utilisent le même dossier pour les données utilisateur du navigateur.

Remarque : lorsque vous définissez UserDataFolderMode sur DefaultFolder , le navigateur ne fonctionne que dans une session à la fois. Si le navigateur est ouvert dans la session principale, il ne fonctionnera pas dans la session PiP. En effet, le même profil de navigateur ne peut pas être utilisé dans deux sessions simultanées.

Remarque : Target Session et UserDataFolderMode sont des propriétés qui ne peuvent être modifiées que dans Studio. Les projets développés dans StudioX doivent être ouverts dans Studio pour pouvoir modifier ces propriétés.

La définition de la propriété UserDataFolderMode sur CustomFolder vous permet de spécifier différents dossiers de données utilisateur dans les sessions principale et PiP.

La session PiP nécessite une connexion à chaque fois

En fonction de votre environnement, certaines stratégies Windows peuvent amener la session PiP à demander une connexion à chaque démarrage.

Par exemple, si le paramètre suivant est défini sur Disabled, cela va déclencher l'apparition de la fenêtre d'incrustation d'image pour demander les informations d'identification à chaque démarrage :

• Local Group Policy\Computer Configuration\Administrative Templates\System\Credential Delegation\Allow delegating default credentials

Cela se produit également lorsque le code PIN Windows Hello for Business est utilisé. L'authentification par code PIN ne fonctionne que la première fois qu'une session PiP est générée. Après cela, la session PiP ne peut être connectée qu'à l'aide d'un nom d'utilisateur et d'un mot de passe.

Authentification par carte à puce

Si votre environnement nécessite une connexion avec une carte à puce, la stratégie suivante ne doit pas (not) être définie sur Enabled :

• Computer Configuration\Administrative Templates\Windows Components\Remote Desktop Services\Remote Desktop Session Host\Device and Resource Redirection\Do not allow smart card device redirection

Le démarrage du workflow dans la session PiP prend beaucoup de temps

Lorsque vous lancez un processus dans la session PiP pour la première fois, l'exécution réelle prend plus de temps que d'habitude pour se lancer. Cela se produit parce que la session PiP doit démarrer tous ses processus Windows et programmes de démarrage.

Recommandation : lancez une session PiP au démarrage de la machine et gardez-la ouverte toute la journée. Cela utilise moins de ressources que le fait de lancer une nouvelle session PiP pour chaque processus.

La session d'incrustation d'image ne démarre pas

Certaines stratégies Windows peuvent empêcher le démarrage de la session d'incrustation d'image. Pour éviter cela, l'utilisateur qui lance une session d'incrustation d'image doit faire partie des stratégies suivantes :

• Computer Configuration\Windows Settings\Security Settings\Local Policies\User Rights Assignment\Allow Log On Locally
• Computer Configuration\Windows Settings\Security Settings\Local Policies\User Rights Assignment\Access this computer from the network
  • Important : cette stratégie est nécessaire si Device Guard est activé sur la machine robot. Cela signifie que la protection DMA du noyau est activée et que les stratégies de groupe local appliquent Device Guard sur la machine.
    Dans le scénario où Device Garde est activé, mais que Access this computer from the network est désactivé, lorsque vous essayez de lancer une session PiP, l'erreur suivante s'affiche : « ChildSession Disconnected: The system administrator has restricted the types of logon (network or interactive) that you may use. For assistance, contact your system administrator or technical support., Reason: 4871, ExtendedReason exDiscReasonNoInfo »

Remarque : nous enquêtons actuellement pour trouver d'autres stratégies qui peuvent affecter la fonctionnalité PiP.

Le client VPN ne fonctionne pas dans la session PiP

Lorsque des clients VPN sont utilisés conjointement avec la session PiP, des conflits peuvent survenir dans certaines situations. Par exemple, si les clients VPN sont configurés pour démarrer lorsque l'utilisateur se connecte, lorsque la session PiP démarre, une autre instance du client VPN est démarrée. Cela provoque un conflit entre les deux sessions, puisque le client VPN est configuré pour exécuter une seule instance par utilisateur.

Pour résoudre ces scénarios, nous avons compilé une liste des fournisseurs de VPN les plus courants avec leurs particularités, ainsi que des solutions aux problèmes connus qui peuvent survenir.

Cisco Anyconnect

Comportement observé

Lorsque le client Cisco Anyconnect s'exécute sur la machine de l'utilisateur et qu'une session PiP est lancée, un autre client Cisco Anyconnect est démarré dans la session PiP.

Origine

Le serveur VPN Cisco est configuré pour accepter une session par utilisateur à la fois. Lorsque la session PiP démarre, Cisco Anyconnect déconnecte le VPN de la session principale et génère une erreur dans la session PiP.

Cela interrompt la connexion VPN de l'utilisateur, laissant celui-ci incapable d'accéder aux services qui nécessitent une connexion VPN.

Résolution

Ne configurez pas le client VPN pour qu'il démarre automatiquement au démarrage de Windows. Cela empêche le client VPN de démarrer une nouvelle connexion lorsque la session PiP démarre et fait passer le trafic PiP par la session Windows principale.

Zscaler

Comportement observé

Lorsque la session PiP est démarrée, un autre client Zscaler est lancé dans cette session. Cela entraîne la disparition du client Zscaler de la session Windows principale. Tout fonctionne comme prévu jusqu'à ce que l'utilisateur ferme la session PiP. Lorsque la session PiP est fermée, le client Zscaler reste dans un état incertain et l'utilisateur doit se déconnecter et se reconnecter, ou redémarrer la machine pour ouvrir le client Zscaler.

Origine

Zscaler enquête sur ce problème de son côté.

Résolution

Veuillez créer un ticket auprès de l'équipe d'assistance de Zscaler.

Pulse Secure

Comportement observé

Lorsqu'une session PiP est démarrée, l'utilisateur est déconnecté du VPN.

Origine

Le client Pulse Secure ne peut pas gérer deux sessions Windows pour le même utilisateur.

Résolution

Nous vous recommandons d'ouvrir un ticket auprès de l'équipe Pulse Secure.

Palo Alto GlobalProtect

Lorsqu'une session PiP démarre, l'interface graphique affiche l'utilisateur déconnecté du VPN dans les deux sessions. Mais la session PiP est toujours connectée au VPN.

Résolution

Nous vous recommandons d'ouvrir un ticket auprès de l'équipe Palo Alto.

Serveurs PIP et Windows

Dans le cas où plusieurs utilisateurs sont connectés en même temps à un serveur Windows, une seule session PIP peut être lancée sur la machine. Cela signifie qu'une seule session PiP peut être ouverte sur une seule machine, quel que soit l'utilisateur ou le type de session utilisé pour ouvrir la session PiP.

PIP et autres environnements virtualisés

Sur d'autres environnements virtualisés tels que AppV ou Citrix XenApps, la fonctionnalité PIP n'est pas disponible.