Use o método GetValue para o Conector de app universal

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura
  • Use o método GetValue para recuperar um valor de um elemento.

    Antes de Iniciar

    Verifique se você tem aplicações abertas ou ativas, por exemplo, onde deseja capturar elementos.

    Função necessária: nenhuma

    Por Que e Quando Desempenhar Esta Tarefa

    Para obter informações sobre as várias operações adicionais que estão disponíveis para as telas e elementos da aplicação, consulte Opções adicionais para telas e elementos da aplicação no Conector de apps universais.

    Procedimento

    1. Configure o Conector de app universal.
      Para saber mais sobre como configurar as telas da aplicação e os elementos secundários, consulte Usar o Conector de app universal.
    2. Em Objetos globais, clique duas vezes no objeto UniversalApplication.
      O método GetValue aparece no painel do Pesquisador de objetos.
    3. Arraste o método GetValue para a superfície Design.
    4. Clique duas vezes no método GetValue para configurar as telas e os elementos no Conector de aplicações universais.
    5. Na janela Configurar telas e elementos, selecione o menu suspenso Escolher em uma janela aberta ( Escolha em uma janela suspensa) e selecione uma tela da aplicação.

      Por exemplo, selecione a aplicação Badge Tool.

      Configure a janela de telas e elementos exibindo a lista de janelas abertas no menu suspenso. A aplicação Ferramenta de crachá está selecionada.
      Nota:
      • Se nenhuma aplicação compatível estiver aberta, a mensagem Janela da aplicação não encontrada será exibida.
      • Para exibir telas de aplicações recém-abertas na lista, selecione o ícone Clique para atualizar janelas ( ícone Atualizar janelas).
    6. Para adicionar a tela da aplicação selecionada, por exemplo, a aplicação Badge Tool, 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 Ferramenta de crachá aparece em Telas e elementos.

    7. Para capturar os elementos da tela, clique com o botão direito do mouse na tela adicionada e selecione Capturar elemento.
      O foco é definido na tela da aplicação que você capturou e a caixa de diálogo de captura de elementos é exibida.
    8. Depois de selecionar o elemento necessário, selecione o ícone Adicionar elemento ( ícone Adicionar elemento) para capturar o elemento.
      Nota:
      Você deve adicionar pelo menos um elemento para continuar.

      Por exemplo, selecione o elemento de caixa de texto marcado como edição selecionando a caixa de texto ao lado do campo Nome de usuário.A aplicação Ferramenta de crachá mostra a caixa de diálogo Capturar elemento que captura o campo de nome de usuário. Este campo pode ser adicionado como um elemento usando o botão Adicionar elemento.

    9. Na janela Configurar telas e elementos, clique com o botão direito do mouse no elemento capturado, escolha Selecionar e selecione Concluído.
      Nota:
      Selecione pelo menos um elemento para executar a ação. Se nenhum estiver selecionado, a ação não será executada. Para prosseguir sem selecionar, selecione OK.
      Configure as telas e a janela de elementos exibindo a opção Selecionar em um nível de elemento.
    10. Clique com o botão direito do mouse no método GetValue e selecione Executar a partir daqui ou Executar isto.
      Tabela 1. Parâmetros do método GetValue
      Nome do parâmetro Descrição do parâmetro Tipo de porta Tipo de Dados
      Retornar Recupera um valor do elemento capturado. Saída de dados Cadeia de caracteres
      O valor de entrada no elemento capturado é recuperado e exibido na porta de saída de dados do método GetValue. Neste cenário, a ServiceNow é recuperada.ServiceNow exibido como a saída no elemento capturado.
    11. Clique duas vezes na tela da aplicação ou no elemento 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 métodos de conector do Windows, consulte Métodos de conector do Windows.
      • Se você capturou uma tela de aplicação web e deseja executar um JavaScript personalizado nela, você pode usar o método ExecuteJavascript.