Use Application/Browser

UiPath.UIAutomationNext.Activities.NApplicationCard

Description

Ouvre une application de bureau ou une page de navigateur Web à utiliser dans UI Automation.

Attention :

Les URL internes ne peuvent pas être ouvertes à l’aide de cette activité lorsque le navigateur ne les accepte pas directement comme arguments de ligne de commande.

Vous ne pouvez pas ouvrir de pages internes Chrome (chrome://) ou Edge (edge://). Cependant, vous pouvez ouvrir des pages internes Firefox (about:).

Après avoir fait glisser et déposé l’activité dans le workflow et indiqué l’application ou la page Web à utiliser, ajoutez les activités à effectuer dans l’activité Use Application/Browser . Si l'application n'est pas déjà ouverte, elle s'ouvre lorsque le projet est exécuté.

Cette activité est compatible avec le référentiel d’objets.

Remarque :

• À partir de UI Automation v20.10.x, plusieurs activités Use Application/Browser peuvent être imbriquées les unes dans les autres. Cela vous permet d'automatiser plusieurs applications simultanément.
• À partir de la version v21.10.3d'UI Automation , l'activité Utiliser l'application/le navigateur (Use Application/Browser) peut ouvrir des applications dans des environnements distants.
• À partir de UI Automation v22.10.1, l'activité peut également ouvrir des navigateurs dans des environnements distants.

Compatibilité du projet

Windows - Héritage | Windows | Multiplateforme

Windows - Héritage, configuration Windows

Module Designer

• Sélectionnez Indiquer l’application (Indicate Application) pour identifier l’application en déplaçant la souris sur sa fenêtre et en la sélectionnant. Si la cible est une page Web de navigateur, accédez à la page avant d’indiquer l’application.
• Après avoir indiqué la cible, gérez-la en sélectionnant le bouton des options de menu et en choisissant l’une des options suivantes :
  • Indiquer la cible à l'écran : indiquez à nouveau l'application.
  • Mettre en surbrillance la cible : affichez l'application indiquée sur votre écran, entourée d'un cadre.
  • Afficher la capture d'écran informative : affichez une capture d'écran de l'application ou de la page Web cible.
  • Supprimer la capture d'écran d'information (Remove informative screenshot ) - Supprime la capture d'écran de l'application cible ou de la page Web.
  • Moteur OCR (OCR Engine) : sélectionnez l'une des deux options suivantes :
    • Moteur OCR intégré (Embedded OCR Engine) : utilisez le moteur OCR intégré dans le modèle Computer Vision AI, à savoir UiPath Screen OCR.
    • Moteur OCR personnalisé (Custom OCR Engine) : utilisez un moteur OCR personnalisé. Lorsque cette option est sélectionnée, un panneau est ajouté à la carte d'activité, où vous pouvez déposer une activité de moteur OCR autre que UiPath Screen OCR.
  • Ajouter au référentiel d’objets (Add to Object Repository ) : ajoutez l’élément d’IU actuel à un projet de bibliothèque, à partir duquel il pourra être réutilisé tout au long de votre processus d’automatisation.

• Vous pouvez lancer une nouvelle instance de l'application ou une nouvelle session de navigateur, en conservant les paramètres de configuration actuels, en utilisant le bouton à côté du Chemin d'accès à l'application (Application Path) (dans le cas d'une application) ou l'URL du navigateur (Browser URL) (dans le cas d'un navigateur). Si vous ouvrez un navigateur via ce bouton, toutes les configurations effectuées dans la section de propriété Options - Navigateur (Options - Browser) sont appliquées, permettant ainsi de tester le comportement de l'activité durant la phase de conception, en atténuant les éventuels échecs au moment de l'exécution.

