ação Executar JavaScript

A ação Executar JavaScript no Navegador pacote executa o JavaScript em uma página da web e em páginas da web que têm iFrames. Essa ação também permite que você execute um snippet JavaScript em aplicativos Chromium Embedded Framework (CEF) de desktop.

Configurações

Nota:
  • Esta ação é compatível com os navegadores Google Chrome e Microsoft Edge baseados em Chromium.
  • Esta ação oferece suporte a aplicativos de desktop baseados em CEF.
  • Quando você usa esta ação para executar um JavaScript que contém um comentário de uma única linha como última linha do JavaScript (por exemplo, //comentário), ela pode fazer com que o Automation Anywhere plugin se torne instável. Recomendamos que você remova o comentário no final do JavaScript ou que o converta em um comentário com várias linhas (por exemplo, /* comentário */).
  • Selecione a guia do navegador da lista de guias do navegador compatíveis ativas ou insira uma variável de janela. Para executar um snippet 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.

  • Escolha uma das seguintes opções:
    • Na opção Importar arquivo existente, selecione um arquivo JavaScript existente.
      Nota: Se estiver fazendo upload de um script a partir de um arquivo em sua área de trabalho, o arquivo e quaisquer dependências devem estar em uma pasta independente. Quando você seleciona um arquivo para fazer upload, o upload de todos os arquivos e pastas é feito no mesmo nível de pasta.
    • Na opção Entrada manual insira o JavaScript.
  • Opcional: usa a opção Coletar objeto para capturar os iFrames.
    Nota:
    • O recurso Coletar objeto é usado apenas para executar o código JavaScript dentro de um iFrame.
    • O suporte para executar o código JavaScript dentro de um iFrame está disponível apenas para o navegador Google Chrome.
    As seguintes propriedades de objeto são selecionadas por padrão ao capturar IFrames:
    • Tipo de navegador
    • Tipo de tecnologia
    • Tipo de controle
    • HTML tag
    • DOMXPath
    • HTML HasFrame
    • HTML FramePath
    • FrameDOMXPath
    • Caminho
    • Função
    • HTML FrameSrc
  • 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.
    Recommended: Insira um valor de tempo esgotado de pelo menos 9 segundos.
  • Opcional: No campo Salvar o resultado para uma variável selecione uma variável para armazenar a saída da ação. A Control Room mostra um nome descritivo da variável padrão. Se você criar diversas variáveis de saída, os nomes das variáveis subsequentes receberão um -1, -2, -3 e assim por diante para evitar a duplicação.
    Nota: Esta ação suporta Tipos de JavaScript String, Number e Boolean que correspondem aos mesmos tipos de variáveis nas variáveis do bot ou no tipo de variável do bot Any.
Recomendação:
  • Não use o Jquery com o JavaScript pacote.
  • Use asações Tentar/capturar do Gerenciador de erros na função JavaScript.
  • Chame uma função JavaScript antes de declará-la.

Assista ao seguinte vídeo sobre a utilização da ação Executar o código JavaScript do Navegador pacote para executar o JavaScript dentro de uma janela do navegador existente:

Automação de aplicativos baseados em objetos

Recomendamos que você use Gravador para automações baseadas em objeto em vez da ação Executar JavaScript. Se você usar a ação Executar JavaScript para automatizar páginas da Web dinâmicas e se houver uma alteração na hierarquia ou nas propriedades de controle, deverá reescrever todo o script. Use a ação Executar JavaScript somente para executar scripts externos em qualquer aplicativo.

Você pode usar o Gravador para automatizar aplicativos usando outras tecnologias disponíveis se não conseguir capturar usando a tecnologia HTML padrão. Certifique-se de que a acessibilidade para seu aplicativo esteja ativada e não esteja bloqueada por nenhuma política da empresa antes de usar uma tecnologia diferente para automatizar. Recomendamos que você abra Google Chrome com a sinalização --force-renderer-accessibility.

Habilite a acessibilidade do aplicativo