pres:gerti:gestao_de_ativos:siap_2:validacao_final_ocorrencia

Diferenças

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

Link para esta página de comparações

Ambos lados da revisão anterior Revisão anterior
Próxima revisão		 Revisão anterior
pres:gerti:gestao_de_ativos:siap_2:validacao_final_ocorrencia [23/10/2026 15:39] – jsdiaspres:gerti:gestao_de_ativos:siap_2:validacao_final_ocorrencia [23/10/2026 20:37] (atual) – jsdias
Linha 115: Linha 115:
 ===== 3. Todas as variáveis ===== ===== 3. Todas as variáveis =====
  
-==== 3.1 Etapa 1 - Identificação  ====+==== 3.1 Etapa 1 - Identificação ====
  
 ^Key^Campo/Título^Tipo^Cols^Obrig.^Readonly| ^Key^Campo/Título^Tipo^Cols^Obrig.^Readonly|
Linha 124: Linha 124:
 |''nomeCargoAposentadoria'' |Descrição completa do cargo da aposentadoria|input|6|Não|Sim| |''nomeCargoAposentadoria'' |Descrição completa do cargo da aposentadoria|input|6|Não|Sim|
  
-==== 3.2 Etapa 1 - Fundamento jurídico  ====+==== 3.2 Etapa 1 - Fundamento jurídico ====
  
 ^Key^Campo/Título^Tipo^Cols^Obrig.^Readonly^Rows| ^Key^Campo/Título^Tipo^Cols^Obrig.^Readonly^Rows|
Linha 132: Linha 132:
 |''dispLegalCompletoAposent_op'' |Fundamentação legal consolidada|textarea|12|Não|Sim|4| |''dispLegalCompletoAposent_op'' |Fundamentação legal consolidada|textarea|12|Não|Sim|4|
  
-==== 3.3 Etapa 1 - Datas e tempos  ====+==== 3.3 Etapa 1 - Datas e tempos ====
  
 ^Key^Título^Tipo^Cols^Readonly| ^Key^Título^Tipo^Cols^Readonly|
Linha 158: Linha 158:
  
 ==== 3.4 Etapa 1 - Tabela de atos de concessão ==== ==== 3.4 Etapa 1 - Tabela de atos de concessão ====
- 
-a { 
-    text-decoration: none; 
-    color: #464feb; 
-} 
-tr th, tr td { 
-    border: 1px solid #e6e6e6; 
-} 
-tr th { 
-    background-color: #f5f5f5; 
-} 
  
 ^Key^Título^Tipo^Cols^Obrig.^Readonly| ^Key^Título^Tipo^Cols^Obrig.^Readonly|
Linha 177: Linha 166:
  
 ==== 3.5 Etapa 1 - Ato de fixação de proventos ==== ==== 3.5 Etapa 1 - Ato de fixação de proventos ====
- 
-a { 
-    text-decoration: none; 
-    color: #464feb; 
-} 
-tr th, tr td { 
-    border: 1px solid #e6e6e6; 
-} 
-tr th { 
-    background-color: #f5f5f5; 
-} 
  
 ^Key^Título^Tipo^Cols^Obrig.^Readonly| ^Key^Título^Tipo^Cols^Obrig.^Readonly|
Linha 194: Linha 172:
  
 ==== 3.6 Etapa 1 - Variáveis ocultas ==== ==== 3.6 Etapa 1 - Variáveis ocultas ====
- 
-a { 
-    text-decoration: none; 
-    color: #464feb; 
-} 
-tr th, tr td { 
-    border: 1px solid #e6e6e6; 
-} 
-tr th { 
-    background-color: #f5f5f5; 
-} 
  
 ^Key^Utilização| ^Key^Utilização|
Linha 235: Linha 202:
  
 ==== 3.7 Etapa 2 - Ocorrências ==== ==== 3.7 Etapa 2 - Ocorrências ====
- 
-a { 
-    text-decoration: none; 
-    color: #464feb; 
-} 
-tr th, tr td { 
-    border: 1px solid #e6e6e6; 
-} 
-tr th { 
-    background-color: #f5f5f5; 
-} 
  
 ^Key^Título^Tipo^Cols^Obrig.^Readonly^Observação| ^Key^Título^Tipo^Cols^Obrig.^Readonly^Observação|
Linha 258: Linha 214:
  
 ==== 3.8 Etapa 2 - Decisão/encaminhamento ==== ==== 3.8 Etapa 2 - Decisão/encaminhamento ====
- 
-a { 
-    text-decoration: none; 
-    color: #464feb; 
-} 
-tr th, tr td { 
-    border: 1px solid #e6e6e6; 
-} 
-tr th { 
-    background-color: #f5f5f5; 
-} 
  
 ^Key^Título^Tipo^Cols^Obrigatório^Readonly| ^Key^Título^Tipo^Cols^Obrigatório^Readonly|
