Pointer sur l'image (Hover Image)

UiPath.Core.Activities.HoverImage

Recherche une image dans un élément de l'interface utilisateur et pointe dessus.

Propriétés

Entrée

• Image.Image (Image.Image) - Image existante à rechercher. Ce champ prend en charge les variables Image uniquement.
• Précision.Image (Image.Accuracy) - Unité de mesure comprise entre 0 et 1 qui exprime la similarité minimale entre l'image que vous recherchez et celle à trouver. Pratique dans les cas où l'image à trouver est légèrement différente de celle que vous recherchez. La valeur par défaut est 0,8.
• Profil.Image : permet de modifier l'algorithme de détection d'image que vous souhaitez utiliser. L'algorithme Basique est l'algorithme classique, qui a une vitesse moyenne et un coût moyen en ressources. L'algorithme Amélioré peut offrir des résultats plus précis, au détriment de plus de ressources. Par défaut, ce champ est défini sur Basique.
• Sélecteur de cible (Target.Selector) - Propriété de texte utilisée pour trouver un élément donné de l'interface utilisateur lors de l'exécution de l'activité. Il s'agit en fait d'un fragment XML spécifiant les attributs de l'élément d'interface graphique utilisateur que vous recherchez et de certains de ses parents.
• Target.TimeoutMS - Spécifie la durée (en millisecondes) à attendre pour que l'activité s'exécute avant que l'erreur SelectorNotFoundException ne soit renvoyée. La valeur par défaut est de 30 000 millisecondes (30 secondes).

• Attente cible prête (Target.WaitForReady) - Avant d'exécuter les actions, attendez que la cible soit prête. Les options suivantes sont disponibles :

  • None (Aucun) - Attend uniquement la création de l'élément de l'interface utilisateur cible avant d'exécuter l'action. Vous pouvez, par exemple, utiliser cette option si vous souhaitez récupérer uniquement du texte à partir d'une page Web ou cliquer sur un bouton spécifique sans être obligé d'attendre que tous les éléments de l'interface utilisateur soient chargés. Il est à noter que ceci peut avoir des conséquences indésirables si le bouton est basé sur des éléments qui ne sont pas encore chargés, comme par exemple des scripts.

  • Interactif/Terminé - Attend que tous les éléments d'IU de l'application cible soient créés avant d'exécuter l'action.

    Pour évaluer si une application est à l'état Interactif (Interactive) ou Terminé (Complete), les balises suivantes sont vérifiées :

  • Applications de bureau : un message wm_null est envoyé pour vérifier l'existence des balises <wnd>, <ctrl>, <java> ou <uia>. S'ils existent, l'activité est exécutée.
  • Applications Web (Web Applications)
  1. Internet Explorer : la balise <webctrl> est utilisée pour vérifier si l’état Prêt du document HTML est défini sur Terminé. En outre, l'état Occupé doit être défini sur « False ».
  2. Autres : la balise <webctrl> est utilisée pour vérifier si l’état Prêt du document HTML est défini sur Terminé.
  • Applications SAP (SAP applications) : une fois la présence de la balise <wnd> vérifiée, une API SAP spécifique est utilisée pour détecter si la session est occupée ou non.
• Élément cible (Target.Element) - Utiliser la variable UiElement renvoyée par une autre activité. Cette propriété ne peut pas être utilisée avec la propriété Selector. Ce champ prend en charge les variables UiElement uniquement.
• Target.ClippingRegion : définit le rectangle de détourage, en pixels, par rapport à l'objet UiElement, dans les sens suivants : gauche, haut, droite, bas. Elle prend en charge les nombres positifs et négatifs.

Options

• Envoyer des messages (SendWindowMessages) - Si cette option est sélectionnée, le pointage est exécuté en envoyant un message spécifique à l'application cible. Cette méthode d'entrée est rapide et fonctionne en arrière-plan. Par défaut, cette case n'est pas cochée. Si cette case n'est pas cochée, la méthode par défaut exécute le pointage en utilisant le pilote matériel. La méthode par défaut est la plus lente, elle ne peut pas fonctionner en arrière-plan, mais elle est compatible avec toutes les applications de bureau.

