Using the Click action

The Click action in the Mouse package enables a bot to simulate mouse clicks. This action enables to capture the UI element such as the screen or window, and to specify the click event and click button.

Prerequisites

Ensure that the screen scale and resolution of the Bot Creator device is the same as the Bot Runner device. If the screen scale and resolution are different, the bot might fail when deployed to the Bot Runner device.

If you are using Internet Explorer, the bot waits until the browser is completely rendered and is in a ready state before executing the Click action.

Procedure

Follow these steps to add a Click action:

  1. In the Actions palette, double-click or drag the Click action from the Mouse package.
  2. Specify the window in which to capture the mouse click:
    Choose from the Application, Browser, or Variable tab.
    OptionDescription
    Application Select from a list of currently active windows.
    Note: You can use the Screen option to capture coordinates on the device screen, however we recommend specifying a window because screen sizes can change, which distorts the captured coordinates.
    Browser Select from a list of supported browser tabs. Review the following information based on the platform where you created the automation:
    • Windows

      This option supports Google Chrome, Chromium-based Microsoft Edge, and Internet Explorer browsers.

    • macOS

      This option supports only Google Chrome and Safari web browsers.
    Variable Select an existing window variable to specify the title of the application window title.
    Note: This option deactivates the Capture option. Use this option only after you have completed the capture step.

    Insérez un caractère générique (*) dans le champ Titre de la fenêtre pour rechercher les titres de fenêtre qui peuvent changer. Vous pouvez spécifier un ou plusieurs caractères génériques (*) au début, au milieu ou à la fin de la valeur. Par exemple, pour effectuer une opération sur une fenêtre qui contient Microsoft dans le titre, utilisez un caractère générique pour indiquer n'importe quelle chaîne en l'ajoutant avant ou après la valeur : *Microsoft*. Le bot recherche d'abord le titre exact de la fenêtre (Microsoft), et s'il ne trouve pas de correspondance, il recherche les fenêtres comportant le terme Microsoft n'importe où dans le titre.

    Vous pouvez utiliser une expression régulière (regex) pour identifier un titre de fenêtre. Définissez la condition d'expression régulière sur Chaîne ou Modèle, puis saisissez la valeur. Par défaut, le champ Titre de fenêtre est sensible à la casse.

    Pour identifier un titre de navigateur, vous pouvez activer l'option Sensible à la casse pour faire correspondre la casse des lettres, ou désactiver l'option pour identifier un titre de fenêtre où la casse des lettres ne correspond pas.
    Note: Assurez-vous que la version Bot Agent minimum installée sur votre système est celle publiée avec Automation 360 v.26. Si vous avez une version de Bot Agent publiée avec Automation 360 v.25 ou antérieure, le titre de la fenêtre est identifié par défaut uniquement par la casse des lettres (sensible à la casse) correspondante.
    Par exemple, pour faire correspondre tous les noms de titres de fenêtres commençant par un mot suivi de - Notepad, vous pouvez saisir la valeur Chaîne comme * -Notepad, ou utiliser la valeur Modèle comme ((\w)\s)*document-Notepad pour les seuls titres de fenêtres qui correspondent à ce modèle.
    Note:
    • Lorsque vous utilisez une expression régulière de type Chaîne avec -title comme valeur d'entrée pour un titre de fenêtre dans n'importe quelle action, le bot risque de rencontrer une erreur de temps d'exécution. Pour éviter toute erreur de temps d'exécution, assurez-vous que lorsque vous ajoutez l'entrée de la chaîne sous la forme *-title, l'application avec le titre spécifique est ouverte. L'astérisque (*) est juste un caractère et non un caractère générique.
    • Lorsque vous utilisez une expression régulière de type Modèle avec -title comme valeur d'entrée pour un titre de fenêtre dans n'importe quelle action, le bot risque de rencontrer une erreur de temps d'exécution, car la valeur d'entrée *-title est incorrecte.

      Assurez-vous d'utiliser des modèles regex valides.

  3. Optional: Sélectionnez l\'option Redimensionner la fenêtre pour spécifier les dimensions de la fenêtre.
    Cette option fournit un bot plus fiable. Elle redimensionne la fenêtre aux dimensions auxquelles la tâche a été enregistrée, ce qui améliore la capacité du bot à identifier l\'objet cible.
    • Si la fenêtre est agrandie lorsque vous enregistrez la tâche, cette option est désélectionnée.
    • Si la fenêtre n\'est pas à la taille maximale lorsque vous enregistrez la tâche, cette option est sélectionnée par défaut, et les champs de largeur et de hauteur se remplissent automatiquement avec les dimensions de la fenêtre.
    Note: Cette option est uniquement disponible pour les fenêtres qu\'il est possible de redimensionner. Elle n\'est pas disponible pour les options Bureau ou Barre des tâches.
  4. Click Capture coordinate.
    The selected window appears.
  5. Drag the mouse to select the click spot and left-click to capture it.
    The captured spot appears in the Preview section with the coordinates underneath.
  6. In the Button option, specify the button to click.
    Choose from Left Button, Right Button, or Middle Button.
  7. In the Event option, specify the event.
    Choose from Click, Double click, Button up, or Button down.
  8. Click Save.