Sur disparition de l'image (On Image Vanish)

UiPath.Core.Activities.OnImageVanish

Conteneur qui attend la disparition d'une image et vous permet d'exécuter d'autres activités.

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.

Commun

• NomAffichage (DisplayName) - Nom affiché de l'activité.

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

Options

• Répéter à l'infini (RepeatForever) - Spécifie si l'activité surveille en permanence les événements. Ce champ prend en charge les valeurs booléennes (True, False) uniquement. True -Le bloc s'exécute chaque fois que l'image spécifiée apparaît ; il s'agit de la valeur par défaut. False - L'activité s'exécute une seule fois.

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é Sur disparition de l'image (On Image Vanish)

L’activité Sur disparition de l'image (On Image Vanish) vérifie lorsqu’une image spécifique d’un site Web disparaît. Cette activité est utilisée pour vérifier le flux d'un site Web et peut être utilisée comme déclencheur d'un processus automatisé.

Pour illustrer comment utiliser cette activité, nous avons créé un exemple qui effectue un test de vitesse sur un site Web sélectionné et lui attribue une note de performance spécifique. Le processus automatisé ouvre un navigateur et vérifie le moment où l'image disparaît. Cela indique que le test a commencé. Une deuxième activité Sur disparition de l'image (On Image Vanish) vérifie la fin du test.

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.

   • Créez la variable suivante :

     Nom de variable	Types de variables	Valeur par défaut
     website	Chaîne de caractères (string)

3. Faites glisser une activité Boîte de dialogue (Input Dialog) dans le conteneur Séquence.

   • Dans le panneau Propriétés , ajoutez l'expression "Insert Website URL" dans le champ Libellé .
   • Ajoutez l’expression "Website" dans le champ Titre.
   • Ajoutez la variable website dans le champ Résultat.

4. Faites glisser une activité Ouvrir le navigateur (Open Browser) sous l’activité Boîte de dialogue (Input Dialog).

   • Ajoutez l’expression "https://tools.pingdom.com" dans le champ URL.
   • Dans le champ Propriétés, sélectionnez l’option IE dans la liste déroulante TypeNavigateur.
   • Cochez la case de l’option NouvelleSession. Une nouvelle session du navigateur sélectionné se lance.

5. Faites glisser une activité Saisir dans (Type Into) à l’intérieur du conteneur Do de l’activité Ouvrir le navigateur (Open Browser).

   • Dans le panneau Propriétés, sélectionnez l'option Target dans la liste déroulante Cible.
   • Ajoutez l'expression "<webctrl id='urlInput' tag='INPUT' />" dans le champ Sélecteur.
   • Sélectionnez l'option INTERACTIVE dans la liste déroulante AttendrePrêt.
   • Ajoutez la variable website dans le champ Texte.
   • Cochez la case de l’option Activer. Cette option place le navigateur au premier plan et l’active avant que le texte ne soit écrit.

6. Placez une activité Clic (Click) sous l’activité Saisir dans (Type Into).

   • Dans le panneau Propriétés, ajoutez la valeur 1000 dans le champ DélaiAprè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 "<webctrl tag='INPUT' type='submit' />" dans le champ Sélecteur.
   • Sélectionnez l'option INTERACTIVE dans la liste déroulante AttendrePrêt.
   • Sélectionnez l'option CursorPosition dans la liste déroulante PositionCurseur.
   • Sélectionnez l'option Center dans la liste déroulante Position.
   • Sélectionnez l’option None dans la liste déroulante ModificateursClés.

7. Faites glisser une activité Retard (Delay) sous l’activité Clic (Click).

   • Dans le panneau Propriétés, ajoutez la valeur 00:00:02 dans le champ Durée. Cela permet un délai de deux secondes entre les activités.

8. Placez une activité Sur disparition de l'image (On Image Vanish) sous l’activité Retard (Delay).

   • Dans le champ Propriétés, sélectionnez l’option ImageTarget dans la liste déroulante Image.
   • Ajoutez la valeur 0.8 dans le champ Précision.
   • Sélectionnez l’option Basic dans la liste déroulante Profil.
   • Sélectionnez l'option Target dans la liste déroulante Cible.
   • Sélectionnez l'option INTERACTIVE dans la liste déroulante AttendrePrêt.
   • Ajoutez la valeur False dans le champ RépéterPourToujours.

9. Faites glisser une nouvelle activité Sur disparition de l'image (On Image Vanish) à l’intérieur du conteneur Do de l’activité On Image Vanish précédente.

   • Dans le champ Propriétés, sélectionnez l’option ImageTarget dans la liste déroulante Image.
     • Ajoutez la valeur 0.8 dans le champ Précision.
     • Sélectionnez l’option Basic dans la liste déroulante Profil.
     • Sélectionnez l'option Target dans la liste déroulante Cible.
     • Ajoutez l'expression "<webctrl id='speedometer' tag='svg' />" dans le champ Sélecteur.
     • Sélectionnez l'option INTERACTIVE dans la liste déroulante AttendrePrêt.
     • Ajoutez la valeur False dans le champ RépéterPourToujours.

   • Sélectionnez le conteneur Do de la dernière activité Sur disparition de l'image (On Image Vanish) et créez la variable suivante :

     Nom de variable	Types de variables	Valeur par défaut
     grade	Chaîne de caractères (string)

10. Faites glisser une activité Obtenir le texte (Get Text) dans le conteneur Do.

    • Dans le panneau Propriétés, sélectionnez l'option Target dans la liste déroulante Cible.
    • Ajoutez l'expression "<html title='Pingdom Tools' /><webctrl parentname='Performance grade' tag='app-grade-badge' />" dans le champ Sélecteur. Cela récupère la note de performance sur le site Web et stocke sa valeur dans la variable grade.
    • Sélectionnez l'option INTERACTIVE dans la liste déroulante AttendrePrêt.
    • Ajoutez la variable grade dans le champ Valeur (Value).

11. Ajoutez une activité Zone de message (Message Box) sous l’activité Obtenir le texte (Get Text).

    • Dans le panneau Propriétés, sélectionnez l’option Ok dans la liste déroulante Boutons.
    • Ajoutez l'expression "Performance Grade is " + grade dans le champ Texte. Cela affiche la note reçue par le site Web que vous avez fourni.
    • Cochez la case de l’option PlusHaut. La boîte de message se retrouve au premier plan.

12. Exécutez le processus. Le robot vous demande de saisir une adresse de site Web, ouvre un nouveau navigateur, accède au site Web www.pingdom.com, vérifie les performances de l'adresse que vous avez ajoutée et renvoie une zone de message avec la note de performance.

Téléchargez l'exemple