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

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. 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, em que 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 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.

    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 Use o Conector de app universal.
    2. Em Objetos globais, clique duas vezes em Aplicação universal objeto.
      O método GetValue aparece no painel Explorador de objetos.
    3. Arraste o método GetValue para a superfície de design.
    4. Clique duas vezes no método GetValue para configurar as telas e os elementos no Conector de aplicativo universal.
    5. Na janela Configurar telas e elementos, selecione o menu suspenso Escolher de uma janela aberta ( Escolha em um menu suspenso de janela aberta.) e selecione uma tela de aplicação.

      Por exemplo, selecione a aplicação Ferramenta de crachá.

      Janela Configurar 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, 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 ( Ícone Atualizar janelas.).
    6. Para adicionar a tela da aplicação selecionada, por exemplo, Aplicação Ferramenta de crachá, 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 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. Depois de selecionar o elemento necessário, selecione o ícone Adicionar elemento ( Ícone Adicionar elemento) e selecione o modo como UIA , 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 Elemento de captura que captura o campo de nome de usuário no modo UIA. 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 e escolha Selecione e selecione Concluído .
      Nota:
      Selecione pelo menos um elemento para executar a ação. Se nenhum for selecionado, a ação não será executada. Para prosseguir sem selecionar, selecione OK .
      Janela Configurar telas e 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 um deles Executar a partir daqui ou Execute isso .
      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 exibida como a saída no elemento capturado.
    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 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.