• Configurez les paramètres de lancement de l'application :
  • Si l'application est un navigateur Web, vous pouvez cliquer sur Plus à droite du champ URL du navigateur (Browser URL), puis utiliser l'une des options du menu pour modifier l'URL de la page Web à ouvrir.
  • Si l'application n'est pas un navigateur Web, vous pouvez :
    • Spécifier les paramètres à transmettre à l'application cible au démarrage à partir du champ Arguments de l'application (Application arguments). Par exemple, si l'application cible est Acrobat Reader, vous pouvez ouvrir un fichier PDF spécifique en fournissant le chemin complet au fichier. Pour ouvrir le fichier C:\Sample.pdf, sélectionnez Plus > Texte (Text), puis saisissez C:\Sample.pdf dans le générateur de textes. Certains types d'applications sont automatiquement identifiés et remplissent automatiquement la propriété Arguments, comme les applications Java, les applications Office Suite, Adobe Acrobat ou l'Explorateur de fichiers Windows.
    • Sélectionnez Plus à droite du champ Chemin d'accès à l'application (Application path), puis utilisez l'une des options du menu pour modifier le chemin complet du fichier exécutable à ouvrir. Pour les applications installées en mode utilisateur, l'automatisation n'enregistre pas le chemin réel qui inclut le nom d'utilisateur ; un chemin relatif est utilisé et affiché dans le champ en tant que User Folder.
      Remarque : lorsque le chemin d'accès défini dans le champ Chemin d'accès à l'application (Application path) est dynamique, la sélection de l'option Indiquer la cible à l'écran (Indicate target on screen) dans les activités enfants génère une erreur si l'application cible n'est pas déjà ouverte.
    • Cochez ou décochez la case Correspondance exacte avec le titre (Match exact title). Cette option s'affiche uniquement lorsque vous indiquez la fenêtre entière d'une application et pas seulement un élément dans l'application. En outre, elle ne s'affiche pas lorsque vous indiquez un navigateur Web. Lorsque cette option est cochée, seules les applications qui correspondent exactement au titre de l'application actuelle sont utilisées dans l'automatisation. Lorsqu'elle n'est pas cochée (par défaut), la fenêtre avec le titre qui correspond le mieux est utilisée dans l'automatisation.

Panneau propriétés

Commun

• Continuer en cas d'erreur (Continue on error ) : spécifie si l'automatisation doit se poursuivre même lorsque l'activité génère une erreur. Ce champ prend uniquement en charge les valeurs Boolean (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu'une erreur est générée, l'exécution du projet s'arrête. Si le champ indique au contraire True, l'exécution du projet se poursuit même en cas d'erreur.

• NomComplet : le nom affiché pour l'activité dans le panneau Concepteur. Un nom d'affichage est automatiquement généré lorsque vous indiquez une cible.

  Important :

  Le nom complet de l’activité Utiliser l’application/le navigateur (Use Application/Browser) est également utilisé comme référence qui pointe vers l’application ou le navigateur ciblé. Après avoir indiqué la cible, à moins qu'il ne soit défini manuellement, le nom d'affichage est automatiquement remplacé par le format suivant :

  • Applications : Use Application: [title] - [app name]
  • Pour les navigateurs : Use Browser [browser type] : [title]

  Dans le cas des cartes d'application imbriquées, chaque activité à l'intérieur d'une carte affiche un menu déroulant dans son corps qui vous permet de choisir la carte d'application avec laquelle vous souhaitez l'utiliser.

• Délai d'attente : spécifiez la durée (en secondes) d'attente de l'exécution de l'activité avant de générer une erreur. La valeur par défaut est 30 secondes.

  Remarque : lorsque vous indiquez une fenêtre dans un environnement Bureau à distance, le paramètre de délai d'expiration par défaut est défini sur 60 secondes.

Entrée

