Texte existant (Text Exists)

UiPath.Core.Activities.TextExists

Vérifie si un texte est trouvé dans un élément de l'interface utilisateur donné.

Remarque : L'activité ne fonctionne pas correctement lorsqu'elle est utilisée dans des navigateurs nécessitant l'automatisation des extensions, tels que Chrome, Firefox et Edge.

Propriétés

Entrée

• Texte (Text) - Chaîne que vous recherchez.

  Remarque : toutes les chaînes doivent être mises entre guillemets.
• Occurrence (Occurrence) - Si la chaîne du champ Texte (Text) apparaît plusieurs fois dans l'élément de l'interface utilisateur indiqué, spécifier ici le nombre d'occurrences que vous souhaitez trouver. Par exemple si la chaîne apparaît 4 fois et que vous voulez cliquer sur la première occurrence, écrivez 1 dans ce champ. La valeur par défaut est 1.

Options

• Texte formaté (FormattedText) - Si cette case est cochée, la mise en page de l'écran du texte capturé est préservée.

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).
• 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.
• Zone de détourage de cible (Target.ClippingRegion) - Définit le rectangle de découpage par rapport à l'élément UiElement.

Sortie

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

Commun

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