Type Into

UiPath.UIAutomationNext.Activities.NTypeInto

Description

Insere o texto em um elemento de interface gráfica especificado, por exemplo uma caixa de texto.

Também é possível enviar teclas especiais como Tab ou Enter para o elemento de IU.

Teclas de adesão também são suportadas. Por exemplo, se você quiser digitar Shift+End para selecionar apenas parte do texto de um controle, você precisa selecionar Shift e End da lista de teclas especiais e o texto proposto é [k(Shift)][k(End)]. Isso emula os pressionamentos das teclas Shift e End sequencialmente. O texto correto é [d(Shift)][k(End)][u(Shift)], onde d significa tecla pressionada para baixo, k significa pressionada tecla e u significa tecla pressionada para cima.

Se você deseja inserir informações confidenciais com segurança, adicione uma atividade Get Username/Password antes desta atividade e selecione os valores de nome de usuário e senha salvos para depois dessa atividade como o texto a digitar.

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.

Para saber como usar esta atividade, consulte:

• Tutorial: Trabalhando com Automação de Interface Gráfica.
• Tutorial: Preenchendo Formulários PDF no Acrobat Reader com Dados do Excel.

Pré-requisitos para inserir informações de login com segurança

Antes de inserir informações de nome de usuário/senha com segurança usando esta atividade, você deve primeiro:

1. Adicione uma atividade Get Username/Password ao projeto.
2. Na atividade Get Username/Password , selecione as credenciais salvas anteriormente no Gerenciador de Credenciais do Windows. Se as credenciais que você deseja usar ainda não estiverem salvas no Gerenciador de Credenciais do Windows, você pode usar esta atividade para adicioná-las.
3. Salve as credenciais para uso posterior no projeto.

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.

  Esta etapa não é necessária se o elemento já estiver em foco no aplicativo de 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.
  • Adicionar verificação automática — verifique se as Actions executadas pela atividade estavam corretas.
  • 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.

• Digitar isto — o texto a ser inserido. Você pode usar o menu suspenso para selecionar uma tecla especial a ser enviada para o campo de texto ou pode adicionar teclas especiais do Construtor de Texto. Você também pode usar as opções da página Mais dentro do Construtor de Texto para adicionar valores salvos para uso posterior ou adicionar dados do Notebook do Projeto ou atividades pai Use Excel File ou Use Outlook Account . Qualquer combinação de texto, dados do Excel ou Outlook e teclas especiais é compatível.

• Esvaziar antes de digitar - Seleciona se o conteúdo existente será excluído no campo antes de digitar o texto e como esvaziar o campo. Campos são esvaziados enviando uma combinação de teclas que difere entre campos com uma única linha e campos com várias linhas. Certifique-se de selecionar a opção certa dependendo do Campo indicado. As opções são:
  • Nenhum - Não exclua o conteúdo existente.
  • Linha única (End, Shift+Home, Del) - Exclua o conteúdo de um campo de texto com uma única linha. Esta é a opção padrão.

  • Linha múltipla (Ctrl+A, Del) - Exclua o conteúdo de um campo de texto com várias linhas.

  Para usar a atividade para limpar o campo de texto indicado, configure essa propriedade para excluir o conteúdo existente, deixe o campo Digite este vazio e defina a propriedade Modo de entrada como Eventos de hardware.

• Clicar antes de digitar — selecione se o elemento de interface gráfica especificado deve ser clicado antes de digitar o texto e o tipo de clique a ser executado. As opções são Nenhum (não clica), Único (executa um único clique) ou Duplo (executa um duplo clique).

  O padrão é Single.

• Verificar se o texto está vazio — essa opção aparece se Adicionar verificação automática for selecionada. Você pode indicar no aplicativo atual ou em qualquer aplicativo.

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

