Serviço externo padrão MentorWeb - Realiza validação de disciplina

Serviço externo do Mentor que realiza a validação de disciplina.
Atenção: O comportamento da rotina é o mesmo comportamento da rotina que defere um requerimento de validação de disciplina, porém, recebendo mais parâmetros.

Nome do serviço externo: realizaValidacaoDisciplina

1. Parâmetros para chamada do serviço externo

Parâmetro	Descrição	Obrigatório	Tipo	Observação
ingressoId	Identificador do ingresso do aluno	Sim	Integer
disciplinaGradeId	Identificador da disciplina/grade que será validada	Sim	Integer
tipoValidacao	Tipo de validação	Não	String(10)	Valores aceitos:TRAEXT (Transferência externa) , TRAINT (Transferência interna), EXASUF (Exame de suficiência), APREST (Aproveitamento de estudos), MIGGRADE (migração de grade).
ValidacaoPeriodoLetivoId	Id do período letivo que a validação foi realizada.	Não	Integer	Id do período letivo que a validação foi realizada.
listValidacaoDisciplina	Lista das disciplinas cursadas (contendo os atributos abaixo)	Sim	Lista
instituicaoEnsinoId	Identificador da pessoa jurídica onde foi cursada a disciplina	Sim	Integer
disciplinaCursadaDescri	Nome da disciplina cursada	Sim	String(100)
semestre	Semestre	Sim	String(20)
cargaHorariaCursada	Carga horária cursada	Sim	Integer
disciplinaExterna	A disciplina é externa?	Sim	Integer	0 = Sim	1 = Não
media	Média obtida na disciplina	Sim	String(10)
frequencia	Frequencia	Sim	String(10)

nomeProfessor	Nome do Professor	Sim	String(255)
tipoTitulacaoDocente	Tipo da titulação do docente	Sim	String(50)

Token Deve-se passar no cabeçalho da requisição o parâmetro token. O valor deste parâmetro é gerado pelo serviço de geração de token.

2. Exemplo de chamada do Serviço

URL: http://IP:PORTA/APLICACAO/rest/servicoexterno/execute/realizaValidacaoDisciplina

2.1. Exemplo da passagem de parâmetros por Json:

{
  "ingressoId" : "195990",
  "disciplinaGradeId" : "63679",
  "tipoValidacao": "TRAEXT",
  "validacaoPeriodoLetivoId": 15,
  "listValidacaoDisciplina" : [
	  {
	   "instituicaoEnsinoId" : "1410484921",
	    "disciplinaCursadaDescri" : "Matemática aplicada",
	    "semestre" : "2010",
	    "cargaHorariaCursada" : 60,
	    "disciplinaExterna" : 0,
	    "media" : "7,00",
	    "frequencia" : "80"
	  }
 
  ]
}

3. Retorno do serviço (Json)

Para obter o retorno do serviço deve-se verificar o status da requisição http. Sempre que o status for 200, significa que o processo foi realizado com sucesso.

Exemplo de retorno Json:

Sucesso - Status code 200:

{
    "valor": "Processo realizado com sucesso!",
    "resultado": "SUCESSO"
}

4. Retorno do serviço (Json)

Exemplo de um retorno quando tentar realizar a validação de uma disciplina já validada:

{
     "resultado": "ERRO",
    "erro": {
        "operacao": "br.com.edusoft.mentorweb.servico.controller.ServicoExternoAcademicoImplJava.realizaValidacaoDIsciplina",
        "valores": "{\r\n  \"ingressoId\" : \"17440580\",\r\n  \"disciplinaGradeId\" : \"2421072\",\r\n  \"tipoValidacao\": null,\r\n  \"validacaoPeriodoLetivoId\": null,\r\n  \"listValidacaoDisciplina\" : [\r\n\t  {\r\n\t   \"instituicaoEnsinoId\" : \"231338\",\r\n\t    \"disciplinaCursadaDescri\" : \"Fundamentos da Administraçãoa\",\r\n\t    \"semestre\" : \"2024/1\",\r\n\t    \"cargaHorariaCursada\" : 60,\r\n\t    \"disciplinaExterna\" : 0,\r\n\t    \"media\" : \"9,00\",\r\n\t    \"frequencia\" : \"90\"\r\n\t  }\r\n \r\n  ]\r\n}",
        "motivo": "EduClientLogProcessoException: Já possui validação realizada para o ingresso, disciplina e fase informados."
    }
}

5. Retorno do serviço (Json)

Se for validada uma disciplina que o aluno está matriculado, a matrícula na disciplina será cancelada.
Exemplo de uma validação em que o aluno está matriculado na disciplina:

{
    "valor": "Matrpicula na turma/Disciplina\"20241dois / 801PRE - Fundamentos da Administração\" foi cancelada."
    "resultado": "SUCESSO"
}