Introdução
Este manual tem como objetivo orientar no uso do Painel de Aprovações de requerimentos.
A implementação dessas funcionalidades visa conferir maior flexibilidade à coleta de dados secundários e tabelas filhas, permitindo que formulários dinâmicos sejam moldados de acordo com as necessidades específicas de cada tipo de solicitação. Através deste documento, você compreenderá desde a estruturação inicial dos campos e suas regras de validação até o fluxo final de persistência dos dados no cadastro do profissional, seja por meio de processamento automatizado ou por análise da equipe de atendimento.
Configuração de Campos no Formulário
O sistema permite a parametrização de campos personalizados para formulários de requerimentos, definindo regras de preenchimento, filtros e ordenação.
Restrição de Cadastro
- Visibilidade por Interface: Durante a criação ou amarração de novos campos, apenas ficarão visíveis para seleção os campos que pertencem estritamente à interface (tabela filha).
Estrutura e Propriedades dos Campos
Ao cadastrar um novo campo em Interno > Campos de Requerimento > Guia Campos – Coleção, as seguintes propriedades devem ser configuradas:
- Descrição: Nome identificador técnico da coluna no banco de dados.
- Legenda: Nome amigável que será exibido para o usuário final na interface do formulário.
- Obrigatório: Marcação booleana que define se o preenchimento do campo impede ou não o avanço de etapa.
- Ordem: Sequência numérica que determina a posição de exibição física no formulário.
O Campo Filtro (Para que serve/Como funciona)
O campo Filtro atua como uma regra de restrição padrão aplicada aos dados que serão exibidos para o usuário solicitante.
- Exemplo prático: Ao configurar um filtro padrão em um campo de busca de “Municípios” para filtrar apenas pelo estado de “SC”, a pesquisa dinâmica do usuário final se resumirá exclusivamente às cidades pertencentes ao estado de Santa Catarina, otimizando o preenchimento.
Em Interno > Campos de Requerimento > Guia Campos – Coleção.
Validações SQL e Comportamento dos Campos
- Validações SQL: Configuração de scripts para verificar a consistência das informações inseridas antes do salvamento definitivo. A execução ocorre no momento em que o usuário tenta avançar ou concluir a etapa, impedindo a gravação de registros inconsistentes (ex: impedir que o ano de conclusão seja o ano futuro).
- Respeito ao Tipo de Campo: O sistema foi projetado para respeitar rigorosamente a tipagem de dados parametrizada. Campos do tipo texto simples, data ou texto longo (Memo) não devem herdar o comportamento de caixas de seleção dinâmica (lookup), mantendo suas respectivas máscaras e inputs de escrita manual ativos.
Modelo de Requerimento e Regras de Aprovação
O comportamento do fluxo de dados das tabelas filhas e dos campos coleção é regido pela parametrização do Modelo de Requerimento, dividida em duas modalidades:
- Aprovação Automática: Os dados preenchidos pelo solicitante recebem o status de “aprovado” imediatamente após o envio. O sistema realiza o repasse automatizado das informações para as tabelas correspondentes (como os dados de formação acadêmica na tabela da Pessoa), sem a necessidade de intervenção do manual.
- Aprovação Manual: Exige que um operador analise criticamente os dados inseridos através do painel regulador antes que eles integrem definitivamente o histórico do cadastro.
Interface de Análise e Painel de Aprovações
Ao receber um protocolo derivado de um requerimento, o atendente dispõe de seções distintas para gerenciar a informação:
Dados do Requerimento
Na tabela de dados do requerimento em Protocolo > Requerimentos, as linhas registram os identificadores nativos (Ids) e dados estruturais necessários para a futura criação física dos registros na base de dados. Por se tratar de uma tabela espelho de banco, esses valores estruturais não são removidos ou substituídos, garantindo a integridade técnica do envio.
Painel de Aprovações
Para a conferência e análise do operador de atendimento, utiliza-se exclusivamente a interface do Painel de Aprovação.
- Resolução de Identificadores: Neste painel, o sistema converte os Ids técnicos e apresenta os dados resolvidos com seus nomes, títulos e descrições textuais correspondentes (ex: o nome do curso por extenso em vez do ID numérico).
- Campos do Tipo Memo: Exibe as respostas em linha única com um ícone lateral que abre um modal, permitindo a leitura de textos longos sem quebrar o layout da página.
- Campos de Data: Mostram apenas a informação de dia/mês/ano, omitindo horas para melhor legibilidade.
Fluxo de Ações: Aprovação e Rejeição no Painel
O processo de análise de dados no Painel de Aprovações baseia-se em comandos individuais ou em massa por campo, seguidos pela execução de uma ação global. Ao passar o mouse sobre os campos, o sistema exibe os comandos de atalho (ex: 1 – Para Aprovar, 2 – Para Reprovar, 3 – Para Aprovar Todos, 4 – Reprovar Todos).
Após marcar os campos com seus respectivos status, o atendente aciona um dos botões principais do topo do painel:
Botão “Atualizar Dados” (Processo de Aprovação)
- Funcionamento: Esta ação é utilizada quando os campos avaliados pelo atendente estão em conformidade e foram marcados como aprovados (ficando com a sinalização visual “verde”).
- Geração de Agendamento: Ao clicar em “Atualizar Dados”, o sistema cria um agendamento em segundo plano chamado “Aprovação de requerimento”.
- Impacto no Sistema: Este agendamento é responsável por ler os dados temporários do requerimento e gravar os registros de forma definitiva nas tabelas finais do sistema (como a aba Título Profissional dentro do cadastro da Pessoa).
- Pré-requisito: Para que o processamento ocorra com sucesso, todos os campos obrigatórios daquela estrutura precisam ter sido devidamente preenchidos e validados pelo fluxo, caso contrário, o agendamento registrará um log de “Falha”.
- Botão Aprovar: Dispara um agendamento no sistema para que os dados coletados e validados no requerimento sejam de fato persistidos, gravando e criando o registro definitivo nas tabelas finais do cadastro (ex: inserindo a formação na aba Formação/Título Profissional dentro de Cadastros > Pessoas).
Botão “Rejeitar” (Processo de Rejeição)
- Funcionamento: Esta ação é utilizada quando o atendente identifica dados incorretos, divergentes ou falsos inseridos pelo solicitante. Ao clicar em “Rejeitar”, o sistema abre uma tela flutuante de “Confirmação de Aprovação” (com foco em rejeição) contendo um campo de texto opcional para observações e justificativas.
- Geração de Agendamento: Ao confirmar, o sistema dispara um agendamento assíncrono específico chamado “Reprovação de requerimento”.
- Impacto no Sistema: Este agendamento barra a gravação dos dados nas tabelas da Pessoa e cria automaticamente uma Pendência Cadastral vinculada ao protocolo do requerimento.
- Trâmite e Retorno ao Usuário: O protocolo é atualizado com o histórico da rejeição e o motivo preenchido pelo atendente. O requerimento é devolvido para a área restrita do solicitante no portal externo, permitindo que ele visualize a crítica, corrija os campos apontados e reenvie para uma nova análise.
- Botão Rejeitar: Cancela a validação do campo e gera automaticamente uma pendência cadastral vinculada ao protocolo do requerente.
Agendamentos
Todo o fluxo de escrita de dados são para garantir a segurança da operação.
- Uso de Agendamentos: As ações disparadas pelo painel de aprovação entram em uma fila de processamento em segundo plano.