• Application cible unifiée : développez cette catégorie pour configurer les paramètres suivants :

  • Arguments : si l'application n'est pas un navigateur Web, vous pouvez spécifier les paramètres à transmettre à l'application cible au démarrage. Vous pouvez utiliser cette propriété pour ouvrir un fichier spécifique avec l'application. Par exemple, si l'application cible est Acrobat Reader, vous pouvez ouvrir un classeur spécifique en fournissant le chemin d'accès complet au fichier. Pour ouvrir le fichier C:\Sample.pdf, entrez "C:\Sample.pdf". Certains types d'applications sont automatiquement identifiés et remplissent automatiquement la propriété Arguments, comme les applications Java, les applications de la suite Office, Adobe Acrobat ou l'explorateur de fichiers Windows.

  • Chemin d'accès au fichier (File path ) : si l'application n'est pas un navigateur Web, spécifie le chemin complet du fichier exécutable à ouvrir. Si un chemin de fichier est spécifié, la propriété URL est effacée.

    Remarque : lorsque le chemin d'accès défini dans le champ Chemin d'accès au fichier ( File path) est dynamique, le fait de sélectionner Indiquer la cible à l'écran (Indicate target on screen) dans les activités enfants génère une erreur si l'application cible n'est pas déjà ouverte.
  • Sélecteur - Fragment XML qui stocke les attributs d'un élément d'interface utilisateur.
  • URL : si l'application est un navigateur Web, spécifie l'URL de la page Web à ouvrir. Si une URL est spécifiée, la propriété Chemin d'accès au fichier est effacée.

Élément d’entrée/de sortie

• Élément d'entrée : l'élément cible que vous souhaitez utiliser avec cette application, stocké dans un objet UIElement . Cet objet peut être récupéré à partir de la propriété Élément de sortie ( Output Element ) d'une autre activité UI Automation. Vous pouvez utiliser ce champ de propriété pour transmettre l'élément cible d'une activité précédente à celle-ci sans avoir à l'indiquer à nouveau. Ce champ ne prend en charge que les variables UIElement .
• Élément de sortie (Output Element ) - Génère l'élément cible indiqué dans cette activité dans une variable UIElement qui peut ensuite être réutilisée dans d'autres activités. Ce champ ne prend en charge que UIElement variables.

Divers

• Privé (Private) : si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose). Ce champ prend uniquement en charge les valeurs Boolean (True, False). La valeur par défaut est False.

Options

• Fermer (Close) : sélectionnez quand fermer l'application cible une fois que l'automatisation a exécuté toutes les activités ajoutées à l'intérieur de cette activité :
  • Jamais (Jamais) : ne ferme jamais l'application.
  • Si ouvert par l’application/le navigateur : fermer uniquement si l’application a été ouverte par l’automatisation. Il s’agit de la valeur par défaut.
  • Toujours : ferme l'application à chaque fois.

• Mode d'entrée (Input mode ) : sélectionnez la méthode que le Robot doit utiliser pour interagir avec l'application cible :

  • Événements matériels (Hardware Events ) : utilise le pilote matériel pour effectuer l'action. C'est la méthode la plus lente, elle ne peut pas fonctionner en arrière-plan, mais elle est compatible avec toutes les applications de bureau.

  • Simuler : simule à l'aide des API d'accessibilité. Recommandé pour les navigateurs, les applications basées sur Java, SAP. Généralement plus fiable que les événements matériels. Envoie tout le texte dans une seule Actions. Fonctionne même si l’application cible n’est pas au point. Veuillez tester si l’élément d’IU de votre application cible prend cela en charge.

  • ChromiumAPI - Effectue des actions grâce aux API de débogage. Fonctionne uniquement avec les éléments Chromium. Envoie tout le texte en une seule fois. Fonctionne même si l'application cible nest pas au point. Pour plus de détails, consultez cette page.

  • Messages de fenêtre : simulez l'utilisation de messages Win32. Recommandé pour les applications de bureau. Généralement plus fiable que les événements matériels. Envoie tout le texte dans une seule Actions. Fonctionne même si l’application cible n’est pas au point. Veuillez tester si l’élément d’IU de votre application cible prend cela en charge.

  • Arrière-plan (Background) : exécute des actions en arrière-plan. Essaie d'utiliser « Simuler » (Simulate) ou l'API Chromium dans la mesure du possible, tandis que les activités complexes (image, texte natif) s'exécuteront comme d'habitude au premier plan. Il est fortement recommandé d'utiliser cette méthode avec la fonctionnalité Vérifier l'exécution (Verify execution).

    Remarque : l'utilisation du mode de saisie en arrière -plan n'est pas prise en charge avec les applications de la plate-forme Windows universelle, ce qui signifie que les applications de ce type ne peuvent pas être automatisées en arrière-plan.
