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é Use Application/Browser , vous devez fournir un élément Input.

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

Compatibilité du projet

Windows - Héritage | Windows | Multiplate-forme

Configuration Windows et multiplate-forme

• Travaux de l’étendue (Work in scope) : choisissez l’onglet du navigateur affichant l’application Web à automatiser.
• Indiquer la cible à l'écran
  • Indiquer 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 :
  • Indicate target on screen - Indicate the target again.
  • Modifier la cible : ouvrez le mode de sélection pour configurer la cible.
• Duration : la durée (en secondes) pendant laquelle l'élément d'IU est survolé. La durée par défaut est de 1 seconde.
• Vérifier : définissez l'étape de vérification de l'exécution de l'activité.
  • Aucun : indique qu'aucune vérification n'est effectuée sur l'élément cible.
  • Élément apparu : vérifie si l’élément apparaît.
  • Élément disparu : vérifie si l'élément disparaît.
  • Texte de l'élément modifié : vérifie s'il y a des changements dans le texte de l'élément.

Panneau propriétés

Entrée/sortie

• Élément d’entrée : l’élément d’IU 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é Output Element d'autres activités UI Automation.
• Output Element : génère un élément d'IU cible et le stocke dans un objet UIElement , qui peut être ensuite 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é.
• Input mode - Select which method the Robot should use to interact with the target application:
  • Identique à l’application/au navigateur : utilisez le même mode d’entrée que pour l’activité Use Application/Browser .
  • Hardware Events - Uses the hardware driver to perform the action. This is the slowest method, it cannot work in the background, but it is compatible with all desktop apps.
  • Simuler : simule à l'aide d'API d'accessibilité. Recommandé pour les navigateurs, les applications basées sur Java, SAP. Habituellement plus fiable que les événements matériels. Envoie tout le texte en une seule action. 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 Debugger. Fonctionne uniquement avec les éléments Chromium. Envoie tout le texte en une seule fois. Fonctionne même si l’application cible n’est pas au point. Pour en savoir plus, consultez la section API Chromium.
  • Messages de fenêtre (Windows uniquement) : simulez à l'aide de messages Win32. Recommandé pour les applications de bureau. Habituellement plus fiable que les événements matériels. Envoie tout le texte en une seule action. 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.
• 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 .
• Continuer en cas d'erreur (Continue on error) : précise si l’automatisation doit se poursuivre même si l’activité génère une erreur. Ce champ prend uniquement en charge les valeurs booléennes Vrai (True) et 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 Vrai (True), l’exécution du projet se poursuit même en cas d’erreurs.

Cible

• Développer les propriétés de la cible : affiche les propriétés de la cible et de l'ancre. Cela masquera les autres propriétés de l'activité et n'affichera que celles liées à la cible.

• Réduire les propriétés de la cible : masque les propriétés de la cible et de l'ancre. Cela masquera les propriétés liées à la cible et affichera les propriétés de l'activité.

• Méthodes de ciblage : les types de sélecteurs que vous souhaitez utiliser pour identifier l’élément. Cette propriété peut être définie sur n’importe quelle combinaison à partir du menu déroulant :

  • Aucun (None)
  • Sélecteur strict : le sélecteur strict généré pour l’élément d’IU cible.
  • Sélecteur de correspondances approximatives : les paramètres du sélecteur de correspondances approximatives.
  • 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.
    • Type de contrôle CV : indique le type de contrôle identifié à l'aide de Computer Vision.
    • Texte du CV : indique le texte identifié à l'aide de Computer Vision.
    • Occurrence de texte CV : indique une occurrence spécifique à utiliser lorsque plusieurs correspondances sont trouvées.
    • Précision du texte CV : indique le niveau de précision de la correspondance de texte OCR.
  • 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.
  • Image (Windows uniquement)
    • Précision de l'image : indique le niveau de précision de la correspondance de l'image.
    • Occurrence d'image : indique une occurrence spécifique à utiliser lorsque plusieurs correspondances sont trouvées.
  • Texte natif
    • Texte natif : le texte à trouver pour identifier l’élément d’IU.
    • Occurrence de texte natif : indique une occurrence spécifique à utiliser lorsque plusieurs correspondances sont trouvées.

• Sélecteur de fenêtre : sélecteur de la fenêtre d'application. Uniquement applicable lorsque le mode d’attachement de fenêtre est défini sur instance d’application.

• Attendre le chargement de la page : avant d’effectuer l’action, attendez que l’application soit prête à accepter la saisie. Les options sont les suivantes :

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

• Vérification de visibilité : lorsqu’elle est activée, l’activité vérifie également si l’élément d’IU est visible ou non. Choisissez l’une des trois options 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 bien si l’application est réduite. Cette vérification est utile lorsque vous voulez vous assurer que vous ne ciblez pas des éléments invisibles, qui existent dans le DOM mais sont masqués.
  • Entièrement visible : vérifie si l'élément d'IU est visible ou non.

• Sites Web réactifs : permet d'activer la mise en page réactive des sites Web.

Cible - Zone de détourage