• Modificateurs de clés (KeyModifiers) - Vous permet d'ajouter un modificateur de clé. Les options suivantes sont disponibles : Alt, Ctrl, Maj, Win.

  Remarque  ModificateursClés ne peut pas être utilisé avec l’option EnvoyerMessagesFenêtre. Aucune erreur n'est générée lors de l'exécution d'un workflow qui contient une activité avec cette combinaison d'options.
• Position du curseur X (CursorPosition.OffsetX) - Déplacement horizontal de la position du curseur en fonction de l'option sélectionnée dans le champ Position.
• Position du curseur Y (CursorPosition.OffsetY) - Déplacement vertical de la position du curseur en fonction de l'option sélectionnée dans le champ Position.
• Position X du curseur (CursorPosition.Position) - Décrit le point de départ du curseur auquel les décalages des propriétés OffsetX et OffsetY sont ajoutés. Les options suivantes sont disponibles : TopLeft, TopRight, BottomLeft, BottomRight et Center. L'option par défaut est Center.

Commun

• NomAffichage (DisplayName) - Nom affiché de l'activité.
• Retard MS (DelayMS) - Délai (en millisecondes) après l'exécution de l'activité. La durée par défaut est de 300 millisecondes.
• Retard avant (DelayBefore) - Délai (en millisecondes) avant que l'activité ne commence à effectuer des opérations. La durée par défaut est de 200 millisecondes.

• Poursuite sur erreur (ContinueOnError) - Spécifie si l'automatisation doit continuer même si l'activité génère un message d'erreur. Ce champ prend uniquement en charge les valeurs booléennes (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et si une erreur est renvoyée, l'exécution du projet s'interrompt. Si la valeur est configurée sur True, l'exécution du projet continue indépendamment de toute erreur.

  Remarque : si cette activité est incluse dans l'activité Try Catch et que la valeur de la propriété ContinuerSurErreur est « True », aucune erreur ne sera détectée lors de l'exécution du projet.

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

Exemple d’utilisation de l’activité Pointer sur l'image (Hover Image)

L’activité Pointer sur l'image (Hover Image) est utilisée pour rechercher une image à l’intérieur d’un élément d’IU et survoler celle-ci.

Pour illustrer comment utiliser cette activité, nous avons créé un exemple qui ouvre un navigateur, survole une image, initie une action et affiche les résultats associés à cette action.

Voici comment le processus d'automatisation peut être créé :

1. Ouvrez Studio et démarrez un nouveau Processus.
2. Faites glisser une activité Sequence (Sequence) dans le panneau du concepteur de workflow.

3. Placez une activité Ouvrir le navigateur (Open Browser) dans le conteneur Sequence.

   • Dans le champ Propriétés, sélectionnez l’option IE dans la liste déroulante TypeNavigateur.
   • Ajoutez l’expression "https://www.goodreads.com/book/show/7144.Crime_and_Punishment" dans le champ URL.
   • Cochez la case de l’option NouvelleSession. Cette option ouvre une nouvelle session du navigateur sélectionné.

4. Faites glisser une activité Pointer sur l'image (Hover Image) à l’intérieur du conteneur Body de l’activité Ouvrir le navigateur (Open Browser).

   • Ouvrez l'adresse du site Web précédemment ajoutée dans l'activité Ouvrir le navigateur (Open Browser).
   • Sélectionnez le bouton Cliquer pour ouvrir le menu Options dans l’activité Pointer sur l'image (Hover Image) et cliquez sur l’option Saisir à partir de l'écran. Sélectionnez l'image souhaitée.

5. Faites glisser une activité Cliquer sur l'image (Click Image) sous l’activité Pointer sur l'image (Hover Image).

   • Dans le panneau Propriétés, sélectionnez l’option CLICK_SINGLE dans la liste déroulante TypeClic.
   • Sélectionnez l’option BTN_LEFT dans la liste déroulante BoutonSouris.
   • Sélectionnez l’option Target dans la liste déroulante Cible.
   • Ajoutez l'expression "<html title='*' /><webctrl aaname='Other editions' parentid='imagecol' tag='A' />" dans le champ Sélecteur.
   • Sélectionnez l'option INTERACTIVE dans la liste déroulante AttendrePrêt.

6. Exécutez le processus. Le robot ouvre un nouveau navigateur, accède au site Web, survole l'image sélectionnée et clique sur le bouton Autres éditions.

Téléchargez l'exemple