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:
  • 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 pacote Executar DLL é 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á.
Important: 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 Abrir para especificar a localização do arquivo .dll que você 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

Ver ação Fechar

Abrir

Ver ação Abrir

Função de execução (legado) Consulte Como usar a ação Executar função.
Nota:
  • O Função Run (Legado)ação não está mais disponível no Executar DLLpacote. Recomendamos que você utilize o Run Function (Função Run) ação do Executar DLL pacote porque este ação é uma versão melhorada do Função Run (Legado) ação.

    Note que os bots que utilizam o Função Run (Legado) continuará a funcionar com sucesso sem nenhum problema.

  • Essa ação é chamada Executar função (legado) a partir da Enterprise A2019.16. A ação é chamada Executar função no Enterprise A2019.15 e versões anteriores.
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: As ações Executar função e Executar função (legado) não são compatíveis 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[]
  • List<UInt16>
  • List<Int16>
  • List<Int32>
  • List<Int64>
  • List<Int>
  • List<Char>
  • List<Single>
  • List<Decimal>
  • List<Float>
  • List<Double>
  • List<Boolean>
  • List<bool>
  • List<Byte>
  • List<String>
  • List<Datetime>
  • List<SByte>
  • List<UInt32>
  • List<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.