• Point d'ancrage : décrit le point de départ du curseur vers lequel il se décalage des propriétés Décalage X et Décalage Y sont ajoutées. Les options suivantes sont disponibles : TopLeft, TopRight, BottomLeft, BottomRight  et 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.
• Largeur du décalage : largeur de la zone de décalage.
• Hauteur de décalage : hauteur de la région de décalage.

Cible - Point de décalage

• Point d'ancrage : décrit le point de départ du curseur vers lequel il se décalage des propriétés Décalage X et Décalage Y sont ajoutées. Les options suivantes sont disponibles : TopLeft, TopRight, BottomLeft, BottomRight  et 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

• Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.

• Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.

• Délai d'attente : spécifiez le délai d'attente pour 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 :

• Indicate target on screen - Indicate the target again.
• Modifier la cible : ouvrez 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é. Vérifiez que l'exécution est activée par défaut.
• Supprimer la capture d'écran d'information : supprime la capture d’écran de l’application cible ou de la page Web.
• Ajouter au référentiel d’objets : 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 : la durée (en secondes) pendant laquelle l'élément d'IU spécifié est survolé. Vous pouvez choisir une valeur prédéterminée dans le menu déroulant : 1, 3, 5. La valeur par défaut est 1 secondes. Vous pouvez également cliquer sur le bouton Plus et utiliser l’une des options du menu pour indiquer la durée.
• 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

• Continue On Error : indique 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 (Vrai, Faux , Faux). 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'erreurs.

• Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.

• Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.

• 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 le délai d'attente pour 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 : l'élément cible. L'élément cible doit être défini. Avant d'indiquer à 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é s’affichent.

  • Décalage de clic : 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 vers lequel il se décalage des propriétés Décalage X et Décalage Y sont ajoutées. Les options suivantes sont disponibles : TopLeft, TopRight, BottomLeft, BottomRight  et 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 ne prend en charge que 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 ne prend en charge que les variables Int32 .
  • Type de contrôle CV : indique le type de contrôle identifié à l'aide de Computer Vision.
  • Texte du CV : indique le texte identifié à l'aide de Computer Vision.
  • Fuzzy selector - The parameters for the fuzzy selector.
  • Texte natif : le texte utilisé pour identifier l'élément d'IU.
  • Sites Web réactifs : permet d'activer la mise en page réactive des sites Web.
  • 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 que vous souhaitez utiliser pour identifier l’élément. Cette propriété peut être définie sur 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.
  • Vérification de visibilité : vérifie si l’élément d’IU est visible ou non. Choisissez l’une des trois options 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 bien si l’application est réduite. Cette vérification est utile lorsque vous voulez vous assurer que vous ne ciblez pas des éléments invisibles, qui existent dans le DOM mais 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 l’action, attendez que l’application soit prête à accepter la saisie. Choisissez l’une des trois options 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 : 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.

• 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 complet : le nom complet de l’action de vérification. Ce champ est rempli automatiquement en fonction de l’action de vérification et de l’élément que vous avez choisi. Une fois l'exécution Vérifier l'exécution configurée, ce nom complet devient visible dans la fiche d'activité.
  • Réessayer - Une fois sélectionnée, plusieurs essais relatifs à l’action seront réalisés pendant toute la durée du délai d’attente de l’activité, si les résultats attendus n’ont pas été atteints. Cette case est cochée par défaut.
  • Cible : cette cible est utilisée pour indiquer l’élément que vous souhaitez vérifier au moment de l’exécution. 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 les fonctionnalités des propriétés sont identiques.
  • Délai d'attente : la 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 est cochée, l’action est à nouveau exécutée, suivie de la vérification, et ce, pour la durée spécifiée dans la propriété Délai d’attente de l’activité. La valeur par défaut est 10 secondes.
  • Vérifier l'élément
    • Définit la modification que vous souhaitez vérifier dans la cible de vérification. Les options disponibles sont les suivantes :
    • Apparu : vérifie si l’élément s’affiche.
    • Disparu : vérifiez si l'élément disparaît.
    • Texte modifié - Vérifie si le texte de l’élément a été modifié.
    • Modifié visuellement : vérifie s'il y a des modifications d'image de l'élément.

• Élément d’entrée : l’élément d’IU 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é Output Element d'autres activités UI Automation.

• Output Element : génère un élément d'IU cible et le stocke dans un objet UIElement , qui peut être ensuite utilisé pour cibler le même élément avec d'autres activités.

• Privé : si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé. Ce champ prend uniquement en charge les valeurs Boolean (Vrai, Faux , Faux). La valeur par défaut est False.

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

• Input mode - Select which method the Robot should use to interact with the target application:

  • Identique à l’application/au navigateur : utilisez le même mode d’entrée que pour l’activité Use Application/Browser .
  • Hardware Events - Uses the hardware driver to perform the action. This is the slowest method, it cannot work in the background, but it is compatible with all desktop apps.
  • Simuler : simule à l'aide d'API d'accessibilité. Recommandé pour les navigateurs, les applications basées sur Java, SAP. Habituellement plus fiable que les événements matériels. Envoie tout le texte en une seule action. 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 en utilisant des messages Win32. Recommandé pour les applications de bureau. Habituellement plus fiable que les événements matériels. Envoie tout le texte en une seule action. 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.