Diferenças

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

--- pres:gerti:gestao_de_ativos:siap_2:validacao_final_ocorrencia [23/10/2026 19:37] – jsdias
+++ pres:gerti:gestao_de_ativos:siap_2:validacao_final_ocorrencia [23/10/2026 20:37] (atual) – jsdias
@@ Linha 188: / Linha 188: @@
 A integração Busca todas variáveis do fluxo possui retorno:‌
-<blockquote>
 value = array
 name = todasVariaveis
-</blockquote>
 Na etapa 2, buscaVariaveisFluxo_e_enviarDados() percorre a coleção utilizando:
-<blockquote>
 model.todasVariaveis[r].name
 model.todasVariaveis[r].value
-</blockquote>
 para tratar as variáveis recuperadas durante a conclusão.
@@ Linha 280: / Linha 272: @@
 A segunda etapa possui a função:
-<blockquote>
 buscaVariaveisFluxo_e_enviarDados()
-</blockquote>
 Ela verifica a quantidade de registros em:
-<blockquote>
 model.todasVariaveis.length
-</blockquote>
 e percorre cada item através de:
-<blockquote>
 model.todasVariaveis[r].name
 model.todasVariaveis[r].value
-</blockquote>
 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.
@@ Linha 328: / Linha 308: @@
 O mapeamento explícito:
-<blockquote>
 nmUsuario → nomeRespAssApostila
-</blockquote>
 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 =====