For Each UiElement

UiPath.UIAutomationNext.Activities.NForEachUiElement

Description

Parcourt une liste d’éléments d’IU et exécute une ou plusieurs Actions sur chacun d’eux.

Cette activité ne peut pas être ajoutée dans une activité Use Application/Browser.

Pour utiliser cette activité en dehors d’une activité Utiliser l'application/le navigateur (Use Application/Browser), vous devez fournir un élément d’entrée.

Cette activité est compatible avec le référentiel d’objets.

Compatibilité du projet

Windows - Héritage | Fenêtres

Windows - Héritage, configuration Windows

Module Designer

• Cliquez sur Indiquer dans l'application/le navigateur (Indicate in App/Browser) pour indiquer l'élément d'IU à utiliser comme cible à l'aide de l'assistant Pour chaque élément d'IU (For Each UI element). Vous pouvez en savoir plus sur l'utilisation de cette activité et de son assistant ici.

  Après avoir indiqué la cible, sélectionnez le menu pour accéder aux options suivantes :

  • Modifier la configuration (Edit configuration ) : ouvre l'assistant Pour chaque élément d'IU (For Each UI element) pour configurer la cible.
  • Configurer une nouvelle cible (Configure new target ) : indiquez à nouveau la cible.
  • Supprimer la capture d'écran d'information (Remove informative screenshot ) - Supprime la capture d'écran de l'application cible ou de la page Web.
  • Ajouter au référentiel d’objets (Add to Object Repository ) : ajoutez l’élément d’IU actuel à un projet de bibliothèque, à partir duquel il pourra être réutilisé tout au long de votre processus d’automatisation.

  Pour filtrer les éléments que vous avez extraits avec votre sélection, sélectionnez Configurer le filtre.

Panneau propriétés

Commun

• Continuer en cas d'erreur (Continue on error ) : 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 Boolean (True, 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.

• Délai après : délai (en secondes) entre le moment où cette activité est terminée et le moment où l'activité suivante commence toutes les opérations. La valeur par défaut est de 0,3 seconde. L'ajout d'un délai entre les activités garantit qu'une activité dispose de suffisamment de temps pour se terminer avant le début de l'activité suivante.

• Délai avant (Delay before) : Délai (en secondes) entre le moment où l'activité précédente est terminée et le moment où cette activité commence à effectuer des opérations. La valeur par défaut est 0,2 seconde. L'ajout d'un délai entre les activités garantit qu'une activité dispose de suffisamment de temps pour se terminer avant le début de l'activité suivante.

• NomComplet : le nom affiché pour l'activité dans le panneau Concepteur. Un nom d'affichage est automatiquement généré lorsque vous indiquez une cible.

• Délai d'attente : spécifiez la durée (en secondes) d'attente de l'exécution de l'activité avant de générer une erreur. La valeur par défaut est 30 secondes.

Entrée

