Use Application/Browser

UiPath.UIAutomationNext.Activities.NApplicationCard

Description

Abre um aplicativo da área de trabalho ou uma página do navegador da Web para serem usados na automação de interface gráfica.

Atenção:

As URLs internas não podem ser abertas usando essa atividade quando o navegador não as aceita diretamente como argumentos de linha de comando.

Você não pode abrir páginas internas do Chrome (chrome://) ou do Edge (edge://). No entanto, você pode abrir páginas internas do Firefox (about:).

Após arrastar e soltar a atividade no fluxo de trabalho e indicar o aplicativo ou a página da web a ser usada, adicione as atividades a serem executadas dentro da atividade Use Application/Browser . Se o aplicativo não estiver aberto, ele será aberto quando o projeto for executado.

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

Observação:

• Começando com UI Automation v20.10.x, várias atividades de uso do aplicativo/navegador podem ser aninhadas umas nas outras. Isso permite que você automatize vários aplicativos simultaneamente.
• Começando com UI Automation v21.10.3, a atividade Usar aplicativo/navegador pode abrir aplicativos em ambientes remotos.
• Começando com UI Automation v22.10.1, a atividade também pode abrir navegadores em ambientes remotos.

Compatibilidade do projeto

Windows - Legado | Janelas | Multiplataforma

Windows - Legada, Configuração do Windows

Painel do Designer

• Selecione Indicar aplicativo para identificar o aplicativo movendo o mouse para sua janela e selecionando-o. Se o destino for uma página da Web do navegador, navegue até a página antes de indicar o aplicativo.
• Depois de indicar o destino, gerencie o destino selecionando o botão de opções de menu e escolhendo uma das seguintes opções:
  • Indique o alvo na tela - Indique o aplicativo novamente.
  • Alvo de Destaque - Visualize o aplicativo indicado em sua tela cercado por uma caixa.
  • Mostrar captura de tela informativa - Veja uma captura de tela do aplicativo ou página da web de destino.
  • Remover captura de tela informativa - Remova a captura de tela do aplicativo de destino ou página da web.
  • Mecanismo de OCR — selecione uma das duas opções:
    • Mecanismo de OCR incorporado - Utilize o mecanismo de OCR incorporado no modelo de IA do Computer Vision, ou seja, UiPath Screen OCR.
    • Mecanismo de OCR personalizado — use um mecanismo de OCR personalizado. Quando esta opção é selecionada, um painel é adicionado ao cartão de atividades onde você pode soltar uma atividade de mecanismo OCR diferente do UiPath Screen OCR.
  • 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.

• Você pode iniciar uma nova instância do aplicativo ou uma nova sessão do navegador, mantendo as configurações atuais, usando o botão ao lado do campo Caminho do aplicativo (no caso de um aplicativo) ou URL do navegador (no caso de um navegador). Se abrir um navegador por meio desse botão, todas as configurações feitas na seção de propriedade Opções — Navegador são aplicadas, permitindo testar o comportamento da atividade no momento do design, mitigando possíveis falhas no tempo de execução.

• Defina as configurações de inicialização do aplicativo:
  • Se o aplicativo for um navegador da Web, você pode selecionar Mais no lado direito do campo URL do navegador e, em seguida, usar uma das opções no menu para editar o URL da página da Web para abrir.
  • Se o aplicativo não for um navegador da Web, você pode:
    • Especificar parâmetros para passar para o aplicativo de destino na inicialização no campo Argumentos do aplicativo. Por exemplo, se o aplicativo de destino for o Acrobat Reader, você pode abrir um arquivo PDF específico fornecendo o caminho completo para o arquivo. Para abrir o arquivo C:\Sample.pdf, selecione Mais > Texto, e em seguida, insira C:\Sample.pdf no Construtor de texto.Certos tipos de aplicativos são identificados automaticamente e preenchem automaticamente a propriedade Argumentos, como aplicativos Java, aplicativos do Office Suite, Adobe Acrobat ou Windows File Explorer.
    • Selecione Mais no lado direito do campo Caminho do aplicativo e, em seguida, use uma das opções no menu para editar o caminho completo do arquivo executável para abrir. Para aplicativos instalados no modo de usuário, a automação não salva o caminho real que inclui o nome de usuário, um caminho relativo é usado e exibido no campo como User Folder.
      Observação: quando o caminho definido no campo Caminho do aplicativo é dinâmico, selecionar Indicar destino na tela em atividades filhas gera um erro se o aplicativo de destino já não estiver aberto.
    • Marque ou desmarque a caixa de seleção Corresponder ao título exato. Essa opção é exibida apenas quando você indica toda a janela de um aplicativo e não apenas um elemento dentro do aplicativo. Além disso, essa opção não é exibida quando você indica um navegador da Web. Quando marcados, apenas aplicativos que correspondem exatamente ao título do aplicativo atual são usados na automação. Quando não é marcada (padrão), a janela com o título correspondente mais próximo é usada na automação.

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.

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

  Importante:

  O nome de exibição da atividade Usar Aplicativo/Navegador também é usado como uma referência que aponta para o aplicativo ou navegador que está sendo direcionado. Depois de indicar o destino, a menos que seja definido manualmente, o nome de exibição é alterado automaticamente para o seguinte formato:

  • Para aplicativos: Use Application: [title] - [app name]
  • Para navegadores: Use Browser [browser type] : [title]

  No caso de cartões de aplicativo aninhados, cada atividade dentro de um cartão exibe um menu suspenso em seu corpo que permite escolher o cartão de aplicativo com o qual deseja usá-lo.

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

  Observação: ao indicar uma janela em um ambiente de Área de Trabalho Remota, a configuração padrão de tempo limite é definida como 60 segundos.

Entrada

• Aplicativo Unified Target - Expanda esta categoria para definir as seguintes configurações:

  • Argumentos - Se o aplicativo não for um navegador da Web, você poderá especificar os parâmetros a serem passados para o aplicativo de destino na inicialização. Você pode usar essa propriedade para abrir um arquivo específico com o aplicativo. Por exemplo, se o aplicativo de destino for o Acrobat Reader, você poderá abrir uma pasta de trabalho específica fornecendo o caminho completo para o arquivo. Para abrir o arquivo C:\Sample.pdf, digite "C:\Sample.pdf". Certos tipos de aplicativos são identificados automaticamente e preenchem automaticamente a propriedade Arguments, como aplicativos Java, aplicativos Office Suite, Adobe Acrobat ou Windows File Explorer.

  • Caminho do arquivo - Se o aplicativo não for um navegador da Web, especifica o caminho completo do arquivo executável a ser aberto. Se um caminho de arquivo for especificado, a propriedade URL será limpa.

    Observação: quando o caminho definido no campo Caminho do arquivo é dinâmico, selecionar Indicar destino na tela em atividades filhas gera um erro se o aplicativo de destino já não estiver aberto.
  • Seletor - Um fragmento XML que armazena os atributos de um elemento da interface do usuário.
  • URL - Se o aplicativo for um navegador da web, especifica o URL da página da web a ser aberta. Se uma URL for especificada, a propriedade Caminho do arquivo será desmarcada.

Elemento de Entrada/Saída

• Elemento de entrada - O elemento de destino que você deseja usar com este aplicativo, armazenado em um objeto UIElement . Esse objeto pode ser recuperado da propriedade Output Element de outra atividade de UI Automation. Você pode usar este campo de propriedade para passar o elemento de destino de uma atividade anterior para esta sem precisar indicá-lo novamente. Este campo suporta apenas UIElement variáveis.
• Elemento de saída - gera o elemento de destino indicado nesta atividade para uma variável UIElement que pode ser reutilizada em outras atividades. Este campo suporta apenas UIElement variáveis.

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

• Fechar — selecione quando fechar o aplicativo de destino após a automação executar todas as atividades adicionadas dentro desta atividade:
  • Nunca - Nunca feche o aplicativo.
  • Se aberto por Aplicativo/Navegador – Fechar apenas se o aplicativo tiver sido aberto pela automação. Esse é o valor padrão.
  • Sempre - Feche o aplicativo todas as vezes.

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

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

  • API do Chromium — Executa ações usando APIs do depurador. Compatível 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.

  • Segundo plano - Executa ações em segundo plano. Tenta usar Simulate ou a API do Chromium quando possível, enquanto as atividades complexas (image, native tex) são executadas normalmente, em primeiro plano. É altamente recomendável usar esse método com a funcionalidade Verificar execução .

    Observação: não há compatibilidade com o uso do Modo de entrada de segundo plano com aplicativos da Universal Windows Platform, o que significa que aplicativos desse tipo não podem ser automatizados em segundo plano.
• Abrir — selecione quando abrir o aplicativo de destino para a execução da automação:
  • Nunca - Nunca abra o aplicativo.
  • Se não estiver aberto – Abre apenas se o aplicativo estiver fechado. Esse é o valor padrão. Funciona apenas se os campos Caminho do arquivo ou URL forem preenchidos.
  • Sempre — abra outra instância do aplicativo, mesmo que uma já esteja aberta. Funciona apenas se os campos Caminho do arquivo ou URL estiverem preenchidos.

• Janela de redimensionamento - Define se o aplicativo/navegador é redimensionado ao ser inicializado.

  • Nenhum - Nenhum redimensionamento é aplicado ao aplicativo/navegador.
  • Maximizar - O aplicativo/navegador é maximizado quando inicializado.
  • Restaurar o tamanho do tempo de design - O aplicativo/navegador é redimensionado e movido para a posição e tamanho que tinha quando indicado, se possível.
  • Minimizar - O aplicativo/navegador é minimizado quando inicializado.
• Modo de anexação de janela - define onde as atividades internas procuram seus elementos de destino.
  • Instância do aplicativo — as atividades internas pesquisam a instância do aplicativo indicada, incluindo todas as janelas pai e filho (alertas, pop-ups, etc.). Outras instâncias do aplicativo são excluídas.
  • Janela única - Pesquisa de atividades internas somente na janela indicada.

Opções - Navegador

• Janela anônima/privada - Se selecionada, abre a nova sessão do navegador no modo anônimo/privado. Por padrão, essa caixa de seleção está desmarcada.

• Modo da pasta de dados do usuário - O modo da pasta de dados do usuário que você deseja definir. É usado para iniciar o navegador com uma pasta de dados do usuário específica.

  • Automático - Dispara automaticamente o modo Picture-in-Picture (PiP) com uma pasta de dados do usuário separada da pasta padrão. Se o caminho da pasta de dados do usuário não estiver definido, uma pasta é gerada automaticamente. Isso pode ser útil quando você está procurando o isolamento do navegador durante tarefas de automação e mantém os dados separados da sessão de navegação principal.
  • Pasta padrão - Usa a pasta do navegador padrão, independentemente de ser executada na sessão de navegação principal ou em uma sessão PIP. Essa opção é útil se você quiser que o UiPath Robot use a pasta de dados do usuário existente e você não precisar de uma sessão separada ou isolada para tarefas de automação.
  • Pasta personalizada - Usa a pasta especificada no caminho da pasta de dados do usuário. Se o Caminho da pasta de dados do usuário não estiver definido, será usado um caminho gerado automaticamente. Essa opção dá a você mais flexibilidade e controle para gerenciar suas pastas para diferentes tarefas de automação, ao definir um caminho personalizado para a pasta de dados do usuário.

  A configuração da pasta de dados do usuário do navegador só está disponível para o Chrome, Edge Chromium e Firefox.

• Caminho da pasta de dados do usuário — a pasta de dados do usuário que o navegador usa. O padrão é %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType , se não tiver sido definida.

  Mais detalhes sobre ModoDaPastaDeDadosDoUsuário e CaminhoDaPastaDeDadosDoUsuário podem ser encontrados aqui.

• Modo do WebDriver — indica como o WebDriver é usado ao abrir uma nova sessão do navegador. As seguintes opções estão disponíveis:

  • Desabilitado — desabilita o uso do WebDriver.
  • ComGUI - A GUI do navegador é exibida.
  • Sem periféricos - O navegador é iniciado silenciosamente, sem GUI.

  Mais detalhes sobre o WebDriver podem ser encontrados aqui.

Configuração multiplataforma

O nome da atividade em projetos multiplataforma é Use Browser e pode ser usado para automatizar apenas janelas de navegador Chrome e aplicativos Java.

Para automatizar aplicativos Java, você precisa definir como True a configuração do projeto Habilitar automação Java (preview) (Configurações do projeto > Automação de interface gráfica > Genérico).

• Selecione Indicar alvo na tela para identificar o aplicativo movendo o mouse para sua janela e selecionando-o.Se o destino for uma página da Web do navegador, navegue até a página antes de indicar o aplicativo.
• Depois de indicar o destino, gerencie o destino selecionando o botão de opções de menu e escolhendo uma das seguintes opções:
  • Indicar alvo na tela - Indicar o aplicativo novamente. Caso o Descritor seja definido no Repositório de Objetos, você tem que desvinculá-lo do Repositório de Objetos, se quiser indicar um Descritor apenas para a atividade atual.
  • Mostrar no Repositório de Objetos - Abre o painel Repositório de Objetos com o Descritor selecionado.
  • Desvincular do Repositório de Objetos - Desvincula o Descritor do Repositório de Objetos.
  • 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.
• Trabalho no escopo - Escolha a guia do navegador que renderiza o aplicativo da Web para automatizar. Se você indicou um aplicativo Java, ele está listado no menu suspenso entre as guias do navegador. A opção fica oculta quando apenas uma guia está disponível.
• Gerar - Abre o Gravador do Autopilot de Automação de Interface Gráfica, onde você pode gerar sequências de fluxo de trabalho de Automação de Interface Gráfica. Você também pode selecionar o ícone Gerar atividades de automação de interface gráfica usando o Autopilot no canto superior direito da caixa informativa da captura de tela. Para obter mais detalhes, consulte a página Gravador do Autopilot de automação de interface gráfica.
• URL — o URL do aplicativo da Web. O valor é preenchido automaticamente após a escolha da guia. Você também pode escolher Abrir o URL em uma nova guia acessando o menu de mais opções. Se a URL já estiver aberta, você pode trazê-la para o foco ou abri-la novamente em uma nova guia.
• Requer Autenticação? - Habilita a autenticação de vários fatores. Para obter mais detalhes, consulte a página Conexão com o navegador da Automação da Interface gráfica.

Opções adicionais

Horários

• 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

• Abrir — define se deve abrir o aplicativo de destino antes de executar as atividades nele.
  • Sempre - Abra a janela do navegador todas as vezes.
  • Se não abrir - Abre uma nova janela do navegador, se nenhuma corresponder ao seletor e à URL. Esse é o valor padrão.
  • Nunca - Nunca abra a janela do navegador.
• Fechar - Define se deve fechar o aplicativo de destino antes de executar as atividades nele.
  • Sempre - Feche a janela do navegador todas as vezes.
  • Se aberta por Use Browser - Feche apenas se a janela do navegador tiver sido aberta pela atividade Use Browser . Esse é o valor padrão.
  • Nunca - Nunca feche a janela do navegador.
• Modo de entrada - O método usado para gerar a entrada do teclado e do mouse.
  • 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.
  • Simular — simula as Actions usando APIs de acessibilidade. Funciona para navegadores. Envia todo o texto em uma única Actions. Funciona em segundo plano (mesmo se o aplicativo de destino não estiver em foco).
• Janela anônima/privada - Se selecionada, abre uma nova sessão do navegador no modo anônimo/privado. Este campo só aceita valores booleanos (True, False). O valor padrão é False.

• Modo da pasta de dados do usuário — o modo da pasta de dados do usuário que você deseja definir. É usado para iniciar o navegador com uma pasta específica de dados do usuário.

  • Automático - Dispara automaticamente o modo Picture-in-Picture (PiP) com uma pasta de dados do usuário separada da pasta padrão. Se o caminho da pasta de dados do usuário não estiver definido, uma pasta é gerada automaticamente. Isso pode ser útil quando você está procurando o isolamento do navegador durante tarefas de automação e mantém os dados separados da sessão de navegação principal.
  • Pasta padrão - Usa a pasta do navegador padrão, independentemente de ser executada na sessão de navegação principal ou em uma sessão PIP. Essa opção é útil se você quiser que o UiPath Robot use a pasta de dados do usuário existente e você não precisar de uma sessão separada ou isolada para tarefas de automação.
  • Pasta personalizada - Usa a pasta especificada no Caminho da pasta de dados do usuário. Se o Caminho da pasta de dados do usuário não estiver definido, será usado um caminho gerado automaticamente. Essa opção dá a você mais flexibilidade e controle para gerenciar suas pastas para diferentes tarefas de automação, ao definir um caminho personalizado para a pasta de dados do usuário.

  A configuração da pasta de dados do usuário do navegador só está disponível para Chrome, Edge Chromium e Firefox.

• Caminho da pasta de dados do usuário — a pasta de dados do usuário que o navegador usa. O padrão é %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType , se não tiver sido definida.

Destino

• Correspondência exata do título - Disponível apenas para aplicativos de desktop. Quando definidos como Ligado, apenas aplicativos que correspondem exatamente ao título atual são usados na automação. Quando definida como Desativada, a janela com o título correspondente mais próximo é usada na automação.O valor padrão é Desativado.
• Seletor - Lista de atributos usados para localizar uma janela específica do navegador.
• Argumentos — parâmetros a serem transmitidos ao aplicativo de destino na inicialização.

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.