Mouse scroll

UiPath.UIAutomationNext.Activities.NMouseScroll

Description

Permet de faire défiler les applications en envoyant des événements de défilement de la souris à l’é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.

Remarque :

Si aucune cible n'est fournie pour cette activité, la cible de l'étendue dans laquelle elle est incluse sera automatiquement utilisée. De plus, en raison de la nature de cette activité, elle ne peut pas être utilisée en mode arrière-plan.

Pour plus d'informations sur l'indication et la configuration des cibles, consultez Écran de sélection.

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.
• Faire défiler le conteneur : faites défiler la page entière ou l'intérieur d'un élément. L'option par défaut est Page entière.
• Défilement : la direction dans laquelle vous souhaitez que le défilement soit effectué. Les options suivantes sont disponibles : Gauche, Haut, Droite, Bas. L'option par défaut est Bas.
• Faire défiler type : sélectionnez entre les deux méthodes d’utilisation pour cette activité :
  • Vers l'élément : défile jusqu'à ce qu'un élément d'IU spécifié soit trouvé dans l'application cible. Il s'agit de l'option par défaut.
  • Plage : défile uniquement dans la mesure indiquée dans le champ de propriété Nombre de défilements .
• Indiquer l'élément recherché à l'écran : indiquer l'élément d'IU vers lequel vous voulez faire défiler. Cette option s’affiche uniquement si l’élément À est sélectionné dans le menu déroulant Type de défilement . 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.
• Nombre de défilements : le nombre de fois à faire défiler. Cette option s'affiche uniquement si l'option Plage est sélectionnée dans le menu déroulant Type de défilement.

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

• 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.
  • 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.
• 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 .
• 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é.
• Modificateurs de touche : ajoutez un ou plusieurs modificateurs de touche à utiliser en association avec l'action de l'activité. Les options suivantes sont disponibles : Aucun, Alt, Ctrl, Maj,et Win. L'option par défaut est None.
• 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.

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 le bouton 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.
  • 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.
• Direction : la direction dans laquelle vous souhaitez que le défilement soit effectué. Les options suivantes sont disponibles : Gauche, Haut, Droite, Bas. L'option par défaut est Bas.
• Faire défiler type : sélectionnez entre les deux méthodes d’utilisation pour cette activité :
  • Vers l'élément : défile jusqu'à ce qu'un élément d'IU spécifié soit trouvé dans l'application cible. Il s'agit de l'option par défaut.
    Remarque :

    Si vous sélectionnez Vers l'élément dans le champ Type de défilement , le champ de propriété Nombre de défilements est ignoré et l'élément d'IU spécifié est recherché. Si, au moment de l'exécution, l'élément indiqué est introuvable, l'activité défile autant que spécifié dans le champ Nombre de défilements , puis retente la recherche de l'élément indiqué. Ce comportement est répété autant de fois que nécessaire, jusqu'à ce que l'élément soit trouvé, et peut être utile dans le cas d'applications dont les temps de chargement sont plus longs.

  • Plage : défile uniquement dans la mesure indiquée dans le champ de propriété Nombre de défilements .
    Remarque :

    The number of lines scrolled by a scroll movement is configured in the Mouse settings section in Windows. If scrolling to a specific element, the element is searched after all rotations are executed. Selecting this method also displays the # of scrolls property in the body of the activity.

• Faites défiler jusqu'à l'élément : cliquez sur Indiquer dans l'application/le navigateur pour indiquer l'élément d'IU vers lequel vous souhaitez faire défiler. Cette option s’affiche uniquement si l’élément À est sélectionné dans le menu déroulant Type de défilement .

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.

  Important :

  Si vous faites défiler jusqu’à une cible d’image, il est recommandé d’augmenter la valeur de la propriété Délai d’attente pour tenir compte des temps de recherche d’image plus longs.

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

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

• Nombre de défilements : le nombre de fois à faire défiler, stocké dans une variable Int32 . Si le type de défilement dans le corps de l'activité est défini sur l' élément À, ce champ est défini par défaut sur 10. S'il est défini sur Plage, ce champ est défini sur 5 par défaut.

• Direction : voir Direction 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.
  • 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.

• Modificateurs de touche : ajoutez un ou plusieurs modificateurs de touche à utiliser en association avec l'action de l'activité. Les options suivantes sont disponibles : Aucun, Alt, Ctrl, Maj,et Win. L'option par défaut est None.

• Élément recherché : l'élément d'IU indiqué vers lequel vous voulez faire défiler.

  • Élément de sortie - Référence d'élément d'interface utilisateur recherchée, que vous pouvez utiliser dans d'autres activités UI Automation, dans la propriété Élément d'entrée .
  • Cible - Cet élément d’IU possède sa propre propriété Cible qui peut être configurée de la même manière que la propriété principale.
  • Délai d'attente (Timeout) : durée (en secondes) d’attente pour que l’élément recherché apparaisse. La valeur par défaut est 0,2 seconde.