Incrustation d’image

La fonction Incrustation d'image vous permet d’exécuter des processus suivis en collaboration avec le Robot. Les processus démarrés en mode Incrustation d'image 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 1 minute. Si la connexion dans la session d'incrustation d'image 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_SESSION_TIMEOUT sur la machine. La valeur maximale de la variable d'environnement UIPATH_SESSION_TIMEOUT est de 180 secondes.

Lorsque vous utilisez le Robot en mode service, assurez-vous de définir la variable UIPATH_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’administration sont nécessaires pour activer la fonctionnalité Incrustation d'image (Picture-in-Picture) sur la machine. Cela n’est nécessaire que la première fois que l’Incrustation d'image (Picture-in-Picture) est utilisée. Par la suite, le processus réel peut être démarré en mode Incrustation d'image (Picture-in-Picture) sans privilèges élevés.

Consultez la section Paramètres de la ligne de commandes ci-dessous pour savoir comment procéder à l'aide d'un programme.

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 de Studio, un processus peut être marqué comme Prêt pour l'incrustation d'image, ce qui signifie qu'il a été testé et peut être exécuté en toute sécurité dans une session PiP. Vous pouvez également définir un processus pour qu'il démarre par défaut dans une session Incrustation d'image.

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 : le processus enfant commence dans la session Incrustation d'image, quel que soit l’endroit où le processus parent s’exécute

  
  

  

  
  

Activation de PiP via la ligne de commande

Les arguments de ligne de commande offrent une option pour activer ou désactiver la fonctionnalité Incrustation d’image sur la machine à l’aide de l’interface de ligne de commande.

Les paramètres sont appliqués sur la machine locale et affectent tous les utilisateurs et sont utilisés pour modifier les installations existantes.

Commande	Description
PiP Remarque : la commande est disponible pour Robot v2020.10.4 et supérieure, pour les versions précédentes, veuillez utiliser childsession au lieu de PiP.	La commande PiP vous permet d’activer la fonctionnalité Incrustation d'image de la machine si les produits UiPath sont déjà installés. Les paramètres suivants peuvent y être indiqués : PiP --enable Active la fonctionnalité Incrustation d'image sur la machine. PiP --disable Désactive la fonctionnalité Incrustation d'image de la machine. Exemple : UiRobot.exe PiP --Enable Vous devez disposer de droits d'administrateur pour exécuter ces commandes.
ENABLE_PIP	La commande ENABLE_PIP vous permet d’activer la fonctionnalité Incrustation d'image 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 Incrustation d'image est ouverte, les programmes de démarrage s'ouvrent également dans la session PiP. Pour cette raison, il est possible que certains paramètres des périphériques soient réinitialisés à leurs valeurs par défaut (comme 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.

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.
• Les automatisations qui dépendent de Microsoft Outlook ne peuvent pas s'exécuter avec succès dans PiP si l’application est déjà ouverte dans la session principale. Pour vous assurer que l’automatisation fonctionne correctement, quittez Microsoft Outlook dans la session principale avant d’exécuter l’automatisation dans PiP.

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. Par conséquent, un seul type de navigateur peut être actif par session PiP, car le même dossier de données utilisateur est utilisé pour tous les types de navigateurs.

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 UserDataFolderMode est réglé sur DefaultFolder, alors le navigateur ne fonctionnera que sur une seule session à la fois. Si le navigateur est ouvert dans la session principale, il ne fonctionnera pas dans la session PiP. La raison est que le même profil de navigateur ne peut pas être utilisé sur deux sessions en même temps.

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.

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.