Essa é uma revisão anterior do documento!


Mapa do tempo

O objetivo funcional é obter e consolidar o mapa de tempo previdenciário do servidor, utilizando informações registradas nas etapas anteriores do processo e uma integração específica de cálculo.

Além do valor apresentado ao usuário, vários tempos possuem uma variável paralela terminada em _dias, permitindo armazenar o resultado em dias.

Exemplo: tempoCargoAposen e tempoCargoAposen_dias

Os seguintes campos são apresentados somente para consulta:

  • Órgão/Entidade;
  • CPF;
  • Nome do servidor;
  • Motivo da aposentadoria.

Dois campos de data participam da contextualização da apuração:

KeyCampoObservação
dataEfetExercCargoInicial Data do efetivo exercício no cargo de ingressoSomente leitura
dataFimTempoContribServico Data do fim da apuração do tempo de contribuição/serviçoSomente leitura

Os campos referentes aos tempos calculados estão configurados como readonly=true.

Isso vale, por exemplo, para:

  • tempoCargoAposen
  • tempoDescontado
  • tempoFicticio
  • tempoAverbadoPublico
  • tempoAverbadoPrivado
  • totalTempoServPublico
  • totalTempoContrbServ

Portanto, os resultados são recebidos/calculados pelo processamento do formulário, e não informados diretamente pelo operador.

Grande parte dos indicadores possui duas variáveis:

tempo…
tempo…_dias

A primeira representa o tempo apresentado no formulário em ano(s,) mese(s) e dia(s) e a segunda armazena a quantidade desse tempo correspondente em dia(s).

O formulário possui integrações obtemmapatemposervidor, versão /v3/. Cálculo do mapa depende de serviço específico de regras de Atos de Pessoal.

Existe um botão específico:

Alterar dados do histórico funcional

A função retornarForm3 está associada à lógica de retorno ao conjunto de informações funcionais utilizado como origem do mapa.

Existem funções específicas de:

  • validação de datas;
  • busca das variáveis do processo;
  • execução do cálculo;
  • auditoria de alterações;
  • envio/conclusão.

Para facilitar o uso da documentação, organizei as variáveis por finalidade.

KeyCampoTipoColsObrig.ReadonlyObservação
nomeOrgao Órgão/Entidadeinput12NãoSimIdentificação institucional
cpfServidor CPF do servidorinput-cpf4NãoSimCPF do interessado
nomeServidor Nome do servidorinput8NãoSimIdentificação do servidor
desc_motivoAposentadoria Motivo da aposentadoriainput12NãoSimMotivo já definido no processo
KeyCampoTipoColsObrig.ReadonlyObservação
dataEfetExercCargoInicial Data do efetivo exercício no cargo de ingressoinput-date6NãoSimData de referência funcional
dataFimTempoContribServico Data do fim da apuração do tempo de contribuição/serviçoinput-date6NãoSimLimite da apuração
KeyCampoColsObrig.Readonly
tempoCargoAposen Tempo de exercício no cargo da aposentadoria (A)9NãoSim
tempoCargoAposen_dias Tempo em dias3NãoSim
tempoDescontado Tempo descontado (B)9NãoSim
tempoDescontado_dias Tempo em dias3NãoSim
tempoFicticio Tempo fictício total (C)9NãoSim
tempoFicticio_dias Tempo em dias3NãoSim
tempoMagisterioInfantil Tempo em função exclusiva de magistério na educação infantil, ensino fundamental ou médio (D)9NãoSim
tempoMagisterioInfantil_dias Tempo em dias3NãoSim

Tipo de todos os campos acima: input.

KeyCampoColsTipoObrigatórioReadonly
tempoAverbadoPublico Tempo averbado público (E)9inputNãoSim
tempoAverbadoPublico_dias Tempo em dias3inputNãoSim
tempoAverbadoPrivado Tempo averbado privado (F)9inputNãoSim
tempoAverbadoPrivado_dias Tempo em dias3inputNãoSim
contribPrevidenciaria Contribuição previdenciária (G)9inputNãoSim
contribPrevidenciaria_dias Tempo em dias3inputNãoSim
compPrevidenciaria Compensação previdenciária (H)9inputNãoSim
compPrevidenciaria_dias Tempo em dias3inputNãoSim
KeyCampoCols
tempoCondicaoDeficiencia Tempo na condição de segurado com deficiência, antes da conversão (J)9
tempoCondicaoDeficiencia_dias Tempo em dias3
tempoCondicaoSegDeficiencia Tempo na condição de segurado com deficiência após conversão, Decreto nº 3.048/1999, art. 70-E (K)9
tempoCondicaoSegDeficiencia_dias Tempo em dias3
tempoCondicaoSemDeficiencia Tempo na condição de pessoa sem deficiência, antes da conversão (L)9
tempoCondicaoSemDeficiencia_dias Tempo em dias3
tempoCondicaoDeficienciaConversao Tempo na condição de pessoa sem deficiência, após conversão (M)9
tempoCondicaoDeficienciaConversao_dias Tempo em dias3

Todos estão definidos como:

  • Tipo: input;
  • Obrigatório: Não;
  • Somente leitura: Sim.
