Java — Access Bridge

Automação de aplicativos Java (Swing/AWT) pelo Java Access Bridge

Buscar Janela Java

java.find_window

Localiza uma janela Java (Swing/AWT) aberta pelo título

Como usar

Localiza uma janela Java (Swing/AWT) aberta pelo título e guarda na variável usada pelos demais comandos Java. Requer um Java instalado com o Access Bridge ativo (rode jabswitch -enable uma vez e reabra o aplicativo); se a janela existir mas não responder, o erro explica isso.

Exemplo: Busque a janela com título contendo "SIGA - Faturamento" em {java_window}.

Campos

Campo	Tipo	Padrão	Detalhes
Título da janela *	Texto		Ex.: `Sistema de vendas`
Salvar resultado na variável *	Variável de saída	`java_window`

+ Avançado (2)

Campo	Tipo	Padrão	Detalhes
Comparação do título	Opção	`Contém`	Opções: Contém, Exato, Expressão regular
Tempo limite	Número	`10 s`

Resultado: guardado na variável java_window (Objeto).

Clicar Elemento Java

java.click

Aciona botão, link ou menu de uma janela Java

Como usar

Aciona um botão, link ou menu da janela Java pela ação "clicar" de acessibilidade, sem mover o mouse. O elemento é indicado por papel|nome, como push button|Salvar; num botão só com ícone, o nome é a dica dele (ex.: push button|Pesquisar). Use "Inspecionar" para capturá-lo. Num campo de texto, o clique só coloca o foco nele. Para duplo clique ou elementos sem ação de clique, o clique é feito com o mouse.

Exemplo: Clique em push button|Confirmar na {java_window}.

Campos

Campo	Tipo	Padrão	Detalhes
Janela Java *	Variável	`java_window`
Elemento *	Seletor		papel\|nome (ex.: push button\|Salvar, text\|Nome) ou só o nome; papel\| sozinho busca pelo papel. Use Inspecionar ou Listar Elementos Java.Ex.: `push button\|Salvar`
Duplo clique	Sim/Não	`Não`

+ Avançado (4)

Campo	Tipo	Padrão	Detalhes
Posição entre os iguais (0 = o primeiro)	Número	`0`
Tempo limite	Número	`10 s`
Clique real do mouse	Sim/Não	`Não`	Por padrão o elemento é acionado sem mover o mouse
Alvo capturado (plano B)	Alvo capturado pelo Inspetor		Caminho capturado pelo Inspetor de Elementos. Usado quando o elemento não é achado pelo seletor.

Clique Direito Elemento Java

java.right_click

Clica com o botão direito num elemento Java (abre o menu de contexto)

Como usar

Clica com o botão direito no centro do elemento Java para abrir o menu de contexto.

Exemplo: Clique com o direito na tabela table|Pedidos para abrir as opções da linha.

Campos

Campo	Tipo	Padrão	Detalhes
Janela Java *	Variável	`java_window`
Elemento *	Seletor		papel\|nome (ex.: push button\|Salvar, text\|Nome) ou só o nome; papel\| sozinho busca pelo papel. Use Inspecionar ou Listar Elementos Java.Ex.: `push button\|Salvar`

+ Avançado (3)

Campo	Tipo	Padrão	Detalhes
Posição entre os iguais (0 = o primeiro)	Número	`0`
Tempo limite	Número	`10 s`
Alvo capturado (plano B)	Alvo capturado pelo Inspetor		Caminho capturado pelo Inspetor de Elementos. Usado quando o elemento não é achado pelo seletor.

Digitar no Campo Java

java.type_text

Preenche um campo de texto Java (substitui o conteúdo)

Como usar

Preenche um campo de texto Java substituindo o conteúdo, sem usar o teclado. O campo é indicado por papel|nome, como text|Nome.

Exemplo: Digite {nome_cliente} no campo text|Nome.

Campos

Campo	Tipo	Padrão	Detalhes
Janela Java *	Variável	`java_window`
Elemento *	Seletor		papel\|nome (ex.: push button\|Salvar, text\|Nome) ou só o nome; papel\| sozinho busca pelo papel. Use Inspecionar ou Listar Elementos Java.Ex.: `push button\|Salvar`
Texto *	Texto