• Texto seguro - O texto seguro a ser inserido. O campo suporta apenas variáveis SecureString. Se este campo estiver configurado, o campo Texto é limpo. O comprimento máximo da string para este campo é de 65536 caracteres.
• 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.
  • Deslocamento de clique - Especifica um deslocamento para a atividade do clique, que pode ser configurado ainda mais.
    • Ponto de ancoragem - Descreve o ponto inicial do cursor para o qual ele se desloca das propriedades Deslocamento de X e Deslocamento de Y. As seguintes opções estão disponíveis: SuperiorEsquerda, SuperiorDireita, InferiorEsquerda, InferiorDireitae Centro. Por padrão, o Centro é selecionado.
    • Deslocamento de X - Deslocamento horizontal da posição do cursor de acordo com a opção selecionada no campo Ponto de ancoragem . Esse campo é compatível apenas com variáveis Int32 .
    • Deslocamento de Y - Deslocamento vertical da posição do cursor de acordo com a opção selecionada no campo Ponto de ancoragem . Esse campo é compatível apenas com variáveis Int32 .
  • 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.
• Texto - O texto a inserir. Você pode adicionar teclas especiais ao texto na lista suspensa no corpo da atividade. Se este campo estiver configurado, o campo Texto seguro é limpo. O comprimento máximo da string para este campo é de 65536 caracteres.

• Verificar execução - No Runtime, verifica se as Actions executadas pela atividade estavam corretas. Isso é feito verificando se o texto especificado na propriedade Texto esperado é encontrado no elemento de interface gráfica indicado após a execução da atividade ou indicando um elemento que deve aparecer ou desaparecer após a execução das Actions , o que é monitorado e verificado após a atividade é executada. Essa funcionalidade pode ser habilitado nas Configurações do projetoou no corpo da atividade, selecionando Adicionar verificação automática a partir do menu de contexto.

  • Nome daexibição — o nome da exibição das Actionsde verificação Esse campo é preenchido automaticamente com base nas Actions de verificação e no elemento que você escolheu. Após a verificação de execução ser configurada, esse nome de exibição ficará visível no cartão de atividades.
  • Texto esperado - O texto que se espera que seja digitado no campo de texto especificado. Este campo é opcional. Este campo é compatível apenas com strings e variáveis String .
  • Tentar novamente - Quando selecionada, as Actions são repetidas no tempo limite da atividade caso o resultado esperado não seja alcançado. Por padrão, essa caixa de seleção fica marcada.
  • Destino - Esse destino é usado para indicar o elemento que você deseja verificar no Runtime. Para obter mais informações sobre os campos de propriedade que podem ser expandidos nesta propriedade, consulte a propriedade Destino acima, pois a funcionalidade das propriedades é a mesma.
  • Tempo limite — tempo (em segundos) de espera para que o elemento de verificação apareça, desapareça ou mude. Se a caixa de seleção Tentar novamente for selecionada, as Actions realizadas novamente, seguidas pela verificação, na duração especificada na propriedade Tempo limite da atividade. O valor padrão é de 10 segundos.
  • Verificar elemento - Defina qual mudança você deseja verificar no destino de verificação. As opções disponíveis são:
    • Aparecedo - Verifica se o elemento é exibido.
    • Desaparecedo - Verifique se o elemento desaparece.
    • Texto alterado - Verifica se há alguma alteração no texto do elemento.
    • Visualmente alterado - Verifica se há qualquer alteração de imagem do elemento.

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

• Alterar elemento desabilitado - Se estiver selecionada, a atividade executa as Actions mesmo se o elemento de interface gráfica especificado estiver desabilitado. Este campo só aceita Boolean valores (True, False). O valor padrão é False.

  Essa propriedade não se aplica se a propriedade Modo de entrada estiver definida como Eventos de hardware.

• Modo de entrada - Selecione qual método o Robô deve usar para interagir com o aplicativo de destino:

  • O mesmo que App/Browser — usa o mesmo modo de entrada da atividade Use Application/Browser .

    Essa é a seleção padrão.

  • Eventos de hardware - usa o driver de hardware para executar a ação. Este é o método mais lento, não pode funcionar em segundo plano, mas é compatível com todos os aplicativos de desktop.

  • Simular — simula usando APIs de acessibilidade. Recomendado para navegadores, aplicativos baseados em Java e SAP. Geralmente mais confiável que Eventos de hardware. Envia todo o texto em uma única Actions. Funciona mesmo que o aplicativo de destino não esteja em foco. Teste se o elemento de interface gráfica de seu aplicativo de destino é compatível com isso.

    No painel Propriedades, a opção ao lado do campo de propriedade Modo de Entrada testa e seleciona automaticamente o modo de entrada correto para as Actions que você está executando. Usando essa funcionalidade, o texto é digitado no campo de destino com todos os métodos de entrada disponíveis, e aquele com o melhor desempenho é escolhido automaticamente.

    As propriedades Ativar, Clicar antes de digitar, Atraso entre teclase Campo vazio não podem ser usadas com o modo de entrada Simular.

  • API do Chromium — executa ações usando APIs do depurador. Funciona apenas com elementos do Chromium. Envia todos os textos de uma vez. Funciona mesmo que o aplicativo de destino não esteja em foco. Para obter mais detalhes, consulte esta página.

  • Mensagens do Windows - Simule usando mensagens Win32. Recomendado para aplicativos de desktop. Geralmente mais confiável que Eventos de hardware. Envia todo o texto em uma única Actions. Funciona mesmo que o aplicativo de destino não esteja em foco. Teste se o elemento de interface gráfica de seu aplicativo de destino é compatível com isso.

