Predefinição:AcademusCalouros sp: mudanças entre as edições

De Wiki Unioeste NTI
Ir para navegaçãoIr para pesquisar
Criou página com '== Stored Procedure: [BDAcademicoProducao].[dbo].[spClrIngGera] == --- === Parâmetros === * '''Obrigatórios:''' ** @prmPrcSlt_Codigo INT -** Código do Processo Seletivo. (Ex: 20251 - Concurso Vestibular 2025) ** @prmChm_Codigo INT -** Código da Sequência da Chamada do Processo Seletivo. (Ex: 1 - Edital 005 2025 Convocação 1...) ** @prmCrsChm_Codigo INT -** Código do Curso da Chamada (SGPS). (Ex: 19324 - Ciências da Computação/Integral) ** @prmInscrClr_Codigo...'
 
Linha 1: Linha 1:
== Stored Procedure: [BDAcademicoProducao].[dbo].[spClrIngGera] ==
== Stored Procedure: [BDAcademicoProducao].[dbo].[spClrIngGera] ==


---
Realiza a matrícula do calouro no curso selecionado. O estudante é então vinculado e seu status atual é definido como cursando. As informações cadastrais são inseridas e a matrícula é associada as disciplinas da grade curricular vigente.
 
=== Tabelas a serem gravadas/modificadas ===
 
ClrMatricula, AcdMatricula, AcdSituacao, AcdStcAtual, AcdDdsVestibular, Academico, Rlc_PssFisca_Vinculo, AcdCurso


=== Parâmetros ===
=== Parâmetros ===
* '''Obrigatórios:'''
* '''Obrigatórios:'''
** @prmPrcSlt_Codigo INT -** Código do Processo Seletivo. (Ex: 20251 - Concurso Vestibular 2025)
** @prmPrcSlt_Codigo INT - Código do Processo Seletivo. (Ex: ''20251'' - Concurso Vestibular 2025)
** @prmChm_Codigo INT -** Código da Sequência da Chamada do Processo Seletivo. (Ex: 1 - Edital 005 2025 Convocação 1...)
** @prmChm_Codigo INT - Código da Sequência da Chamada do Processo Seletivo. (Ex: ''1'' - Edital 005 2025 Convocação 1...)
** @prmCrsChm_Codigo INT -** Código do Curso da Chamada (SGPS). (Ex: 19324 - Ciências da Computação/Integral)
** @prmCrsChm_Codigo INT - Código do Curso da Chamada (SGPS). (Ex: ''19324'' - Ciências da Computação/Integral)
** @prmInscrClr_Codigo VARCHAR(100) -** Número de inscrição do calouro no vestibular. (Ex: 364322)
** @prmInscrClr_Codigo VARCHAR(100) - Número de inscrição do calouro no vestibular. (Ex: ''364322'')
** @prmPrdLtv_Ingresso INT -** Código do Período Letivo da Matrícula. (Ex: 20251)
** @prmPrdLtv_Ingresso INT - Código do Período Letivo da Matrícula. (Ex: ''20251'')
** @prmTblGrlItm_Codigo VARCHAR(20) -** Forma de Ingresso do Calouro. (Ex: AprPrn, Dpl, ENEM)
** @prmTblGrlItm_Codigo VARCHAR(20) - Forma de Ingresso do Calouro. (Ex: ''AprPrn, Dpl, ENEM'')
** @prmClrMtrPssFsc_IncCodigo INT -** Código da pessoa física que está realizando a inclusão.
** @prmClrMtrPssFsc_IncCodigo INT - Código da pessoa física que está realizando a inclusão.


* '''Opcional:'''
* '''Opcional:'''
** @prmDtMatricula DATE -** Data da realização da matrícula. Se não for informada, a função `GETDATE()` do banco de dados é utilizada.
** @prmDtMatricula DATE - Data da realização da matrícula. Se não for informada, a função ''GETDATE()'' do banco de dados é utilizada.
 
---


=== Dependências ===
=== Dependências ===
* [BDAcademicoProducao].[dbo].[fnClrIngVrfExiste] - Utilizada para verificar se um registro de ingresso já existe.
* [BDAcademicoProducao].[dbo].[fnClrIngVrfExiste] - Utilizada para verificar se um registro de ingresso já existe.


---
=== Requisitos ===
 
=== Fluxo do Processo e Lógica de Negócio ===
1. É verificado se o calouro está inscrito no processo seletivo informado.
* Se encontrado segue com a execução.
* Se não encontrada a inscrição, será retornado resposta de `ERRO` e a Store Procedure para execução.
 
2. É verificado se existe o código do curso externo equivalente cadastrado no [Cadastro de Cursos].
* Se encontrado segue com a execução.
* se não localizado, será retornado resposta de ERRO e a Store Procedure para execução.


3. Em seguida, ela verifica a tabela `ClrMatricula` para ver se um status confirmado já existe para o calouro.
* O calouro deve estar inscrito no Processo Seletivo informado pelo parâmetro @prmPrcSlt_Codigo;
* Se um status confirmado for '''encontrado''', ele é atualizado.
* O [Código de Curso Externo Equivalente] deve estar vinculado ao curso pelo [Cadastro de Cursos] no Academus;
* Se um status confirmado '''não for encontrado''', é realizada uma nova inserção.
* O curso informado pelo parâmetro @prmCrsChm_Codigo deve ter sua [Grade Curricular] cadastrada;
* O calouro deve deve estar no cadastro de Pessoa Física, item validado pelo CPF;
* O calouro deve ter seu endereço cadastrado;
* Para cursos EAD, devem ser informado o [Polo Equivalente];


4. A procedure verifica se um registro para o processo de ingresso já existe para o estudante.
=== Divergências ===
* Se um registro '''existir''', ela atualiza o status do estudante para '**CURSANDO**' e reativa quaisquer matrículas canceladas.
Essas mensagens não interrompem a execução da Stored Procedure, mas servem como avisos informativos para alertar sobre a necessidade de ajustes em dados divergentes, como:
* Se o estudante já tiver um registro e o status não for nulo e for diferente de '**CURSANDO**', um novo status 'cursando' é adicionado, e o seu status atual é atualizado para '**CURSANDO**'.
* Divergência entre o nome do calouro do Processo seletivo (Sistema SGPS) e o [Cadastro de Pessoa Física];
* Divergência entre o nome da Mãe do Processo seletivo (Sistema SGPS) e o [Cadastro de Pessoa Física];
* Município de procedência não cadastrado para o calouro;


=== Retorno ===
=== Retorno ===
Linha 49: Linha 48:
* '''PrdLtv_Grupo'''
* '''PrdLtv_Grupo'''
* '''Crs_Codigo'''
* '''Crs_Codigo'''
* '''Observacoes''' - Uma descrição detalhada do evento ou da divergência.
* '''Observacoes'''

Edição das 15h03min de 28 de agosto de 2025

Stored Procedure: [BDAcademicoProducao].[dbo].[spClrIngGera]

Realiza a matrícula do calouro no curso selecionado. O estudante é então vinculado e seu status atual é definido como cursando. As informações cadastrais são inseridas e a matrícula é associada as disciplinas da grade curricular vigente.

Tabelas a serem gravadas/modificadas

ClrMatricula, AcdMatricula, AcdSituacao, AcdStcAtual, AcdDdsVestibular, Academico, Rlc_PssFisca_Vinculo, AcdCurso

Parâmetros

  • Obrigatórios:
    • @prmPrcSlt_Codigo INT - Código do Processo Seletivo. (Ex: 20251 - Concurso Vestibular 2025)
    • @prmChm_Codigo INT - Código da Sequência da Chamada do Processo Seletivo. (Ex: 1 - Edital 005 2025 Convocação 1...)
    • @prmCrsChm_Codigo INT - Código do Curso da Chamada (SGPS). (Ex: 19324 - Ciências da Computação/Integral)
    • @prmInscrClr_Codigo VARCHAR(100) - Número de inscrição do calouro no vestibular. (Ex: 364322)
    • @prmPrdLtv_Ingresso INT - Código do Período Letivo da Matrícula. (Ex: 20251)
    • @prmTblGrlItm_Codigo VARCHAR(20) - Forma de Ingresso do Calouro. (Ex: AprPrn, Dpl, ENEM)
    • @prmClrMtrPssFsc_IncCodigo INT - Código da pessoa física que está realizando a inclusão.
  • Opcional:
    • @prmDtMatricula DATE - Data da realização da matrícula. Se não for informada, a função GETDATE() do banco de dados é utilizada.

Dependências

  • [BDAcademicoProducao].[dbo].[fnClrIngVrfExiste] - Utilizada para verificar se um registro de ingresso já existe.

Requisitos

  • O calouro deve estar inscrito no Processo Seletivo informado pelo parâmetro @prmPrcSlt_Codigo;
  • O [Código de Curso Externo Equivalente] deve estar vinculado ao curso pelo [Cadastro de Cursos] no Academus;
  • O curso informado pelo parâmetro @prmCrsChm_Codigo deve ter sua [Grade Curricular] cadastrada;
  • O calouro deve deve estar no cadastro de Pessoa Física, item validado pelo CPF;
  • O calouro deve ter seu endereço cadastrado;
  • Para cursos EAD, devem ser informado o [Polo Equivalente];

Divergências

Essas mensagens não interrompem a execução da Stored Procedure, mas servem como avisos informativos para alertar sobre a necessidade de ajustes em dados divergentes, como:

  • Divergência entre o nome do calouro do Processo seletivo (Sistema SGPS) e o [Cadastro de Pessoa Física];
  • Divergência entre o nome da Mãe do Processo seletivo (Sistema SGPS) e o [Cadastro de Pessoa Física];
  • Município de procedência não cadastrado para o calouro;

Retorno

Esta procedure não retorna um conjunto de resultados, mas popula a tabela temporária #Relatorio com registros sobre a sua execução, incluindo mensagens de log e divergências.

  • Tp_Registro - O tipo de registro. Possíveis valores: 'ERRO', 'INFO', 'DIVERGÊNCIA'.
  • Sst_Sgps
  • Sst_Academus
  • Vst_Codigo
  • PrdLtv_Grupo
  • Crs_Codigo
  • Observacoes