GERADOR DE RELATÓRIOS SENIOR HCM: TOTAIS, TOTALIZADORES E VISÕES ANALÍTICA E SINTÉTICA

A consolidação de dados quantitativos e financeiros representa um dos requisitos fundamentais no desenvolvimento de relatórios corporativos. No ecossistema Senior HCM, a correta estruturação de rodapés, totalizadores acumuladores e contadores assegura a acurácia necessária para relatórios de folha e auditoria cadastral.

Além da soma numérica e contagem de registros por quebras departamentais, a flexibilidade na entrega da informação exige que o mesmo modelo possa operar tanto de forma detalhada quanto sumarizada. O controle das seções e a gestão de parâmetros analíticos e sintéticos reduzem a duplicidade de modelos no sistema.

Neste artigo, serão apresentadas as técnicas para criação de rodapés padronizados, aplicação de componentes totalizadores, gerenciamento de seções de limpeza e o tratamento de integridade de dados por meio de cursores programados em LSP.

O rodapé de página cumpre o papel de identificar a origem do documento e subsidiar auditorias internas. O Gerador de Relatórios disponibiliza variáveis de sistema nativas que eliminam a necessidade de programação para capturar metadados do relatório.

Componentes essenciais para a composição do rodapé:

- Data e hora de referência: registra o momento exato em que a extração foi disparada.

- Nome do usuário: identifica o operador responsável pela emissão do relatório.

- Numeração de páginas: estabelece a paginação sequencial no formato de página atual ou totalizador de vias.

- Identificador do modelo: imprime o código do relatório na base para agilizar manutenções pelo suporte técnico.

A padronização visual desses dados na margem inferior confere consistência aos relatórios distribuídos na organização.

Para consolidar valores salariais e quantitativos de quadro de pessoal, o gerador conta com o controle nativo de totalizadores. Esse componente opera processando os registros lidos na seção de detalhe conforme a operação configurada.

Modalidades operacionais mais utilizadas:

- Acumulador: realiza o somatório linear contínuo de valores numéricos, como salários, proventos e descontos.

- Contador: apura a quantidade absoluta de registros processados, como o total de cadastros ou vínculos empregatícios.

- Média e extremos: calcula valores médios, mínimos ou máximos a partir de conjuntos numéricos de entrada.

A escolha do tipo de cálculo deve ser alinhada ao campo selecionado nas propriedades do componente totalizador.

A apresentação de totais intermediários exige a criação de seções do tipo Subtotal, atreladas a quebras previamente definidas na hierarquia do modelo. Já o fechamento global das informações ocorre na seção de Total Geral.

Diretrizes para distribuição das seções:

- Associação com quebras: a seção de subtotal deve ser parametrizada para disparar na alteração de um campo de ordem, como empresa ou centro de custo.

- Salto de página condicional: configuração da quebra de página visual para segmentar unidades distintas em folhas separadas.

- Total geral ao término: seção posicionada no final do fluxo para imprimir a consolidação total da listagem.

A sincronia entre as ordens da seção de detalhe e os eventos de quebra garante a correta exibição dos blocos de subtotal.

Um comportamento crítico no manuseio de totalizadores reside no momento em que a memória do acumulador é reiniciada. Se o mecanismo de limpeza não for apontado corretamente, os valores de um agrupamento serão somados aos agrupamentos subsequentes.

Regras para controle de limpeza:

- Configuração da propriedade Sessão Limpeza: define exatamente após a impressão de qual seção o valor do acumulador deve voltar a zero.

- Totalizadores de subtotal: devem ser reiniciados na própria seção de subtotal à qual pertencem.

- Totalizadores gerais: devem ser configurados sem limpeza ou com limpeza exclusiva no encerramento do relatório.

Essa parametrização impede a distorção cumulativa dos subtotais durante o percurso das quebras.

A construção de modelos versáteis permite que gestores optem por visualizar colaboradores individuais ou apenas os resumos por departamento. Isso é viabilizado combinando parâmetros de tela com regras de cancelamento de seção.

Etapas para implementação da alternância:

- Criação do parâmetro de entrada: tela interativa que recebe a opção analítica ou sintética antes da execução.

- Condicional na seção de detalhe: regra LSP avaliando a variável informada pelo usuário.