Linha 291: Linha 236:
  
 ==== 3.9 Etapa 2 - Variáveis auxiliares/PDF ==== ==== 3.9 Etapa 2 - Variáveis auxiliares/PDF ====
- 
-a { 
-    text-decoration: none; 
-    color: #464feb; 
-} 
-tr th, tr td { 
-    border: 1px solid #e6e6e6; 
-} 
-tr th { 
-    background-color: #f5f5f5; 
-} 
  
 ^Key^Tipo^Readonly^Observação| ^Key^Tipo^Readonly^Observação|
Linha 313: Linha 247:
  
 O agrupador Campos Ocultos da segunda etapa contém: O agrupador Campos Ocultos da segunda etapa contém:
- 
-a { 
-    text-decoration: none; 
-    color: #464feb; 
-} 
-tr th, tr td { 
-    border: 1px solid #e6e6e6; 
-} 
-tr th { 
-    background-color: #f5f5f5; 
-} 
  
 ^Key^Finalidade| ^Key^Finalidade|
Linha 329: Linha 252:
 |''nomeRespAssApostila'' |Nome do responsável relacionado à apostila| |''nomeRespAssApostila'' |Nome do responsável relacionado à apostila|
 |''processoTceHub'' |Variável de processo relacionada ao TCE Hub| |''processoTceHub'' |Variável de processo relacionada ao TCE Hub|
 +
 +===== 4. Integrações =====
 +
 +Considerando as duas etapas, existem duas integrações distintas.
 +
 +==== 4.1 Busca todas variáveis do fluxo ====
 +
 +^Propriedade^Valor|
 +|Nome|Busca todas variáveis do fluxo|
 +|Evento|''click'' |
 +|Elemento|''cpfServidor'' |
 +|Serviço|[[:pres:gerti:gestao_de_ativos:siap_2:solarbpm|SolarBPM]] - Consulta todas variáveis 2|
 +|Operação|''GET_/bpm-server-adm/bindings/{cdVinculo}/variables'' |
 +|Send Model|''false'' |
 +
 +**Finalidade correta**
 +
 +A finalidade principal dessa integração é recuperar as variáveis existentes na instância BPM e preencher todasVariaveis como array, além dos retornos individualmente mapeados.
 +
 +A segunda etapa possui a função:
 +
 +buscaVariaveisFluxo_e_enviarDados()
 +
 +Ela verifica a quantidade de registros em:
 +
 +model.todasVariaveis.length
 +
 +e percorre cada item através de:
 +
 +model.todasVariaveis[r].name
 +
 +model.todasVariaveis[r].value
 +
 +Portanto, a consulta de todasVariaveis participa da rotina de conclusão do formulário, e não deve ser documentada simplesmente como uma integração destinada a carregar visualmente os campos readonly da aba 1.
 +
 +==== 4.2 Nome responsável apostila (no SIAP 2.0 a utilidade desta integração foi removida) ====
 +
 +Esta integração pertence à segunda etapa.
 +
 +^Propriedade^Valor|
 +|Nome|Nome responsável apostila|
 +|Evento|''load'' |
 +|Serviço|''cpa-core-backend'' |
 +|Operação|''POST_/s/integracao-fd/consulta-usuario-logado'' |
 +|Send Model|''false'' |
 +
 +Entre os retornos configurados estão:
 +
 +  * dataHoraInfoSobreApostila;
 +  * nomeRespAssApostila;
 +  * tab_criticas5A2;
 +  * bt_comoDesejaProsseguir;
 +  * sel_etapaRetorno;
 +  * variáveis auxiliares de PDF.
 +
 +O mapeamento explícito:
 +
 +nmUsuario → nomeRespAssApostila
 +
 +recupera o nome do usuário para nomeRespAssApostila.
 +
 +===== 5. Botões =====
 +
 +==== Etapa 1 ====
 +
 +Prosseguir para próxima aba
 +
 +^Propriedade^Valor|
 +|Key|''submit_1'' |
 +|Tipo|submit|
 +|Título|Prosseguir para próxima aba|
 +|Função|''formFunctions.nextStep'' |
 +
 +Botão técnico de carregamento
 +
 +^Propriedade^Valor|
 +|Key|''btn_load'' |
 +|Tipo|button|
 +|Exibição|''false'' |
 +|Função|''carregaDadosIniciais'' |
 +
 +==== Etapa 2 ====
 +
 +**Voltar para aba anterior**
 +
 +Key: btn_3
 +
 +Função: formFunctions.previousStep
 +
 +Retorna para a primeira etapa.
 +
 +**Salvar**
 +
 +Key: btn_salvar
 +
 +Função: formFunctions.saveDraft
 +
 +**Concluir formulário**
 +
 +Key: submit_1
 +
 +Tipo: submit
 +
 +Função: finalizarTarefa
 +
 +**Botão técnico btn_load**
 +
 +Key: btn_load
 +
 +Função: carregaDadosIniciais
 +
 +showCondition: false
 +
 +===== 6. Principais Regras de Negócio =====
 +
 +==== RN-VFO-01 - Conferência antes da decisão ====
 +
 +A tarefa separa a conferência dos dados, na etapa 1, da análise das ocorrências e decisão de encaminhamento, na etapa 2.
 +
 +==== RN-VFO-02 - Ocorrências protegidas contra alteração estrutural ====
 +
 +Código e descrição são readonly e a função ''ocultaBotao_excluir_e_add_tab_criticas5A2()''  remove da interface os controles para adicionar/remover ocorrências.
 +
 +==== RN-VFO-03 - Justificativa é editável ====
 +
 +A coluna ''col_justificativa''  é o campo editável da tabela de ocorrências.
 +
 +==== RN-VFO-04 - Decisão obrigatória ====
 +
 +''bt_comoDesejaProsseguir''  possui ''required=true''.
 +
 +==== RN-VFO-05 - Retorno selecionável ====
 +
 +Caso o fluxo de decisão seja de retorno para alteração, o formulário disponibiliza ''sel_etapaRetorno''  com quatro destinos configurados.
 +
 +==== RN-VFO-06 - Validação antes da conclusão ====
 +
 +''finalizarTarefa()''  executa ''Class_ocultaCampos()''  e interrompe o processamento quando identifica campos inválidos, exibindo alerta:
 +
 +Existem campos com valores inválidos.
 +
 +==== RN-VFO-07 - Preparação para PDF ====
 +
 +Antes da sequência de conclusão, ''finalizarTarefa()''  chama:
 +
 +pdf_decideMostrarOuNaoNoPDF(form, model, context);
 +
 +===== 7. Principais funções JavaScript =====
 +
 +==== 7.1 Etapa 1 ====
 +
 +A primeira etapa possui 5 funções.
 +
 +^Função^Finalidade|
 +|''concatenacao()'' |Acrescenta a unidade "anos" a ''tempoMinContribServ'' conforme condição implementada|
 +|''carregaDadosIniciais()'' |Executa a inicialização|
 +|''onLoadFuncao()'' |Inicializa ajustes de interface e botão técnico|
 +|''ajustaTamanhoTabelas()'' |Realiza ajustes CSS de tabelas referenciadas|
 +|''acionaIntegracaoBuscaTodasVariaveis()'' |Dispara o mecanismo associado à consulta das variáveis do fluxo|
 +
 +----
 +
 +==== 7.2 Etapa 2 ====
 +
 +A segunda etapa possui um conjunto mais amplo de funções, incluindo:
 +
 +^Função^Finalidade|
 +|''retornaForm1()'' |Rotina relacionada ao retorno de formulário|
 +|''onLoadFuncao()'' |Inicialização da segunda etapa|
 +|''carregaCriticas()'' |Tratamento/carregamento das ocorrências|
 +|''limpaSelecaoEtapaRetorno()'' |Limpa seleção da etapa de retorno|
 +|''Class_ocultaCampos()'' |Controla visibilidade/obrigatoriedade e validação de campos|
 +|''ocultaShow_atencao()'' |Controla exibição do alerta|
 +|''ocultaBotao_excluir_e_add_tab_criticas5A2()'' |Oculta controles de inclusão/exclusão da tabela de ocorrências|
 +|''carregaDadosIniciais()'' |Realiza inicialização dos dados da aba|
 +|''removerLinhas()'' |Rotina para remoção/tratamento de linhas|
 +|''ocultaTabelaOcorrencias()'' |Controla visibilidade da tabela de ocorrências|
 +|''finalizarTarefa()'' |Coordena validação e conclusão do formulário|
 +|''pdf_decideMostrarOuNaoNoPDF()'' |Controla quais elementos serão apresentados no PDF|
 +|''exibeAlerta()'' |Exibe mensagens de validação|
 +|''escondeAlerta()'' |Oculta mensagens|
 +|''dataFinalizacaoTarefa()'' |Rotina relacionada à data de finalização|
 +|''variaveisParaBusca_NAO_USADO()'' |Implementação identificada explicitamente como não utilizada|
 +|''buscaVariaveisFluxo_e_enviarDados_DESATIVADO()'' |Versão explicitamente identificada como desativada|
 +|''variaveisParaBusca()'' |Prepara variáveis para o processamento|
 +|''buscaVariaveisFluxo_e_enviarDados()'' |Percorre ''todasVariaveis'' e trata os valores recuperados para a sequência de conclusão|
 +|''iniciaPropriedadesForm()'' |Inicializa propriedades e controles do formulário|
 +
 +==== Função crítica: buscaVariaveisFluxo_e_enviarDados() ====
 +
 +Essa é uma das funções centrais da segunda etapa.
 +
 +Ela utiliza:
 +
 +model.todasVariaveis.length
 +
 +e, para cada registro:
 +
 +model.todasVariaveis[r].name
 +
 +model.todasVariaveis[r].value
 +
 +O código trata diferentes variáveis do processo, incluindo estruturas tabulares, e monta objetos a partir dos valores recuperados.
 +
 +===== 8. Fluxo funcional completo das duas etapas =====
 +
 +{{:pres:gerti:gestao_de_ativos:siap_2:fluxofuncionalvalidacaofinaleocorrencias.png?nolink&321x755}}
 +
 +===== 9. Pontos técnicos importantes =====
 +
 +==== todasVariaveis é central para a conclusão ====
 +
 +A interpretação correta da arquitetura é:
 +
 +{{:pres:gerti:gestao_de_ativos:siap_2:pontostecnicosimportantesvalidfinaleocorrencias.png?nolink&254x338}}
 +
 +A variável ''todasVariaveis''  representa, portanto, uma estrutura intermediária importante para o processamento realizado na segunda etapa.
 +
 +==== Controle dinâmico da interface ====
 +
 +''Class_ocultaCampos()''  contém lógica para mostrar/ocultar campos e tratar obrigatoriedade dinamicamente. A função também participa da validação executada por ''finalizarTarefa()''.
 +
 +==== Ocorrências controladas ====
 +
 +A tabela ''tab_criticas5A2''  não é livremente manipulável: o próprio [[:pres:gerti:gestao_de_ativos:siap_2:javascript|JavaScript]] oculta os controles de inclusão e exclusão, enquanto código e descrição permanecem readonly.
 +
 +===== 10. Resumo Executivo =====
 +
 +A tarefa **Validação final e ocorrências**  é uma etapa de fechamento composta por **duas abas funcionalmente distintas**.
 +
 +A **primeira etapa**  concentra a conferência das informações produzidas anteriormente no processo, exibindo em modo somente leitura a identificação do servidor, cargo, fundamento jurídico, datas, tempos previdenciários e atos de aposentadoria/fixação de proventos.
 +
 +A **segunda etapa**  concentra o tratamento efetivo da validação: apresenta a tabela de **Ocorrências**, mantém código e descrição protegidos contra edição, permite registrar **Justificativa**  e exige que o usuário escolha **Como deseja prosseguir?**. As opções são concluir o preenchimento e enviar ao TCE ou retornar aos formulários para alteração. Neste último caso, o usuário pode direcionar o retorno para Dados básicos, Dados do fundamento jurídico, Dados do histórico funcional ou Documentos de formalização.
 +
 +Do ponto de vista técnico, a integração **Busca todas variáveis do fluxo**  deve ser entendida em conjunto com ''todasVariaveis''. A integração alimenta essa coleção com as variáveis da instância BPM e, na lógica da segunda etapa, ''buscaVariaveisFluxo_e_enviarDados()''  percorre os registros por ''name''  e ''value''  durante o processamento relacionado à conclusão. (Responsável por preencher a variável ''processoTceHub ''que é enviada no serviço de críticas dentro do fluxo)
 +
 +A tarefa ainda possui uma segunda integração, **Nome responsável apostila**, executada no carregamento da segunda etapa para obter, entre outros retornos, ''nomeRespAssApostila''. (Neste SIAP 2.0 a integração executa mas os dados de retorno não são utilizados nesta versão do SIAP)
 +
 +Por fim, embora a rotina de conclusão manipule informações recuperadas de ''todasVariaveis'', **a versão 29 não demonstra registro ativo de novos campos em''tab_relacoesInfoalteradas''  **, pois as referências observadas a ''preencheInformacoesAlteradas()''  estão comentadas. Por isso, a auditoria deve ser documentada como **não explicitamente implementada nesta tarefa**, evitando atribuir incorretamente os campos editáveis da etapa 2 à ''tab_relacoesInfoalteradas''.
 +
 +===== 11. Tela do formulário e vídeos =====
 +
 +===== Tela aba 1 =====
 +
 +{{:pres:gerti:gestao_de_ativos:siap_2:validacaofinaleocorrenciasaba1.png?nolink&1798x989}}
 +
 +===== Tela aba 2 =====
 +
 +{{:pres:gerti:gestao_de_ativos:siap_2:validacaofinaleocorrenciasaba2.png?nolink&1747x868}}
 +
 +===== Vídeo demonstrativo =====
  
  
  • pres/gerti/gestao_de_ativos/siap_2/validacao_final_ocorrencia.1792769949.txt.gz
  • Última modificação: 23/10/2026 15:39
  • por jsdias