+ Avançado (3)

Campo	Tipo	Padrão	Detalhes
Posição entre os iguais (0 = o primeiro)	Número	`0`
Tempo limite	Número	`10 s`
Alvo capturado (plano B)	Alvo capturado pelo Inspetor		Caminho capturado pelo Inspetor de Elementos. Usado quando o elemento não é achado pelo seletor.

Enviar Teclas Java

java.send_keys

Envia combinação de teclas a uma janela ou elemento Java (ex.: Enter, Ctrl+S)

Como usar

Envia teclas ou atalhos (Enter, Tab, Ctrl+S) para a janela Java ou para um elemento, que recebe o foco antes. Use quando o aplicativo reage a teclas, como confirmar uma busca com Enter.

Exemplo: Envie Enter para o campo text|Código depois de digitar o código do produto.

Campos

Campo	Tipo	Padrão	Detalhes
Janela Java *	Variável	`java_window`
Teclas *	Texto		Ctrl+S, Alt+F4, Enter, F5, Ctrl+Shift+Esc ou o formato do pywinauto (^s, %{F4})Ex.: `Ctrl+S`
Elemento (opcional)	Seletor		Recebe o foco antes das teclas; vazio envia à janelaEx.: `text\|Nome`

+ Avançado (3)

Campo	Tipo	Padrão	Detalhes
Posição entre os iguais (0 = o primeiro)	Número	`0`
Tempo limite	Número	`10 s`
Alvo capturado (plano B)	Alvo capturado pelo Inspetor		Caminho capturado pelo Inspetor de Elementos. Usado quando o elemento não é achado pelo seletor.

Obter Texto Java

java.get_text

Lê o texto de um campo ou rótulo Java

Como usar

Lê o conteúdo de um campo Java ou, em rótulos e outros elementos, o nome exibido, e guarda numa variável.

Exemplo: Leia o rótulo label|Total (posição 1) em {total_pedido}.

Campos

Campo	Tipo	Padrão	Detalhes
Janela Java *	Variável	`java_window`
Elemento *	Seletor		papel\|nome (ex.: push button\|Salvar, text\|Nome) ou só o nome; papel\| sozinho busca pelo papel. Use Inspecionar ou Listar Elementos Java.Ex.: `push button\|Salvar`
Salvar resultado na variável *	Variável de saída	`java_text`

+ Avançado (3)

Campo	Tipo	Padrão	Detalhes
Posição entre os iguais (0 = o primeiro)	Número	`0`
Tempo limite	Número	`10 s`
Alvo capturado (plano B)	Alvo capturado pelo Inspetor		Caminho capturado pelo Inspetor de Elementos. Usado quando o elemento não é achado pelo seletor.

Resultado: guardado na variável java_text (Texto).

Marcar Caixa Java

java.check

Marca, desmarca ou inverte uma caixa de seleção ou opção Java

Como usar

Marca, desmarca ou inverte uma caixa de seleção ou opção Java e guarda se ficou marcada.

Exemplo: Marque check box|Ativo antes de salvar o cadastro.

Campos

Campo	Tipo	Padrão	Detalhes
Janela Java *	Variável	`java_window`
Elemento *	Seletor		papel\|nome (ex.: push button\|Salvar, text\|Nome) ou só o nome; papel\| sozinho busca pelo papel. Use Inspecionar ou Listar Elementos Java.Ex.: `push button\|Salvar`
Ação *	Opção	`Marcar`	Opções: Marcar, Desmarcar, Inverter
Salvar resultado na variável	Variável de saída	`java_checked`

+ Avançado (3)

Campo	Tipo	Padrão	Detalhes
Posição entre os iguais (0 = o primeiro)	Número	`0`
Tempo limite	Número	`10 s`
Alvo capturado (plano B)	Alvo capturado pelo Inspetor		Caminho capturado pelo Inspetor de Elementos. Usado quando o elemento não é achado pelo seletor.

Resultado: guardado na variável java_checked (Booleano).

