Pointer (Hover)

UiPath.UIAutomationNext.Activities.NHover

Description

Déplace la souris sur un élément d'IU spécifié.

Cette activité doit ê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 | Windows | Multiplateforme

Windows and Cross-platform configuration

• Étendue du travail (Work in scope ) - Choisissez l'onglet du navigateur générant le rendu de l'application Web à automatiser.

• Indiquer la cible à l’écran : indiquez l’élément d’IU à utiliser comme cible.

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

  • Indiquer la cible à l'écran : Indiquez à nouveau la cible.
  • Modifier la cible (Edit target ) : ouvre le mode de sélection pour configurer la cible.
• Durée (Duration) - durée (en secondes) pendant laquelle l'élément d'IU est survolé. La durée par défaut est de 1 seconde.
• Verify - Define activity execution verification step.
  • None - Indicates that no verification is performed on the target element.
  • Element appeared - Checks whether the element appears.
  • Element disappeared - Checks whether the element disappears.
  • Element text changed - Checks whether there are any changes in the text of the element.

Panneau propriétés

Entrée/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.

Options

• TypeMouvementCurseur : spécifie le type de mouvement effectué par le curseur de la souris. Deux options sont disponibles :
  • Instantané : le curseur passe à la destination. Il s'agit de l'option par défaut.
  • Lisse : le curseur se déplace par incréments. Le paramètre n'a d'effet que si le mode d'entrée Événements matériels est utilisé.
• 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 .
  • É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.
  • 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.
  • Chromium API - Performs actions using debugger APIs. Works only for Chromium elements. Sends all text in one go. Works even if target app is not in focus. For more details, refer to Chromium API.
  • Window Messages (Windows only) - Simulate using Win32 messages. Recommended for desktop apps. Usually more reliable than Hardware Events. Sends all text in a single action. Works even if target app is not in focus. Please test if your target application UI element supports this.
• Mode Healing Agent : configure le comportement de Healing Agent pour cette activité, en fonction des paramètres de gouvernance ou d'Orchestrator au niveau du processus ou de la tâche.
  • Désactivé : désactive Healing Agent pour cette activité.
  • Inherit job settings : applique les paramètres définis dans Gouvernance ou dans Orchestrator au niveau du processus ou de la tâche.
  • Recommandation uniquement : permet à Healing Agent de fournir des recommandations sur la façon de résoudre les problèmes d'automatisation de l'interface utilisateur lors des tâches en cours d'exécution, mais uniquement si les paramètres de gouvernance ou d'Orchestrator le permettent.
  • Identique à l’application/au navigateur : hérite de la configuration de l’activité parente Use Application/Browser .
• Continue on error - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

Cible

• Expand target properties - Display target and anchor properties. This will hide the other activity properties and display only those related to the target.

• Collapse target properties - Hide target and anchor properties. This will hide target related properties and display the activity properties.

• 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)
  • Strict selector - The strict selector generated for the target UI element.
  • Fuzzy selector - The fuzzy selector parameters.

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

    Another way of using Computer Vision as a targeting method is to set Use Local Server to True. This implies that the UiPath.ComputerVision.LocalServer package is installed in your project. When Local Server is enabled, the server value is over-written. However, the Local Server is not available in cross-platform projects.

    • 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.
    • CV Text occurrence - Indicates a specific occurrence to be used, when multiple matches are found.
    • CV Text accuracy - Indicates the accuracy level for OCR text matching.
  • Semantic selector - Leverages large language models (LLMs) to generate functional, human-like descriptions of UI elements. These descriptions are highly reliable making them adaptable to UI changes and significantly improving automation resilience when traditional selectors fail.
  • Image (Windows only)
    • Image accuracy - Indicates the accuracy level for image matching.
    • Image occurrence - Indicates a specific occurrence to be used, when multiple matches are found.
  • Native text (Windows only)
    • Native text - The text to find to identify the UI element.
    • Native text occurrence - Indicates a specific occurrence to be used, when multiple matches are found.
• Window selector (Application instance) - Selector for the application window. Only applicable when window attach mode is set to application instance.
• Wait for page load - Before performing the action, wait for the application to becaome ready to accept input. The options are:
  • 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.
• Visibility check - When enabled, the activity also checks whether the UI element is visible or not. You can choose one of three options from the drop-down menu:
  • 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.
• Sites Web réactifs - Activez la mise en page des sites Web réactifs.

Target - Clipping region

• 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.
• Offset width - Width of the offset region.
• Offset height - Height of the offset region.

Target - Offset point

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

Horaires

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

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

Configuration Windows - Héritage

