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.

Observaçã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:).

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

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

Observação:

• A partir do UIAutomation v20.10.x, várias atividades Use Application/Browser podem ser aninhadas umas nas outras. Isso permite que você automatize vários aplicativos simultaneamente.
• A partir do UIAutomation v21.10.3, a atividade Use Application/Browser pode abrir aplicativos em ambientes remotos.
• A partir do UIAutomation v22.10.1, a atividade também pode abrir navegadores em ambientes remotos.

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Configuração do Windows e multiplataforma

• 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 seu 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 URL em uma nova guia acessando o menu mais opções. Se a URL já estiver aberta, você pode colocá-la em 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 .

Painel de Propriedades

Manuseio de caixas de diálogo

• Ignorar alertas — habilita o encerramento automático de caixas de diálogo de alerta do JavaScript.
• Ignorar confirmações – Habilita o encerramento automático de caixas de diálogo de confirmação do JavaScript.
• Confirmar resposta da caixa de diálogo - Resposta à confirmação das caixas de diálogo do JavaScript: Cancelar ou OK. Ela só estará disponível quando Descartar Confirmações estiver definido como True.
• Ignorar prompts - Habilite o encerramento automático de caixas de diálogo de prompt do JavaScript.
• Resposta da caixa de prompt - Resposta a caixas de diálogo do prompt do JavaScript: Cancelar ou OK. Ela só estará disponível quando Ignorar Prompts estiver definido como True.
• Texto de resposta do prompt - Resposta de texto para diálogos de prompt do JavaScript. Ela só estará disponível quando Ignorar Prompts estiver definido como True.

Entrada/Saída

• 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

• Abrir — define se deve abrir o aplicativo de destino antes de executar as atividades nele.

  • Sempre - Abra a janela do navegador toda vez.
  • Se não estiver aberto - Abra uma nova janela do navegador se nenhuma corresponder ao seletor e à URL. Esse é o valor padrão.
  • Nunca - abrir a janela do navegador.

• Fechar — Define se o aplicativo de destino deve ser fechado antes de executar as atividades nele.

  • Sempre — feche a janela do navegador sempre.
  • Se aberta por Usar navegador — Fechar apenas se a janela do navegador tiver sido aberta pela atividade Usar navegador . Esse é o valor padrão.
  • Nunca - feche a janela do navegador.

• Modo de entrada - O método usado para gerar entrada do teclado e mouse.

  • Chromium API - Performs actions using debugger APIs. Works only for Chromium elements. Sends all text in one go. Works even if target app is not in focus.
  • Simular — simula a ação usando APIs de acessibilidade. Funciona para navegadores. Envia todo o texto em uma única ação. Funciona em segundo plano (mesmo que o aplicativo de destino não esteja em foco).

• Janela anônima/privada — se selecionada, abre a 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 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 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.

• Resize window - Defines whether the application/browser is resized when initialized.

  • Nenhum – Nenhum redimensionamento é aplicado ao aplicativo/navegador.
  • Maximizar – O aplicativo/navegador é maximizado quando inicializado.
  • Restaurar o tamanho do período 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.

• Window attach mode - Defines where inner activities search for their target elements.

  • Application instance - Inner activities search the indicated application instance, including all parent and child windows (alerts, popups, etc). Other instances of the application are excluded.
  • Single window - Inner activities search only in the indicated window.

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

• WebDriver mode - Indicates how the WebDriver is used when opening a new browser session. The following options are available:

  • Desabilitado — desabilita o uso do WebDriver.
  • Com interface gráfica – A interface gráfica do navegador é exibida.
  • Sem periféricos - O navegador é iniciado de forma silenciosa, sem interface gráfica. Mais detalhes, consulte Sobre o protocolo do WebDriver.

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

Destino

• URL - If the application is a web browser, specifies the URL of the web page to open. If a URL is specified, the File path property is cleared.
• File path - If the application is not a web browser, specifies the full path of the executable file to open. If a file path is specified, the URL property is cleared.
  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 - Lista de atributos usados para localizar uma janela de navegador específica.
• Argumentos — parâmetros a serem transmitidos ao aplicativo de destino na inicialização.
• Diretório de trabalho - O caminho para o diretório de trabalho atual. Este campo é compatível apenas com variáveis String ou valores string, que devem ser colocados entre aspas.

Horários

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

Windows - Configuração legada

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

  • Indicate target on screen - Indicate the application again.
  • Highlight Target - View the indicated application on your screen surrounded in a box.
  • Show informative screenshot - View a screenshot of the target application or web page.
  • Remover captura de tela informativa – Remove a captura de tela do aplicativo de destino ou página da Web.
  • Mecanismo de OCR — selecione uma de duas opções:
    • Mecanismo de OCR incorporado - Use 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 essa opção é selecionada, um painel é adicionado ao cartão de atividades onde você pode soltar uma atividade de mecanismo de 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 seu 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, selecione Mais no lado direito do campo URL do navegador e, em seguida, use 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 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.

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

  Importante:

  O nome de exibição da atividade Use Application/Browser também é usado como uma referência que aponta para o aplicativo ou navegador que está sendo direcionado. Após 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 aplicativos aninhados, cada atividade dentro de um cartão exibe uma soltar em seu corpo, que permite escolher o cartão do aplicativo com o qual você deseja usá-lo.

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

  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.

