Métodos do Conector Java

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 8 min. de leitura

    • O Conector Java expõe métodos nos níveis de conector, tela e elemento. Todos os tipos de elementos têm métodos comuns, mas eles também têm métodos diferentes.

    Métodos de nível de conector

    Início

    Inicia a aplicação Java a partir de seu local e a coloca em foco.
    Nota:
    Primeiro, você deve executar este método.

    Para fornecer entradas para os parâmetros, consulte Configure as propriedades da porta.

    Tabela 1. Parâmetros do método de início
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Caminho Caminho para a aplicação Java na unidade local. Dados em Cadeia de caracteres Nenhum(a) Sim
    Args Argumentos para o caminho. Dados em Cadeia de caracteres Nenhum(a) Não

    GetMainWindowHandle

    Retorna o identificador da janela da aplicação Java iniciada pelo método Iniciar.

    Tabela 2. Parâmetros do método GetMainWindowHandle
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Retorna o identificador da janela da aplicação. Saída de dados Inteiro Nenhum(a) Não aplicável

    GetMainWindowTítulo

    Retorna o título da janela da aplicação Java.

    Tabela 3. Parâmetros do método GetMainWindowTitle
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Retorna o título da janela da aplicação. Saída de dados Cadeia de caracteres Nenhum(a) Não aplicável

    EncerraMainWindow

    Fecha a janela principal da aplicação Java.

    Finalizar

    Encerra a janela principal da aplicação Java.

    Métodos no nível da tela

    Fechar

    Fecha a janela da aplicação Java ativa.

    Foco

    Se a janela da aplicação Java estiver minimizada ou em execução em segundo plano, o método restaurará o foco.

    GetFields

    Obtém os dados dos campos de texto em uma aplicação Java. Primeiro, você deve configurar os campos de texto. Para configurar, execute as etapas a seguir.
    1. Configure o conector Java e capturam um ou mais campos de texto.
    2. Exponha os métodos no nível da tela. Consulte Use o método de conector.
    3. No painel do Explorador de objetos, arraste o método GetFields para a superfície de design.
    4. Clique no ícone Configurações de método ( Ícone de configurações de método.).
    5. Selecione um ou mais campos de texto.
    6. Atualize o tipo de dados do campo de texto.
    7. Para fechar a janela ESCOLHER ELEMENTOS DE FORMULÁRIO, clique em OK .

      Uma porta de saída de dados é criada para cada campo de texto selecionado.

    O método GetFields agora pode retornar os dados contidos nos campos de texto.

    GetInstanceCount

    Retorna o número total de instâncias da aplicação Java abertas.

    Tabela 4. Parâmetros do método GetInstanceCount
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Retorna o número total de instâncias da aplicação Java abertas. Saída de dados Inteiro Nenhum(a) Não aplicável

    GetScreenshot

    Captura e retorna a captura de tela da tela da aplicação Java.

    Tabela 5. Parâmetros do método GetInstanceCount
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Retorna a captura de tela da tela da aplicação Java. Saída de dados Bitmap Nenhum(a) Não aplicável

    GetWindowHandle

    Retorna Windows Número do identificador da janela da tela da aplicação Java.

    Tabela 6. Parâmetros do método GetInstanceCount
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Retorna Windows Número do identificador da janela da tela da aplicação Java. Saída de dados Inteiro Nenhum(a) Não aplicável

    ÉCriado

    Retorna a resposta booliana com base na correspondência das regras de uma janela configurada. Quando você configura uma tela de aplicação Java, a seção REGRAS DE CORRESPONDÊNCIA da janela Conector Java mostra determinadas regras que correspondem à tela configurada. O método corresponde às mesmas regras.

    Para fornecer entradas para os parâmetros, consulte Configure as propriedades da porta.

    Tabela 7. Éparâmetros do método criado
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório? Anotações
    MatchAllChild Retorna a resposta booliana depois de corresponder às regras dos elementos da tela. Dados em Booliano Nenhum(a) Não Este parâmetro será relevante se você capturar um ou mais elementos.
    Retornar Retorna a resposta booliana para se as regras da tela da aplicação Java configurada corresponderam. Saída de dados Booliano Nulo Não aplicável

    Maximizar

    Maximiza a janela da aplicação Java.

    Minimizar

    Minimiza a janela da aplicação Java.

    MouseAction

    Executa diferentes ações do dispositivo do mouse na aplicação Java, como clique com o botão esquerdo, clique com o botão direito e clique do meio do mouse.

    Para fornecer entradas para os parâmetros, consulte Configure as propriedades da porta.

    Tabela 8. Parâmetros do método MouseAction
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Ação Especifica a ação do dispositivo do mouse. Dados em Entrada de dispositivo de mouse Nenhum(a) Sim
    Clique no meio Se um clique do meio será realizado. Dados em Booliano Nenhum(a) Não

    Redimensionar

    Muda a largura, a altura e a posição da janela da aplicação Java ao longo dos eixos X e Y.

    Para fornecer entradas para os parâmetros, consulte Configure as propriedades da porta.

    Tabela 9. Parâmetros do método de redimensionamento
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    XPos Posição da janela na tela ao longo do eixo X. Dados em Inteiro Nenhum(a) Não
    YPos Posição da janela na tela ao longo do eixo Y. Dados em Inteiro Nenhum(a) Não
    Largura Largura da janela. Dados em Inteiro Nenhum(a) Não
    Altura Altura da janela. Dados em Inteiro Nenhum(a) Não

    Restaurar

    Restaura as dimensões originais da janela da aplicação Java. Você pode usar o método depois de executar métodos como maximizar e minimizar.

    Chaves de envio

    Envie qualquer entrada de dados ou teclado para o campo ativo na aplicação Java. Por exemplo, você pode enviar uma cadeia de caracteres de dados "RPA" ou uma entrada de teclado [Espaço] para desmarcar uma caixa de seleção.

    Para fornecer entradas para os parâmetros, consulte Configure as propriedades da porta.

    Tabela 10. WaitForCreate parâmetros do método
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Chaves Envia os dados ou a entrada do teclado para o campo ativo. Dados em Cadeia de caracteres Nenhum(a) Sim
    ValorExistente Antes de enviar qualquer entrada de dados ou teclado, limpa qualquer valor existente no campo ativo. Dados em Booliano Nenhum(a) Não
    TypeAtraso Define um atraso antes de enviar qualquer entrada de dados ou teclado para o campo ativo. Dados em Inteiro Nenhum(a) Não

    SetFields

    Defina texto personalizado nos elementos do campo de texto capturados da tela da aplicação Java.

    Para usar o método, execute as etapas a seguir.
    1. No Explorador de objetos, arraste o método SetFields para a superfície de design.
    2. Clique no ícone Configurações de método ( Ícone de configurações de método.).
    3. Selecione um ou mais campos de texto.
    4. Atualize o tipo de dados do campo de texto.
    5. Clique em OK.

      Uma porta de entrada de dados é criada para cada campo de texto selecionado. Você pode passar a cadeia de caracteres a ser definida nos campos da aplicação Java.

      Para fornecer entradas para os parâmetros, consulte Configure as propriedades da porta.

    WaitForCriar

    Cada tela que você configura no Java Connector é identificada por algumas regras, exibidas na seção REGRAS DE CORRESPONDÊNCIA da janela Java Connector. O método retorna uma resposta booliana com base no fato de as regras da tela que você configurou corresponderem.

    Para fornecer entradas para os parâmetros, consulte Configure as propriedades da porta.

    Tabela 11. WaitForCreate parâmetros do método
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Timeoutemsegundos Tempo após o qual a operação do método expira. Dados em Inteiro Nenhum(a) Não
    MatchAllChild Retorna a resposta booliana depois de corresponder às regras dos elementos da tela. Dados em Booliano Nenhum(a) Não
    Retornar Retorna a resposta booliana para se as regras da tela da aplicação Java configurada corresponderam. Saída de dados Booliano Nenhum(a) Não

    Métodos de nível de elemento

    GetAccessibleActions

    Retorna a lista de ações que você pode executar em um elemento. Por exemplo, para um botão, ele retorna Clique em .
    Tabela 12. Parâmetros do método gettext
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Retorna a lista de ações que você pode executar em um elemento. Saída de dados Lista Nenhum(a) Não aplicável

    GetInstanceCount

    Retorna a contagem total de um tipo de elemento na aplicação Java. Por exemplo, se houver três caixas de texto em uma aplicação, a contagem de instâncias será 3.

    Tabela 13. Parâmetros do método gettext
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Retorna a contagem de instâncias de um tipo de elemento na aplicação. Saída de dados Inteiro Nenhum(a) Não aplicável

    Gettext

    Retorna o texto do elemento de caixa de texto capturado na aplicação Java. Para capturar vários textos de várias caixas de texto, você deve configurar vários elementos de caixa de texto.

    Tabela 14. Parâmetros do método gettext
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Texto Retorna o texto contido na caixa de texto da aplicação Java. Saída de dados Cadeia de caracteres Nenhum(a) Não aplicável

    ÉCriado

    Retorna a resposta booliana dependendo se as regras do elemento configurado correspondem.

    Tabela 15. Éparâmetros do método criado
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório?
    Retornar Retorna a resposta booliana dependendo se as regras do elemento configurado correspondem. Saída de dados Booliano nulo Não aplicável

    MouseClick

    Clica com o botão esquerdo do mouse no elemento capturado.

    ExecutarAção

    Executa a ação especificada em um elemento. Por exemplo, clique em um botão. Cada elemento permite um conjunto de ações que você pode obter executando o método GetAccessibleActions.

    Para fornecer entradas para os parâmetros, consulte Configure as propriedades da porta.

    Tabela 16. Éparâmetros do método criado
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório? Anotações
    Ação Aceita a ação a ser executada no elemento. Dados em Cadeia de caracteres Nenhum(a) Sim

    Você deve especificar a ação exatamente no formato fornecido pelo método GetAccessibleActions.
    Retornar Retorna Verdadeiro se a ação foi executada, senão, Falso. Saída de dados Booliano Nenhum(a) Não aplicável

    SetPassword

    Automatizar a inserção de senha com segurança no campo de senha de uma aplicação Java.

    Para fornecer entradas para os campos, consulte Configure as propriedades da porta.
    Tabela 17. Parâmetros do método SetPassword
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Obrigatório? Anotações
    Senha Aceita a senha como uma cadeia de caracteres segura. Dados em Cadeia de caracteres protegida Nenhum(a) Sim Como aceita a senha como uma cadeia de caracteres segura, ela mostra somente o tamanho da cadeia de caracteres quando você clica com o botão direito do mouse no parâmetro e clica em Visualizar dados .
    UseSendKeys SendKeys é um método usado para enviar entradas de teclado, como caracteres, números e símbolos, para caixas de texto dentro de uma aplicação. Dados em Booliano Falso(a) Sim
    Dica:
    . SetPassword o método falha ao inserir a senha no campo de senha, defina o valor como Verdadeiro e execute o método novamente.