Use o Conector de app universal

Crie automações para o. Windows, Java, Google Chromee. EdgeAplicações baseadas em navegador usando o Conector universal de aplicações (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

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

Função necessária: nenhuma

Procedimento

1. No painel Caixa de ferramentas, navegue até Conectores e arraste Conector de app universal para Objetos globais No painel Explorador de projetos.
   O conector é adicionado como Aplicação universal objeto em Objetos globais .
2. Opcional: Para renomear Aplicação universal , clique com o botão direito do mouse e selecione Renomeie .
3. Para usar os métodos em Conector de app universal nível do conector, clique duas vezes em Aplicação universal objeto.
   Por exemplo, o método Iniciar será usado se você quiser que o navegador ou a aplicação seja iniciado antes de interagir com qualquer tela ou elemento da aplicação. Para obter mais informações sobre como usar o método Iniciar, consulte Use o método Iniciar .
   Os métodos aparecem no painel Explorador de objetos.
4. 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 o menu suspenso Escolher em uma janela aberta ( ) 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 o ícone de tipo de aplicação de filtro ( ) 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.
   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. 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 Nome e pressione Insira .
      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 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.

      

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

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

      

5. Opcional: Use as regras de correspondência de tela para editar os valores nas regras de correspondência fornecidas para identificar a tela exclusivamente.
   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 URL da tela da aplicação. Os atributos aparecem em Regras de correspondência de tela painel no Configure 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 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.

   

6. Opcional: Use as regras de correspondência de elemento para editar os valores no fornecido Localizador e o. Atributos de correspondência seções para identificar um elemento exclusivamente.
   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 Configure 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.

   

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 XPath fornece o XPath para o elemento.

   

   1. No painel Telas e elementos, selecione um elemento em uma tela.
   2. Em Localizador selecione um dos localizadores de elemento.

      Tabela 1. Localizadores de elemento da 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.
      CssSeletor	Web	O seletor CSS que localiza o elemento web capturado. Por exemplo, Náv > ul > li > a. . Se uma aplicação web oferecer suporte ao Shadow DOM, o Seletor CSS mostrará o caminho com os elementos do shadow DOM. Por exemplo, html > body > shop-app > /ShadowDom/ > app-header > app-toolbar > div:nth-of-type(3) > a > paper-icon-button > /ShadowDom/ > iron-icon[id
      Nome do marcador	Web	Nome de marcador exclusivo do elemento 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 web. Se uma aplicação web oferecer suporte ao Shadow DOM, este localizador mostrará o XPath completo com os elementos Shadow DOM. Por exemplo, html > body > shop-app > /ShadowDom/ > iron-pages > shop-home > /ShadowDom/ > div > h2 .
      Tipo	Java e Windows	Permite localizar um elemento de tela por tipo. Por exemplo, botão ou caixa de texto. Quando você seleciona Tipo O conector do UAC preenche o. Valor campo com o tipo do elemento.
      Caminho	Java e Windows	Permite localizar um elemento da tela especificando sua posição na hierarquia de elementos da tela. Quando você seleciona Caminho O conector do UAC preenche o. Valor campo com o caminho do elemento.
      CustomPath	Windows	Permite ajustar ou aparar o caminho para um elemento.

8. Opcional: Para exibir o caminho para um iframe, se houver, em um elemento capturado, execute as etapas.
   1. Em Telas e elementos selecione o elemento.
   2. Selecione a guia Advanced.
      O iframe é exibido.

      

   3. Em Localizador selecione um localizador para encontrar o caminho para o iframe.
      
9. Opcional: Clique com o botão direito do mouse na tela da aplicação ou no elemento para executar operações adicionais.
   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 app universal.
10. Selecione Concluído após concluir a configuração das telas ou elementos da aplicação.
    As telas da aplicação e seus elementos aparecem sob o objeto do UAC em Objetos globais .
11. 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 de conector Java, consulte Métodos do conector Java .

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

    • Para obter mais informações sobre métodos do Conector do Windows, consulte Métodos de conector do Windows .
12. 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.