Usando a ação Executar função

Use a ação Executar função para executar uma função dentro de um arquivo .dll e especifique os parâmetros para passar uma função e armazenar a saída como uma variável.

  • Essa ação permite que você passe um parâmetro de qualquer tipo.
  • A ação Executar função não oferece suporte ao uso do Windows Forms.
  • 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

  • Este ação oferece suporte à funções sobrecarregadas a partir do Enterprise A2019.17. O ação pode lidar com arquivos .dll que contêm múltiplas funções com o mesmo nome. Ele chama a função com base no número de parâmetros passados.
  • Quando usar essa ação, lembre-se de usar os tipos de dados compatíveis com as funções DLL.

    pacote DLL

Procedimento

Execute os seguintes passos para executar uma função:

  1. Na paleta Ações , clique duas vezes ou arraste a ação Executar função do pacote DLL.
  2. No campo Nome da sessão, insira o nome da sessão.
  3. No campo Inserir namespace (opcional), especifique o namespace.
    Você pode especificar qualquer um dos namespaces definidos no arquivo DLL.
    Nota: Certifique-se de que o valor fornecido no campo esteja correto.
    Importante: Esse campo diferencia maiúsculas de minúsculas.
  4. No campo Inserir o nome da classe, especifique o nome da classe.
    Você pode especificar o nome de qualquer classe disponível no espaço de nomes.
    Importante: Esse campo diferencia maiúsculas de minúsculas.
  5. No campo Inserir o nome da função a ser executada, especifique o nome da função que deseja executar.
    Certifique-se de que o nome fornecido esteja correto e disponível na classe especificada na etapa anterior.
    Importante: Esse campo diferencia maiúsculas de minúsculas.
  6. Opcional: Na seção Parâmetros de entrada, clique no botão Adicionar parâmetros.
    1. Na caixa de diálogo Detalhes do parâmetro DLL, no campo Nome do parâmetro, insira o nome do parâmetro.
    2. Na lista Tipo de parâmetro, selecione um tipo de dado.
      Para o tipo de dados Inteiro (UInt16, Int16, Int32, Int64, Int, Single, Float, Decimal, Double, UInt32, ou UInt64), você pode usar um valor de um cofre de credenciais ou uma variável de credencial como parâmetro de entrada.
    3. No campo valor, insira o valor que você deseja passar.
      Se você selecionar o tipo de dados Inteiro, pode escolher entre as seguintes opções:

    • Número: No campo número, insira o valor que você deseja passar.

    • Credencial: Para usar um valor de um cofre de credenciais, selecione Credencial. Para usar uma variável de credencial, selecione Variável.
    Para mais informações sobre cofres de credenciais e como utilizá-los, consulte Credenciais e cofres no Credential Vault.
    Repita a Etapa 6 para adicionar vários parâmetros.
    Importante: Os nomes dos parâmetros que você adiciona e sua ordem devem ser os mesmos da função DLL.
  7. Use a opção Executar função em segundo plano quando nenhuma operação relacionada com o sistema Windows, como por exemplo, toque de tecla, clique do mouse ou mudança de janela, for chamada no C# DLL. Você pode selecionar a caixa de seleção Executar função em segundo plano para ignorar a janela intermediária (AAZeroSizeForm) e executar o C# DLL no aplicativo do console sem o formulário. Recomendamos que você selecione esta caixa de seleção se a função DLL não estiver interagindo com a API do Windows para realizar operações tais como pressionamento de teclas, clique do mouse ou mudança de janela. Esta característica também ajuda a melhorar o desempenho da execução da DLL se a caixa de seleção Executar função em segundo plano estiver selecionada.
  8. Opcional: Na lista Atribuir a saída à variável, selecione a variável que deseja usar para armazenar a saída da função.
    Você pode usar os tipos de variável booliana, data/hora, de dicionário, lista, string ou tabela para armazenar a saída com base no tipo de saída que a função retorna.
  9. Clique em Salvar.