Os Modelos constituem uma camada de padronização estrutural e visual, desenvolvida para otimizar o processo de criação de relatórios e reduzir o tempo de desenvolvimento gasto pelo usuário.

  • Definição: Um Modelo é um gabarito predefinido que armazena configurações de layout, diretrizes visuais e comportamentos estruturais padronizados. Ao ser associado a um novo documento, ele replica automaticamente essa base configurada, eliminando a necessidade de desenhar a estrutura do relatório do zero.
  • Funcionalidade: Sua aplicação automatiza a inserção e o posicionamento de elementos comuns — como cabeçalhos, rodapés, logotipos institucionais e numeração de páginas. Além de acelerar a construção, o uso de modelos garante a consistência estética e a identidade visual em todo o ecossistema de relatórios do sistema.


Designer de Modelos

O Designer de Modelos apresenta grande similaridade operacional e construtiva em relação ao Designer de Relatórios ativo. A distinção principal reside na disponibilização de recursos e componentes adicionais especializados para a manutenção, gerenciamento e aplicação dos gabaritos estruturais.


A imagem 01 mostra a tela de construção e aplicação de Modelos:


Fig. 01


Carregando um Modelo

Para carregar um modelo, usamos a aba situada no rodapé da área de desenho para acessar o grid com a lista dos modelos existentes, como indicado na figura 02:


Fig. 02


Com o grid aberto, com um clique na linha do modelo escolhido, este é carregado no Designer.


Fig. 03


Aplicando um Modelo

Para aplicar um modelo usamos o botão "Aplicar". O formulário de seleção de bandas é apresentado com a lista de bandas. O modelo será aplicado para as bandas que estiverem marcadas:


Fig. 04

A banda PageHeaderBand pode receber um modelo padrão definido pela administração. Dependendo da parametrização, os componentes aplicados automaticamente podem ou não ser removidos da banda. Mesmo nos cenários em que a remoção é bloqueada, é permitido acrescentar novos componentes ou alterar as propriedades dos elementos previamente adicionados.

Criando um Modelo

Para criar um modelo, usamos o link disponibilizado pelo botão "Novo Modelo".

Controle de Visibilidade e Níveis de Acesso na Criação de Modelos

O formulário de criação de novos modelos adapta sua interface dinamicamente com base no perfil do usuário conectado, alternando entre a visão padrão e a visão estendida de administração.

  • Interface para Usuários Comuns: Conforme ilustrado na imagem 05, os usuários comuns visualizam uma interface simplificada, contendo apenas os campos de identificação básica ("NOME" e "DESCRIÇÃO") e o controle de visibilidade. A seção de parametrização global (destacada em laranja na imagem anterior, 05) permanece totalmente oculta para este perfil.
  • Gerenciamento de Privacidade do Modelo: O parâmetro "PÚBLICO?" fica disponível para edição na interface comum. Caso o usuário opte por manter a opção desmarcada, o modelo será configurado como privado, restringindo a visualização e a utilização do gabarito exclusivamente ao seu criador. Ao assinalar a opção como ativa, o modelo torna-se visível para os demais utilizadores do sistema, sem convertê-lo em um modelo estrutural de sistema.
  • Interface Estendida (Perfil Administrador): A área adicional destacada na figura 05, destina-se apenas a usuários administradores. Ela estende as capacidades do formulário para permitir a criação de um "Modelo Padrão do Sistema" — o qual é disponibilizado globalmente de forma impositiva (forçando o parâmetro público como marcado e desabilitado) — exigindo o preenchimento de um identificador único e controle de versão, além de ativar o mecanismo automatizado de salvaguarda e persistência via sistema de arquivos.


Fig. 05


Novo a Partir do Designer Principal

É possível criar um modelo, tomando por base o layout que está sendo trabalhado no Designer principal do relatório, usando o botão "Novo a Partir do Designer Principal". O formulário de definição é o mesmo apresentado na figura 05 e atua sob as mesmas regras. O layout presente no Designer é filtrado e transferido para o Designer de modelos.



Visualizar Modelo

A partir de um modelo carregado, pressionando o botão "Visualizar Impressão", um preview de teste é gerado com dados fictícios:

Fig. 06


Salvar e Salvar Como

  • O botão "Salvar Como" permite que uma cópia do modelo sendo editado ou apresentado possa ser feita. 
  • O botão "Salvar" permite que o usuário Salve as alterações realizadas no modelo. 


MODELOS DE SISTEMA, TIPO SYSTEM, SOMENTE PODEM SER ALTERADOS POR ADMINISTRADORES. Portanto se um usuário padrão estiver com um modelo de sistema aberto, o botão "Salvar" não ficará habilitado.