Élément existant (Element Exists)

UiPath.Core.Activities.UiElementExists

Permet de vérifier si un élément de l'interface utilisateur existe, même s'il n'est pas visible.

Propriétés

Commun

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

Entrée

• Target.Target - Identifie l'élément d'IU. Sélectionnez l'une des options suivantes dans la liste déroulante : Cible, Null. L'option par défaut est Cible.
• Target.ClippingRegion : définit le rectangle de détourage, en pixels, par rapport à UiElement, dans les sens suivants : gauche, haut, droite, bas. Elle prend en charge les nombres positifs et négatifs.
• Cible.Élément : cette propriété utilise la variable UiElement renvoyée par une autre activité. Elle ne peut pas être utilisée avec la propriété Sélecteur. Ce champ prend uniquement en charge les variables UiElement.
• 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 de l'interface graphique utilisateur que vous recherchez et de certains de ses parents.
• Expiration cible ms : Indique la durée d'attente (en millisecondes) pour l’exécution d'une activité lorsque l'élément n'existe pas..

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

  • Aucun : attend uniquement la création de l'élément d'IU 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 (Interactive) : attend que l'application cible indique qu'elle est prête, bien que certains actifs puissent toujours être en cours de chargement.

• Terminé - attend le chargement de tous les éléments d'IU dans l'application cible avant l'exécution effective de l'action.

  Remarque :

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

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

Sortie

• Existe (Exists) - Indique si l'élément existe ou non. Ce champ prend en charge les variables booléennes uniquement.

Exemple d’utilisation de l’activité élément OCR existant (OCR Text Exists)

Ici, vous pouvez voir comment l'activité Élément existant est utilisée dans un exemple qui intègre plusieurs activités.