Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

--- pres:gerti:gestao_de_ativos:siap_2:mapa_tempo [16/10/2026 18:38] – [== Validação do acesso] jsdias
+++ pres:gerti:gestao_de_ativos:siap_2:mapa_tempo [16/10/2026 19:55] (atual) – jsdias
@@ Linha 53: / Linha 53: @@
 ==== RN05. Cálculo externo ====
-O formulário possui integrações [[#validacao|Clique aqui para ir à seção de validação]] obtemmapatemposervidor, versão /v3/. Cálculo do mapa depende de serviço específico de regras de Atos de Pessoal.
+O formulário possui integrações [[#calculo_tempo_v3|obtemmapatemposervidor]], versão /v3/. Cálculo do mapa depende de serviço específico de regras de Atos de Pessoal.
 ==== RN06. Alteração de dados de origem ====
@@ Linha 185: / Linha 184: @@
 Inicializada no carregamento do formulário e é reponsável pela captura dos dados do usuário logado e disponibilizado ao sistema.
-==== == Validação do acesso ====
+====   ====
-[[:anchor:validacao?media=anchor:validacao|validacao]]
 ==== 4.2 Cálculo Tempo V3 ====
@@ Linha 197: / Linha 193: @@
 Também está configurada como integração de click.
+**Visão consolidada**
+**{{:pres:gerti:gestao_de_ativos:siap_2:visaoconsolidadamapatempo.png?nolink&336x237}}**
+=====   =====
+==== 4.3 Busca de todas as variáveis do fluxo ====
+**Serviço**: [[:pres:gerti:gestao_de_ativos:siap_2:solarbpm|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.
+===== 5. Botões =====
+Alterar dados do histórico funcional
+^Propriedade^Valor|
+|Key|''btn_2'' |
+|Tipo|button|
+|Título|Alterar 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 =====
+==== RN-MT-01: cálculo centralizado ====
+Os valores do Mapa do Tempo são tratados como resultados calculados, visto que seus respectivos campos estão definidos como somente leitura.
+==== RN-MT-02: obtenção das variáveis do fluxo ====
+Antes/durante o processamento, o formulário possui mecanismo específico para recuperar variáveis do vínculo BPM.
+==== RN-MT-03: integração especializada ====
+O mapa utiliza o serviço [[#calculo_tempo_v3|obtemmapatemposervidor]] para enviar e devolver parametros utilizado nos calculos.
+==== RN-MT-04: resultados em dias ====
+As categorias principais têm representação complementar em dias, identificada pelo padrão:
+*_dias
+==== RN-MT-05: datas controlam o período ====
+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.
+==== RN-MT-06: alteração dos dados funcionais ====
+Se houver necessidade de corrigir os dados funcionais usados pelo mapa, existe uma ação explícita **Alterar dados do histórico funcional**.
+==== RN-MT-07: auditoria ====
+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 **  [[:pres:gerti:gestao_de_ativos:siap_2:javascript|JavaScript]] .
+==== 7.1 Inicialização e estado do formulário ====
+^Função^Responsabilidade 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|
+==== 7.2 Cálculo do Mapa do Tempo ====
+^Função^Responsabilidade|
+|''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.
+==== 7.3 Busca de variáveis BPM ====
+^Função^Responsabilidade|
+|''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_de_todas_as_variaveis_do_fluxo|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
+==== 7.4 Auditoria ====
+^Função^Responsabilidade|
+|''setInfoAlterada()'' |Trata informação identificada como alterada|
+|''preencheInformacoesAlteradas()'' |Preenche estrutura de alterações. (Antes e depois)|
+==== 7.5 Navegação e submissão ====
+^Função^Responsabilidade|
+|''retornarForm3()'' |Lógica de retorno relacionada ao formulário anterior/histórico funcional|
+|''enviarDados()'' |Rotina de envio/conclusão|
+|''capturaDataHoraAtual()'' |Obtém data/hora utilizada pelo processamento|
+==== 7.6 Interface ====
+^Função^Responsabilidade|
+|''exibeAlerta()'' |Exibe mensagem/alerta no formulário|
+===== 8. Fluxo Funcional Consolidado =====
+{{:pres:gerti:gestao_de_ativos:siap_2:fluxofuncionalconsolidado-mapadotempo.png?nolink&357x730}}
+======   ======
+===== 9.Resumo Executivo =====
+A tarefa **Mapa do Tempo**  consolida os tempos relevantes à análise da aposentadoria civil.
+O formulário trabalha principalmente com **dados calculados e somente leitura**, abrangendo tempo de cargo, descontos, tempo fictício, magistério, averbações públicas e privadas, contribuição/compensação previdenciária, condições especiais, pessoa com deficiência, conversões e totais de serviço/contribuição.
+Tecnicamente, a tarefa possui três componentes centrais:
+  - **Recuperação das variáveis da instância BPM**, por meio do vínculo do processo, para preparação e envio das variáveis para o serviço de críticas logo depois desta tarefa Mapa do tempo finalizada ;
+  - **Processamento pela API de regras de Atos de Pessoal**, através do serviço ''[[:pres:gerti:gestao_de_ativos:siap_2:obtemmapatemposervidor|ObtemMapaTempoServidor]]'' ;
+  - **Apresentação do mapa calculado**, mantendo tanto valores de apresentação quanto os correspondentes valores em dias.
+=====   =====
+===== 10. Imagens do formulário =====
+{{:pres:gerti:gestao_de_ativos:siap_2:formmapadotempo.png?nolink&1727x989}}
+Voltar para o [[:pres:gerti:gestao_de_ativos:siap_2:catalago_formularios|Catálago de formulários]]