Rechercher les enfants (Find Children)

Activité Find Children qui récupère une collection d’éléments d’IU enfants en fonction d’une étendue et de critères de filtre spécifiés.

UiPath.Core.Activities.FindChildren

Récupère une collection d'éléments de l'interface utilisateur enfants en fonction d'une étendue spécifiée et de critères de filtre.

Propriétés

Entrée

• Filtre : le filtre est un sélecteur. L’activité recherche tous les enfants ou descendants de l’élément cible correspondant au sélecteur. Par exemple, l’utilisation de <webctrl tag='UL' /> lancerait une recherche d’éléments de liste non ordonnés sur une certaine page Web.

  Remarque :

  Si la condition de filtre que vous utilisez laisse de côté tous les éléments possibles, une liste d'éléments vide est renvoyée.

Options

• Étendue : permet de définir l'étendue des éléments d'IU dans la collection. Les options suivantes sont disponibles :
  • FIND_CHILDREN : la recherche inclut les enfants immédiats de l'élément.
  • FIND_DESCENDANTS : la recherche inclut les descendants de l'élément, y compris les enfants.
  • FIND_TOP_LEVEL : la recherche inclut l'ordre et le nombre d'éléments enfants.
  • FIND_PROCESS : la recherche inclut les types de données des éléments enfants.
  • FIND_THREAD : la recherche inclut les valeurs par défaut et fixes des éléments enfants.

Sortie

• Children - All UI children found according to the filter and scope set. The field supports only IEnumerable<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).
• 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.
• Expiration cible ms (Target.TimeoutMS) - Spécifie le délai d'attente (en millisecondes) avant l'exécution de l'activité au-delà duquel un message d'erreur SelectorNotFoundException est généré . La valeur par défaut est 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 (Desktop applications) - Un message wm_null est envoyé pour vérifier l'existence des balises <wnd>, <ctrl>, <java> ou <uia>. Si elles existent, l'activité est exécutée.
  • Applications Web (Web Applications)
  1. Internet Explorer - The <webctrl> tag is used to check if the Ready state of the HTML document is set to Complete. Additionally, the Busy state has to be set to "False".
  2. Others - The <webctrl> tag is used to check if the Ready state of the HTML document is Complete.
  • 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é.

• ContinuerSurErreur (ContinueOnError) : 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 booléennes (Vrai (True), Faux (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.

  Remarque :

  Si cette activité est incluse dans Tenter de capturer (Try Catch) et que la valeur de la propriété Poursuite sur erreur (ContinueOnError) est True, aucune erreur n'est détectée lors de l'exécution du projet.