Uso de la acción Ejecutar función

Use la acción Ejecutar función para ejecutar una función dentro del archivo .dll y especifique los parámetros para pasar una función y guardar la salida como una variable.

  • Esta acción le permite pasar un parámetro de cualquier tipo.
  • La acción Run function (Ejecutar función) no admite el uso de formularios de Windows.
  • Si el archivo .dll utiliza funciones o clases .NET de otro archivo .dll, debe agregar el segundo archivo .dll como dependencia manual del bot.

    Dependencias de Bot

  • Esta acción soporta funciones sobrecargadas a partir de Enterprise A2019.17. La acción puede manejar archivos .dll que contienen múltiples funciones del mismo nombre. Llama a la función según el número de parámetros pasados.
  • Cuando utilice esta acción, asegúrese de utilizar los tipos de datos compatibles para las funciones DLL.

    paquete DLL

Procedimiento

Realice los siguientes pasos para ejecutar una función:

  1. En la paleta Acciones, haga doble clic o arrastre la acción Ejecutar función desde el paquete DLL.
  2. En el campo Session name (Nombre de sesión), escriba un nombre para la sesión.
  3. En el campo Ingresar el espacio de nombres (opcional), especifique el espacio de nombres.
    Puede especificar cualquiera de los nombres definidos en el archivo DLL.
    Nota: Asegúrese de que el valor que proporcionó sea el correcto.
    Importante: Este campo distingue mayúsculas de minúsculas.
  4. En el campo Enter the class name (Escribir el nombre de clase), especifique el nombre de la clase que desea utilizar.
    Puede especificar el nombre de cualquiera de las clases disponibles en el espacio de nombres.
    Importante: Este campo distingue mayúsculas de minúsculas.
  5. En el campo Enter the name of function to be executed (Ingresar el nombre de la función que se va a ejecutar), especifique el nombre de la función que desea ejecutar.
    Asegúrese de que el nombre que proporcionó sea correcto y esté disponible en la clase especificada en el paso anterior.
    Importante: Este campo distingue mayúsculas de minúsculas.
  6. Opcional: En la sección Input parameters (Parámetros de entrada), haga clic en el botón Add Parameters (Agregar parámetros).
    1. En el campo Parameter name (Nombre del parámetro) de DLL parameter details (Detalles del parámetro DLL), ingrese el nombre del parámetro.
    2. Desde la lista Parameter type (Tipo de parámetro), seleccione un tipo de datos.
      Para el tipo de datos Integer (Enteros) (UInt16, Int16, Int32, Int64, Int, Single, Float, Decimal, Double, UInt32 o UInt64), puede utilizar un valor de una Credential Vault o una variable de credencial como parámetro de entrada.
    3. En el campo value (valor), ingrese el valor que desea pasar.
      Si selecciona el tipo de datos Integer (Entero), puede elegir entre las siguientes opciones:
    • Number (Número): En el campo de número, ingrese el valor que desea pasar.

    • Credencial: Para utilizar un valor de una Credential Vault, seleccione Credential (Credencial). Para utilizar una variable de credencial, seleccione Variable.
    Para obtener más información sobre las Credential Vault y cómo utilizarlas, consulte Credenciales y casilleros en Credential Vault.
    Repita el Paso 6 para agregar varios parámetros.
    Importante: Los nombres de los parámetros que agrega y su orden deben ser los mismos que en la función DLL.
  7. Utilizar la opción Ejecutar función en segundo plano cuando no se llamen operaciones relacionadas con el sistema Windows, como pulsaciones de teclas, clic de mouse o cambiar de ventana, en el DLL de C#. Puede seleccionar la casilla de verificación Ejecutar función en segundo plano para omitir la ventana intermedia (AAZeroSizeForm) y ejecutar el DLL de C# en la aplicación de consola sin el formulario. Le recomendamos que seleccione esta casilla de verificación si la función DLL no interactúa con la API de Windows para realizar operaciones como pulsaciones de teclas, clic de mouse o cambio de ventanas. Esta función también ayuda a mejorar el rendimiento de la ejecución de DLL si la opción Ejecutar la función en segundo plano está seleccionada.
  8. Opcional: En la lista Assign output to variable (Asignar el resultado a una variable), seleccione una variable para usar en el almacenamiento de la salida de la función.
    Puede usar los tipos de variables booleana, de fecha y hora, de diccionario, de lista, numérico, de cadena o tabla para almacenar la salida según el tipo de salida que retorna la función.
  9. Haga clic en Guardar.