Usar o Conector de aplicações universais

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 6 min. de leitura

    • Crie automações para suas aplicações baseadas em navegador Windows, Java, Google Chromee Edge usando o Universal App Connector (UAC). Configure as aplicações a partir de um único conector unificado e capture as telas e os 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

    Certifique-se de ter aplicações Windows, Java, Google Chromeou Edge abertas ou ativas.

    Função necessária: nenhuma

    Procedimento

    1. No painel Caixa de ferramentas, navegue até Conectorese arraste o Conector de aplicações universais para Objetos globais no painel Project Explorer.
      O conector é adicionado como um objeto UniversalApplication em Objetos globais.
    2. Opcional: Para renomear UniversalApplication, clique com o botão direito do mouse e selecione Renomear.
    3. Para usar os métodos no nível do conector do Universal App Connector, clique duas vezes no objeto UniversalApplication.
      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. Para obter mais informações sobre como usar o método Iniciar, consulte Usar o método Iniciar.
      Os métodos aparecem no painel Pesquisador de objetos.
    4. Para configurar as telas e os elementos no UAC, siga estas etapas.
      1. Em Objetos globais, clique com o botão direito do mouse em UniversalApplication e selecione Configurar.
      2. Na janela Configurar telas e elementos, selecione o menu suspenso Escolher em uma janela aberta ( Escolher em um menu suspenso em uma janela aberta) e selecione uma tela de aplicação.
        Aplicações abertas.
        Nota:
        • Se nenhum aplicativo compatível estiver aberto, a mensagem Janela do aplicativo não encontrado será exibida.
        • Para exibir telas de aplicações recém-abertas na lista, selecione o ícone Clique para atualizar o Windows (ícone Clique para atualizar o Windows.).
      3. Opcional: Para filtrar as aplicações abertas por tipo, selecione o ícone de filtro de tipo de aplicação (í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 serão exibidas na lista Escolher em uma janela aberta.
      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.

        O nome da tela da aplicação aparece em Telas e elementos.

      5. Opcional: Para mudar o nome da tela, 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.
      6. Opcional: Atualize o nome da tela da aplicação no campo Nome e pressione Enter.
        O nome da aplicação é atualizado no painel Telas e elementos.
      7. Para capturar os elementos da tela, no painel Tela e elementos, clique com o botão direito do mouse na tela adicionada e selecione Capturar elemento.
        Opção de capturar elemento.
        O foco é definido na tela do aplicativo que você capturou e a caixa de diálogo de captura de elementos é exibida.

        A tela capturada em foco e a caixa de diálogo de captura são exibidas.

      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 Capturar elemento, consulte Usar a caixa de diálogo Capturar elemento.

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

        Controles de tela capturados.

    5. Opcional: Use as regras de correspondência de tela para editar os valores nas regras de correspondência fornecidas para identificar a tela de forma exclusiva.
      Durante a execução, o plug-in deve identificar a tela de destino exclusivamente para automatizar as ações na tela. Exemplos de atributos são o título ou o URL da tela da aplicação. Os atributos aparecem no painel Regras de correspondência de tela na janela Configurar elementos e telas. O UAC usa esses atributos para identificar a tela primeiro e executar ações em elementos como Clicar ou Obter texto.

      Regras de correspondência de tela.

      A imagem abaixo mostra um exemplo de vários elementos que correspondem aos mesmos critérios fornecidos na seção Corresponder atributos. Um número múltiplo de instâncias, se houver, aparece quando você atualiza o elemento capturado, é 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 exatamente a um elemento.

      Várias instâncias do elemento capturado.

    6. Opcional: Use as regras de correspondência de elemento para editar os valores nas seções Localizador e Atributos de correspondência fornecidos para identificar um elemento de forma exclusiva.
      Durante a execução, o plug-in deve identificar o elemento de destino exclusivamente para automatizar as ações no elemento. Os atributos aparecem no painel Corresponder atributos na janela Configurar elementos e telas. O UAC usa esses atributos para identificar a tela primeiro e executar ações em elementos como Clicar ou Obter texto.

      A imagem mostra as regras de correspondência de um elemento capturado.

      Elemento e suas regras de correspondência.

    7. Opcional: Use os localizadores dos elementos capturados para encontrar os elementos na tela da aplicação.
      O UAC fornece vários tipos de localizador. Por exemplo, o localizador de XPath fornece o XPath para o elemento.

      Localizadores de elemento.

      1. No painel Telas e elementos, selecione um elemento em uma tela.
      2. Na lista Localizador, selecione um dos localizadores de elemento.
        Tabela 1. Localizadores de elemento de tela
        Tipo de localizador Tipo de aplicação Descrição
        Id Web, Java e Windows Identificador exclusivo do elemento se estiver definido na aplicação de destino.
        Nome Web, Java e Windows Nome exclusivo do elemento se estiver definido na aplicação de destino.
        SeletorCss Web O seletor de CSS que localiza o elemento da Web capturado. Por exemplo, div#navbarNav > ul > li > a. Se uma aplicação da web for compatível com o DOM de sombra, o Seletor de CSS mostrará o caminho com os elementos do DOM de sombra. Por exemplo, html > corpo > loja-app > /ShedowDom/ > app-header[id="header"] > app-toolbar > div:nth-of-type(3) > a > paper-icon-button > / SombraDom/ > ícone-de-ferro[id="icon"]
        Nome do marcador Web Nome de marcador exclusivo do elemento da Web.
        JavaScript Web Permite que o usuário defina um código JavaScript personalizado para localizar um elemento.
        XPath Web XPath para localizar o elemento da Web. Se uma aplicação da web for compatível com o DOM de sombra, este localizador mostrará o XPath completo com os elementos do DOM de sombra. Por exemplo, html > corpo > loja-app > /SombraDom/ > página-ferro > loja-home > /SombraDom/ > div > h2.
        Tipo Java e Windows Permite que você localize um elemento de tela por tipo. Por exemplo, botão ou caixa de texto.

        Quando você seleciona o localizador de tipo, o conector do UAC preenche o campo Valor com o tipo do elemento.
        Caminho Java e Windows Permite que você localize um elemento de tela especificando sua posição na hierarquia de elementos de tela.

        Quando você seleciona o localizador de caminho, o conector do UAC preenche o campo Valor com o caminho do elemento.
        CustomPath Windows Permite ajustar ou recortar o caminho para um elemento.
    8. Opcional: Para exibir o caminho para um iframe, se houver, em um elemento capturado, siga estas etapas.
      1. No painel Telas e elementos, selecione o elemento.
      2. Selecione a guia Advanced.
        O iframe é exibido.

        O iframe é exibido.

      3. Na lista Localizador, selecione um localizador para encontrar o caminho para o iframe.
        localizador de iframe.
    9. Opcional: Clique com o botão direito do mouse na tela ou no elemento da aplicação para executar operações adicionais.
      Para obter informações sobre as várias operações adicionais que estão disponíveis para as telas e os elementos da aplicação, consulte Opções adicionais para telas e elementos da aplicação no Conector de aplicações universais.
    10. Selecione Concluído depois de terminar de configurar as telas ou os elementos da aplicação.
      As telas da aplicação e seus elementos aparecem no objeto UAC em Objetos globais.
    11. Clique duas vezes na tela ou no elemento da aplicação necessário e o painel do Pesquisador 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 Pesquisador de objetos.
      • Para obter mais informações sobre métodos de conector Java, consulte Métodos de conector Java.

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

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

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

    12. Arraste o método necessário do painel Pesquisador 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 os elementos da aplicação e salve a automação.