Use o Conector de app universal

Crie automações para seu Windows Java, Google Chrome e Edge Aplicações baseadas em navegador usando o Conector de aplicativo universal (UAC). Configure as aplicações a partir de um único conector unificado e capture as telas e elementos ou controles de tela, como caixas de seleção e botões. Use os métodos dessas telas e elementos para criar sua automação.

Antes de Iniciar

Adicione o plug-in Conector de aplicativo universal do Gerenciador de plug-ins antes de usar o conector. Para obter mais informações sobre como adicionar o plug-in SSH, consulte Gerencie plug-ins no Design studio de RPA para desktop.

Verifique se você está aberto ou ativo Windows Java, Google Chrome ou Edge aplicações.

Função necessária: nenhuma

Procedimento

1. No painel Caixa de ferramentas, navegue até Conectores e arraste Conector de aplicativo universal . Objetos globais No painel Explorador de projetos.
   O conector é adicionado como Aplicação universal objeto em Objetos globais .
2. Para usar os métodos em Conector de aplicativo universal no nível do conector, clique duas vezes em Aplicação universal objeto.

   Nome do método	Referência
   Clique	Use o Método de clique para o Conector de aplicativo universal
   GetValue	Use o método GetValue para o Conector de app universal
   SetValue	Use o método SetValue para o Conector de app universal
   Início	Use o método Iniciar para o Conector de aplicativo universal
   WaitForAnyScreen	Use o método WaitForAnyScreen para o Conector de aplicativo universal

   Por exemplo, o método Iniciar será usado se você quiser que o navegador ou a aplicação inicie antes de interagir com qualquer tela ou elemento da aplicação.
   Os métodos aparecem no painel Explorador de objetos.
3. Para configurar as telas e os elementos no UAC, execute as etapas.
   1. Em Objetos globais, clique com o botão direito do mouse Aplicação universal e selecione Configurar .
   2. Na janela Configurar telas e elementos, selecione Escolha em uma janela aberta menu suspenso ( ) e selecione uma tela de aplicação.
      

      Nota:

      • Se nenhuma aplicação compatível estiver aberta, o. Mensagem Janela da aplicação não encontrada é exibido.
      • Para exibir telas de aplicações recém-abertas na lista, selecione o ícone Clique para atualizar janelas ( ).
   3. Opcional: Para filtrar as aplicações abertas por tipo, selecione Todos ícone filtrar tipo de aplicação ( ) E selecione Todos ou o tipo de aplicação.

      Por exemplo, se você selecionar Chrome , Somente as páginas da web do Google Chrome aparecem no Escolha em uma janela aberta lista.

      Por exemplo, se você selecionar WindowsAplicação , somente Windows as telas aparecem em Escolha em uma janela aberta lista.

      Figura 1. Filtre as aplicações abertas

      

   4. Para adicionar a tela da aplicação selecionada, selecione Adicionar tela .
      Depois de executar esta etapa, você pode capturar os elementos da tela para executar ações.
      A tela da aplicação aparece no painel Telas e elementos.

      

   5. Para capturar os elementos da tela, no painel Tela e elementos, clique com o botão direito do mouse na tela adicionada e selecione Elemento de captura .
      
      O foco é definido na tela da aplicação que você capturou e a caixa de diálogo de elementos de captura é exibida.

      Por exemplo, quando você está capturando elementos de um WindowsAplicação como o Bloco de Notas. Se você selecionar UIA (Automação de IU), a barra de rolagem do Bloco de notas também é capturada.

      Figura 2. Caixa de diálogo de captura da aplicação Windows - Bloco de notas - Modo UIA

      

      Se você selecionar AA. (Active Accessibility), a barra de rolagem do Bloco de notas não é capturada.

      Figura 3. Caixa de diálogo de captura da aplicação Windows - Bloco de notas - Modo AA.

      

   6. Para usar os métodos em Conector de aplicativo universal Para os dois modos, Automação de IU e Acessibilidade ativa, clique duas vezes em Aplicação universal objeto.
      Para obter mais informações sobre os métodos para o modo Automação de IU e o modo de acessibilidade ativa, consulte Modos Automação de IU e Active Accessibility Mode.
      Os métodos aparecem no painel Explorador de objetos.