Selecionar Item Java

java.select_item

Escolhe um item pelo texto numa lista ou caixa de combinação Java

Como usar

Escolhe um item pelo texto numa lista ou caixa de combinação Java; se o item não existir, o erro lista os disponíveis.

Exemplo: Selecione "SP" na combo box|UF.

Campos

Campo	Tipo	Padrão	Detalhes
Janela Java *	Variável	`java_window`
Elemento *	Seletor		papel\|nome (ex.: push button\|Salvar, text\|Nome) ou só o nome; papel\| sozinho busca pelo papel. Use Inspecionar ou Listar Elementos Java.Ex.: `push button\|Salvar`
Item *	Texto

+ Avançado (3)

Campo	Tipo	Padrão	Detalhes
Posição entre os iguais (0 = o primeiro)	Número	`0`
Tempo limite	Número	`10 s`
Alvo capturado (plano B)	Alvo capturado pelo Inspetor		Caminho capturado pelo Inspetor de Elementos. Usado quando o elemento não é achado pelo seletor.

Ler Tabela Java

java.get_table

Lê uma tabela Java como lista de linhas (cabeçalho → valor)

Como usar

Lê uma tabela Java inteira como lista de linhas, cada uma um dicionário cabeçalho → valor, para percorrer com Para Cada ou salvar no Excel.

Exemplo: Leia table|Pedidos em {pedidos} e percorra lendo {item.Pedido} e {item.Situação}.

Campos

Campo	Tipo	Padrão	Detalhes
Janela Java *	Variável	`java_window`
Elemento *	Seletor		papel\|nome (ex.: push button\|Salvar, text\|Nome) ou só o nome; papel\| sozinho busca pelo papel. Use Inspecionar ou Listar Elementos Java.Ex.: `push button\|Salvar`
Salvar resultado na variável *	Variável de saída	`java_table`

+ Avançado (3)

Campo	Tipo	Padrão	Detalhes
Posição entre os iguais (0 = o primeiro)	Número	`0`
Tempo limite	Número	`10 s`
Alvo capturado (plano B)	Alvo capturado pelo Inspetor		Caminho capturado pelo Inspetor de Elementos. Usado quando o elemento não é achado pelo seletor.

Resultado: guardado na variável java_table (Lista).

Aguardar Elemento Java

java.wait_element

Espera um elemento Java aparecer ou sumir

Como usar

Espera um elemento Java aparecer ou sumir, como uma mensagem de sucesso ou uma barra de progresso, e guarda se a condição foi atendida.

Exemplo: Aguarde até 60 s o label|Gravado com sucesso aparecer.

Campos

Campo	Tipo	Padrão	Detalhes
Janela Java *	Variável	`java_window`
Elemento *	Seletor		papel\|nome (ex.: push button\|Salvar, text\|Nome) ou só o nome; papel\| sozinho busca pelo papel. Use Inspecionar ou Listar Elementos Java.Ex.: `push button\|Salvar`
Esperar até *	Opção	`Aparecer`	Opções: Aparecer, Sumir
Tempo limite	Número	`30 s`
Salvar resultado na variável	Variável de saída	`java_found`

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Falhar se o tempo acabar	Sim/Não	`Sim`

Resultado: guardado na variável java_found (Booleano).

Listar Elementos Java

java.list_elements

Lista os elementos de uma janela Java (papel, nome, seletor) no log

Como usar

Lista no log os elementos da janela Java, com papel, nome e o seletor pronto para usar. Elementos sem nome aparecem pela descrição (a dica dos botões só com ícone). Ajuda a montar seletores quando o Inspetor não alcança um elemento.

Exemplo: Liste os elementos de {java_window} com profundidade 12 e copie o seletor do botão de exportar.

Campos

Campo	Tipo	Padrão	Detalhes
Janela Java *	Variável	`java_window`
Salvar resultado na variável *	Variável de saída	`java_elements`

+ Avançado (2)

Campo	Tipo	Padrão	Detalhes
Profundidade máxima	Número	`12`
Somente visíveis	Sim/Não	`Sim`

Resultado: guardado na variável java_elements (Lista).