R E P O R T - G E N E R A T O R

As opções gerais definem parâmetros que são utilizados no contexto global da aplicação, tais como rótulos, imagens, padrões e habilitação e configuração de serviços previamente cadastrados.

Fig. 01

Como pode ser verificado na figura 01, para usuários com o perfil administrador, o item de menu Configurações fica habilitado permitindo acesso às opções administrativas, além das que são sempre apresentadas independente do perfil do usuário logado. Abrindo o menu Configurações --> Opções Gerais o utilizador tem acesso ao formulário mostrado na figura 02: 

Fig. 02

Na aba Títulos e Imagens podemos definir parâmetros visuais que serão aplicados no formulário principal, como também durante a construção de relatórios:

Sub-aba Títulos

A tela apresentada na Figura 02 destaca a sub-aba Títulos, responsável pela personalização de rótulos e textos institucionais do ecossistema. Nesta interface, o usuário pode definir e aplicar o título oficial da aplicação, bem como configurar uma mensagem customizada ou aviso que ficará permanentemente fixado no lado esquerdo do rodapé da tela principal do sistema.

Sub-aba Imagens

Fig. 03

A Figura 03 detalha a sub-aba Imagens, espaço dedicado à gestão de ativos visuais de identidade da plataforma. Nesta área, o administrador pode realizar o upload e a aplicação da imagem institucional que será exibida permanentemente no canto superior esquerdo do formulário principal da aplicação, estabelecendo a identidade visual corporativa do sistema conforme ilustrado na Figura 01.

Sub-aba Cabeçalho Corporativo

Fig 04

A Figura 04 apresenta a sub-aba Cabeçalho Corporativo, uma funcionalidade voltada à padronização visual e governança dos relatórios da instituição. Nesta área, é possível configurar uma estrutura de identidade visual padrão que será injetada de forma automática na banda PageHeader (Cabeçalho de Página) do Designer sempre que um novo relatório for iniciado.

Regras de Aplicação e Governança:

• Automação de Layout: Garante que elementos essenciais (como logotipos, títulos institucionais e metadados) sejam replicados instantaneamente em novas criações, economizando tempo de desenvolvimento
• Restrição por Obrigatoriedade: Caso o modelo de cabeçalho seja marcado como obrigatório (seja no momento da gravação original ou por meio de uma auditoria posterior), o sistema acionará uma trava de segurança no Designer. 
• Controle de Permissões: Sob a regra de obrigatoriedade, o autor do relatório não terá permissão para remover ou excluir os itens nativos do cabeçalho corporativo.
• Flexibilidade Controlada: Embora a remoção seja bloqueada para preservar o padrão institucional, o desenvolvedor mantém a autonomia para modificar propriedades específicas dos componentes existentes (como textos ou cores) e para adicionar novos componentes livremente abaixo dos elementos já consolidados pelo modelo.

Aba Serviços Agendados:

Nesta aba são aplicadas as configurações dos serviços agendados, para cada serviço cadastrado teremos uma aba específica.

Fig. 05

Configuração de Serviços Agendados

Para que as tarefas programadas no sistema sejam disparadas, é indispensável a operação de um temporizador (timer) ativo de plano de fundo. Este mecanismo atua em intervalos de tempo pré-definidos, varrendo a base de dados para checar se existem rotinas pendentes de execução e qualificadas para disparo inmediato.

Parâmetros de Controle (Figura 05):

A ativação e o refinamento desta rotina de infraestrutura são realizados diretamente na aba de Serviços Agendados, por meio dos seguintes controles:

• Habilitar Agendamentos: Chave ou caixa de seleção que ativa globalmente o motor do timer. Sem esta opção marcada, nenhuma tarefa programada entrará em fila de execução, independentemente de seus agendamentos individuais.
  
  
• Intervalo de Checagem (Minutos): Campo numérico onde se estipula a periodicidade da varredura. Um valor configurado como 5, por exemplo, determina que a cada 5 minutos o sistema acordará a rotina de busca para validar se há novas tarefas prontas para processamento, mitigando o impacto de concorrência ou sobrecarga no servidor de banco de dados. 

Como apresentado na figura 06 abaixo, ao marcarmos o checkbox, as abas de serviços disponíveis são apresentadas permitindo que estes sejam configurados:

Fig. 06

Sub-aba Ciclo de Vida de Relatórios:

O assunto ciclo de vida de relatórios, já foi brevemente tratado no tópico Criando Relatório, sub-tópico: Formulário de Criação/Edição.  Iremos aqui retoma-lo de forma mais detalhada. 

Escopo de Precedência do Serviço de Ciclo de Vida

As parametrizações aplicadas para o Serviço de Ciclo de Vida de Relatórios neste formulário possuem um escopo global e atuam como uma camada de menor precedência no sistema. Elas funcionam como diretrizes padronizadas ou valores default (padrão) para toda a aplicação.

Regra de Sobrescrita e Governança:

