Inject Js Script

UiPath.Core.Activities.NInjectJsScript

Description

Executa o código JavaScript no contexto da página da Web correspondente a um UiElement.

Esta atividade precisa ser adicionada a uma atividade Use Application/Browser.

To use this activity outside a Use Application/Browser activity, you need to provide an Input element.

Esta atividade é compatível com o Repositório de Objetos.

Compatibilidade do projeto

Windows - Legado | Janelas | Multiplataforma

Windows - Legada, Configuração do Windows

Painel do Designer

• Clique em Indicar no aplicativo/navegador para indicar o elemento de interface gráfica a ser usado como destino.

  Após indicar o destino, selecione o Menu para acessar as seguintes opções:

  • Indicar destino na tela — indique o destino novamente.
  • Editar destino – Abra o modo de seleção para configurar o destino.
  • Remover captura de tela informativa - Remova a captura de tela do aplicativo de destino ou página da web.
  • Adicionar ao Repositório de Objetos — Adicione o elemento de interface gráfica atual a um projeto de biblioteca, de onde ele pode ser reutilizado em todo o processo de automação.
• Código descript - O código JavaScript que você deseja executar. Você pode escrevê-lo aqui como uma string ou adicionar o caminho completo de um arquivo .js que contém o código a ser executado. Ele deve conter uma única função anônima, como no exemplo abaixo:

  function (element, input) {
      return "result";
  }

  Onde element representa o elemento HTML correspondente ao nó de interface gráfica solicitado, e input representa a string de entrada fornecida pelo solicitante.
• ParâmetroDeEntrada - Dados de entrada para o código JavaScript, como uma string ou variável de string.
• Salvar saída do script em — onde salvar o resultado do código JavaScript.

Painel de Propriedades

Comum

• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita Boolean valores (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

• Atraso após - Atraso (em segundos) entre o momento em que esta atividade é concluída e o momento em que a próxima atividade inicia qualquer operação. O valor padrão é 0,3 segundos. Adicionar um atraso entre as atividades garante que uma atividade tenha tempo suficiente para ser concluída antes do início da próxima atividade.

• Atraso antes — atraso (em segundos) entre o momento em que a atividade anterior é concluída e o momento em que esta atividade começa a realizar alguma operação. O valor padrão é de 0,2 segundos. Adicionar um atraso entre as atividades garante que uma atividade tenha tempo suficiente para ser concluída antes do início da próxima atividade.

• Nome daexibição - O nome exibido para a atividade no painel do Designer. Um nome de exibição é gerado automaticamente quando você indica um destino.

• Tempo limite — especifique o período (em segundos) para aguardar que a atividade seja executada antes de gerar um erro. O valor padrão é 30 segundos.

Entrada

• Parâmetro de entrada - Consulte Parâmetro de entrada no painel do Designer.
• Código de script - Consulte Código de script no painel Designer.
• Destino - O elemento de destino. É necessário definir o elemento de destino. Antes de indicar na tela, esse campo é definido como (null). Assim que o destino for indicado, todas as propriedades relacionadas ao elemento indicado serão exibidas.
  • Tipo de controle de CV - Indica o tipo de controle identificado usando o Computer Vision.
  • Texto do CV - Indica o texto identificado usando o Computer Vision.
  • Seletor difuso - Os parâmetros para o seletor difuso.
  • Texto nativo - O texto usado para identificar o elemento de interface gráfica.
  • Sites responsivos — habilita o layout de sites responsivos.
  • Seletor restrito - O seletor restrito gerado para o elemento de interface gráfica.
  • Métodos de segmentação - Os tipos de seletor que você deseja usar para identificar o elemento. Essa propriedade pode ser definida como qualquer combinação no menu suspenso:
    • Nenhum
    • Seletor restrito
    • Seletor difuso
    • Imagem
    • Texto nativo
    • Computer Vision
  • Verificação devisibilidade — verifica se o elemento de interface gráfica está visível ou não. Você pode escolher uma das três opções do menu suspenso:
    • Nenhum - Não verifica a visibilidade.
    • Interativo (para seletor Difuso) - opção padrão. Verifica se o elemento está potencialmente visível, ignorando a rolagem da página, as obstruções de outros aplicativos ou o fato de o aplicativo estar minimizado. Essa verificação é útil ao tentar garantir que você não esteja segmentando elementos invisíveis que existem no DOM, mas que estão ocultos.
    • Totalmente visível - Verifica se o elemento de interface gráfica está visível ou não.
  • Aguardar carregamento da página — antes de executar as Actions, aguarde o aplicativo ficar pronto para aceitar a entrada. Você pode escolher uma das três opções do menu suspenso:
    • Nenhum - Não aguarda que o destino esteja pronto.
    • Interativo - Aguarda até que apenas uma parte do aplicativo seja carregada.
    • Completo - Aguarda até que todo o aplicativo seja carregado.
  • Seletor de janela (instância do Aplicativo) - O seletor que é usado para a janela do aplicativo. Aplicável somente quando o modo de anexação de janela estiver definido como Instância do aplicativo.

Elemento de Entrada/Saída

• Elemento deentrada — o elemento de interface gráfica no qual a atividade é executada, armazenado em um objeto UIElement . Esse campo é compatível apenas com objetos UIElement . Esse objeto pode ser obtido do campo de propriedade Elemento de Saída de outras atividades do UIAutomation.
• Elemento de saída - Gera um Elemento de Interface Gráfica de destino e o armazena em um objeto UIElement , que pode ser usado para direcionar o mesmo elemento com outras atividades.

Diversos

• Particular — se selecionada, os valores de variáveis e argumentos não são mais registrados no nível Verbose. Este campo é compatível apenas com valores Boolean (Verdadeiro, Falso). O valor padrão é False.

Opções

• Mundo de execução — o ambiente JavaScript para a execução do script. Escolha uma das duas opções no menu suspenso:
  • Isolado - Permite o acesso aos elementos do HTML, mas impede o acesso a variáveis e códigos de página. Use essa opção para garantir que a execução do script não entre em conflito com a página.Essa é a seleção padrão.
  • Página — Permite o acesso aos elementos HTML, variáveis de página e código. Use esta opção se você precisar acessar variáveis de página (por exemplo, jQuery $) ou para interagir com o código de página (por exemplo, window.alert). Usar esta opção é necessário para corrigir esse problema conhecido específico para extensões MV3.

  Você pode alterar a propriedade Mundo de execução para todas as atividades Inject Js Script por meio das configurações do projeto.

Saída

• Saída do script - O resultado da string retornado do código do JavaScript.

Configuração multiplataforma

• Indicar destino na tela — indique o elemento de interface gráfica a ser usado como destino.

  Após indicar o destino, selecione o botão mais para acessar as seguintes opções:

  • Indicar destino na tela — indique o destino novamente.
  • Editar destino – Abra o modo de seleção para configurar o destino.
• Código descript - O código JavaScript que você deseja executar. Você pode escrevê-lo aqui como uma string ou adicionar o caminho completo de um arquivo .js que contém o código a ser executado. Ele deve conter uma única função anônima, como no exemplo abaixo:

  function (element, input) {
      return "result";
  }

  Onde element representa o elemento HTML correspondente ao nó de interface gráfica solicitado, e input representa a string de entrada fornecida pelo solicitante.

Opções adicionais

Horários

• Atraso antes — atraso (em segundos) entre o momento em que a atividade anterior é concluída e o momento em que esta atividade começa a realizar alguma operação. O valor padrão é de 0,2 segundos. Adicionar um atraso entre as atividades garante que uma atividade tenha tempo suficiente para ser concluída antes do início da próxima atividade.

• Atraso após - Atraso (em segundos) entre o momento em que esta atividade é concluída e o momento em que a próxima atividade inicia qualquer operação. O valor padrão é 0,3 segundos. Adicionar um atraso entre as atividades garante que uma atividade tenha tempo suficiente para ser concluída antes do início da próxima atividade.

• Tempo limite — especifique o período (em segundos) para aguardar que a atividade seja executada antes de gerar um erro. O valor padrão é 30 segundos.

• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita Boolean valores (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

Opções

• Mundo de execução — o ambiente JavaScript para a execução do script. Escolha uma das duas opções no menu suspenso:
  • Isolado - Permite o acesso aos elementos do HTML, mas impede o acesso a variáveis e códigos de página. Use essa opção para garantir que a execução do script não entre em conflito com a página.Essa é a seleção padrão.
  • Página — Permite o acesso aos elementos HTML, variáveis de página e código. Use esta opção se você precisar acessar variáveis de página (por exemplo, jQuery $) ou para interagir com o código de página (por exemplo, window.alert). Usar esta opção é necessário para corrigir esse problema conhecido específico para extensões MV3.

  Você pode alterar a propriedade Mundo de execução para todas as atividades Inject Js Script por meio das configurações do projeto.

Saída

• Saída do script - O resultado da string retornado do código do JavaScript.

Entrada/Saída

• Elemento deentrada — o elemento de interface gráfica no qual a atividade é executada, armazenado em um objeto UIElement . Esse campo é compatível apenas com objetos UIElement . Esse objeto pode ser obtido do campo de propriedade Elemento de Saída de outras atividades do UIAutomation.
• Elemento de saída - Gera um Elemento de Interface Gráfica de destino e o armazena em um objeto UIElement , que pode ser usado para direcionar o mesmo elemento com outras atividades.