action Appeler une fonction JavaScript

L'action Appeler une fonction JavaScript du package Navigateur vous permet d'appeler une fonction JavaScript existante directement dans une page Web ou dans un élément iFrame au sein d'une page Web.

Configurer les paramètres

Remarque : Cette action prend en charge les navigateurs Google Chrome et Microsoft Edge basé sur Chromium.
  1. Sélectionnez l'onglet du navigateur dans la liste des onglets actifs du navigateur pris en charge ou insérez une variable de fenêtre.

    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.

  2. Facultatif : Utilisez l'objet Capturer l'objet pour capturer les iFrames.
    Remarque : Vous pouvez utiliser la fonctionnalité Capturer l'objet pour appeler et exécuter une fonction JavaScript existante à l'intérieur d'un élément iFrame.
  3. Dans le champ Nom de la fonction, indiquez le nom de la fonction JavaScript existante que vous souhaitez appeler.
  4. Facultatif : Dans la section Arguments, cliquez sur Ajouter un argument pour ajouter les arguments qui doivent être transmis pour appeler la fonction JavaScript.
    1. Dans la boîte de dialogue Détails de l'argument, sélectionnez le Type d'argument requis pour l'argument spécifique.
    2. Dans le champ Valeur, saisissez la valeur ou la variable correspondante du type sélectionné que vous souhaitez transmettre.
      Remarque : Toutes les valeurs de chaîne dans les arguments sont transmises telles quelles, sans qu'aucun caractère ne soit converti ou ignoré.
  5. Facultatif : Dans le champ Délai d'expiration, saisissez le nombre de secondes pendant lesquelles le robot doit attendre la fin de l'action du navigateur.
    Remarque : Saisissez une valeur de délai d'expiration d'au moins 9 secondes.
  6. Dans le champ Type de retour, sélectionnez le type de valeur renvoyée par la fonction JavaScript.
    Remarque : Si la fonction ne renvoie rien, dans le champ Type de retour, sélectionnez Aucun.
  7. Pour toute valeur du champ Type de retour, à l'exception de la valeur Aucun, dans le champ Enregistrer le résultat dans une variable, sélectionnez une variable pour la valeur du champ Type de retour sélectionnée afin de contenir la sortie de la fonction JavaScript.

Créer la variable

Pour créer une variable pour la valeur du champ Type de retour sélectionnée, effectuez les étapes suivantes :
  1. Cliquez sur le symbole Créer la variable en regard du champ Enregistrer la sortie dans une variable.

    Une boîte de dialogue Créer la variable s'ouvre avec un nom de variable par défaut pour le type de variable sélectionné.

  2. Facultatif : spécifiez les informations relatives à la variable dans le champ Description.
  3. Facultatif : spécifiez une valeur dans le champ Valeur par défaut.
  4. Cliquez sur Créer et sélectionner pour sélectionner la variable nouvellement créée.

Types JavaScript pris en charge dans les champs Argument et Type de retour

Les types JavaScript suivants sont pris en charge :

  • Les types JavaScript Chaîne, Nombre et Booléen qui correspondent aux mêmes types de variables dans les variables de robot.
  • Le type JavaScript Tableau qui correspond au type de variable List dans les variables de robot.
  • Le type JavaScript Objet qui correspond au type de variable Dictionary dans les variables de robot.