KeyCampoCols
tempoSobCondicoesEspeciais Tempo em atividades sob condições especiais, antes da conversão (N)9
tempoSobCondicoesEspeciais_dias Tempo em dias3
tempoCondicoesEspeciasConversao1 Tempo em atividades sob condições especiais após conversão, Decreto nº 3.048/1999, art. 70-F, §1º (O)9
tempoCondicoesEspeciasConversao1_dias Tempo em dias3
tempoCondicoesEspeciasConversao2 Tempo em atividades sob condições especiais após conversão, Decreto nº 3.048/1999, art. 66, §2º9
tempoCondicoesEspeciasConversao2_dias Tempo em dias3

Todos são input, não obrigatórios e somente leitura.

KeyCampoColsReadonly
totalTempoServPublico Total de tempo de serviço público (TSP)9Sim
totalTempoServPublico_dias Tempo em dias3Sim
tempoContribuicaoServicoPCD Total de tempo de contribuição/serviço após conversões (TCS-PcD)9Sim
tempoContribuicaoServicoPCD_dias Tempo em dias3Sim
tempoConvertidoSerAcrescido Tempo convertido a ser acrescido (I)9Sim
tempoConvertidoSerAcrescido_dias Tempo em dias3Sim
totalTempoContrbServ Total de tempo de contribuição/serviço (TCS)9Sim
totalTempoContrbServ_dias Tempo em dias3Sim

Tipo: input.

Obrigatórios: Não.

KeyCampoTipoColsObrig.ReadonlyFinalidade
fd_tempo FD_Tempoinput6NãoNãoVariável técnica relacionada ao processamento do mapa, variável que recebe o retorno da api que trás os tempos calculados.

O JSON contém 5 configurações de integração.

Nome: usuariologado

Evento: load

Serviço: cpa-core-backend

Operação: POST /s/integracao-fd/consulta-usuario-logado

Inicializada no carregamento do formulário e é reponsável pela captura dos dados do usuário logado e disponibilizado ao sistema.

TCE - Atos de Pessoal - Api Regras Form Dinamico

POST /v3/ObtemMapaTempoServidor

Também está configurada como integração de click.

Visão consolidada

Serviço: SolarBPM - Consulta todas variáveis 2

GET /bpm-server-adm/bindings/{cdVinculo}/variables

Essa integração recupera as variáveis vinculadas à instância do processo (cdVinculo) para utilização pelo processamento do formulário.

Alterar dados do histórico funcional

PropriedadeValor
Keybtn_2
Tipobutton
TítuloAlterar dados do histórico funcional

Permite acionar o caminho de retorno relacionado às informações funcionais usadas pelo mapa ( finaliza e direciona, atravéz do fluxo, para tarefa “Dados do histórico funcional”).

6. Principais Regras de Negócio

Os valores do Mapa do Tempo são tratados como resultados calculados, visto que seus respectivos campos estão definidos como somente leitura.

Antes/durante o processamento, o formulário possui mecanismo específico para recuperar variáveis do vínculo BPM.

O mapa utiliza o serviço obtemmapatemposervidor para enviar e devolver parametros utilizado nos calculos.

As categorias principais têm representação complementar em dias, identificada pelo padrão:

*_dias

A data de efetivo exercício no cargo de ingresso e a data final da apuração integram os dados apresentados para a apuração.

Se houver necessidade de corrigir os dados funcionais usados pelo mapa, existe uma ação explícita Alterar dados do histórico funcional.

O formulário possui funções específicas para identificar e registrar alterações:

setInfoAlterada()

preencheInformacoesAlteradas()

removeIndice_tab_relacoesInfoalteradas()

7. Principais Funções JavaScript

O arquivo possui 18 funções JavaScript .

FunçãoResponsabilidade funcional
onLoadFuncao() Rotinas de carregamento
statusForm_finalizadoOuNao() Verifica, no carregamento da pagina, o estado do formulário, se esta finalizado ou não. (Mais detalhes, consulta no form codigo na função)
carregaDadosIniciais() Carregamento dos dados iniciais
FunçãoResponsabilidade
carregarMapaTempo() Carregamento do mapa
executaIntegracaoTempo() Aciona processamento/integracão relacionada ao cálculo
validaDataCalculos() Valida datas utilizadas na rotina de cálculo
removePalavraDias() Tratamento textual relacionado à representação de dias

Estas funções formam o núcleo funcional da tela.

FunçãoResponsabilidade
variaveisParaBusca() Prepara as variáveis necessárias à busca.(Relacionadas as críticas da instância jurisdicionado)
Ex: { 'variavel_f': 'cod_motivoAposentadoria', 'variavel_tce': 'motivoAposentadoria' }
acionaIntegracaoBuscaTodasVariaveis() Aciona integração Busca todas variáveis do fluxo de consulta das variáveis do fluxo e retornas todas as variáveis com seus respectivos valores na variável todasVariaveis.
buscaVariaveisFluxo_e_enviarDados() Combina recuperação das variáveis com sequência de envio

A existência dessas funções está diretamente relacionada à integração:

GET /bpm-server-adm/bindings/{cdVinculo}/variables

  • pres/gerti/gestao_de_ativos/siap_2/mapa_tempo.1792178957.txt.gz
  • Última modificação: 16/10/2026 19:29
  • por jsdias