Inject Js Script

UiPath.Core.Activities.NInjectJsScript

Descripción

Ejecuta el código JavaScript en el contexto de la página web correspondiente a UiElement.

Esta actividad debe añadirse dentro de una actividad Usar aplicación/navegador.

Para utilizar esta actividad fuera de una actividad Usar aplicación/navegador, debe proporcionar un elemento de entrada.

Esta actividad es compatible con el repositorio de objetos.

Compatibilidad de proyectos

Windows: heredado | Windows | Multiplataforma

Windows (heredado), configuración de Windows

Panel del Diseñador

• Haz clic en Indicar en aplicación / navegador para indicar el elemento de IU que se utilizará como destino.

  Después de indicar el destino, seleccione el menú para acceder a las siguientes opciones:

  • Indicar destino en pantalla: indica de nuevo el destino.
  • Editar objetivo : abre el modo de selección para configurar el objetivo.
  • Eliminar captura de pantalla informativa : elimina la captura de pantalla de la aplicación o página web de destino.
  • Añadir al repositorio de objetos : añade el elemento de IU actual a un proyecto de biblioteca, desde donde pueda reutilizarse en todo el proceso de automatización.
• Código descript: el código JavaScript que quieres ejecutar. Puedes escribirlo aquí como una cadena o añadir la ruta completa de un archivo .js que contenga el código a ejecutar. Debe contener una única función anónima, como en el siguiente ejemplo:

  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;
  }

  Donde element representa el elemento HTML correspondiente al nodo de la IU que llama, y input representa la cadena de entrada facilitada por el llamante.
• ParámetroDeEntrada: datos de entrada para el código JavaScript, como cadena o variable de cadena.
• Guardar salida de script en : dónde guardar el resultado del código JavaScript.

Panel de propiedades

Común

• Continuar en caso de error : especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso. Como resultado, si el campo está en blanco y se produce un error, se detiene la ejecución del proyecto. Si el valor se establece en Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

• Retraso después de : retraso (en segundos) entre el momento en que se completa esta actividad y el momento en que la siguiente actividad inicia cualquier operación. El valor predeterminado es 0,3 segundos. Agregar un retraso entre actividades garantiza que una actividad tenga tiempo suficiente para completarse antes de que comience la siguiente.

• Retraso antes de: retraso (en segundos) entre la hora a la que se termina la actividad anterior y la hora a la que esta actividad empieza a ejecutar operaciones. El valor predeterminado es 0,2 segundos. Añadir un retraso entre actividades garantiza que una actividad tiene tiempo suficiente para completarse antes de que comience la actividad siguiente.

• Nombre paramostrar : el nombre que se muestra para la actividad en el panel Diseñador. Se genera automáticamente un nombre para mostrar cuando indica un destino.

• Tiempo de espera: especifica la cantidad de tiempo (en segundos) que se debe esperar a que se ejecute la actividad antes de arrojar un error. El valor predeterminado es 30 segundos.

Entrada

• Parámetro de entrada : consulta Parámetro de entrada en el panel Diseñador.
• Código de script : consulta Código de script en el panel Diseñador.
• Destino : el elemento de destino. Se debe establecer el elemento de destino. Antes de indicarlo en la pantalla, este campo se establece como (null). Una vez que se indica el destino, se muestran todas las propiedades relacionadas con el elemento que se indicó.
  • Tipo de control CV : indica el tipo de control identificado mediante Computer Vision.
  • Texto de CV : indica el texto identificado mediante Computer Vision.
  • Selector difuso : los parámetros para el selector difuso.
  • Texto nativo : el texto que se utiliza para identificar el elemento de la interfaz de usuario.
  • Páginas web dinámicas: habilita el diseño de páginas web dinámicas.
  • Selector estricto: el selector estricto generado para el elemento de IU.
  • Métodos de destino: los tipos de selectores que quieres utilizar para identificar el elemento. Esta propiedad se puede establecer en cualquier combinación del menú desplegable:
    • Ninguno
    • Selector estricto
    • Selector difuso
    • Imagen
    • Texto nativo
    • Computer Vision: para utilizar Computer Vision como método de orientación, debes ir a Configuración del proyecto > Computer Vision y asegurarte de establecer el punto final del servidor correcto. Puedes dejar este campo tal como está y utilizar UiPath Cloud, que se rellena de forma predeterminada, o puedes introducir otro valor seleccionando cualquiera de los otros puntos finales públicos específicos de una región del servidor o tu propio servidor local.

      Otra forma de utilizar Computer Vision como método de orientación es establecer Usar servidor local en Verdadero. Esto implica que el paquete UiPath.ComputerVision.LocalServer se instale en tu proyecto. Cuando el servidor local está habilitado, el valor del servidor se sobrescribe. Sin embargo, el servidor local no está disponible en proyectos multiplataforma.

  • Comprobación devisibilidad: comprueba si el elemento de la IU está visible o no. Puedes elegir una de las tres opciones del menú desplegable:
    • Ninguno : no comprueba la visibilidad.
    • Interactivo (para selector difuso) : opción predeterminada. Comprueba si el elemento es potencialmente visible, ignorando el desplazamiento de página y las obstrucciones de otras aplicaciones, o el hecho de que la aplicación está minimizada. Esta comprobación es útil cuando intenta asegurarse de que no está apuntando a elementos invisibles que existen en el DOM pero que están ocultos.
    • Totalmente visible : comprueba si el elemento de la IU está visible o no.
  • Esperar a que se cargue la página : antes de realizar las Actions, espera a que la aplicación esté lista para aceptar la entrada. Puedes elegir una de las tres opciones del menú desplegable:
    • Ninguno: No espera a que el objetivo esté listo.
    • Interactivo: espera hasta que se cargue solo una parte de la aplicación.
    • Completo: espera a que se cargue la aplicación completa.
  • Selector de ventana (instancia de aplicación) : el selector que se utiliza para la ventana de la aplicación. Solo se aplica cuando el modo de agregación de ventana está establecido en Instancia de aplicación.

