Incrustation d’image

La fonctionnalité Incrustation d’image (Picture-in-Picture) permet d'exécuter des processus Attended en collaboration avec le Robot. Les processus démarrés en mode Incrustation d’image (Picture-in-Picture) s'exécutent dans une session Windows isolée, vous permettant ainsi d'utiliser la machine pendant l’exécution du processus.

Vous pouvez démarrer un processus en mode Incrustation d'image, soit depuis l’onglet Débogage dans Studio, depuis StudioX, soit directement depuis l’Assistant UiPath à partir du menu contextuel d’un processus.

Remarque :

Le délai d'expiration par défaut pour démarrer un processus dans une session PiP est de 180 secondes. Si la connexion dans la session Incrustation d’image (Picture-in-Picture) dépasse ce délai, une erreur de délai d'expiration est renvoyée. Ce délai d'expiration par défaut peut être modifié à l'aide de la variable d'environnement UIPATH_PIP_SESSION_TIMEOUT sur la machine.

Lorsque vous utilisez le Robot en mode service, assurez-vous de définir la variable UIPATH_PIP_SESSION_TIMEOUT comme variable d'environnement système, puis redémarrez le service de Robot.

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

Remarque : les droits d'administrateur sont nécessaires pour activer la fonctionnalité Picture-in-Picture sur la machine. Cela n'est nécessaire que la première fois que Picture-in-Picture est utilisé, par la suite, le processus réel peut être démarré dans Picture-in-Picture sans privilèges élevés.

Contrôles

Les commandes suivantes sont disponibles pour la fenêtre PiP :

• - Activez cette option pour prendre le contrôle de la session PiP. Lorsqu'elle est désactivée, votre souris et votre clavier ne fonctionnent que dans la session principale.
• - Activez cette option pour garder la fenêtre PiP au-dessus des autres applications même lorsqu'elle est hors champ.
• Réduire : réduit la fenêtre PiP à la barre des tâches de session principale sans interrompre le processus.
• Agrandir : agrandit la fenêtre PiP.

• Fermer : ferme la fenêtre PiP, arrête tout processus en cours d’exécution et déconnecte la session PiP.

  
  

  

  
  

Lorsque vous démarrez pour la première fois une session Incrustation image, une invite vous demande vos informations d'identification Windows. Veuillez noter que si vous redémarrez la machine, vous ne serez pas invité à fournir à nouveau les informations d'identification.

Marquer un processus comme prêt pour l'incrustation d'image

Dans la section Paramètres du projet (Project Settings) dans Studio, un processus peut être marqué comme Prêt pour l’incrustation d’image (PiP Ready), ce qui signifie qu'il a été testé et peut être exécuté en toute sécurité dans une session Incrustation d’image. Vous pouvez également définir un processus pour qu'il démarre par défaut dans une session Incrustation d’image (Picture-in-Picture).

Utilisation de PiP pour les activités d'appel

Les activités d'appel telles que Invoque le processus, Invoquer le flux de travail et Exécuter le processus parallèle permettent de choisir où démarrer le nouveau processus.

Cela peut être défini depuis l'onglet Propriétés de l'activité dans Divers > Session cible dans Studio.

Remarque : la propriété Target Session peut uniquement être modifiée depuis Studio. Les projets développés dans StudioX doivent être ouverts dans Studio pour pouvoir modifier ces propriétés.

Les options sont les suivantes :

• Actuel : le processus enfant s'ouvre dans la même session que le processus parent
• Processus par défaut : le processus enfant utilise les paramètres de processus
• Principal : le processus enfant démarre dans la session principale quel que soit l'endroit où le processus parent s'exécute

• Incrustation d’image (Picture-in-Picture) : le processus enfant démarre dans la session Incrustation d’image (Picture-in-Picture), quel que soit l’endroit où le processus parent s’exécute

  
  

  

  
  

Activation de l'incrustation d'image

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 Picture in picture.
• Lorsque la session d'incrustation d'image est ouverte, les programmes de démarrage s'ouvrent également dans la session PiP. Pour cette raison, certains paramètres des périphériques peuvent être réinitialisés à leurs valeurs par défaut (tels que les paramètres d'éclairage du clavier et de la souris).
• Si vous activez la session Bureau à distance lorsque l'invite apparaît lors de l'exécution d'un processus PiP, vous devez vous déconnecter et vous reconnecter à la session Windows principale pour que les modifications prennent effet.
• La machine ne peut pas être redémarrée ou arrêtée pendant que la session PiP est ouverte, car la session enfant doit être fermée au préalable.
• En raison des limitations du système d’exploitation relatives à l’exécution de la fonctionnalité d’Incrustation d'image, les éditions Famille de Windows 8 et 10 ne sont pas prises en charge.
• Le presse-papiers est partagé entre la session PiP et la session principale.
• L'exécution en tant qu'administrateur ne peut pas être utilisée dans la session PiP.
• Une seule session d'Incrustation d'image peut être démarrée à la fois.
• Pour qu'un utilisateur démarre une session PiP, il doit disposer des autorisations 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é InvokeIsolatedWorkflow pour invoquer la partie de l’automatisation à l’aide de Microsoft Office et définissez sa session cible sur Picture-in-Picture à partir de Studio.
  Remarque : Microsoft Outlook n'est pas concerné par la limitation décrite ci-dessus.

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.

Remarque : il est nécessaire de procéder à une installation par machine de l'extension de navigateur pour que cette dernière puisse fonctionner par défaut dans les navigateurs d'incrustation d'image. Dans le cas contraire, il vous faudra l'installer dans la session d'incrustation d'image.

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
  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.

Cause 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.

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.

Cause Nous enquêtons actuellement sur ce comportement avec Zscaler pour en trouver la cause. Solution Nous étudions actuellement ce comportement avec Zscaler pour trouver une solution.

Pulse Secure

Comportement observé

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

Cause Le client Pulse Secure ne peut pas gérer deux sessions Windows pour le même utilisateur. 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.

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.