ação Chamar uma função JavaScript
- Última atualização2022/12/14
ação Chamar uma função JavaScript
A ação Chamar uma função JavaScript no Navegador pacote permite chamar uma função JavaScript existente diretamente em uma página da web ou em um iFrame dentro de uma página da web.
Configurar as definições
Nota: Esta opção é compatível com os navegadores Google Chrome, Microsoft Edge e baseado em Chromium.
- Selecione a guia do navegador da lista de guias do navegador compatíveis ativas ou insira uma variável de janela.
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.
-
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.
- No campo Nome da função, especifique o nome da função JavaScript existente que você pretende executar.
-
Opcional: Na seção Argumentos, clique em Adicionar argumento para adicionar argumentos que devem ser passados para chamar a função JavaScript.
- Na caixa de diálogo Detalhes do argumento, selecione o Tipo de argumento necessário para o argumento específico.
- 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.
-
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.
- 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.
- Para qualquer Tipo de retorno, exceto Nenhum, no campo Salvar o resultado para 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:
- 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.
- Opcional: Especifique as informações da variável no campo Descrição.
- Opcional: Especifique um valor no campo Valor padrão.
- 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.