pacote DLL

Um arquivo de DLL (Dynamic-Link Library, link dinâmico de biblioteca) contém uma biblioteca compartilhada de funções que podem ser usadas pelos programas Windows. O pacote DLL usa um arquivo .dll como referência e chama funções do bot.

Antes de começar

Execute as seguintes ações dentro do pacote DLL como parte do uso do conjunto de ações disponíveis:
Nota:
  • As funções de DLL de 32 bits são suportadas, pois o AutomationAnywhere.ManagedDLLWrapper.exe utiliza bibliotecas de 32 bits.
  • Se você criar bots usando DLL personalizadas, e a DLL personalizada tiver uma dependência da biblioteca Apache log4net, então recomendamos utilizar:
    • log4net versão 2.0.11 ou posterior na DLL personalizada.
    • Atualize a Agente de bot (versão 21.210 ou posterior) mesmo que a Agente de bot atualização seja opcional.
  • Somente as DLLs construídas utilizando o Microsoft .NET Framework são apoiados.
  • O Executar DLL pacote é compatível com as seguintes versões do Microsoft .NET: 4.6, 4.7 e 4.8.
  • Quando você cria um bot e usar a sessão local com loop, certifique-se de que usará a ação de sessão de encerramento no bot. Se você não usar o comando da sessão de encerramento, a sessão local será aberta AutomationAnywhere.ManagedDLLWrapper.exe com cada iteração do loop. Como resultado, você ficará sem espaço de memória e o bot falhará.
Importante: Se você usar versões diferentes de um pacote DLL em um bot principal e um bot secundário, a capacidade de compartilhar uma sessão através de bots não é atualmente suportado. Para compartilhar uma sessão entre bots principal e secundário, assegure-se de utilizar a mesma versão do pacote tanto no principal como no secundário bots.
  1. Use a ação Abrirpara especificar a localização do arquivo .dll que deseja usar e o nome da sessão. Use o mesmo nome de sessão para a outra ações. O .dll mencionado é automaticamente adicionado como uma dependência do bot.
  2. Use a ação Executar função para executar uma função do .dll e salvar o valor de saída como variável.
  3. Após executar as funções necessárias, feche a referência .dll. É importante fechar a referência .dll para liberar a memória do sistema operacional.

    Versões do Windows e versões adequadas do Microsoft .NET Framework estão disponíveis nos dispositivos que executam DLLs.

    Para rever o bot lançador de logs, navegue para C:\ProgramData\AutomationAnywhere\BotRunner\Logs\<current month>\Bot_Launcher-<today's date>.log.zip. Cada pasta zipada contém um arquivo com dados sobre a execução do código, que é útil para a depuração.

Nota: Se o arquivo .dll usar funções .NET ou classes de outro arquivo .dll, você deverá adicionar o segundo arquivo .dll como dependência manual do bot.

Dependências Bot

Quando você importar várias DLLs que tenham uma DLL principal e outras DLLs são referenciadas a partir dela, certifique-se de ter todas as DLLs em uma pasta. Além disso, as DLLs referenciadas devem ser chamadas usando um nome de sessão que seja diferente do nome usado nas DLLs principais. A execução de seu bot falhará se o mesmo nome de sessão for usado tanto nas DLLs principal como nas DLLs referenciadas.

Ações no pacote DLL

O pacote DLL inclui as seguintes ações:

Ação Descrição
Fechar

Consulte ação Fechar

Abrir

Consulte ação Abrir

Executar função Consulte Usando a ação Executar função.

Tipos de dados compatíveis com funções DLL

A tabela a seguir lista as variáveis e tipos de dados que você pode usar como parâmetro de entrada ou saída em funções DLL.
Nota: A ação Executar função não é compatível com nenhum tipo de dado definido pelo usuário no campo Parâmetro para a função ou Atribuir saída à variável.
Tipo variável como parâmetros de entrada ou saída Tipos de dados compatíveis com .NET
String
  • Char
  • Byte
  • String
  • string
  • SByte
Número
  • UInt16
  • Int16
  • UInt32
  • Int32
  • UInt64
  • Int64
  • Int
  • Único
  • Decimal
  • Float
  • Duplo
Booliano
  • Booliano
  • bool
Data/hora
  • Data/hora
Lista
  • UInt16[]
  • Int16[]
  • Int32[]
  • Int64[]
  • Int[]
  • Char[]
  • Single[]
  • Decimal[]
  • Float[]
  • Double[]
  • Boolean[]
  • bool[]
  • Byte[]
  • String[]
  • Datetime[]
  • 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: O tipo de dados C# IList não é compatível e não funciona com o tipo de dados da Lista Automation 360.
Tabela
  • UInt16[,]
  • Int16[,]
  • Int32[,]
  • Int64[,]
  • Int[,]
  • Char[,]
  • Single[,]
  • Decimal[,]
  • Float[,]
  • Double[,]
  • Boolean[,]
  • bool[,]
  • Byte[,]
  • String[,]
  • Datetime[,]
  • Byte[,]
  • UInt32[,]
  • UInt64[,]
Nota: A variável do tipo Tabela é equivalente a uma variável do tipo array bidimensional em .NET.
Dicionário
  • Dicionário<String,UInt16>
  • Dicionário<String,Int16>
  • Dicionário<String,Int32>
  • Dicionário<String,Int64>
  • Dicionário<String,Int>
  • Dicionário<String,Char>
  • Dicionário<String,Single>
  • Dicionário<String,Decimal>
  • Dicionário<String,Float>
  • Dicionário<String,Double>
  • Dicionário<String,Boolean>
  • Dicionário<String,bool>
  • Dicionário<String,Byte>
  • Dicionário<String,String>
  • Dicionário<String,Datetime>
  • Dicionário<Int,String>
  • Dicionário<Decimal,String>
  • Dicionário<Boolean,String>
  • Dicionário<String,SByte>
  • Dicionário<String,UInt32>
  • Dicionário<String,UInt64>
Nota: Ao criar a função DLL .Net, use o tipo de dados IDictionary em vez do tipo de dados Dictionary.