activities

latest

false

Importante :

A tradução automática foi aplicada parcialmente neste conteúdo. A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.

Atividades do UIAutomation

Última atualização 5 de jun de 2025

Escopo da Caixa de Diálogo do Navegador

UiPath.UIAutomationNext.Activities.NBrowserDialogScope

Description

Captura e gerencia as caixas de diálogo do JavaScript, como: Alerta, Confirmar, Solicitação. Esta atividade deve ser usada como um escopo para as atividades que podem gerar uma caixa de diálogo do navegador, de forma que as atividades que podem acionar a caixa de diálogo devem ser colocadas no corpo da atividade Browser Dialog Scope .

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

Compatibilidade do projeto

Windows | Multiplataforma

Configuração

Painel do Designer

No menu suspenso Tipo de caixa de diálogo , selecione o tipo de caixa de diálogo do navegador JavaScript tratado pela atividade Browser Dialog Scope:
- Alerta
- Confirmar
- Prompt
Resposta da caixa de diálogo - Resposta aos diálogos de confirmação do JavaScript: Cancelar ou OK. Ela está disponível apenas para os tipos de diálogo Confirmar ou Solicitar .
Texto de resposta pronta - Resposta de texto para caixas de diálogo de solicitação JavaScript. Ele está disponível apenas para o tipo de diálogo Prompt .
Mensagem de diálogo - Variável de saída de string para armazenar a mensagem da caixa de diálogo tratada pelo escopo de diálogo.

Painel de Propriedades

Horários

Aguardar a exibição da caixa de diálogo tempo limite - Especifique a quantidade de tempo (em segundos) para aguardar a caixa de diálogo aparecer antes de gerar um erro. O valor padrão é 30 segundos.

Opções

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.

Guia de instruções

Na automação de processos de negócios, os usuários encontram casos em que as caixas de diálogo do navegador bloqueiam a execução da página do navegador atual. Normalmente, o usuário gostaria de descartar a caixa de diálogo do navegador e também obter a mensagem de diálogo para uso posterior no cenário de negócios.

Para projetos do Windows, esse tipo de cenário pode ser tratado definindo o modo de anexação da janela como Instância do aplicativo para a atividade do contêiner Use Application/Browser e gerando o seletor de caixa de diálogo do navegador com a estrutura de interface gráfica do Active Accessibility (AA).

Mas para projetos multiplataforma (incluindo o Studio Web), não tínhamos nenhuma solução para lidar com esse tipo de cenário.

O JavaScript possui três tipos de caixas pop-up: Alerta, Confirmação e Solicitação. A atividade Browser Dialog Scope pode lidar com esses tipos de diálogos e deve ser usada como um escopo para as atividades que podem gerar uma caixa de diálogo do navegador.

A atividade Browser Dialog Scope deve ser adicionada dentro de uma atividade Use Application/Browser e as atividades que podem disparar a caixa de diálogo devem ser colocadas no corpo da atividade Browser Dialog Scope .

Configuração de alerta

Uma caixa de diálogo Alerta é usada para garantir que as informações sejam mostradas ao usuário. Quando ela aparecer, o usuário terá que clicar no botão OK para prosseguir, caso contrário, a execução será bloqueada.

É assim que a atividade Browser Dialog Scope pode ser configurada para lidar com uma caixa de diálogo Alerta , que é acionada quando você clica no botão Enviar .

Figura 1. . docs image

Configuração para Confirmar

Uma caixa de diálogo Confirmar é usada quando o usuário precisa verificar ou aceitar algo. Quando ela aparece, o usuário tem que clicar no botão OK ou Cancelar para prosseguir.

É assim que a atividade Browser Dialog Scope pode ser configurada para lidar com uma caixa de diálogo Confirmar , que é disparada quando você clica no botão Enviar .

Figura 2. . docs image

Configuração de prompt

Uma caixa de diálogo Prompt é usada quando o usuário precisa fornecer uma entrada de texto para uma operação. Quando ela aparecer, o usuário terá que clicar em OK ou Cancelar para prosseguir após inserir um valor de entrada.

Figura 3. . docs image

Exemplo de várias caixas de diálogo

Há situações raras em que uma página abre várias caixas de diálogo, uma após a outra, quando o usuário clica em um botão. Vamos considerar o seguinte cenário:

