Utilisation de l'action Capturer

Utilisez l'action Capturer pour capturer une seule interaction (clic, séquence de touches ou mouvement de la souris) avec une commande d'objet comprenant une zone de texte, un bouton, un tableau, un menu, une case d'option, une boîte combinée, une case à cocher, une vue de liste, un lien, une arborescence ou un onglet de page.

Prérequis

  • Avant d'utiliser l'Enregistreur, vous devez au préalable effectuer les tâches suivantes :
  • Configurez l'affichage du périphérique et le facteur d'échelle de police sur 100 %.

    Si vous utilisez le package Enregistreur version 2.0.6-20200626-193519 ou ultérieure, vous pouvez enregistrer des tâches dans les applications d'automatisation d'interface utilisateur Google Chrome, Internet Explorer, Java, Microsoft et Microsoft Active Accessibility sur un ordinateur dont l'échelle d'affichage est configurée sur 100 %, 125 % ou 150 %.

  • Si vous automatisez une tâche dans un navigateur, définissez le niveau de zoom sur 100 %.

    Si vous utilisez le package Enregistreur version 2.0.6-20200626-193519 ou ultérieure, vous pouvez enregistrer des tâches dans un navigateur Google Chromequi n’a pas un niveau de zoom défini sur 100 %.

  • Si vous automatisez une tâche à l'aide d'un navigateur Google Chrome, assurez-vous que le plug-in Automation Anywhere correspondant à la version de build de Automation 360 est activé.

    Exigences relatives aux navigateurs pour Espace de travail d'automatisation

  • Pour automatiser les applications Web fonctionnant sur Microsoft Edge Chromium en mode Internet Explorer en utilisant l'Enregistreur universel, assurez-vous que le mode de compatibilité d'Internet Explorer est activé. Les objets sur les applications Web sont capturés à l'aide de la technologie HTML. Pour activer ce mode, procédez comme suit :
    1. Sur la page du navigateur Microsoft Edge Chromium, cliquez sur Paramètres.
    2. Dans le volet de gauche, cliquez sur Navigateur par défaut.
    3. Accédez à l'onglet Autoriser le rechargement des sites en mode Internet Explorer et sélectionnez Autoriser.
    4. Cliquez sur Ajouter pour ajouter l'URL de la page que vous souhaitez charger en mode Internet Explorer.
      Remarque : Les pages que vous ajoutez s'ouvrent dans Internet Explorer pendant 30 jours à compter de la date d'ajout de la page.
Considérations relatives à l'enregistrement d'une tâche :
  • Dans la mesure du possible, utilisez les clics plutôt que les touches de raccourci.

    Lorsque vous cliquez sur un objet à l'aide du Enregistreur, il récupère les propriétés de l'objet qui permettent au robot d'identifier l'objet lors de l'exécution. Les raccourcis clavier sont moins fiables. Utilisez-les lorsqu'il n'est pas possible d'automatiser la tâche en cliquant sur un objet.

  • Si vous automatisez une tâche à l'aide d'un navigateur, n'utilisez pas le remplissage automatique pour saisir des valeurs dans les champs.
  • Enregistrez la tâche à faible vitesse.
  • Évitez de faire glisser des fenêtres pendant le processus d'enregistrement.
  • Évitez de cliquer sur des applications qui ne font pas partie du processus que vous enregistrez et automatisez.
  • Lorsque vous utilisez Internet Explorer, l'action attend que le navigateur soit entièrement chargé et prêt avant d'exécuter l'action.

Procédure

