Inject Js Script

UiPath.Core.Activities.InjectJsScript

Exécute le code JavaScript dans le contexte de la page Web correspondant à un UiElement.

Propriétés

Entrée

• ScriptCode : le code JavaScript que vous souhaitez exécuter. Vous pouvez l'écrire ici sous forme de chaîne ou ajouter le chemin complet d'un fichier .js qui contient le code à exécuter. Il doit contenir une seule fonction anonyme, comme dans ces exemples :

  function (element, input) {
    return "result";
  }
  

  async function (element, input) 
  {
    const asyncResult = await new Promise((resolvePromiseCb) => 
    {
      const timeoutMs = 100;
      setTimeout(() => 
      {
        resolvePromiseCb("async_result");
      }, 
      timeoutMs);
    });
    return asyncResult;
  }
  

  où element représente l'élément HTML correspondant au nœud d'IU appelant, et input représente la chaîne d'entrée fournie par l'appelant.

• InputParameter - Données d'entrée du code JavaScript, en tant que chaîne ou variable de chaîne.

• Sélecteur de cible (Target.Selector) - Propriété de texte utilisée pour trouver un élément donné de l'interface utilisateur lors de l'exécution de l'activité. Il s'agit en fait d'un fragment XML spécifiant les attributs de l'élément d'interface graphique utilisateur que vous recherchez et de certains de ses parents.

• Expiration cible ms (Target.TimeoutMS) - Spécifie le délai d'attente (en millisecondes) avant l'exécution de l'activité au-delà duquel un message d'erreur SelectorNotFoundException est généré . La valeur par défaut est 30 000 millisecondes (30 secondes).

• Attente cible prête (Target.WaitForReady) - Avant d'exécuter les actions, attendez que la cible soit prête. Les options suivantes sont disponibles :

  • None (Aucun) - Attend uniquement la création de l'élément de l'interface utilisateur cible avant d'exécuter l'action. Vous pouvez, par exemple, utiliser cette option si vous souhaitez récupérer uniquement du texte à partir d'une page Web ou cliquer sur un bouton spécifique sans être obligé d'attendre que tous les éléments de l'interface utilisateur soient chargés. Il est à noter que ceci peut avoir des conséquences indésirables si le bouton est basé sur des éléments qui ne sont pas encore chargés, comme par exemple des scripts.
  • Interactif/Terminé - Attend que tous les éléments d'IU de l'application cible soient créés avant d'exécuter l'action. Pour évaluer si une application est à l'état Interactif (Interactive) ou Terminé (Complete), les balises suivantes sont vérifiées :
  • Applications de bureau (Desktop applications) - Un message wm_null est envoyé pour vérifier l'existence des balises <wnd>, <ctrl>, <java> ou <uia>. Si elles existent, l'activité est exécutée.
  • Applications Web (Web Applications)
  1. Internet Explorer - The <webctrl> tag is used to check if the Ready state of the HTML document is set to Complete. Additionally, the Busy state has to be set to "False".
  2. Others - The <webctrl> tag is used to check if the Ready state of the HTML document is Complete.
  • Applications SAP (SAP applications) - Une fois la présence de la balise <wnd> vérifiée, une API SAP spécifique est utilisée pour détecter si la session est occupée ou non.

• Élément cible (Target.Element) - Utiliser la variable UiElement renvoyée par une autre activité. Cette propriété ne peut pas être utilisée avec la propriété Selector. Ce champ prend en charge les variables UiElement uniquement.

• Target.ClippingRegion : définit le rectangle de détourage, en pixels, par rapport à l'objet UiElement, dans les sens suivants : gauche, haut, droite, bas. Elle prend en charge les nombres positifs et négatifs.

Sortie

• Sortie de script (ScriptOutput) - Résultat de la chaîne renvoyé par le code JavaScript.

Commun

• NomAffichage (DisplayName) - Nom affiché de l'activité.

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  Remarque :

  Si cette activité est incluse dans Tenter de capturer (Try Catch) et que la valeur de la propriété Poursuite sur erreur (ContinueOnError) est True, aucune erreur n'est détectée lors de l'exécution du projet.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Options

• Execution world - The JavaScript environment for the script execution.
  • Isolated - Allows access to the HTML elements, but prevents access to page variables and code. Use this option to ensure that the script execution does not conflict with the page.
  • Page : permet d'accéder aux éléments HTML, aux variables de page et au code. Utilisez cette option si vous devez accéder aux variables de page (par exemple, jQuery $) ou interagir avec le code de la page (par exemple, window.alert). L'utilisation de cette option est nécessaire pour résoudre ce problème connu spécifique aux extensions MV3.

Vous pouvez modifier la propriété Monde de l’exécution pour toutes les activités Injecter JavaScript via les paramètres du projet.

Remarque :

The Execution world option is available starting with UiPath.UIAutomation.Activities version 22.12.

Exemple d'utilisation de l'activité Injecter JavaScript (Inject JS Script)

L'activité Injecter JavaScript (Inject JS Script) est utilisée pour ouvrir un navigateur et traiter les fichiers .js dans ces pages. Les extensions de navigateur doivent être installées et activées.

Pour illustrer comment utiliser cette activité, nous avons créé un exemple qui ouvre un navigateur et affiche une alerte avec le texte spécifié par l'utilisateur.

Voici comment le processus d'automatisation peut être créé :

1. Ouvrez Studio et démarrez un nouveau Processus.
   Remarque :

   Assurez-vous de placer le fichier .js dans le dossier du projet. Pour cet exemple, nous avons utilisé le fichier example.js.

2. Drag a Sequence to the Workflow Designer.

   • Créez les variables suivantes :

     Nom de variable	Types de variables	Valeur par défaut
     TextToWrite	ValeurGénérique

3. Faites glisser une activité Boîte de dialogue (Input Dialog) dans le conteneur Séquence.
   • In the Properties panel, add the name Ask for message in the DisplayName field.
   • Ajoutez l’expression "Please insert the text to be written on the web page." dans le champ Libellé.
   • Ajoutez le message "Please insert text" dans le champ Titre.
   • Ajoutez la variable textToWrite dans le champ Résultat.
4. Faites glisser une activité Ouvrir le navigateur (Open Browser) sous l’activité Boîte de dialogue (Input Dialog).
   • Ajoutez l’adresse "https://www.google.com/" dans le champ URL.
5. Faites glisser un Injecter JavaScript (Inject JS Script)S dans le conteneur Body de l’activité Ouvrir le navigateur (Open Browser).
   • Dans le panneau Propriétés, ajoutez la variable Show Alert dans le champ Afficher le nom.
   • Ajoutez la variable TextToWrite dans le champ ParamètreEntrée.
   • Ajoutez l’expression "Inject JS\example.js" dans le champ CodeScript.
6. Exécutez le processus. Le robot ouvre une nouvelle page de navigateur et fournit l'alerte avec le texte que vous avez ajouté.

Téléchargez l'exemple