• Cible (Target) - L'élément cible. L’élément cible doit être défini. Avant d'être indiqué à l'écran, ce champ est défini sur (null). Une fois la cible indiquée, toutes les propriétés concernant l'élément qui a été indiqué sont affichées.
  • Type decontrôle CV (CV Control type ) : indique le type de contrôle identifié à l'aide de Computer Vision.
  • Texte CV - Indique le texte identifié à l’aide de Computer Vision.
  • Sélecteur de correspondances approximatives : les paramètres du sélecteur de correspondances approximatives.
  • Texte natif : le texte utilisé pour identifier l'élément d'IU.
  • Sites Web réactifs - Activez la mise en page des sites Web réactifs.
  • Sélecteur strict : le sélecteur strict généré pour l'élément d'IU.
  • Méthodes de ciblage : les types de sélecteurs à utiliser pour identifier l'élément. Cette propriété peut recevoir n'importe quelle combinaison à partir du menu déroulant :
    • Aucun (None)
    • Sélecteur strict
    • Sélecteur de correspondances approximatives
    • Image
    • Texte natif
    • Computer Vision : pour utiliser Computer Vision comme méthode de ciblage, vous devez accéder à Paramètres du projet > Computer Vision et veiller à définir le bon point de terminaison du serveur. Vous pouvez laisser ce champ tel quel et utiliser UiPath Cloud, qui est rempli par défaut, ou bien saisir une autre valeur en sélectionnant l’un des autres points de terminaison publics spécifiques à une région de serveur ou à votre propre serveur local.

      Vous pouvez également utiliser Computer Vision comme méthode de ciblage en définissant Utiliser un serveur local sur True. Cela implique que le package UiPath.ComputerVision.LocalServer soit installé dans votre projet. Lorsque le serveur local est activé, la valeur du serveur est écrasée. Le serveur local n'est cependant pas disponible avec les projets multiplate-forme.

  • Contrôle de visibilité (Visibility check ) - Vérifie si l'élément d'IU est visible ou non. Vous pouvez choisir l’une des trois options suivantes dans le menu déroulant :
    • Aucun : ne vérifie pas la visibilité.
    • Interactif (pour le Sélecteur de correspondances approximatives) : option par défaut. Vérifie si l'élément est potentiellement visible, en ignorant le défilement de la page et les obstructions par d'autres applications, ou le fait que l'application est réduite. Cette vérification est utile lorsque vous essayez de vous assurer que vous ne ciblez pas des éléments invisibles qui existent dans le DOM mais qui sont masqués.
    • Entièrement visible : vérifie si l'élément d'IU est visible ou non.
  • Attendre le chargement de la page : avant d'effectuer les Actions, attendez que l'application soit prête à accepter les entrées. Vous pouvez choisir l’une des trois options suivantes dans le menu déroulant :
    • None : n’attend pas que la cible soit prête.
    • Interactif : attend qu'une partie de l'application soit prête.
    • Complète  : attend que l'application entière soit prête.
  • Sélecteur de fenêtre (Instance d'application) : le sélecteur utilisé pour la fenêtre d'application. Uniquement applicable lorsque le mode d'attachement de fenêtre est défini sur Instance d'application (Application instance).
• Cible (bouton suivant) : le prochain élément d'IU sur lequel vous souhaitez effectuer des Actions . Avant d'indiquer à l'écran la cible que vous souhaitez utiliser, ce champ est défini sur (null). Une fois la cible indiquée, toutes les propriétés concernant l'élément qui a été indiqué sont affichées. À l'exception de Click Offset, les propriétés des enfants de ce champ sont identiques à celles spécifiques à la propriété Cible .
  • Décalage duclic : spécifie un décalage pour l'activité de clic, qui peut être configuré davantage.
    • Point d'ancrage - Décrit le point de départ du curseur auquel les décalages des propriétés Décalage X et Décalage Y sont ajoutés. Les options suivantes sont disponibles : TopLeft, TopRight, BottomLeft, BottomRightet Center. Par défaut, Center est sélectionné.
    • Décalage X - Déplacement horizontal de la position du curseur en fonction de l'option sélectionnée dans le champ Point d'ancrage . Ce champ prend uniquement en charge les variables Int32 .
    • Décalage Y - Déplacement vertical de la position du curseur en fonction de l'option sélectionnée dans le champ Point d'ancrage . Ce champ prend uniquement en charge les variables Int32 .

Élément d’entrée/de sortie

• Élément d'entrée (Input element ) : l'élément de l'interface utilisateur sur lequel l'activité est exécutée, stocké dans un objet UIElement . Ce champ ne prend en charge que les objets UIElement . Cet objet peut être obtenu à partir du champ de propriété Élément de sortie ( Output Element ) d’autres activités UI Automation.
• Élément de sortie (Output element ) : génère un élément d'IU cible et le stocke dans un objet UIElement , qui peut ensuite être utilisé pour cibler le même élément avec d'autres activités.

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). Ce champ prend uniquement en charge les valeurs Boolean (True, False). La valeur par défaut est False.

Options

• Délai entre les pages : le délai (en secondes) à attendre jusqu'à ce que la page suivante soit chargée si les données s'étendent sur plusieurs pages.

• Mode d'entrée (Input mode ) : sélectionnez la méthode que le Robot doit utiliser pour interagir avec l'application cible :

  • Identique à l'application/au navigateur (Identique à l'application/au navigateur ) - Utilisez le même mode d'entrée que l'activité Utiliser l'application/le navigateur .

    Il s'agit de la sélection par défaut.

  • Événements matériels (Hardware Events ) : utilise le pilote matériel pour effectuer l'action. C'est la méthode la plus lente, elle ne peut pas fonctionner en arrière-plan, mais elle est compatible avec toutes les applications de bureau.

    Cette option est sélectionnée par défaut si vous modifiez le paramètre par défaut de l'une des propriétés suivantes : ClickType, MouseButtonou KeyModifiers.

  • Simuler : simule à l'aide des API d'accessibilité. Recommandé pour les navigateurs, les applications basées sur Java, SAP. Généralement plus fiable que les événements matériels. Envoie tout le texte dans une seule Actions. Fonctionne même si l’application cible n’est pas au point. Veuillez tester si l’élément d’IU de votre application cible prend cela en charge.

  • ChromiumAPI - Effectue des actions grâce aux API de débogage. Fonctionne uniquement avec les éléments Chromium. Envoie tout le texte en une seule fois. Fonctionne même si l'application cible nest pas au point. Pour plus de détails, consultez cette page.

  • Messages de fenêtre : simulez l'utilisation de messages Win32. Recommandé pour les applications de bureau. Généralement plus fiable que les événements matériels. Envoie tout le texte dans une seule Actions. Fonctionne même si l’application cible n’est pas au point. Veuillez tester si l’élément d’IU de votre application cible prend cela en charge.

• Limiter l'extraction à : le type de limite que vous souhaitez appliquer lors de l'extraction de données. Les options suivantes sont disponibles :
  • Nombre maximal d'éléments d'IU : spécifie le nombre maximal d'éléments d'IU que vous souhaitez extraire. La valeur par défaut est 1 000.
  • Aucune limite (No limit) : extrait tous les éléments pouvant être trouvés, sans aucune limite.
  • Nombre maximal depages : spécifie le nombre maximal de pages à partir desquelles vous souhaitez extraire des éléments d'IU, lors de l'extraction de données de tables qui s'étendent sur plusieurs pages.
• Nombre d'éléments (Number of items ) : le nombre maximal de résultats que vous souhaitez extraire. Si la valeur est 0, tous les éléments identifiés sont extraits.