Inject Js Script

UiPath.Core.Activities.NInjectJsScript

Description

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

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.

Compatibilité du projet

Windows - Héritage | Windows | Multiplate-forme

Configuration Windows et multiplate-forme

• Indiquer la cible à l'écran

  • Indiquer l’élément d’IU à utiliser comme cible. 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.

• CodeScript (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 l’exemple ci-dessous :

  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.

Panneau propriétés

Entrée/sortie

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

• InputParameter - Données d'entrée du code JavaScript.

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

• Monde de l’exécution : l’environnement JavaScript pour l’exécution du script. Choisissez dans le menu déroulant d’une deux options :

  • Isolé (Isolated) : permet d'accéder aux éléments HTML, mais empêche l'accès aux variables de page et au code. Utilisez cette option pour vous assurer que l'exécution du script n'entre pas en conflit avec la page. Il s'agit de la sélection par défaut.
  • 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.

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

Cible

• Développer les propriétés de la cible : affiche les propriétés de la cible et de l'ancre. Cela masquera les autres propriétés de l'activité et n'affichera que celles liées à la cible.

• Réduire les propriétés de la cible : masque les propriétés de la cible et de l'ancre. Cela masquera les propriétés liées à la cible et affichera les propriétés de l'activité.

• 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 : le sélecteur strict généré pour l’élément d’IU cible.
  • Sélecteur de correspondances approximatives : les paramètres du sélecteur de correspondances approximatives.
  • 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.
    • 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.
    • Occurrence de texte CV : indique une occurrence spécifique à utiliser lorsque plusieurs correspondances sont trouvées.
    • Précision du texte CV : indique le niveau de précision de la correspondance de texte OCR.
  • 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.
  • Image (Windows uniquement)
    • Précision de l'image : indique le niveau de précision de la correspondance de l'image.
    • Occurrence d'image : indique une occurrence spécifique à utiliser lorsque plusieurs correspondances sont trouvées.
  • Texte natif
    • Texte natif : le texte à trouver pour identifier l’élément d’IU.
    • Occurrence de texte natif : indique une occurrence spécifique à utiliser lorsque plusieurs correspondances sont trouvées.

• Sélecteur de fenêtre : sélecteur de la fenêtre d'application. Uniquement applicable lorsque le mode d’attachement de fenêtre est défini sur instance d’application.

• Attendre le chargement de la page : avant d’effectuer l’action, attendez que l’application soit prête à accepter la saisie. Les options sont les suivantes :

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

• Vérification de visibilité : lorsqu’elle est activée, l’activité vérifie également 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.

• Sites Web réactifs : permet d'activer la mise en page réactive des sites Web.

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 Indiquer dans l’application/le navigateur pour indiquer l’élément d’IU à utiliser comme cible.

Après avoir indiqué la cible, sélectionnez le 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.

• CodeScript (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 l’exemple ci-dessous :

  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.
• Enregistrer la sortie du script vers : où enregistrer le résultat du code JavaScript.

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.

• Paramètre d'entrée : voir Paramètre d'entrée dans le panneau Concepteur.

• Code de script : voir Code de script dans le panneau Concepteur.

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

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

• Monde de l’exécution : l’environnement JavaScript pour l’exécution du script. Choisissez dans le menu déroulant d’une deux options :

  • Isolé (Isolated) : permet d'accéder aux éléments HTML, mais empêche l'accès aux variables de page et au code. Utilisez cette option pour vous assurer que l'exécution du script n'entre pas en conflit avec la page. Il s'agit de la sélection par défaut.
  • 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.

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