Elemento de entrada/salida

• Elemento deentrada: el elemento de IU en el que se ejecuta la actividad, almacenado en un objeto UIElement . Este campo solo admite UIElement objetos. Este objeto se puede obtener del campo de propiedad Elemento de salida de otras actividades de automatización de IU.
• Elemento desalida : genera un elemento de IU de destino y lo almacena en un objeto UIElement , que puede usarse para señalar el mismo elemento con otras actividades.

Otros

• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso.

Opciones

• Mundo de ejecución : el entorno de JavaScript para la ejecución del script. Elija dos opciones en el menú desplegable:
  • Aislado: permite el acceso a los elementos HTML, pero evita el acceso a las variables de página y código. Utiliza esta opción para asegurarte de que la ejecución del script no entra en conflicto con la página.Esta es la selección predeterminada.
  • Página : permite el acceso a los elementos HTML, las variables de la página y el código. Utiliza esta opción si tienes que acceder a las variables de la página (p. Ej., jQuery $) o interactuar con el código de la página (p. Ej., window.alert). Es necesario usar esta opción para solucionar este problema conocido específico de las extensiones MV3.

  Puedes cambiar la propiedad del Mundo de ejecución para todas las actividades de Inject Js Script a través de la configuración del Proyecto.

Salida

• Salida descript : el resultado de la cadena devuelto desde el código JavaScript.

Configuración multiplataforma

• Indicar destino en pantalla : indica el elemento de la IU que se usará como destino.

  Después de indicar el destino, selecciona el botón más para acceder a las siguientes opciones:

  • Indicar destino en pantalla: indica de nuevo el destino.
  • Editar objetivo : abre el modo de selección para configurar el objetivo.
• Código descript: el código JavaScript que quieres ejecutar. Puedes escribirlo aquí como una cadena o añadir la ruta completa de un archivo .js que contenga el código a ejecutar. Debe contener una única función anónima, como en el siguiente ejemplo:

  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;
  }

  Donde element representa el elemento HTML correspondiente al nodo de la IU que llama, y input representa la cadena de entrada facilitada por el llamante.

Opciones adicionales

Plazos

• Retraso antes de: retraso (en segundos) entre la hora a la que se termina la actividad anterior y la hora a la que esta actividad empieza a ejecutar operaciones. El valor predeterminado es 0,2 segundos. Añadir un retraso entre actividades garantiza que una actividad tiene tiempo suficiente para completarse antes de que comience la actividad siguiente.

• Retraso después de : retraso (en segundos) entre el momento en que se completa esta actividad y el momento en que la siguiente actividad inicia cualquier operación. El valor predeterminado es 0,3 segundos. Agregar un retraso entre actividades garantiza que una actividad tenga tiempo suficiente para completarse antes de que comience la siguiente.

• Tiempo de espera: especifica la cantidad de tiempo (en segundos) que se debe esperar a que se ejecute la actividad antes de arrojar un error. El valor predeterminado es 30 segundos.

• Continuar en caso de error : especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso. Como resultado, si el campo está en blanco y se produce un error, se detiene la ejecución del proyecto. Si el valor se establece en Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

Opciones

• Mundo de ejecución : el entorno de JavaScript para la ejecución del script. Elija dos opciones en el menú desplegable:
  • Aislado: permite el acceso a los elementos HTML, pero evita el acceso a las variables de página y código. Utiliza esta opción para asegurarte de que la ejecución del script no entra en conflicto con la página.Esta es la selección predeterminada.
  • Página : permite el acceso a los elementos HTML, las variables de la página y el código. Utiliza esta opción si tienes que acceder a las variables de la página (p. Ej., jQuery $) o interactuar con el código de la página (p. Ej., window.alert). Es necesario usar esta opción para solucionar este problema conocido específico de las extensiones MV3.

  Puedes cambiar la propiedad del Mundo de ejecución para todas las actividades de Inject Js Script a través de la configuración del Proyecto.

Salida

• Salida descript : el resultado de la cadena devuelto desde el código JavaScript.

Entrada/Salida

• Elemento deentrada: el elemento de IU en el que se ejecuta la actividad, almacenado en un objeto UIElement . Este campo solo admite UIElement objetos. Este objeto se puede obtener del campo de propiedad Elemento de salida de otras actividades de automatización de IU.
• Elemento desalida : genera un elemento de IU de destino y lo almacena en un objeto UIElement , que puede usarse para señalar el mismo elemento con otras actividades.