paquete DLL

Un archivo de biblioteca de enlace dinámico (dynamic-link library, DLL) contiene una biblioteca compartida de funciones que pueden ser utilizadas por los programas de Windows. El paquete DLL utiliza un archivo .dll como referencia y funciones de llamada desde el bot.

Antes de comenzar

Realice las siguientes acciones dentro del paquete DLL como parte del uso del conjunto de acciones disponibles:
Nota:
  • Si crea bots usando un DLL personalizado, y el DLL personalizado tiene una dependencia en la biblioteca log4net de Apache, entonces recomendamos usar:
    • log4net versión 2.0.11 o posterior en el DLL personalizado.
    • Actualice el Agente de bot (versión 21.210 o posterior) aunque la actualización del Agente de bot sea opcional.
  • Solo se admiten los DLL creados con Microsoft .NET Framework.
  • El paquete Ejecutar DLL es compatible con las siguientes versiones de Microsoft .NET: 4.6, 4.7 y 4.8.
  • Cuando cree un bot y utilice la sesión local con bucle, asegúrese de utilizar la acción cerrar sesión en el bot. Si no se utiliza el comando de cierre de sesión, la sesión local abrirá AutomationAnywhere.ManagedDLLWrapper.exe con cada iteración del bucle. Como resultado, se quedará sin espacio en la memoria y el bot fallará.
Important: Si se utilizan diferentes versiones del paquete DLL en un bot primario y en un bot secundario, la capacidad de compartir una sesión entre bots no es compatible actualmente. Para compartir una sesión entre bots primarios y secundarios, asegúrese de que utiliza la misma versión del paquete en los bots primarios y secundarios.
  1. Utilice la acción Abrir para especificar la ubicación del archivo .dll que desea usar y el nombre de sesión. Use el mismo nombre de sesión para las demás acciones. El .dll al que se hace referencia se agrega automáticamente como una dependencia del bot.
  2. Utilice la acción Ejecutar función para ejecutar una función desde el .dll y guardar su valor de salida como variable.
  3. Después de ejecutar las funciones necesarias, cierre la referencia al .dll. Es importante cerrar el .dll de referencia para liberar la memoria del sistema operativo.

    Windows y las versiones adecuadas de Microsoft .NET Framework están disponibles en los dispositivos que ejecutan las DLL.

    Para revisar los registros del iniciador de bot, vaya a C:\ProgramData\AutomationAnywhere\BotRunner\Logs\<current month>\Bot_Launcher-<today's date>.log.zip. Cada carpeta comprimida contiene un archivo con datos sobre la ejecución del código, que es útil para la depuración.

Nota: 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

Cuando se importan múltiples DLL que tienen un DLL principal y se hace referencia a otros DLL desde este, asegúrese de tener todos los DLL en una carpeta. Además, los DLL referenciados deben ser llamados con un nombre de sesión diferente al utilizado en el DLL principal. La ejecución del bot fallará si se utiliza el mismo nombre de sesión tanto en el DLL principal como en los DLL referenciados.

Acciones en el paquete DLL

El paquete DLL incluye las siguientes acciones:

Acción Descripción
Cerrar

Consulte acción Cerrar

Abrir

Consulte acciónAbrir

Ejecutar función (heredada) Consulte Uso de la acción Ejecutar función.
Nota:
  • La acción Ejecutar función (Heredado) ya no está disponible en el paquete de Ejecutar DLL. Le recomendamos que utilice la acción Ejecutar función del paquete de Ejecutar DLL porque esta acción es una versión mejorada de la acción Ejecutar función (Heredado).

    Tenga en cuenta que los bots existentes que utilizan Ejecutar función (Heredado) seguirán ejecutándose correctamente sin ningún problema.

  • Esta acción se denomina Ejecutar función (heredada) desde Enterprise A2019.16. La acción se llama Ejecutar función en Enterprise A2019.15 y versiones anteriores.
Ejecutar función Consulte Uso de la acción Ejecutar función.

Tipos de datos admitidos en las funciones de DLL

La siguiente tabla contiene las variables y los tipos de datos que se pueden utilizar como parámetro de entrada o salida en las funciones DLL.
Nota: Las acciones Ejecutar función y Ejecutar función (heredada) no admiten ningún tipo de dato definido por el usuario en los campos Parámetros de la función o Asignar salida a variable.
Tipo de variable como parámetros de entrada o salida Tipos de datos admitidos en .NET
Cadena
  • Char
  • Byte
  • Cadena
  • cadena
  • SByte
Número
  • Estudio UInt16
  • Estudio Int16
  • Estudio UInt32
  • Estudio Int32
  • Estudio UInt64
  • Estudio Int64
  • Int
  • Simple
  • Decimal
  • Float
  • Doble
Booleano
  • Booleano
  • bool
Fecha y hora
  • Fecha y hora
Lista
  • UInt16[]
  • Int16[]
  • Int32[]
  • Int64[]
  • Int[]
  • Char[]
  • Simple[]
  • Decimal[]
  • Float[]
  • Doble[]
  • Booleano[]
  • bool[]
  • Byte[]
  • Cadena[]
  • Fecha y hora[]
  • Lista<UInt16>
  • Lista<Int16>
  • Lista<Int32>
  • Lista<Int64>
  • Lista<Int>
  • Lista<Char>
  • Lista<Single>
  • Lista<Decimal>
  • Lista<Float>
  • Lista<Double>
  • Lista<Boolean>
  • Lista<bool>
  • Lista<Byte>
  • Lista<String>
  • Lista<Datetime>
  • Lista<SByte>
  • Lista<UInt32>
  • Lista<UInt64>
Nota: El tipo de datos IList de C# no es compatible y no funciona con el tipo de datos de lista de Automation 360.
Tabla
  • UInt16[,]
  • Int16[,]
  • Int32[,]
  • Int64[,]
  • Int[,]
  • Char[,]
  • Simple[,]
  • Decimal[,]
  • Float[,]
  • Doble[,]
  • Booleano[,]
  • bool[,]
  • Byte[,]
  • Cadena[,]
  • Fecha y hora[,]
  • Byte[,]
  • UInt32[,]
  • UInt64[,]
Nota: La variable de tipo Tabla equivale a una variable de tipo matriz bidimensional en .NET.
Diccionario
  • Diccionario<String,UInt16>
  • Diccionario<String,Int16>
  • Diccionario<String,Int32>
  • Diccionario<String,Int64>
  • Diccionario<String,Int>
  • Diccionario<String,Char>
  • Diccionario<String,Single>
  • Diccionario<String,Decimal>
  • Diccionario<String,Float>
  • Diccionario<String,Double>
  • Diccionario<String,Boolean>
  • Diccionario<String,bool>
  • Diccionario<String,Byte>
  • Diccionario<String,String>
  • Diccionario<String,Datetime>
  • Diccionario<Int,String>
  • Diccionario<Decimal,String>
  • Diccionario<Boolean,String>
  • Diccionario<String,SByte>
  • Diccionario<String,UInt32>
  • Diccionario<String,UInt64>
Nota: Para crear la función DLL de .Net, utilice el tipo de datos IDictionary en lugar del tipo de datos Dictionary.