Métodos do conector Java

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. 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

    Iniciar

    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?
    Caminho Caminho para a aplicação Java na unidade local. Dados em Cadeia de caracteres Nenhum(a) Sim
    Argumentos Argumentos para o caminho. Dados em Cadeia de caracteres Nenhum(a) Não

    GetMainWindowHandle

    Retorna o identificador de 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 manipulador de janela da aplicação. Saída de dados Inteiro Nenhum(a) 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?
    Retornar Retorna o título da janela da aplicação. Saída de dados Cadeia de caracteres Nenhum(a) 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.

    ObterCampos

    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 capturar um ou mais campos de texto.
    2. Expor os métodos de nível de tela. Consulte Usar método de conector.
    3. No painel Pesquisador de objetos, arraste o método GetFields para a superfície Design.
    4. Clique no ícone de 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 ESCOLHA 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.

    ObterContagemDeInstância

    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 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 aplicação Java. Saída de dados Bitmap Nenhum(a) Não aplicável

    GetWindowHandle

    Retorna o número de 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?
    Retornar Retorna o número de manipulador Windows 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 para 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
    CorresponderTodos os Filhos Retorna a resposta booliana após corresponder às regras dos elementos da tela. Dados em Booliano Nenhum(a) Não Este parâmetro é relevante se você capturar um ou mais elementos.
    Retornar Retorna a resposta booliana se as regras da tela da aplicação Java que você configurou corresponderem. 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.

    Ação do mouse

    Executa diferentes ações do dispositivo do mouse na aplicação Java, como clicar com o botão esquerdo, clicar com o botão direito 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?
    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 do mouse será realizado. Dados em Booliano Nenhum(a) 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. Redimensionar parâmetros do método
    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.

    SendKeys

    Envie qualquer entrada de dados ou teclado para o campo ativo na aplicação Java. Por exemplo, você pode enviar dados de cadeia de caracteres "RPA" ou uma entrada de 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?
    Chaves Envia os dados ou a entrada do teclado para o campo ativo. Dados em Cadeia de caracteres Nenhum(a) Sim
    LimparValorExistente Antes de enviar qualquer entrada de dados ou teclado, limpa qualquer valor existente no campo ativo. Dados em Booliano Nenhum(a) Não
    TypeDelay Define um atraso antes de enviar qualquer dado ou entrada de teclado para o campo ativo. Dados em Inteiro Nenhum(a) 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 as etapas abaixo.
    1. No Pesquisador de objetos, arraste o método SetFields para a superfície Design.
    2. Clique no ícone de 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 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 nas regras da tela que você configurou corresponderem.

    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?
    timeoutinSeconds Tempo após o qual a operação do método expira. Dados em Inteiro Nenhum(a) Não
    CorresponderTodos os Filhos Retorna a resposta booliana após corresponder às regras dos elementos da tela. Dados em Booliano Nenhum(a) Não
    Retornar Retorna a resposta booliana se as regras da tela da aplicação Java que você configurou corresponderem. Saída de dados Booliano Nenhum(a) Não

    Métodos de nível de elemento

    ObterAçõesAcessíveis

    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?
    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

    ObterContagemDeInstância

    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

    ObterTexto

    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 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?
    Retornar Retorna a resposta booliana dependendo se as regras do elemento que você configurou correspondem. Saída de dados Booliano 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(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, caso contrário, retorna falso. Saída de dados Booliano Nenhum(a) 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. Entrada de dados Cadeia de caracteres protegida Nenhum(a) 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, em seguida, 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. Entrada de dados Booliano 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.