Menu de acesso ao Gravador Windows
*** ### Pré-requisitos * Ambiente Windows * Aplicação desktop alvo aberta e visível na tela *** ### Como usar #### Passo 1 — Abrir o Gravador Windows Na barra superior do Genesis, clique no ícone de **três tracinhos** (menu) ao lado de **Perfil** e selecione **Gravador Windows**.Menu suspenso com as opções Árvore de Elementos, Gravador Web e Gravador Windows
#### Passo 2 — Configurar os comandos do gravador O modal **Configurações do Gravador** abrirá com três atalhos de teclado pré-configurados. Você pode mantê-los ou personalizá-los clicando em **Configurar**.Tela inicial de Configurações do Gravador
#### Passo 3 — Definir o destino das capturas de imagem No campo **Destino de captura de imagem**, selecione a pasta onde as imagens capturadas durante a gravação serão salvas (ex: `C:\Users\Roboteasy\Downloads`).Campo Destino de captura de imagem configurado
#### Passo 4 — Ajustar as opções de gravação (opcional) Marque ou desmarque as opções conforme a necessidade da sua automação: * **Separar as janelas em rotinas automaticamente?** * **Focar em janelas automaticamente?** * **Habilitar configurações avançadas?** * **Usar busca por UIA2?**Checkboxes de opções do gravador
#### Passo 5 — Iniciar a gravação Clique em **Iniciar Gravação** para começar a captura dos elementos. Para capturas baseadas em imagem em vez de propriedades, clique em **Gravação Por Imagem**.Botões Iniciar Gravação e Gravação Por Imagem
#### Passo 6 — Capturar o elemento Com a gravação ativa, use o atalho **Control + Alt + A** (padrão do comando **Abrir janela de componente**) sobre o elemento da aplicação desktop que deseja capturar. O Genesis abrirá a janela **Ações em Elemento** com os dados do elemento preenchidos — incluindo o **XPath**.Janela Ações em Elemento com o XPath e demais atributos do elemento capturado
#### Passo 7 — Confirmar a ação Na janela **Ações em Elemento**: * **Selecionar ação:** escolha a ação a executar (ex: `Clique Esquerdo`) * **Título do Componente:** nome de exibição * **Nome Identificador do Componente:** identificador único do elemento * **Buscar elemento por:** mantenha **XPath** (ou troque se necessário) Clique em **Confirmar** para inserir o elemento na rotina. #### Passo 8 — Encerrar a gravação Use o atalho **Shift + Control + X** (padrão do comando **Encerrar a gravação**) para finalizar a captura.Observe o componente criado pelo gravador windows no Genesis
*** ### Comandos do Gravador | Comando | Atalho padrão | O que faz | | -------------------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------------- | | Encerrar a gravação | `Shift + Control + X` | Finaliza a sessão de gravação | | Pausar a gravação | `Ctrl Esquerdo` | Pausa temporariamente a captura de ações sem encerrá-la | | Abrir janela de componente | `Control + Alt + A` | Abre a janela **Ações em Elemento** com os dados do elemento sob o cursor, permitindo capturar seu XPath e demais atributos | Para alterar qualquer atalho, clique em **Configurar** ao lado do comando correspondente e pressione a nova combinação de teclas. *** ### Campos e opções | Campo | Descrição | Valores aceitos | | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | | Configurar comando para encerrar a gravação | Define o atalho que encerra a gravação | Combinação de teclas | | Configurar comando para pausar a gravação | Define o atalho que pausa a gravação | Combinação de teclas | | Configurar comando para abrir janela de componente | Define o atalho que abre a janela **Ações em Elemento** sobre o elemento apontado | Combinação de teclas | | Destino de captura de imagem | Pasta onde as imagens capturadas durante a gravação serão salvas | Caminho de pasta | | Separar as janelas em rotinas automaticamente? | Cria rotinas separadas para cada janela capturada | Marcado / Desmarcado | | Focar em janelas automaticamente? | Vincula as ações à janela focada. Se desmarcado, no modo de gravação não assistida todas as ações serão registradas em coordenadas absolutas, sem vínculo com qualquer janela | Marcado / Desmarcado | | Habilitar configurações avançadas? | Libera configurações adicionais do gravador | Marcado / Desmarcado | | Usar busca por UIA2? | Usa a engine UIA2 em vez da padrão UIA3. Recomendado apenas se a busca padrão (UIA3) não estiver funcionando como deveria | Marcado / Desmarcado | | Iniciar Gravação | Inicia a captura por propriedades dos elementos | Botão | | Gravação Por Imagem | Inicia a captura baseada em reconhecimento de imagem | Botão | *** ### Dados capturados na janela Ações em Elemento Após acionar o comando **Abrir janela de componente** sobre o elemento, o Genesis preenche automaticamente: | Campo | Descrição | | -------------------------------- | ---------------------------------------------------------- | | Selecionar ação | Ação a ser executada no elemento (ex: Clique Esquerdo) | | Título do Componente | Nome descritivo do elemento | | Nome Identificador do Componente | ID interno do elemento na rotina | | XPath | Caminho do elemento na árvore de componentes do Windows | | Texto | Texto visível do elemento | | ClassName | Classe da UI Automation do elemento | | AutomationId | ID de automação do elemento | | Buscar elemento por | Estratégia de busca (XPath, ClassName, AutomationId, etc.) | | Buscar por imagem? | Alterna para busca baseada em captura de imagem | *** ### Observações e dicas * 💡 Use o **Gravador Windows** quando precisar automatizar aplicações desktop (não-web) — para navegadores, use o **Gravador Web**. * 💡 O campo **XPath** capturado pelo gravador pode ser colado diretamente no campo **Valor de busca** do componente **Buscar Elementos** (modo Windows) em outras rotinas. * 💡 **Focar em janelas automaticamente** costuma ser a opção mais robusta — mantenha marcada, salvo em casos específicos. * ⚠️ **Usar busca por UIA2** deve ser ativado **apenas** se a busca padrão (UIA3) não estiver funcionando como esperado. O UIA3 é o padrão recomendado. * ⚠️ Se a opção **Focar em janelas automaticamente** estiver desmarcada, no modo de gravação não assistida todas as ações serão registradas em coordenadas absolutas, sem vínculo com qualquer janela — o que reduz a robustez da automação. * ⚠️ Certifique-se de que o **Destino de captura de imagem** aponte para uma pasta existente e com permissão de escrita antes de iniciar a gravação.