• Sélectionnez Indiquer dans l’application/le navigateur pour indiquer l’élément d’IU à utiliser comme cible.

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

  • Indiquer la cible à l'écran : Indiquez à nouveau la cible.
  • Modifier la cible (Edit target ) : ouvre le mode de sélection pour configurer la cible.
  • Ajouter une vérification / Supprimer la vérification : ajoute ou supprime la fonctionnalité Indiquer la cible de vérification à l’écran dans la fiche d’activités. L'option Vérifier l'exécution est activée par défaut.
  • 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.
• Duration - The duration (in seconds) during which the specified UI element is hovered. You can choose a predetermined value from the drop-down menu: 1, 3, 5. The default value is 1 second. Alternatively, you can select the Plus button and use one of the options in the menu to enter the duration.
• Indiquer la cible de vérification à l’écran : indiquez l’élément d’IU à utiliser en tant que cible et qui apparaîtra ou disparaîtra après l’exécution de l’action. Utilisez cette fonctionnalité lorsque vous voulez vous assurer qu’une action spécifique effectuée par l’activité a été exécutée correctement pendant le runtime. Ceci est particulièrement utile dans les processus automatisés, où vous devez confirmer que des éléments d’IU spécifiques apparaissent ou disparaissent à la suite d’une action. Il ajoute une couche de vérification supplémentaire pour s’assurer que le processus s’exécute comme prévu. Ainsi, si votre processus d’automatisation dépend de l’exécution correcte de certaines étapes, vous souhaiterez probablement vérifier l’exécution. Cette fonctionnalité peut être activée à partir des paramètres du projet ou dans le corps de chaque activité, en sélectionnant Ajouter une vérification.

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.

• TypeMouvementCurseur : spécifie le type de mouvement effectué par le curseur de la souris. Deux options sont disponibles :

  • Instantané : le curseur passe à la destination. Il s'agit de l'option par défaut.
  • Lisse : le curseur se déplace par incréments. Le paramètre n'a d'effet que si le mode d'entrée Événements matériels est utilisé.
• 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.
  • 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 .
  • 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.

    • Sélecteur sémantique : exploite des modèles LLM pour générer des descriptions fonctionnelles et humaines des éléments d’IU. Ces descriptions sont très fiables. Elles peuvent donc évoluer en fonction des modifications de l’interface utilisateur et améliorent considérablement la résilience de l’automatisation lorsque les sélecteurs traditionnels échouent.
  • 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).

• Vérifier l'exécution - Au moment de l’exécution, vérifie si l’action effectuée par l’activité était correcte. Pour cela, il suffit d’indiquer un élément qui doit apparaître ou disparaître après l’exécution de l’action, qui est surveillé et vérifié après l’exécution de l’activité. Cette fonctionnalité peut être activée à partir des paramètres du projet ou du corps de chaque activité, en sélectionnant Ajouter une vérification (Add Verification) dans le menu contextuel.

  • Nom affiché (Display name ) : le nom affiché des Actionsde vérification. Ce champ est rempli automatiquement en fonction des Actions de vérification et de l'élément que vous avez choisis. Une fois la vérification de l'exécution configurée, ce nom d'affichage devient visible dans la carte d'activité.
  • Réessayer (Retry) - Lorsque cette option est sélectionnée, les Actions sont réessayées pendant toute la durée du délai d’attente de l’activité, si les résultats attendus n’ont pas été atteints. Par défaut, cette case est cochée.
  • Cible : cette cible est utilisée pour indiquer l'élément que vous souhaitez vérifier au moment du Runtime. Pour plus d'informations sur les champs de propriété qui peuvent être développés sous cette propriété, consultez la propriété Cible ci-dessus, car la fonctionnalité des propriétés est la même.
  • Délai d'attente : durée (en secondes) d'attente de l'apparition, de la disparition ou de la modification de l'élément à vérifier. Si la case Réessayer (Retry) est cochée, les Actions sont exécutées à nouveau, suivies de la vérification, et pour la durée spécifiée dans la propriété Délai d'attente ( Timeout ) de l'activité. La valeur par défaut est 10 secondes.
  • Vérifier l'élément : définit la modification pour laquelle vous souhaitez vérifier la cible de vérification. Les options disponibles sont :
    • Apparu : Vérifie si l'élément apparaît.
    • Disparu : vérifie si l'élément disparaît.
    • Texte modifié (Text Changed ) - Vérifie s'il y a des changements dans le texte de l'élément.
    • Modifié visuellement (Visually Changed ) - Vérifie s'il y a des changements d'image de l'élément.

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

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

• Durée : voir Durée dans le panneau Concepteur.

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

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

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