• Unified Target Application - Expand this category to configure the following settings:

  • Arguments - If the application is not a web browser, you can specify parameters to pass to the target application at startup. You can use this property to open a specific file with the application. For example, if the target application is Acrobat Reader, you can open a specific workbook by providing the full path to the file. To open the file C:\Sample.pdf, enter "C:\Sample.pdf". Certain application types are automatically identified and autofill the Arguments property, such as Java apps, Office Suite apps, Adobe Acrobat, or Windows File Explorer.
  • File path - If the application is not a web browser, specifies the full path of the executable file to open. If a file path is specified, the URL property is cleared.
    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.

  • Selector - An XML fragment that stores the attributes of a user interface element.
  • URL - If the application is a web browser, specifies the URL of the web page to open. If a URL is specified, the File path property is cleared.
  • DiretórioDeTrabalho - O caminho para o diretório de trabalho atual. Este campo é compatível apenas com variáveis String ou valores string, que devem ser colocados entre aspas.

• Elemento de entrada — o elemento de destino que você deseja usar com esse aplicativo, armazenado em um objeto UIElement . Este objeto pode ser recuperado da propriedade Elemento de Saída de outra atividade do UIAutomation. Você pode usar esse campo de propriedade para passar o elemento de destino de uma atividade anterior para esta sem ter que indicá-lo novamente. Este campo é compatível apenas com variáveis UIElement .

• Output Element - Outputs the target element indicated in this activity to an UIElement variable which can then be reused in other activities. This field supports only UIElement variables.

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

• Fechar — selecione quando fechar o aplicativo de destino após a automação executar todas as atividades adicionadas dentro desta atividade:

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

• Input mode - Select which method the Robot should use to interact with the target application:

  • Hardware Events - Uses the hardware driver to perform the action. This is the slowest method, it cannot work in the background, but it is compatible with all desktop apps.
  • 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 ação. 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. 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 de janelas - Simule usando mensagens Win32. Recomendado para aplicativos de desktop. Geralmente mais confiável que Eventos de hardware. Envia todo o texto em uma única ação. 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 API do Chromium quando possível, enquanto atividades complexas (imagem, texto nativo) são executadas como de costume, em primeiro plano. É altamente recomendável usar esse método com a funcionalidade Verificar execução .
    Observação:

    O uso do Modo de entrada de segundo plano com aplicativos da Universal Windows Platform não é compatível, 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 - 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 - Abre outra instância do aplicativo mesmo que uma já esteja aberta. Funciona apenas se os campos Caminho do arquivo ou URL forem preenchidos.

• Resize window - Defines whether the application/browser is resized when initialized.

  • Nenhum – Nenhum redimensionamento é aplicado ao aplicativo/navegador.
  • Maximizar – O aplicativo/navegador é maximizado quando inicializado.
  • Restaurar o tamanho do período 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.

• Window attach mode - Defines where inner activities search for their target elements.

  • Application instance - Inner activities search the indicated application instance, including all parent and child windows (alerts, popups, etc). Other instances of the application are excluded.
  • Single window - Inner activities search only in the indicated window.

Opções - Navegador

• Manuseio de caixas de diálogo — depois de selecionar o valor DialogHandling em vez de (null), você pode configurar as seguintes opções:

  • Ignorar alertas — habilita o encerramento automático de caixas de diálogo de alerta do JavaScript.
  • Ignorar confirmações – Habilita o encerramento automático de caixas de diálogo de confirmação do JavaScript.
  • Confirmar resposta da caixa de diálogo - Resposta à confirmação das caixas de diálogo do JavaScript: Cancelar ou OK.
  • Ignorar prompts - Habilite o encerramento automático de caixas de diálogo de prompt do JavaScript.
  • Resposta da caixa de prompt - Resposta a caixas de diálogo do prompt do JavaScript: Cancelar ou OK.
  • Texto de resposta do prompt - Resposta de texto para diálogos de prompt do JavaScript.

• Incognito/private window - If selected, opens the new browser session in incognito/private mode. By default, this check box is cleared.

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

• WebDriver mode - Indicates how the WebDriver is used when opening a new browser session. The following options are available:

  • Desabilitado — desabilita o uso do WebDriver.
  • ComGUI – A GUI do navegador é exibida.
  • Sem periféricos - O navegador é iniciado de forma silenciosa, sem interface gráfica. Mais detalhes sobre o WebDriver podem ser encontrados aqui.