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.

Para usar esta atividade fora de uma atividade Use Application/Browser, você precisa fornecer um Elemento de entrada.

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";
}function (element, input) {
    return "result";
}
```
```
async function (element, input) 
{
    const asyncResult = await new Promise((resolvePromiseCb) => 
    {
        const timeoutMs = 100;
        setTimeout(() => 
        {
            resolvePromiseCb("async_result");
        }, 
        timeoutMs);
    });
    return asyncResult;
}async function (element, input) 
{
    const asyncResult = await new Promise((resolvePromiseCb) => 
    {
        const timeoutMs = 100;
        setTimeout(() => 
        {
            resolvePromiseCb("async_result");
        }, 
        timeoutMs);
    });
    return asyncResult;
}
```
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 - Para usar o Computer Vision como um método de segmentação, você precisa acessar Configurações do projeto > Computer Vision e certificar-se de definir o ponto de extremidade do servidor correto. Você pode deixar esse campo como está e usar o UiPath Cloud, que é preenchido por padrão, ou você pode inserir outro valor selecionando qualquer um dos outros pontos de extremidade públicos específicos de uma região do servidor ou seu próprio servidor no local.
    Outra maneira de usar o Computer Vision como um método de segmentação é definir Usar Servidor Local como True. Isso indica que o pacote UiPath.ComputerVision.LocalServer está instalado em seu projeto. Quando o Servidor local é habilitado, o valor do servidor é substituído. No entanto, o Servidor local não está disponível em projetos multiplataforma.
- 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 acesso aos elementos HTML, variáveis de página e código. Use esta opção se precisar acessar variáveis de página (por exemplo, jQuery $) ou interagir com o código da página (por exemplo, window.alert). O uso dessa opção é necessário para corrigir esse problema conhecido específico das 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";
}function (element, input) {
    return "result";
}

async function (element, input) 
{
    const asyncResult = await new Promise((resolvePromiseCb) => 
    {
        const timeoutMs = 100;
        setTimeout(() => 
        {
            resolvePromiseCb("async_result");
        }, 
        timeoutMs);
    });
    return asyncResult;
}async function (element, input) 
{
    const asyncResult = await new Promise((resolvePromiseCb) => 
    {
        const timeoutMs = 100;
        setTimeout(() => 
        {
            resolvePromiseCb("async_result");
        }, 
        timeoutMs);
    });
    return asyncResult;
}

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 acesso aos elementos HTML, variáveis de página e código. Use esta opção se precisar acessar variáveis de página (por exemplo, jQuery $) ou interagir com o código da página (por exemplo, window.alert). O uso dessa opção é necessário para corrigir esse problema conhecido específico das 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.