Pour enregistrer une seule interaction avec une commande d'objet, procédez comme suit :

  1. Double-cliquez sur ou faites glisser Enregistreur > Capturer.
  2. Spécifiez la fenêtre dans laquelle capturer un objet.
    Choisissez l'onglet Application, Navigateur ou Variable.
    OptionDescription
    Application Choisissez dans une liste de fenêtres actuellement actives. Cette option affiche une liste de toutes les fenêtres d'application et de navigateur ouvertes sur le périphérique Bot Creator.
    Navigateur choisissez parmi une liste d'onglets de navigateur pris en charge.
    Remarque : Cette option prend en charge les navigateurs Google Chrome, Microsoft Edge basé sur Chromium et Internet Explorer. Pour tous les autres navigateurs, utilisez l'option Application.
    Variable sélectionnez une variable de fenêtre existante pour spécifier le titre de la fenêtre d'application.
  3. Facultatif : 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 robot 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.
    Remarque : Assurez-vous que la version Agent de robot minimum installée sur votre système est celle publiée avec Automation 360 v.26. Si vous avez une version de Agent de robot 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, vous pouvez saisir la valeur de Chaîne sous la forme ((\w*)-Notepad pour tous les noms de titres de fenêtres commençant par ((\w*)-Notepad ou utiliser la valeur de Pattern sous la forme ((\w)\s)*document-Notepad uniquement pour les titres de fenêtres qui correspondent à ce modèle.
    Remarque :
    • 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 robot 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 robot 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.

    Remarque : Pendant l'exécution, vérifiez que le Robot de tâches identifie la fenêtre appropriée. Si ce n'est pas le cas, procédez comme suit :
    1. Ouvrez la fenêtre de l'application ou du navigateur
    2. Faites glisser l'action Fenêtre > Obtenir le titre de la fenêtre active au-dessus de l'action Enregistreur > Capturer.
    3. Insérez une variable de chaîne dans le champ Attribuer le titre de la fenêtre à une variable.
    4. Faites glisser une action Fenêtre > Définir le titre sous l'action Fenêtre > Obtenir le titre de la fenêtre active.
    5. Dans le champ Fenêtre, insérez la variable de fenêtre générée par l'action Enregistreur > Capturer.
    6. Dans le champ Nouveau titre de la fenêtre, insérez la variable de chaîne à partir de l'action Obtenir le titre de la fenêtre active.
    7. Cliquez sur Enregistrer.
  4. Facultatif : Sélectionnez l'option Redimensionner la fenêtre pour spécifier les dimensions de la fenêtre.
    Cette option fournit un robot plus fiable. Elle redimensionne la fenêtre aux dimensions auxquelles la tâche a été enregistrée, ce qui améliore la capacité du robot à 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.
    Remarque : 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.
  5. Cliquez sur Capturer l'objet.
    La fenêtre sélectionnée s'affiche.
  6. Placez le pointeur de la souris sur l'objet que souhaitez automatiser, par exemple, un bouton, un champ de formulaire ou un tableau.
    Une zone rouge apparaît autour de l'objet.
    Remarque : Si cette zone n'apparaît pas et que vous effectuez une capture dans le navigateur Google Chrome, Microsoft Edge ou Mozilla Firefox, vérifiez que vous avez activé les extensions Automation Anywhere de ces navigateurs. Consultez la rubrique Exigences d'extension du navigateur Google Chrome pour le navigateur Google Chrome.
  7. Cliquez sur l'objet.
  8. Examinez le tableau Propriétés de l'objet.
    Vous trouverez ci-dessous la liste des propriétés d'objet qui sont sélectionnées par défaut en fonction du type de technologie :
    Remarque : Vous n'avez pas la possibilité de sélectionner explicitement la technologie Java ou HTML. Lorsque vous capturez une application en mode de détection automatique, l'Enregistreur détecte automatiquement la technologie en fonction de l'application capturée. Lorsque l'Enregistreur détecte une technologie spécifique, le type de technologie s'affiche dans les Propriétés de l'objet.
    Important : La liste suivante ne comprend pas toutes les propriétés, mais inclut uniquement celles les plus couramment utilisées et les plus importantes en fonction du type de technologie.
    Type de technologie Propriétés de l'objet Description
    Technologie HTML Type de contrôle Cette propriété en lecture seule indique le type d'objet capturé, par exemple une zone de texte ou un bouton.
    DOMXPath Il s'agit du chemin qui est utilisé pour localiser le contrôle ou l'objet qui est capturé. DOMXPath peut être de deux types : XPath relatif et XPath absolu.
    • Xpath absolu : Il contient le chemin complet de l'élément racine à l'élément souhaité. Par exemple, un Xpath absolu pour cette rubrique serait le suivant : /html/body/div/div[1]/main/​div[2]/div/div/​div[2]/div/div/div[1]/​div/article/main/​article/div/p[1]
    • Xpath relatif : Il s'agit d'un chemin plus court qui fait référence à un élément que vous voulez identifier. Un chemin relatif commence par un symbole //. Par exemple, le XPath relatif pour cette rubrique serait le suivant : //*[@id="cloud-using-recorder-action"]/div/p[1]
    Par exemple, si vous voulez trouver le DOMXPath d'un élément particulier sur le navigateur Google Chrome, effectuez les étapes suivantes :
    1. Sélectionnez l'élément pour lequel vous voulez extraire le XPath.
    2. Cliquez avec le bouton droit sur l'élément et sélectionnez Inspecter.
    3. Cliquez avec le bouton droit de la souris sur l'élément en surbrillance dans l'onglet Élément.
    4. Accédez à Copier > Copier Xpath pour copier le chemin relatif et sélectionnez Copier > Copier le chemin complet Xpath pour copier le chemin absolu.
    Chemin Cette propriété est une représentation numérique de la position d'une commande particulière dans une application. Pour les applications Web, la meilleure pratique consiste à utiliser DOMXPath dans les critères de recherche plutôt que Chemin.
    Nom et ID HTML Ces propriétés sont utilisées pour identifier un objet HTML.
    Texte interne HTML La propriété DOM innerText est utilisée pour définir ou renvoyer le contenu textuel d'un nœud spécifié et de ses descendants
    Balise HTML Les balises HTML sont comme des mots-clés qui définissent la manière dont le navigateur Web formate et affiche le contenu. Par exemple, si le texte capturé comporte un code HTML : <h3 class="search_results-title">Search results for ״string package״</h3>, puis saisissez h3 dans le champ de la balise HTML.
    Microsoft Active Accessibility Type de contrôle Cette propriété est utilisée uniquement comme référence pour s'assurer que le bon objet est capturé
    Chemin Il s'agit d'une représentation numérique de la position d'un contrôle particulier dans une application
    Nom Cela spécifie le nom d'un élément et fonctionne comme un identifiant
    Identifiant Cela spécifie l'ID d'un élément et fonctionne comme un identifiant
    Technologie Java Type de contrôle Cette propriété est utilisée uniquement comme référence pour s'assurer que le bon objet est capturé
    Chemin Il s'agit d'une représentation numérique de la position d'un contrôle particulier dans une application
    Microsoft UI Automation Type de contrôle Cette propriété est utilisée uniquement comme référence pour s'assurer que le bon objet est capturé
    Chemin Il s'agit d'une représentation numérique de la position d'un contrôle particulier dans une application
    Nom Cela spécifie le nom d'un élément et fonctionne comme un identifiant
    Identifiant Cela spécifie l'ID d'un élément et fonctionne comme un identifiant
    IsFirst Cette propriété permet au robot de détecter le premier objet en fonction de vos critères de recherche au lieu de parcourir l'ensemble de l'arborescence. Vous pouvez utiliser cette propriété lorsqu'un objet n'a pas d'ID d'automatisation unique et que la hiérarchie des objets varie dans l'application.
    Microsoft UI Automation (COM) Type de contrôle Cette propriété est utilisée uniquement comme référence pour s'assurer que l'objet correct est capturé.
    Chemin Cette propriété est une représentation numérique de la position d'une commande particulière dans une application.
    Nom Cette propriété spécifie le nom d'un élément et fonctionne comme un identifiant.
    Identifiant Cette propriété spécifie l'ID d'un élément et fonctionne comme un identifiant.
    Le robot utilise les propriétés sélectionnées pour identifier la commande d'objet pendant l'exécution.
    1. Vérifiez que le Type de contrôle correspond à votre objet prévu.
      Par exemple, lorsque vous capturez un tableau à partir d'un site Web, assurez-vous que les valeurs de Type de contrôle et de Balise HTML sont définies sur Tableau.
      Si le Type de contrôle ne correspond pas à l'objet prévu, capturez à nouveau la commande d'objet.
    2. Sélectionnez et attribuez des valeurs aux propriétés d'objet que vous souhaitez inclure dans la recherche d'objets.
      Pour un robot plus fiable, nous vous recommandons de ne sélectionner que les propriétés qui ont des valeurs statiques (telles que Nom, Classe, Type, ID HTML et DOMXPATH), et désélectionnez les propriétés qui ont des valeurs dynamiques (telles que HTML Href, Chemin ou Valeur) qui sont susceptibles de changer et de provoquer des erreurs de robot.
      Il est recommandé d'utiliser le caractère générique (*) ou la variable dans les valeurs des propriétés d'objet pour rechercher les objets dont les propriétés sont dynamiques et changent fréquemment.
      Remarque : La correspondance des caractères génériques n'est actuellement pas prise en charge par la technologie SAP. Lorsque vous exécutez un robot avec un caractère générique, les valeurs propriétaires correspondent exactement à celles spécifiées dans les critères de recherche.
  9. Sélectionnez l'Action dans la liste déroulante.
    Pour obtenir une liste complète des actions possibles effectuées par un objet, consultez la rubrique Actions effectuées sur des objets capturés avec Enregistreur universel.
    • Si vous enregistrez un clic et des frappes au clavier dans une zone de texte dont le type de contrôle est Password text, l'enregistreur ne capture pas les frappes au clavier renseignées dans le champ. Au lieu de cela, l'action sélectionne l'option Définir le texte et propose des options pour saisir le mot de passe en toute sécurité. Nous vous recommandons de stocker le mot de passe dans le Credential Vault et de l'insérer dans l'action en tant qu'informations d'identification.

      Reportez-vous à la rubrique Informations d'identification et variables d'informations d'identification dans l'Éditeur de robots.

      Si vous accédez à la zone de texte en utilisant la touche TAB au lieu d'un clic dans une application MSAA ou SAP, l'enregistreur est capable d'identifier les champs dont le type de contrôle est Password text.

    • Si l'action sélectionnée prend en charge le traitement en arrière-plan, une option Exécuter en arrière-plan est disponible.

      Reportez-vous à la rubrique Enregistreur universel pour l'automatisation basée sur les objets.

  10. Dans le champ Définir le délai d'expiration du système, sélectionnez Basique ou Avancé.
    • Basique : dans le champ Attendre la réponse du système (en secondes), spécifiez le nombre de secondes pendant lesquelles le robot doit attendre que le contrôle d'objet s'affiche dans la fenêtre de l'application. Ce temps d'attente comprend le temps de chargement de la page et le temps de recherche de l'objet.

      Nous vous recommandons de définir un délai lorsque vous utilisez l'action Définir le texte pour saisir des frappes dans un champ de texte.

      Remarque : Le délai d'attente spécifié pour que le robot attende que le contrôle apparaisse sur la fenêtre de l'application ne s'applique que si la fenêtre dans laquelle le contrôle est présent existe. L'Enregistreur recherche d'abord la fenêtre de l'application, puis l'objet qui se trouve dans cette fenêtre. Par défaut, la durée de recherche de la fenêtre est de 30 secondes. Par conséquent, même si vous spécifiez un délai d'attente de 5 secondes, il attend toujours 30 secondes par défaut si la fenêtre n'existe pas.

      Nous vous recommandons d'utiliser d'abord la condition Si > La fenêtre existe, de spécifier un délai d'attente de zéro seconde et de vous assurer que la fenêtre de l'application existe. Si la fenêtre existe, utilisez l'Enregistreur, spécifiez un délai d'attente de 5 secondes et exécutez le robot pour détecter l'objet.

    • Avancé : utilisez cette option pour automatiser les sites Web qui se chargent et se mettent à jour en permanence avec les données les plus récentes, comme un site Web d'actions. Techniquement, ces sites Web ne sont jamais entièrement chargés à l'écran. Dans ces cas-là, le robot n'a pas besoin d'attendre le chargement complet de la page Web et peut directement procéder à l'automatisation de la page Web après un certain temps.

      Dans le champ Attendre la réponse du navigateur (en secondes), indiquez le nombre de secondes pendant lesquelles le robot doit attendre le chargement du navigateur. Sélectionnez l'une des options ci-dessous :

      • Arrêter le robot et afficher un message d'erreur : si la page Web n'a pas été complètement chargée dans le délai spécifié, sélectionnez cette option pour arrêter le robot et afficher un message d'erreur.
      • Ignorer et accéder à l'objet : sélectionnez cette option pour accéder directement à l'objet et le capturer même si la page Web n'a pas été complètement chargée.

      Saisissez une valeur dans le champ Attendre la réponse de l'objet (en secondes) pour spécifier le nombre de secondes pendant lesquelles le robot doit attendre que le contrôle d'objet s'affiche dans la fenêtre de l'application.

  11. Facultatif : Attribuez la sortie à une variable.
    La Control Room suggère un nom de variable par défaut descriptif en fonction de l'action que vous avez sélectionnée à l'étape 8. Par exemple, si vous avez sélectionné Obtenir la propriété, la variable de sortie suggérée est PropertyValue. Si vous créez plusieurs variables de sortie, -1 est ajouté à la fin des noms de variables suivants pour éviter la duplication.
  12. Cliquez sur Enregistrer.
    Les images capturées ne sont pas ajoutées en tant que dépendances et ne sont pas affichées dans la liste des dépendances lorsque vous archivez votre robot.
Relier un objet à une ancre de support
Remarque : Vous pouvez utiliser l'ancrage d'objet dans Microsoft Active Accessibility, Microsoft UI Automation ou les applications Java.
Pendant l'exécution, si le robot ne peut pas identifier de manière fiable un objet, associez-le à un objet à proximité (tel qu'un lien ou un bouton) plus facile à trouver pour le robot :
  1. Ouvrez l'action Capturer.
  2. Cliquez sur l'onglet Ancre.
  3. Cliquez sur Capturer l'ancre.

    La fenêtre du navigateur ou de l'application s'active avec l'objet principal en surbrillance (l'objet que vous avez capturé précédemment). Une boîte de dialogue apparaît, vérifiant si l'action a correctement identifié l'objet principal.

  4. Si le bon objet est mis en évidence, cliquez sur Oui, sélectionner l'ancre.

    Sinon, cliquez sur Non, je dois la corriger pour sélectionner le bon objet.

  5. Sélectionnez un objet à proximité de l'objet cible qui est plus facile à trouver pour le robot.

    L'objet est mis en évidence par une icône d'ancre à droite de l'objet.

  6. Cliquez sur Enregistrer.