Opções – Eventos de Hardware/API do Chromium

• Ativar - Traz o elemento de interface gráfica para o primeiro plano e o ativa antes de clicar nele. Se não estiver selecionado, a atividade será digitada na janela ativa atual. Este campo só aceita valores booleanos (True, False). O valor padrão é True.
• Clicar antes de digitar - Consulte Clicar antes de digitar no painel Designer.
• Atraso entre teclas - Atraso (em segundos) entre dois pressionamentos de tecla consecutivos. O valor padrão é de 0,02 segundos. O valor máximo é de 1 segundo.
• Campo vazio — consulte Campo vazio antes de digitar no painel do Designer.

Opções: Simular

• Desmarcar no final - Esta caixa de seleção só pode ser usada quando a propriedade Modo de entrada estiver definida como Simular e estiver selecionada por padrão. Alguns aplicativos de destino não registram uma ação de tipo, a menos que um evento Complete também seja enviado junto com a ação. Marcar esta caixa de seleção adiciona um evento Complete após a entrada de texto, para registrar a ação corretamente. Se esta caixa de seleção estiver desmarcada, o evento Complete não será enviado ao aplicativo de destino. Por predefinição, esta caixa de verificação está seleccionada.

Configuração multiplataforma

• Trabalho em escopo — escolha a guia do navegador renderizando o aplicativo da Web para automatizar.

• 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.

• Digitar isto — o texto a ser inserido. É possível adicionar teclas especiais do Construtor de Texto.

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

• Campo vazio - Seleciona se o conteúdo existente será excluído no campo antes de digitar o texto e como esvaziar o campo. Campos são esvaziados enviando uma combinação de teclas que difere entre campos com uma única linha e campos com várias linhas.Certifique-se de selecionar a opção certa dependendo do Campo indicado.As opções são:
  • Nenhum - Não exclua o conteúdo existente.
  • Linha única (End, Shift+Home, Del) - Exclua o conteúdo de um campo de texto com uma única linha. Esta é a opção padrão.

  • Linha múltipla (Ctrl+A, Del) - Exclua o conteúdo de um campo de texto com várias linhas.

• Clicar antes de digitar — selecione se o elemento de interface gráfica especificado deve ser clicado antes de digitar o texto e o tipo de clique a ser executado. As opções são Nenhum (não clica), Único (executa um único clique) ou Duplo (executa um duplo clique). O padrão é Single.
• Ativar - Se selecionado, o elemento de interface gráfica especificado é trazido para o primeiro plano e ativado antes que o texto seja digitado. Se não estiver selecionado, a atividade será digitada na janela ativa atual. Este campo só aceita valores booleanos (True, False). O valor padrão é True.
• Desmarcar no final - Adiciona um evento Concluído após a entrada de texto para disparar determinadas respostas de UI em navegadores da web.

• Modo de entrada - Selecione qual método o Robô deve usar para interagir com o aplicativo de destino:

  • Igual ao Navegador — use a configuração do modo de entrada da atividade pai Use Browser . Esse é o valor padrão.
  • API do Chromium — executa ações usando APIs do depurador. Funciona apenas para elementos do Chrome e Edge. Envia todos os textos de uma vez. Funciona mesmo que o aplicativo de destino não esteja em foco.
  • Simular - Simula o clique usando APIs de acessibilidade. Funciona para navegadores. Envia todos os textos de uma vez. Esse método de entrada funciona em segundo plano (mesmo se o aplicativo de destino não estiver em foco).

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.