Visão Geral
A ação Abrir Janela do LATROMI permite a abertura de janelas de forma programática durante a navegação. Para que a chamada dessa ação funcione corretamente através de um procedimento, é necessário realizar a configuração prévia das janelas no próprio formulário. Neste tutorial, vamos apresentar o passo a passo de como configurar e acionar esse recurso dentro do objeto Formulário.
Janelas
Precisa solicitar dados extras ou apresentar informações complementares para o usuário sem tirá-lo da tela atual? A configuração de janelas é a solução ideal para esse cenário.
Com esse recurso, você consegue abrir objetos já existentes por cima da sua tela principal. Dessa forma, você reaproveita interfaces e regras de negócio que já foram implementadas no sistema, ganhando produtividade e facilitando a manutenção do projeto.
Referenciando objetos
A primeira configuração necessária é adicionar uma janela ao formulário, para isso siga os passos a seguir:
-
No canto esquerdo, clique com o botão direito, na seção
Janelas, para adicionar uma nova janela.
-
Será aberto uma tela de seleção de objeto, selecione o objeto que deseja usar no contexto.
Veja também a documentação sobre o recurso Janelas.
Solicitando abertura da janela
Após ter uma janela configurado no contexto do formulário, ela poderá ser invocada a qualquer momento, entre os procedimentos, usando a ação Abrir Janela.
Conclusão
Configurar as janelas diretamente no objeto Formulário vai muito além de apenas organizar a navegação da sua aplicação. Essa prática traz um benefício estrutural, o rastreamento automático de dependências da plataforma.
Ao utilizar o recurso padrão de configuração de janelas, o LATROMI consegue mapear e reconhecer perfeitamente a relação entre a tela principal e os objetos secundários que serão abertos.
Isso garante que recursos como o mecanismo de segurança, restrição de navegação por dependência, autorizando o acesso legítimo às janelas filhas e evitando bloqueios indevidos durante o uso. Além disso, essa arquitetura assegura uma geração de pacotes (LCP) precisa, pois os objetos vinculados às janelas são detectados e incluídos automaticamente na exportação, eliminando o risco de falhas por falta de componentes ao migrar o projeto para novos ambientes.
Extra
Precisa abrir janelas dinamicamente? Caso sim, pode usar a API Javascript do LATROMI, que será responsável por invocar o motor de abertura de Janela da plataforma. Para isso é necessário garantir a captura do Código de Atualização do Objeto, que é um valor global independente do ambiente.
- Abrindo janela sem parâmetros:
new latromi.windowManager().openWindow(
{
window: {
title: "Meu titulo",
height: 600,
width: 800,
targetUpgradeCode: "FRM00000030900002420240905165836170305" // Código do formulário LATROMI
},
options: {
modal: true,
maximized: false
}
}
);
- Abrindo janela com parâmetros:
new latromi.windowManager().openWindow(
{
window: {
title: "Meu titulo",
height: 600,
width: 800,
targetUpgradeCode: "FRM00000030900002420240905165836170305", // Código do formulário LATROMI
targetParameters: {
meuParametro1: {
value: "2026-01-01"
},
meuParametro2: {
value: 123
},
meuParametroN: {
value: "N valores"
}
},
},
options: {
modal: true,
maximized: false
}
}
);
Os códigos acima podem ser invocados tanto em Arquivos Javascript, no formulário, ou na ação Executar código Javascript, em qualquer procedimento.