Check App State

UiPath.UIAutomationNext.Activities.NCheckState

Description

Verifica o estado de um aplicativo ou navegador da web verificando se um elemento aparece ou desaparece da interface do usuário. Ele pode executar um conjunto de atividades se o elemento for encontrado e outro se não for encontrado o elemento.

Ele pode monitorar um aplicativo inteiro em busca de alterações, não apenas um único elemento da interface gráfica.

Esta atividade pode ser usada dentro e fora de uma atividade Use Application/Browser .

Ela também pode ser usada como condição para a atividade Retry Scope.

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

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Configuração do Windows e multiplataforma

• Trabalho no escopo - Escolha a guia do navegador que renderiza o aplicativo da Web para automatizar.
• Indicar destino na tela
  • Indica o elemento de interface gráfica a ser usado como destino. Depois de indicar o destino, selecione o botão de adição para acessar as seguintes opções:
  • Indicate target on screen - Indicate the target again.
  • Editar destino - Abra o modo de seleção para configurar o destino.
• Wait for (appear/disappear) - Select which event to use for determining the state of the application or browser:
  • Element to appear - Wait for the element to appear in the user interface. If you select this option:
    • Adicione as atividades a serem executadas se o elemento aparecer no bloco IfExists .
    • Adicione as atividades a serem executadas se o elemento não aparecer no bloco IfNotExists .
  • Element to disappear - Wait for the element to disappear from the user interface. If you select this option:
    • Adicione as atividades a serem executadas se o elemento desaparecer no bloco IfExists .
    • Adicione as atividades a serem executadas se o elemento não desaparecer no bloco IfNotExists .
• Tempo limite (segundos) - O período para esperar que o elemento apareça ou desapareça antes de executar um dos dois blocos de atividade. O valor padrão é de 5 segundos.

Painel de Propriedades

Entrada/Saída

• Estado — um valor Verdadeiro ou Falso que indica o estado detectado do destino.
• Elemento de entrada - O elemento de interface gráfica no qual a atividade é executada, armazenado em um objeto UIElement . Este campo é compatível apenas com objetos UIElement . Esse objeto pode ser obtido do campo de propriedade Elemento de saída de outras atividades de Automação de interface gráfica.
• 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.

Opções

• 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.
  • Desabilitado - Desativa o Healing Agent para essa atividade.
  • Herdar configurações do trabalho — aplica as configurações definidas na governança ou no Orchestrator no nível do processo ou trabalho.
  • 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.
  • Igual ao Aplicativo/Navegador — herda a configuração da atividade pai Use Application/Browser .

Destino

• Expandir propriedades de destino - Exibe as propriedades de destino e de âncora. Isso ocultará as outras propriedades da atividade e exibirá apenas aquelas relacionadas ao destino.

• Recolher propriedades de destino — Oculta propriedades de destino e de âncora. Isso ocultará as propriedades relacionadas ao destino e exibirá as propriedades da atividade.

• Métodos de segmentação - Os tipos de seletores que você deseja usar para identificar o elemento. Essa propriedade pode ser definida como qualquer combinação no menu suspenso:

  • Nenhum
  • Seletor restrito - O seletor restrito gerado para o elemento de interface gráfica de destino.
  • Seletor difuso - Os parâmetros do seletor difuso.
  • 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.
    • Tipo de controle de CV - Indica o tipo de controle identificado usando o Computer Vision.
    • CV Text - Indica o texto identificado usando o Computer Vision.
    • Ocorrência de CV Text - Indica uma ocorrência específica a ser usada quando várias correspondências são encontradas.
    • Precisão do texto CV - Indica o nível de precisão para correspondência de texto OCR.
  • Seletor semântico – Aproveita modelos de linguagem grande (LLMs) para gerar descrições funcionais e semelhantes às humanas de elementos de interface gráfica. Essas descrições são altamente confiáveis, tornando-as adaptáveis a alterações de interface gráfica e melhorando significativamente a resiliência da automação quando os seletores tradicionais falham.
  • Imagem (apenas Windows)
    • Precisão da imagem - Indica o nível de precisão para correspondência de imagens.
    • Ocorrência de imagem - Indica uma ocorrência específica a ser usada, quando várias correspondências são encontradas.
  • Texto nativo (apenas Windows)
    • Texto nativo - O texto a ser encontrado para identificar o elemento de interface gráfica.
    • Ocorrência de texto nativa - Indica uma ocorrência específica a ser usada quando várias correspondências forem encontradas.

