ação Chamar uma função JavaScript

A ação Chamar uma função JavaScript no pacote Navegador permite chamar uma função JavaScript existente direto em uma página da web ou em um iFrame dentro de uma página da web. Essa ação também permite que você chame uma função JavaScript em aplicativos Chromium Embedded Framework (CEF) de desktop.

Configurar as definições

Nota:
  • Esta opção é compatível com os navegadores Google Chrome, Microsoft Edge e baseado em Chromium.
  • Esta ação oferece suporte a aplicativos de desktop baseados em CEF.
  1. Selecione a guia do navegador da lista de guias do navegador compatíveis ativas ou insira uma variável de janela. Para chamar uma função JavaScript em aplicativos CEF, use a guia Aplicativo. Na guia Aplicativo, selecione o aplicativo CEF específico na lista de aplicativos. Um aplicativo CEF integra a funcionalidade de navegador web ao incorporar o Chromium em um aplicativo de desktop.
    Importante:
    • Para automatizar aplicativos de desktop que utilizam a estrutura CEF, é necessário desenvolver e executar as automações em modo elevado. Consulte .
    • Para automatizar aplicativos CEF, certifique-se de usar o pacote Navegador versão 3.13.1 e posterior.
    Nota:
    • Automatizar iFrame de domínio cruzado em aplicativos CEF não é suportado.
    • Os aplicativos CEF não serão listados na guia Navegador.

    Você pode usar uma expressão regular (regex) para identificar um título da janela. Selecione a condição de expressão regular como String ou Padrão e, em seguida, insira o valor. Por padrão, o campo Título da janela diferencia maiúsculas e minúsculas.

    Para identificar um título do navegador, ative a opção Maiúsculas e minúsculas para corresponder às letras maiúscula e minúscula ou desativar a opção para identificar uma janela em que Maiúsculas e minúsculas não correspondam.
    Nota: Garanta que a versão do Agente de bot instalado em seu sistema é a versão lançada com o Automation 360 v.26. Se você tiver uma versão de Agente de bot lançada com Automation 360 v.25 ou anterior por padrão, então o título da janela ainda será identificado apenas com letras maiúsculas correspondentes (sensível a maiúsculas e minúsculas) por padrão.
    Por exemplo, para corresponder a todos os nomes de títulos de janelas que começam com uma palavra seguida por - Notepad, você pode inserir o valor da String como * -Notepad ou usar o valor Padrão como ((\w)\s)*document-Notepad para apenas os títulos das janelas que correspondem a esse padrão.
    Nota:
    • Quando você usa uma expressão regular do tipo String com -title como o valor de entrada para um título de janela em qualquer ação, o bot pode encontrar um erro de tempo de execução. Para evitar o erro de tempo de execução, assegure-se de que quando você adicionar a entrada de string como *-title, o aplicativo com o título específico está aberto. O asterisco (*) é apenas um caractere e não um caractere curinga.
    • Quando você usa uma expressão regular do tipo Padrão com -title como o valor de entrada para um título de janela em qualquer ação, o bot pode encontrar um erro de tempo de execução, uma vez que o valor de entrada *-title está incorreto.

      Assegure-se de utilizar padrões regex válidos.

  2. Opcional: usa a opção Coletar objeto para capturar os iFrames.
    Nota: Use a função Coletar objeto para chamar e executar uma função JavaScript existente dentro de um iFrame.
  3. No campo Nome da função, especifique o nome da função JavaScript existente que você pretende executar.
  4. Opcional: Na seção Argumentos, clique em Adicionar argumento para adicionar argumentos que devem ser passados para chamar a função JavaScript.
    1. Na caixa de diálogo Detalhes do argumento, selecione o Tipo de argumento necessário para o argumento específico.
    2. No campo valor, introduza o valor ou variável correspondente do tipo selecionado que pretende passar.
      Nota: Todos os valores das strings nos argumentos são passados como estão sem que nenhum caractere seja convertido ou omitido.
  5. Opcional: No campo Tempo esgotado após, insira o número de segundos que o bot deve esperar a conclusão da ação do navegador.
    Nota: Insira um valor de tempo esgotado de pelo menos 9 segundos.
  6. No campo Tipo de retorno, selecione o tipo de argumento para produzir a função JavaScript.
    Nota: Se a função não devolver nada, no campo Tipo de retorno , selecione Nenhum.
  7. Para qualquer Tipo de retorno, exceto Nenhum, no campo Salvar o resultado em uma variável, selecionar uma variável do Tipo de retorno selecionado para manter a saída da função JavaScript.

Criar variável...

Para criar uma variável de um Tipo de retorno selecionado, execute os seguintes passos:
  1. Clique no símbolo Criar variável ao lado do campo Salvar o resultado para uma variável.

    Uma caixa de diálogo Criar variável é aberta com o nome da variável padrão para o tipo de variável selecionada.

  2. Opcional: Especifique as informações da variável no campo Descrição.
  3. Opcional: Especifique um valor no campo Valor padrão.
  4. Clique em Criar e selecionar para selecionar a variável recém-criada.

Tipos de JavaScript suportados nos campos Argumental e Retorno

Os seguintes tipos de JavaScript são suportados:

  • Os tipos de JavaScript String, Number e Boolean correspondem aos mesmos tipos de variáveis em bot variáveis.
  • O tipo JavaScript da matriz corresponde ao tipo de variável List em bot variáveis.
  • O tipo JavaScript corresponde ao tipo de variável Dictionary em bot variáveis.