CONTEÚDO
- Visão Geral
- Parâmetros de Entrada (filtros)
- Estrutura de Dados
- Regra de Negócio
- Exemplo de Utilização
- Relatórios que Utilizam esse Objeto de Negócio
01. VISÃO GERAL
O objeto de negócio FopListAniversarioBusinessObject tem como finalidade extrair a relação de colaboradores aniversariantes. Ele utiliza os dados de nascimento armazenados na tabela de pessoas (PPESSOA) cruzando com as informações contratuais da folha de pagamento (PFUNC), permitindo filtragens por mês, idade e estrutura organizacional.
- Módulo: Folha de Pagamento
- Time Responsável: Rotinas
02. PARÂMETROS DE ENTRADA
Este objeto possui parâmetros específicos para controlar a profundidade do histórico e a visibilidade de dados sensíveis:
| Parâmetro | Descrição | Comportamento |
|---|
Mês | Mês do Aniversário | Filtra os aniversariantes de um ou mais meses específicos. |
| Coligada | Código da Empresa | Filtra os dados por uma coligada específica. |
| Situação | Status do Funcionário | Filtra por Ativos, Férias, Afastados, etc. |
| Tipo | Tipo de Funcionário | Filtra por categorias (Ex: Estagiário, Autônomo, Normal). |
| Filial | Unidade de Negócio | Restringe a lista a filiais selecionadas. |
| Idade | Faixa Etária | Filtra colaboradores que possuem idades específicas. |
| Departamento | Seção / Estrutura | Permite busca hierárquica por código de seção (via LIKE). |
Exibe Salário | Privacidade | Define se o salário do colaborador deve constar no resultado. |
Exibe C. Custo | Centro de Custo | Define a visibilidade da classificação contábil no objeto. |
03. Estrutura de Dados
Os dados são mapeados através da entidade FopListaDeAniversarianteBusinessObjectEntity:
- EmployeeName: Nome completo do colaborador.
- EmployeeCode: Chapa/Matrícula.
- BirthDate: Data de nascimento completa.
- EmployeeAge: Idade calculada dinamicamente.
- DepartmentName: Nome da seção/departamento atual.
- Salary: Valor salarial (condicionado ao parâmetro de exibição).
- CostCenterCode: Código do Centro de Custo.
04. Regra de Negócio
- Cálculo Dinâmico de Idade: O objeto realiza o cálculo da idade em tempo real, adaptando a função conforme o banco de dados utilizado:
- SQL Server: Utiliza DATEDIFF(YEAR, PPESSOA.DTNASCIMENTO, GETDATE()).
- Oracle: Utiliza TRUNC(MONTHS_BETWEEN(SYSDATE, PPESSOA.DTNASCIMENTO) / 12).
- Extração do Mês: A lógica de extração do mês de nascimento também é adaptativa:
- SQL Server: Função MONTH().
- Oracle: Função EXTRACT(MONTH FROM ...).
- Segurança: O acesso aos dados é controlado pelo código de segurança 812000680, garantindo que apenas usuários autorizados no módulo de Folha de Pagamento possam gerar a lista.
- Otimização de Leitura: Todas as consultas internas para carregamento de opções (Options) utilizam o dialeto NoLockStatment, evitando deadlocks em bases SQL Server com alto volume de movimentação.
05. Exemplo de Utilização
06. Relatórios que utilizam esse objeto de negócio