package 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 package DLL utiliza un archivo .dll como referencia y funciones de llamada desde el bot.

Antes de comenzar

Realice las siguientes actions dentro del package DLL como parte del uso del conjunto de actions disponibles:
Nota:
  • Las funciones DLL de 32 bits son compatibles, ya que AutomationAnywhere.ManagedDLLWrapper.exe utiliza bibliotecas de 32 bits.
  • 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 Bot Agent (versión 21.210 o posterior) aunque la actualización del Bot Agent sea opcional.
  • Solo se admiten los DLL creados con Microsoft .NET Framework.
  • El package de Run 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 action 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á.
Importante: Si se utilizan diferentes versiones del package 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 action 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 actions. El .dll al que se hace referencia se agrega automáticamente como una dependencia del bot.
  2. Utilice la action 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.

Actions en el package DLL

El package DLL incluye las siguientes actions:

Action Descripción
Cerrar

Consulte action Cerrar

Abrir

Consulte actionAbrir

Ejecutar función Consulte Uso de la action 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: La action Ejecutar función no admite ningún tipo de dato definido por el usuario en los campos Parámetro 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
String
  • Char
  • Byte
  • String
  • string
  • SByte
Número
  • UInt16
  • Int16
  • UInt32
  • Int32
  • UInt64
  • 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[]
  • String[]
  • 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[,]
  • String[,]
  • 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.