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 19:39] – jsdiaspres:gerti:gestao_de_ativos:siap_2:validacao_final_ocorrencia [23/10/2026 20:37] (atual) – jsdias
Linha 312: Linha 312:
  
 recupera o nome do usuário para 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.1792784364.txt.gz
  • Última modificação: 23/10/2026 19:39
  • por jsdias