4. Escolha uma das opções a seguir para uma ação desejada.

   Opção	Ação
   Para renomear Aplicação universal	Navegue até Objetos globais No painel Explorador de projetos, clique com o botão direito do mouse em Aplicação universal e selecione Renomear . Figura 4. Renomeie UniversalApplication
   Para mudar o nome da tela ao configurar as telas e os elementos	Selecione o nome da tela da aplicação no painel Telas e elementos. As informações da tela da aplicação selecionada aparecem no painel Propriedades. Atualize o nome da tela da aplicação no Nome e pressione Insira . O nome da aplicação é atualizado no painel Telas e elementos. Figura 5. Atualize o nome da tela da aplicação
   Para identificar a tela de forma exclusiva	Use as regras de correspondência de tela para identificar e localizar a tela. Durante a execução, o plug-in deve identificar a tela de destino exclusivamente para automatizar ações na tela. Exemplos de atributos são o título ou o URL da tela da aplicação. Os atributos aparecem em Regras de correspondência de tela painel no Configurar telas e elementos janela. O UAC usa as regras de correspondência de tela para identificar a tela primeiro e usa a regra de correspondência de elemento para identificar o elemento e, em seguida, executa ações em elementos como Clicar ou Obter texto. A imagem abaixo mostra um exemplo de vários elementos que correspondem aos mesmos critérios fornecidos na seção Atributos de correspondência. Um número múltiplo de instâncias, se houver, aparece quando você atualiza o elemento capturado e é indicado entre colchetes em vermelho. Nesses casos, você deve ajustar os atributos para selecionar exatamente o elemento que precisa ser automatizado. O usuário pode atualizar para verificar se os critérios selecionados correspondem a exatamente um elemento.
   Para identificar um elemento exclusivamente	Use as regras de correspondência de elemento para editar os valores no fornecido Localizador e o. Atributos de correspondência seções. Durante a execução, o plug-in deve identificar o elemento de destino exclusivamente para automatizar ações no elemento. Os atributos aparecem em Atributos de correspondência painel no Configurar telas e elementos janela. O UAC usa as regras de correspondência de tela para identificar a tela primeiro e usa a regra de correspondência de elemento para identificar o elemento e, em seguida, executa ações em elementos como Clicar ou Obter texto. A imagem mostra as regras de correspondência de um elemento capturado.
   Para encontrar os elementos na tela da aplicação	Use os localizadores dos elementos capturados. Para obter mais informações, consulte Encontre os elementos na tela da aplicação.
   Para exibir o caminho para um iframe, se houver, em um elemento capturado	Em Telas e elementos , selecione o elemento. Selecione a guia Advanced. O iframe é exibido. Em Localizador , selecione um localizador para encontrar o caminho para o iframe.

5. Opcional: Clique com o botão direito do mouse na tela da aplicação ou no elemento para executar operações adicionais, como Atualizar , Atualizar tela e elementos , Foco , Adicionar elemento personalizado , Mostrar elementos , Excluir e muito mais.
   Para obter informações sobre as várias operações adicionais disponíveis para as telas e elementos da aplicação, consulte Opções adicionais para telas e elementos da aplicação no Conector de aplicativo universal.
6. Selecione Concluído depois de terminar de configurar as telas ou elementos da aplicação.
   As telas da aplicação e seus elementos aparecem no objeto UAC em Objetos globais .
7. Clique duas vezes na tela ou no elemento da aplicação necessário e o painel Explorador de objetos será exibido listando os métodos relacionados.
   Por exemplo, se você selecionar uma tela ou elemento de aplicação Java, os métodos do conector Java serão exibidos no Explorador de objetos.

   • Para obter mais informações sobre métodos do conector Java, consulte Métodos do Conector Java .

   • Para obter mais informações sobre os métodos do Google Chrome e do Microsoft Edge Connector, consulte Métodos de conector Chromium .

   • Para obter mais informações sobre métodos do Conector do Windows, consulte Métodos do Conector do Windows .

   • Se você capturou uma tela de aplicação web e deseja executar um JavaScript personalizado nela, poderá usar o método ExecuteJavascript.

8. Capture quantos elementos de tela forem necessários usando a caixa de diálogo Capturar elemento.

   Para aprender a usar a caixa de diálogo Elemento de captura, consulte Use a caixa de diálogo Capturar elemento .

   Os elementos da tela capturados aparecem na tela da aplicação capturada como elementos.

   

9. Arraste o método necessário do painel Explorador de objetos para a superfície de design.

   O método é exibido com a tela da aplicação ou o nome do elemento na superfície de design.

O que Fazer Depois

Projete a automação usando os diferentes métodos para as telas e elementos da aplicação e salve a automação.