- Invocação da função Cancel: supressão da seção de detalhe quando a opção sintética estiver ativa.

- Ajuste de cabeçalhos de coluna: cancelamento de títulos desnecessários para manter a estética do relatório sintético limpa.

O processamento interno das somas continua ativo mesmo quando a linha detalhada tem sua impressão cancelada.

Quando um modelo precisa exibir descrições de tabelas secundárias, a criação de junções automáticas pode ocultar colaboradores que não possuem o respectivo cadastro vinculado, operando como um Inner Join tácito.

Estratégias para manutenção da integridade cadastral:

- Identificação de campos opcionais: cadastros de empresas ou colaboradores com centros de custo em branco podem ser omitidos por relacionamentos diretos.

- Remoção de junções gráficas restritivas: eliminação do vínculo entre a tabela principal e a tabela auxiliar na modelagem visual.

- Consulta pontual com cursor LSP: pesquisa programada da descrição apenas quando a chave estrangeira for diferente de nulo.

- Inicialização preventiva de variáveis: atribuição de valor em branco às variáveis de exibição antes da abertura do cursor.

A recuperação via cursor assegura que todos os colaboradores constem no relatório, independentemente da completude de seus vínculos secundários.

Além das consolidações numéricas, a formatação visual e textual dos campos eleva o padrão de acabamento dos documentos gerados no sistema.

Funções e propriedades auxiliares:

- ConverteParaMaiusculo e ConverteParaMinusculo: funções LSP para uniformização de caixas em descrições e nomes.

- Propriedade Justificado em campos Memorando: alinhamento pleno das margens de parágrafos extensos em termos contratuais.

- Reaproveitamento de escopo: declaração de variáveis globais para evitar execuções repetidas da mesma consulta em seções distintas.

O domínio desses recursos complementares garante a entrega de relatórios e documentos contratuais precisos e esteticamente alinhados.

Veja como esse conteúdo foi abordado na aula:

Siga os passos abaixo para configurar um modelo contendo totais departamentais, total geral e controle de visão analítica/sintética:

1. Acesse o Gerador de Relatórios e crie um novo modelo utilizando a tabela de Colaboradores (R034FUN).

2. Insira no leiaute as seções de Cabeçalho de Página, Detalhe, Subtotal, Total Geral e Rodapé de Página.

3. No Rodapé de Página, adicione campos de sistema contendo a data de geração, o código do usuário e a paginação.

4. Defina na seção de Detalhe a ordenação por Empresa (NumEmp), Centro de Custo (CodCcu) e Matrícula (NumCad).

5. Insira na seção de Subtotal dois componentes do tipo Totalizador: um configurado como Acumulador para o campo ValSal e outro como Contador para o campo NumCad.

6. Nas propriedades de ambos os totalizadores da seção de Subtotal, selecione a própria seção de Subtotal no campo Sessão Limpeza.

7. Replique os totalizadores na seção de Total Geral, ajustando a propriedade Sessão Limpeza para nenhuma seleção.

8. Adicione uma tela de entrada contendo a variável tipo alfa para selecionar entre a emissão Analítica ou Sintética.

9. Na regra da seção de Detalhe, inclua a condição lógica testando se o relatório foi solicitado em modo sintético; caso positivo, execute a função Cancel(0).

10. Caso utilize descrição de centro de custo, programe um cursor LSP sobre a tabela R018CCU para buscar a descrição sem gerar vínculos visuais restritivos.

11. Execute o relatório nas duas modalidades e confirme se os cálculos de subtotal e total geral conferem nas visões detalhada e resumida.

A consolidação de informações por meio de totalizadores nativos constitui uma técnica indispensável para simplificar o desenvolvimento de relatórios no Senior HCM. A correta parametrização de limpeza de seções elimina falhas recorrentes de duplicidade nos valores acumulados.

A flexibilização entre modos analítico e sintético no mesmo relatório reduz significativamente a quantidade de modelos mantidos no ambiente, facilitando a gestão do repositório da empresa.

Por fim, a substituição de junções visuais restritivas por cursores programados garante a integridade completa dos registros, fornecendo demonstrativos confiáveis para tomada de decisão no departamento de recursos humanos.