Métodos de conector Java

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 8 min. de leitura

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

    Métodos de nível de conector

    Início

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

    Para fornecer entradas para os parâmetros, consulte Configurar 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? Anotações
    Caminho Caminho para a aplicação Java na unidade local. Dados em Cadeia de caracteres Nenhum Sim
    Argumentos Argumentos para o caminho. Dados em Cadeia de caracteres Nenhum 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? Anotações
    Retornar Retorna o identificador da janela da aplicação. Dados esgotados Inteiro Nenhum Não aplicável

    GetMainWindowTitle

    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? Anotações
    Retornar Retorna o título da janela da aplicação. Dados esgotados Cadeia de caracteres Nenhum Não aplicável

    CloseMainWindow

    Fecha a janela principal da aplicação Java.

    Finalizar

    Encerra a janela principal da aplicação Java.

    Métodos de nível de 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.

    Obter campos

    Obtém os dados dos campos de texto em uma aplicação Java. Você deve primeiro configurar os campos de texto. Para configurar, siga estas etapas.
    1. Configurar o conector Java e capturam um ou mais campos de texto.
    2. Exponha os métodos de nível de tela. Consulte Usar método de conector.
    3. No painel do Pesquisador de objetos, arraste o método GetFields para a superfície de design.
    4. Clique no ícone de configurações do método (ícone de configurações do 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? Anotações
    Retornar Retorna o número total de instâncias da aplicação Java abertas. Dados esgotados Inteiro Nenhum Não aplicável

    GetScreenShot

    Captura e retorna a captura de 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? Anotações
    Retornar Retorna a captura de tela da aplicação Java. Dados esgotados Bitmap Nenhum Não aplicável

    GetWindowHandle

    Retorna o número do manipulador Windows 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? Anotações
    Retornar Retorna o número do manipulador Windows da janela da tela da aplicação Java. Dados esgotados Inteiro Nenhum Não aplicável

    Foi 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 do conector Java mostra determinadas regras que correspondem à tela configurada. O método corresponde às mesmas regras.

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

    Tabela 7. Parâmetros do método IsCreated
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Corresponder a todos os secundários Retorna a resposta booliana após corresponder às regras dos elementos da tela. Dados em Booleano Nenhum Não Este parâmetro será relevante se você capturar um ou mais elementos.
    Retornar Retorna a resposta booliana para saber se as regras da tela da aplicação Java que você configurou corresponderam. Dados esgotados Booleano Nulo Não aplicável

    Maximizar

    Maximiza a janela da aplicação Java.

    Minimizar

    Minimiza a janela da aplicação Java.

    Ação do mouse

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

    Para fornecer entradas para os parâmetros, consulte Configurar 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? Anotações
    Ação Especifica a ação do dispositivo do mouse. Dados em Entrada de mouse Nenhum Sim
    Clique no meio Se um clique do meio será realizado. Dados em Booleano Nenhum Não

    Redimensionar

    Altera 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 Configurar 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? Anotações
    xPos Posição da janela na tela ao longo do eixo X. Dados em Inteiro Nenhum Não
    yPos Posição da janela na tela ao longo do eixo Y. Dados em Inteiro Nenhum Não
    Largura Largura da janela. Dados em Inteiro Nenhum Não
    Altura Altura da janela. Dados em Inteiro Nenhum 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.

    SendKeys

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

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

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

    Definir Campos

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

    Para usar o método, siga estas etapas.
    1. No Pesquisador de objetos, arraste o método SetFields para a superfície de design.
    2. Clique no ícone de configurações do método (ícone de configurações do 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 para definir nos campos da aplicação Java.

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

    AguardarCriação

    Cada tela configurada no conector Java é identificada por algumas regras, exibidas na seção REGRAS DE CORRESPONDÊNCIA da janela do conector Java. O método retorna uma resposta booliana com base na correspondência das regras da tela que você configurou.

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

    Tabela 11. Parâmetros do método WaitForCreate
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    timeoutinSeconds Tempo após o qual a operação do método expira. Dados em Inteiro Nenhum Não
    Corresponder a todos os secundários Retorna a resposta booliana após corresponder às regras dos elementos da tela. Dados em Booleano Nenhum Não
    Retornar Retorna a resposta booliana para saber se as regras da tela da aplicação Java que você configurou corresponderam. Dados esgotados Booleano Nenhum 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.
    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? Anotações
    Retornar Retorna a lista de ações que você pode executar em um elemento. Dados esgotados Lista Nenhum 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? Anotações
    Retornar Retorna a contagem de instâncias de um tipo de elemento na aplicação. Dados esgotados Inteiro Nenhum Não aplicável

    Obter texto

    Retorna o texto do elemento da 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? Anotações
    Texto Retorna o texto contido na caixa de texto da aplicação Java. Dados esgotados Cadeia de caracteres Nenhum Não aplicável

    Foi criado

    Retorna a resposta booliana dependendo se as regras do elemento que você configurou correspondem.

    Tabela 15. Parâmetros do método IsCreated
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor-padrão Obrigatório? Anotações
    Retornar Retorna a resposta booliana dependendo se as regras do elemento que você configurou correspondem. Dados esgotados Booleano nulo Não aplicável

    Clique do mouse

    Executa um clique com o botão esquerdo do mouse no elemento capturado.

    Executar açã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 Configurar propriedades da porta.

    Tabela 16. Parâmetros do método IsCreated
    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 Sim

    Você deve especificar a ação exatamente no formato fornecido pelo método GetAccessibleActions.
    Retornar Retorna Verdadeiro se a ação foi realizada, caso contrário, Retorna Falso. Dados esgotados Booleano Nenhum Não aplicável

    Definir Senha

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

    Para fornecer entradas para os campos, consulte Configurar 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 protegida. Dados em Cadeia de caracteres protegida Nenhum Sim Como ele aceita a senha como uma cadeia de caracteres protegida, ele só mostra 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 do teclado, como caracteres, números e símbolos para caixas de texto dentro de uma aplicação. Dados em Booleano Falso Sim
    Dica:
    Se o método SetPassword falhar ao inserir a senha no campo de senha, defina o valor como Verdadeiro e execute o método novamente.