• Seletor de janela (Instância do aplicativo) — Seletor da janela do aplicativo. Aplicável somente quando modo de anexação de janela estiver definido como instância do aplicativo.

• Aguardar carregamento da página — antes de executar a ação, aguarda o aplicativo ficar pronto para aceitar a entrada. 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 - Habilitar o layout de sites responsivos.

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.

• Verificar visibilidade - Ao habilitar, a atividade também verifica se o elemento de interface gráfica está visível ou não.

Windows - Configuração legada

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

Depois de indicar o destino, selecione o Menu botão para acessar as seguintes opções:

• Indicate target on screen - Indicate the target again.
• Editar destino - Abra o modo de seleção para configurar o destino.
• Indicar em qualquer aplicativo - Quando usado dentro de uma atividade Use Application/Browser , você pode selecionar essa opção para verificar os estados do aplicativo para janelas ou elementos não associados à instância do aplicativo atual sem ter que adicionar um novo cartão de aplicativo.
• Remover captura de tela informativa – Remove 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 seu processo de automação.

• Wait for - Select which event to use for determining the state of the application or browser:
  • Element to appear - Wait for the element to appear in the user interface. If you select this option:
    • Add the activities to execute if the element appears in the Target appears block.
    • Add the activities to execute if the element does not appear in the Target does not appear block.
  • Element to disappear - Wait for the element to disappear from the user interface. If you select this option:
    • Add the activities to execute if the element disappears in the Target disappears block.
    • Add the activities to execute if the element does not disappear in the Target does not disappear block.
• Segundos - o tempo para esperar que o elemento apareça ou desapareça antes de executar um dos dois blocos de atividade. Você pode escolher um valor predeterminado no menu suspenso. O valor padrão é de 5 segundos.
• Clique em Alternar ramificações no corpo da atividade para configurar a visibilidade do Destino aparece e Destino não aparece contêineres onde você pode adicionar atividades a serem executadas, dependendo do estado. Você pode trabalhar com ambos os contêineres, seja com um ou com nenhum. Por padrão, ambos os blocos são visíveis.

Painel de Propriedades

Comum

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

• Nome de exibição — o nome exibido da atividade no painel do Designer. Um nome de exibição é gerado automaticamente quando você indica um destino.

• • Tipo de controle de CV - Indica o tipo de controle identificado usando o Computer Vision.
  • CV Text - Indica o texto identificado usando o Computer Vision.
  • Fuzzy selector - The parameters for the fuzzy selector.
  • Texto nativo - O texto que é usado para identificar o elemento de interface gráfica.
  • Sites responsivos - Habilitar 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 seletores 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.
    • Seletor semântico – Aproveita modelos de linguagem grande (LLMs) para gerar descrições funcionais e semelhantes às humanas de elementos de interface gráfica. Essas descrições são altamente confiáveis, tornando-as adaptáveis a alterações de interface gráfica e melhorando significativamente a resiliência da automação quando os seletores tradicionais falham.
  • Verificação de visibilidade - 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.
  • Aguardar carregamento da página — antes de executar a ação, aguarda o aplicativo ficar pronto para aceitar a entrada. Você pode escolher uma das três opções no 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 apenas quando o modo de anexação de janela estiver definido como Instância do aplicativo.

• Elemento de entrada - O elemento de interface gráfica no qual a atividade é executada, armazenado em um objeto UIElement . Este campo é compatível apenas com objetos UIElement . Esse objeto pode ser obtido do campo de propriedade Elemento de saída de outras atividades de Automação de interface gráfica.

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

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

• Tempo limite (segundos) — consulte segundos no painel Designer.

• Aguardar (aparecer/desaparecer) - Consulte Aguardar no painel Designer.

• Resultado - Indica se o elemento existe ou não. O campo é compatível apenas com variáveis Boolean . Opcionalmente, você pode salvar esse valor (True/False) para uso posterior ou salvá-lo em uma célula em um arquivo do Excel pai ou no Notebook do projeto.