Atualizar Elemento de Interface Gráfica (anteriormente Set Value)

A atividade Update UI Element (anteriormente Set Value) que usa IA para definir um valor em qualquer campo de entrada: caixa de entrada, caixa suspensa, caixa de seleção, botões de rádio, seletor de data para Automação Semântica.

UiPath.Semantic.Activities.NSetValue

Description

Usa IA para definir um valor em qualquer campo de entrada: caixa de entrada, caixa suspensa, caixa de seleção, botões de rádio, seletor de data.

Pode ser usado apenas no Chrome, Edge, Firefox e Safari.

Usa a mesma funcionalidade que Preencher formulário, mas no nível do elemento.

Em vez de usar outras atividades para campos de entrada específicos (por exemplo, Type Into para caixas de entrada, Check/Uncheck para caixas de seleção, etc.), você pode usar uma única atividade genérica de Update UI Element . Ele também pode lidar com seletores de datas e grupos de botões de opção.

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

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

Compatibilidade do projeto

Janelas | Plataforma cruzada

Configuração

• Indicar na tela – Indica 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 — indique o destino novamente.
  • Editar destino - Abra o modo de seleção para configurar o destino.
• Valor — o valor definido no campo. Este campo aceita apenas variáveis String .
  Se o destino indicado for uma caixa de seleção, esses são os valores aceitos:
  • Verdadeiro: "true", "yes", "checked", "x"
  • Falso: "false", "no", "unchecked"
• Habilitar validação – Habilita a validação de execução para o valor de runtime se o botão de alternância for definido como Ativado. Uma exceção é gerada se o mecanismo de validação interno detectar um valor inválido após a execução. A opção padrão é Desligado.

Painel de Propriedades

Destino

• Seletor de janela (Instância do aplicativo) - O seletor para a janela do aplicativo (aplicativo/navegador).
• Seletor semântico – Uma descrição semântica do destino.
• Modelo de seletor semântico - Indica o modelo de LLM subjacente usado para processamento semântico. Ele pode ser alterado apenas em Configurações do projeto > Automação de interface gráfica > Seletor semântico.
  Modelos disponíveis: Gemini 2.5 Flash, Path Mini (consulte Configurações do projeto para o Seletor semântico).
• Aguardar carregamento da página — Aguarda que o aplicativo fique pronto para aceitar a entrada antes de executar a ação. As opções são:
  • 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.
• Verificação de visibilidade - Ao habilitada, a atividade também verifica se o elemento de interface gráfica está visível ou não. Você pode escolher uma das três opções no menu suspenso:
  • Nenhum - Não verifica a visibilidade.
  • Interativo (para Seletor difuso) - Opção padrão. Verifica se o elemento é potencialmente visível, ignorando a rolagem de página e obstruções por outros aplicativos ou o fato de o aplicativo estar minimizado. Essa verificação é útil ao tentar garantir que você não esteja visando 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.
• Sites responsivos - Habilita o layout de sites responsivos.

Opções

• Modelo - O modelo de LLM usado para entender o elemento de interface gráfica de destino e produzir o valor a ser definido. Isso pode ser alterado apenas em Configurações do projeto > Automação de interface gráfica > Atividades semânticas > Atualizar Elemento da UI — Modelo.
  Modelos disponíveis (consulte Configurações do projeto para atividades semânticas):
  • GPT-4.1
  • GPT-4.1 mini
  • GPT-5 mini
  • Gemini 2.5 Flash
  • Gemini 3.0 Flash Preview
  • Path Mini
• Modo do Healing Agent - configura o comportamento do Healing Agent para esta atividade, com base nas configurações de Governança ou do Orchestrator no nível do processo ou trabalho.
  • Igual ao Aplicativo/Navegador — herda a configuração da atividade pai Use Application/Browser .
  • Herdar configurações do trabalho — aplica as configurações definidas na governança ou no Orchestrator no nível do processo ou trabalho.
  • Desabilitado - Desativa o Healing Agent para essa atividade.
  • Apenas recomendação — permite que o Healing Agent forneça recomendações sobre como corrigir problemas de automação de interface gráfica na execução de trabalhos, mas somente se permitido pela governança ou pelas configurações do Orchestrator.
• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo aceita apenas valores Boolean (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.

Horários

• Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• Tempo limite — especifique a quantidade de tempo (em segundos) para esperar que a atividade seja executada antes de gerar um erro. O valor padrão é 30 segundos.