Use o método SetValue 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 SetValue para atribuir um valor especificado a 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 SetValue aparece no painel do Pesquisador de objetos.
    3. Arraste o método SetValue para a superfície Design.
    4. Clique duas vezes no método SetValue 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 o Windows ( ícone Clique para atualizar o Windows).
    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 a caixa de texto ao lado do campo Nome de usuário e selecione o marcador como edição.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. Preencha os seguintes parâmetros no método SetValue:
      Tabela 1. Parâmetros do método SetValue
      Nome do parâmetro Descrição do parâmetro Tipo de porta Tipo de Dados
      Valor Insira o valor que você deseja atribuir no elemento.

      Por exemplo, ServiceNow.

      Entrada de dados Cadeia de caracteres
    11. Clique com o botão direito do mouse no método SetValue e selecione Executar a partir daqui ou Executar isto.
      O valor de entrada é exibido no elemento capturado. Neste cenário, a ServiceNow é exibida no campo Nome de usuário.ServiceNow exibido no elemento capturado que é o campo Nome de usuário.
    12. 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.