Quando o botão Enviar Dados é clicado, uma caixa de diálogo Prompt é aberta para que o usuário preencha seu nome.
Após fechar a caixa de diálogo Prompt com o botão OK, quando a operação de envio for concluída, uma caixa de diálogo Alerta será exibida.

A atividade Browser Dialog Scope pode ser usada para lidar com essa situação aninhando vários escopos de diálogo. Eles têm que ser organizados na mesma ordem que as caixas de diálogo que eles gerenciam aparecem na página. O fluxo de trabalho continuará assim que todas as caixas de diálogo forem tratadas. Para o cenário acima:

Primeiro, crie um Browser Dialog Scope para lidar com o primeiro diálogo, neste caso, um diálogo Prompt .
Dentro do primeiro escopo, crie um segundo Escopo da caixa de diálogo do navegador para lidar com a segunda caixa de diálogo, neste caso, uma caixa de diálogo Alerta .
Dentro do segundo escopo, coloque a atividade que aciona as caixas de diálogo, neste caso, um clique no botão Enviar dados .

Figura 4. . docs image

Opções de cartão de aplicativo de processamento de diálogo

Além da atividade Browser Dialog Scope , adicionamos opções de manipulação de caixas de diálogo do navegador à atividade Use Application/Browser .

As novas configurações de Manuseio de diálogo no App Card permitem que o usuário descreva como ignorar automaticamente os diálogos do navegador (quais tipos de diálogo ignorar e que resposta dar para confirmar e solicitar diálogos).

Ignorar alertas
Ignorar Confirmações + Confirmar resposta da caixa de diálogo
Ignorar Solicitações + Texto da resposta da Solicitação + Resposta da Caixa de Diálogo da Solicitação

Figura 5. . docs image

Configurações do projeto do cartão do aplicativo de manipulação de diálogo

Configurações de projeto semelhantes foram adicionadas para o Manuseio de diálogo, que funciona como padrão para as opções Usar manuseio de diálogo do aplicativo/navegador.

Projetos do Windows : Automação de Interface Gráfica Moderna > Aplicativo/Navegador
Projetos multiplataforma : Automação de Interface Gráfica > Aplicativo/Navegador

Figura 6. . docs image

Escopo de caixa de diálogo do navegador e prioridade de processamento da caixa de diálogo do cartão de aplicativo

Quando várias atividades Browser Dialog Scope e App Cards com Dialog Handling estão aninhadas, é importante ter algumas coisas em mente para determinar como os diálogos serão tratados:

As atividades Browser Dialog Scope têm prioridade sobre as opções de App Card Dialog Handling .
As atividades Nested Browser Dialog Scope lidam com vários diálogos, na ordem em que aparecem: a primeira Dialog Scope lida com a primeira caixa de diálogo, a segunda Dialog Scope lida com a segunda caixa de diálogo e assim por diante.
Os cartões de aplicativo aninhados com manuseio de diálogo se substituem: o cartão de aplicativo interno substituirá as configurações do cartão de aplicativo externo. Por exemplo, um App Card de nível superior pode ser configurado para descartar todas as caixas de diálogo com Cancelar em todo o fluxo de trabalho, mas para uma pequena parte do fluxo de trabalho, um App Card de curta duração pode ser usado dentro do de nível superior para aceitar Confirmar caixas de diálogo com OK, alterando a manipulação da caixa de diálogo apenas para essa parte do fluxo de trabalho. Alertas e prompts ainda serão descartados de acordo com o Cartão de aplicativo de nível superior.

Quando uma caixa de diálogo do navegador aparece e há várias Browser Dialog Scopes e App Cards com Dialog Handling que podem lidar com o diálogo, a Browser Dialog Scope ou App Card que lida com a caixa de diálogo é selecionada da seguinte maneira:

A primeira atividade Browser Dialog Scope (mais externa) que: tem um tipo de diálogo correspondente e ainda não capturou nenhum diálogo.
Se nenhum Browser Dialog Scope for encontrado, então o último Cartão de Aplicativo (mais interno), configurado para lidar com o tipo de diálogo, será usado.
Se não for encontrado nenhum escopo de diálogo do navegador ou cartão de aplicativo viável, a caixa de diálogo não será tratada e será exibida para o usuário.