acción Llamar a una función de JavaScript

La acción Llamar a JavaScript en el paquete Navegador permite llamar a una función JavaScript existente directamente en una página web o en un iFrame dentro de una página web.

Configurar los ajustes

Nota: Esta opción es compatible con los navegadores Google Chrome y Microsoft Edge basados en Chromium.
  1. Seleccione la pestaña del navegador de la lista de pestañas del navegador activas compatibles o inserte una variable de ventana.

    Puede utilizar una expresión común (lo que se suele llamar regex) para identificar el título de una ventana. Seleccione la condición de expresión regular como Cadena o un Patrón y, a continuación, introduzca el valor. De forma predeterminada, el campo Título de la ventana distingue entre mayúsculas y minúsculas.

    Para identificar el título de un navegador, puede habilitar la opción Distinguir mayúsculas para que identifique las mayúsculas y minúsculas, o deshabilitar la opción para identificar un título de la ventana en el que no coincidan las mayúsculas y minúsculas.
    Nota: Asegúrese de que la versión mínima del Agente de bot instalada en su sistema sea la versión publicada con Automation 360 v.26. Si tiene una versión de Agente de bot publicada con Automation 360 v.25 o anterior, el título de la ventana se identificará de forma predeterminada solo con las mayúsculas y minúsculas correspondientes (distinción de mayúsculas).
    Por ejemplo, para hacer coincidir todos los nombres de títulos de ventanas que comienzan con una palabra seguida de - Notepad, puede ingresar el valor Cadena como * -Notepad o utilizar el valor Patrón como ((\w)\s)*document-Notepad solo para aquellos títulos de ventana que coincidan con este patrón.
    Nota:
    • Cuando se utiliza una expresión regular de tipo Cadena con -title como valor de entrada para el título de una ventana en cualquier acción, el bot podría detectar un error del tiempo de ejecución. Para evitar un error de tiempo de ejecución, asegúrese de que cuando agregue la cadena de entrada como *-title, se abra la aplicación con el título específico. El asterisco (*) es solo un carácter y no un carácter comodín.
    • Cuando se utiliza una expresión regular de tipo Patrón con -title como valor de entrada para un título de ventana en cualquier acción, el bot podría detectar un error de tiempo de ejecución, ya que el valor de entrada *-title es incorrecto.

      Asegúrese de utilizar patrones regex válidos.

  2. Opcional: Usar la opción Capturar objeto para capturar los iFrames.
    Nota: Puede utilizar la característica Objeto de captura para llamar y ejecutar una función JavaScript existente dentro de un iFrame.
  3. En el campo Nombre de la función, especifique el nombre de la función JavaScript existente que desea llamar.
  4. Opcional: En la sección Argumentos, haga clic en Agregar argumento para añadir los argumentos que se deben pasar para llamar a la función de JavaScript.
    1. En el cuadro de diálogo Detalles de los argumentos, seleccione el Tipo de argumento necesario para el argumento específico.
    2. En el campo valor, introduzca el valor o variable correspondiente del tipo seleccionado que desea pasar.
      Nota: Todos los valores de cadena de los argumentos se pasan tal cual, sin convertir ni quitar ningún carácter.
  5. Opcional: En el campo Tiempo de espera después de, escriba el número de segundos que el bot debe esperar para que la acción de la página web se complete.
    Nota: Ingrese un valor de tiempo de espera de al menos 9 segundos.
  6. En el campo Tipo de retorno, seleccione el tipo de valor devuelto por la función JavaScript.
    Nota: Si la función no devuelve nada, en el campo Tipo de devolución, seleccione Ninguna.
  7. Para cualquier Tipo de retorno, excepto Ninguno, en el campo Guardar el resultado en una variable, seleccione una variable para el Tipo de retorno seleccionado para contener la salida de la función JavaScript.

Crear variable

A fin de crear una variable para el Tipo de retorno seleccionado, realice los siguientes pasos:
  1. Haga clic en el símbolo Crear variable junto al campo Guardar el resultado en una variable.

    Se abre un cuadro de diálogo Crear variable con el nombre de la variable predeterminado para el tipo de variable seleccionada.

  2. Opcional: Especifique la información de la variable en el campo Descripción.
  3. Opcional: Especifique un valor en el campo Valor predeterminado.
  4. Haga clic en Crear & seleccionar para seleccionar la variable recién creada.

Tipos de JavaScript admitidos en los campos Argumento y Tipo de retorno

Los siguientes tipos de JavaScript son compatibles:

  • Los tipos de cadena, número y booleanos de JavaScript se corresponden con los mismos tipos de variables en las variables del bot.
  • El tipo de matriz JavaScript que se corresponde con el tipo de variable List en las variables del bot.
  • El tipo de objeto de JavaScript que se corresponde con el tipo de variable Dictionary en las variables del bot.