• Ouvrir (Open) : sélectionnez quand ouvrir l’application cible pour l’exécution de l’automatisation :
  • Jamais : n'ouvre jamais l'application.
  • Si non ouvert : s’ouvre uniquement si l’application est fermée. Il s’agit de la valeur par défaut. Fonctionne uniquement si les champs Chemin d’accès au fichier ou URL ont été renseignés.
  • Toujours : ouvre une autre instance de l'application, même si elle est déjà ouverte. Fonctionne uniquement si les champs Chemin d'accès au fichier ( File Path) ou URL (URL) sont renseignés.

• Redimensionner la fenêtre (Resize window ) - Définit si l'application/le navigateur est redimensionné lors de l'initialisation.

  • Aucun – Aucun redimensionnement n’est appliqué à l’application/au navigateur.
  • Agrandir – L’application/le navigateur est agrandi(e) lors de son lancement.
  • Restaurer à la taille actuelle – L'application/le navigateur est redimensionné(e) et déplacé à la position et à la taille qu'il/elle avait au moment indiqué (dans la mesure du possible).
  • Réduire – L’application/le navigateur est réduit(e) lors de son lancement.
• Window attach mode (Mode d'attachement de fenêtre) - Définit où les activités internes recherchent leurs éléments cibles.
  • Instance d'application : les activités internes effectueront une recherche dans l’instance d’application indiquée, y compris dans toutes les fenêtres parents et enfants (alertes, fenêtres contextuelles, etc.). Les autres instances de l’application sont exclues.
  • Fenêtre unique (Single window ) : les activités internes ne recherchent que dans la fenêtre indiquée.

Options - Navigateur

• Fenêtre incognito/privée : si cette option est sélectionnée, ouvre la nouvelle session de navigateur en mode incognito/privé. Par défaut, cette case est décochée.

• Mode de dossier des données utilisateur : le Mode de dossier des données utilisateur que vous souhaitez utiliser. Cette option est utilisée pour démarrer le navigateur avec un dossier de données utilisateur spécifique.

  • Automatique : déclenche automatiquement le mode Incrustation d’image (PiP) avec un dossier de données utilisateur distinct de celui par défaut. Si le Chemin du dossier de données utilisateur n’est pas défini, un dossier est automatiquement généré. Cela peut être utile lorsque vous recherchez l’isolation du navigateur pendant les tâches d’automatisation et que vous séparez les données de la session de navigation principale.
  • DefaultFolder : utilise le dossier du navigateur par défaut, peu importe qu’il soit exécuté dans la session principale ou dans la session PIP. Cette option est utile si vous souhaitez que le robot utilise le dossier de données utilisateur existant et que vous n’avez pas besoin d’une session séparée ou isolée pour les tâches d’automatisation.
  • CustomFolder : utilise le dossier spécifié dans Chemin du dossier de données utilisateur. Si le chemin du dossier de données utilisateur n’est pas défini, un chemin généré automatiquement est utilisé. Cette option vous donne plus de flexibilité et de contrôle pour gérer vos dossiers pour différentes tâches d’automatisation en définissant un chemin personnalisé pour le dossier de données utilisateur.

  La configuration du dossier de données utilisateur du navigateur n’est disponible que pour Chrome, Edge Chromium et Firefox.

• Chemin du dossier des données utilisateur : le dossier de données utilisateur utilisé par le navigateur. La valeur par défaut est %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType si elle n'est pas définie.

  Vous trouverez plus de détails sur le mode de dossier de données utilisateur (User Data Folder Mode ) et le chemin d’accès au dossier de données utilisateur (User Data Folder Path) ici.

• WebDriver mode : indique comment WebDriver doit être utilisé lors de l'ouverture d'une nouvelle session de navigateur. Les options suivantes sont disponibles :

  • Désactivé (Disabled ) : désactive l'utilisation de WebDriver.
  • AvecGUI : l'interface graphique du navigateur s'affiche.
  • Sans interface graphique : le navigateur est lancé en mode silencieux, sans interface graphique.

  Vous trouverez plus de détails sur WebDriver ici.

Configuration multiplateforme

Le nom de l’activité dans les projets multiplate-forme est Utiliser un navigateur (Use Browser) et est utilisable pour automatiser uniquement les fenêtres du navigateur Chrome et les applications Java.

Pour automatiser les applications Java, vous devez définir sur Vrai (True) le paramètre de projet Activer l’automatisation Java (aperçu) (Enable Java automation (preview)) (Paramètres du projet (Project Settings) > UI Automation > Générique (Generic).

• Sélectionnez Indiquer la cible à l'écran (Indicate target on screen) pour identifier l'application en déplaçant la souris sur sa fenêtre et en la sélectionnant. Si la cible est une page Web de navigateur, accédez à la page avant d'indiquer l'application.
• Après avoir indiqué la cible, gérez-la en sélectionnant le bouton des options de menu et en choisissant l’une des options suivantes :
  • Indiquer la cible à l’écran (Indicate target on screen) : indiquez à nouveau l’application. Si le descripteur est défini dans le référentiel d’objets, vous devez le dissocier du référentiel d’objets si vous souhaitez indiquer un descripteur uniquement pour l’activité actuelle.
  • Afficher dans le référentiel d’objets (Show in Object Repository) : ouvre le panneau Référentiel d’objets (Object Repository) avec le descripteur sélectionné.
  • Dissocier du référentiel d’objets (Unlink from Object Repository) : dissocie le descripteur du référentiel d’objets.
  • Ajouter au référentiel d’objets (Add to Object Repository ) : ajoutez l’élément d’IU actuel à un projet de bibliothèque, à partir duquel il pourra être réutilisé tout au long de votre processus d’automatisation.
• Travaux de l’étendue (Work in scope) : choisissez l’onglet du navigateur affichant l’application Web à automatiser. Si vous avez indiqué une application Java, elle sera répertoriée dans le menu déroulant parmi les onglets du navigateur. L’option est masquée lorsqu’un seul onglet est disponible.
• Générer (Générer) : ouvre l’enregistreur Autopilot UI Automation, dans lequel vous pouvez générer des séquences de workflow UI Automation. Vous pouvez également sélectionner l’icône Générez les activités d’UI Automation à l’aide de Autopilot dans le coin supérieur droit de la zone de capture d’écran d’information. Pour plus de détails, consultez la page Enregistreur Autopilot UI Automation.
• URL (URL) - URL de l’application Web. La valeur sera automatiquement renseignée après le choix de l'onglet. Vous pouvez également choisir d ' Ouvrir l'URL (Open URL) dans un nouvel onglet en accédant au menu Plus d'options (More Options). Si l'URL est déjà ouverte, vous pouvez la mettre en évidence ou la rouvrir dans un nouvel onglet.
• Requiert l'authentification ? - Active l'authentification multifacteur. Pour plus de détails, consultez la page Connexion de navigateur avec UI Automation .

Options supplémentaires

Horaires

• Délai d'attente : spécifiez la durée (en secondes) d'attente de l'exécution de l'activité avant de générer une erreur. La valeur par défaut est 30 secondes.

• Continuer en cas d'erreur (Continue on error ) : spécifie si l'automatisation doit se poursuivre même lorsque l'activité génère une erreur. Ce champ prend uniquement en charge les valeurs Boolean (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu'une erreur est générée, l'exécution du projet s'arrête. Si le champ indique au contraire True, l'exécution du projet se poursuit même en cas d'erreur.

Options

• Ouvrir (Open) : définit s'il faut ouvrir l'application cible avant d'exécuter les activités à l'intérieur.
  • Toujours : ouvre la fenêtre du navigateur à chaque fois.
  • Si non ouvert (If not open) : ouvre une nouvelle fenêtre de navigateur si aucune ne correspond au sélecteur et à l'URL. Il s'agit de la valeur par défaut.
  • Jamais : n'ouvre jamais la fenêtre du navigateur.
• Fermer (Close) : définit s'il faut fermer l'application cible avant d'exécuter les activités à l'intérieur.
  • Toujours : ferme la fenêtre du navigateur à chaque fois.
  • Si ouvert par Utiliser le navigateur (Use Browser ) : se ferme uniquement si la fenêtre du navigateur a été ouverte par l'activité Utiliser le navigateur ( Use Browser ). Il s'agit de la valeur par défaut.
  • Jamais : ne ferme jamais la fenêtre du navigateur.
• Mode de saisie (Input mode ) : la méthode utilisée pour générer la saisie au clavier et à la souris.
  • ChromiumAPI - Effectue des actions grâce aux API Debugger. Fonctionne uniquement avec les éléments Chromium. Envoie tout le texte en une seule fois. Fonctionne même si l’application cible n’est pas au point.
  • Simuler : simule les Actions à l'aide des API d'accessibilité. Fonctionne avec les navigateurs. Envoie tout le texte dans une seule Actions. Fonctionne en arrière-plan (même si l'application cible n'est pas au point).
• Fenêtre Incognito/privée : si cette option est sélectionnée, ouvre la nouvelle session du navigateur en mode incognito/privé. Ce champ prend uniquement en charge les valeurs booléennes (True, False). La valeur par défaut est False.

• ModeDossierDonnéesUtilisateur : le ModeDossierDonnéesUtilisateur que vous souhaitez définir. Cette option est utilisée pour démarrer le navigateur avec un dossier de données utilisateur spécifique.

  • Automatique : déclenche automatiquement le mode Incrustation d’image (PiP) avec un dossier de données utilisateur distinct de celui par défaut. Si le Chemin du dossier de données utilisateur n’est pas défini, un dossier est automatiquement généré. Cela peut être utile lorsque vous recherchez l’isolation du navigateur pendant les tâches d’automatisation et que vous séparez les données de la session de navigation principale.
  • Dossier par défaut : utilise le dossier du navigateur par défaut, peu importe qu’il soit exécuté dans la session principale ou dans la session PIP. Cette option est utile si vous souhaitez que le robot utilise le dossier de données utilisateur existant et que vous n’avez pas besoin d’une session séparée ou isolée pour les tâches d’automatisation.
  • Dossier personnalisé : utilise le dossier spécifié dans Chemin du dossier de données utilisateur. Si le chemin du dossier de données utilisateur n’est pas défini, un chemin généré automatiquement est utilisé. Cette option vous donne plus de flexibilité et de contrôle pour gérer vos dossiers pour différentes tâches d’automatisation en définissant un chemin personnalisé pour le dossier de données utilisateur.

  La configuration du dossier de données utilisateur du navigateur n’est disponible que pour Chrome, Edge Chromium et Firefox.

• Chemin du dossier des données utilisateur : le dossier de données utilisateur utilisé par le navigateur. La valeur par défaut est %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType si elle n'est pas définie.

Cible

• Correspondance exacte avec le titre (Match exact title) : disponible uniquement pour les applications de bureau. Lorsque ce champ est activé, seules les applications qui correspondent exactement au titre actuel sont utilisées dans l’automatisation. Lorsqu’il est désactivé, la fenêtre dont le titre correspond le mieux est utilisée dans l’automatisation. La valeur par défaut est Désactivé (Off).
• Sélecteur (Selector ) - Liste des attributs utilisés pour rechercher une fenêtre de navigateur particulière.
• Arguments (Arguments) - Paramètres à transmettre à l'application cible au démarrage.

Entrée/sortie

• Élément d'entrée (Input element ) : l'élément de l'interface utilisateur sur lequel l'activité est exécutée, stocké dans un objet UIElement . Ce champ ne prend en charge que les objets UIElement . Cet objet peut être obtenu à partir du champ de propriété Élément de sortie ( Output Element ) d’autres activités UI Automation.
• Élément de sortie (Output element ) : génère un élément d'IU cible et le stocke dans un objet UIElement , qui peut ensuite être utilisé pour cibler le même élément avec d'autres activités.