• Precedência Local: No momento da criação ou edição de um relatório específico, esses mesmos parâmetros do ciclo de vida podem ser configurados diretamente a nível de documento.
• Hierarquia de Decisão: Caso haja divergência entre os valores, as configurações definidas diretamente no relatório possuem maior precedência, anulando as diretrizes globais para aquele caso específico.
• Flexibilidade Operacional: Essa arquitetura garante que a plataforma mantenha políticas institucionais padronizadas globalmente, sem retirar a autonomia do autor para aplicar exceções técnicas ou regras de negócio customizadas sob demanda em relatórios individuais.

No tópico Gerenciando Serviços Agendados será explanado como configurar um agendamento de serviço.

Conceito do Ciclo de Vida de Relatórios

O Ciclo de Vida de Relatórios refere-se ao tempo limite que um relatório pode permanecer armazenado no banco de dados sem que nenhuma ação de execução seja registrada. Esse ciclo atua como um mecanismo de governança de dados, obedecendo a regras estritas parametrizadas no sistema para balizar as ações automáticas de limpeza, arquivamento ou expiração de relatórios inativos.

Dinâmica e Funcionamento:

• Controle de Inatividade: O motor do sistema monitora continuamente a data da última execução de cada relatório. Caso um documento ultrapasse o período estipulado de ociosidade, ele entra em gatilho de ciclo de vida.
• Governança de Armazenamento: Essa rotina evita o crescimento desnecessário do banco de dados relacional (Postgres/SQL Server), garantindo a eliminação de relatórios obsoletos, sazonais ou de teste que foram abandonados pelos usuários.
• Automação de Ações: Com base no cumprimento dessas regras, o serviço executa ações automatizadas (como expiração, desativação ou exclusão lógica), liberando recursos do servidor e otimizando a performance global do ambiente de relatórios. 

Regra de Escopo para Usuários Comuns

• Alistamento Automático: Relatórios desenvolvidos por usuários que não possuem o perfil de Administrador são automaticamente elegíveis e vinculados ao serviço de monitoramento do ciclo de vida de dados assim que são salvos na base de dados.
• Herança de Parâmetros Globais: No momento da criação, esses relatórios recebem de forma nativa os parâmetros de tempo de inatividade e expiração definidos nas configurações globais do sistema.
• Isenção de Perfis Administrativos: Essa regra garante que relatórios criados por administradores (que podem incluir modelos institucionais, relatórios do sistema ou matrizes críticas) permaneçam protegidos contra rotinas automáticas de expiração, enquanto o conteúdo gerado por usuários comuns fica sujeito às políticas de governança e limpeza para preservação da performance do servidor.

Níveis de Competência e Perfis de Acesso

O sistema gerencia as permissões de manipulação e visibilidade de dados por meio de uma estrutura hierárquica dividida em três perfis principais: Administrador, Gerente e Usuário Comum. Esta arquitetura garante a governança dos dados ao mesmo tempo em que preserva a autonomia operacional das equipes.

1. Perfil Administrador

O Administrador possui controle global e irrestrito sobre o ecossistema de relatórios da aplicação, detendo a maior precedência de comandos no sistema.

• Ações Permitidas: Criar, Alterar, Remover e Distribuir qualquer relatório existente na base de dados.
• Exceção de Visibilidade (Relatório Privado): No momento da criação ou edição de um relatório, o Administrador pode marcá-lo explicitamente com a flag de Privado. Sob esta condição, abre-se uma exceção na regra global: apenas o próprio criador do relatório terá visibilidade e acesso a ele, ocultando-o inclusive de outros usuários com o mesmo perfil administrativo.

2. Perfil Gerente

O Gerente detém privilégios administrativos equivalentes aos do Administrador, porém com o escopo estritamente restrito e delimitado aos perfis organizacionais sob sua tutela.

• Requisito de Acesso: Para usufruir dessas permissões, o usuário deve estar categorizado nativamente sob o grupo de segurança Perfil Gerente.
• Mecanismo de Delegação: No módulo especializado de cadastro, vinculam-se perfis de gerência específicos à conta do usuário.
• Regra de Escopo: Estes perfis vinculados não se confundem com os perfis padrão do sistema; eles funcionam estritamente como ponteiros de visibilidade, determinando que o Gerente em questão só poderá enxergar, alterar, remover ou distribuir os relatórios explicitamente associados a esses grupos.
• Nota técnica: O detalhamento técnico e operacional desta configuração encontra-se no tópico Cadastro de Gerentes.

3. Perfil Usuário Comum

O Usuário Comum atua na camada mais granular de segurança do sistema, operando sob o princípio do menor privilégio.

• Regra de Acesso: Possui visibilidade e capacidade de manipulação limitadas estritamente a duas circunstâncias:
1. Relatórios criados por ele mesmo (propriedade direta).
2. Relatórios de terceiros os quais uma cópia lhe foi explicitamente atribuída por outrem (Administradores ou Gerentes competentes).

Tabela de Definição dos Campos