Serviço externo padrão MentorWeb - Gravação da média final
Serviço externo do Mentor que registra a média final do aluno no período, calculando a média final.
Para saber mais sobre serviços externos clique aqui.
Este serviço receberá um código de turma/disciplina, código do aluno e nota:
1. Ao receber a turma/disciplina, o sistema irá buscar no critério de avaliação dessa turma/disciplina a avaliação de menor ordem que não seja nota calculada;
1. O sistema gravará a nota como média da avaliação encontrada no passo anterior;
2. O sistema calculará a média final para esse aluno e turma/disciplina e atualizar a situação de resultado.
Obs.: Para calcular a média o diário desta turma/disciplina/tipo de nota precisa estar fechado.
Nome do serviço externo: integracaoMediaEAD
Para ver como montar a URL de chamada para esse serviço externo, acesse a página referente à execução de serviços externos clicando aqui.
Parâmetros para chamada do serviço
Parâmetro | Descrição | Obrigatório | Tipo | Observação |
---|---|---|---|---|
aluno | Código de integração do aluno (pessoa física) | Sim | String | Informar o código de integração do aluno. |
disciplinas | Lista de turma/disciplinas | Sim | Lista | Informar as turma/disciplinas do aluno. Nesta versão é possível apenas uma disciplina por vez. |
idTurmaDisciplina | Código de integração da turma/disciplina (Lista: disciplinas) | Sim | String | Informar o código de integração da turma/disciplina. |
nota | Nota a ser gravada (Lista: disciplinas) | Sim | Decimal | Informar a nota que deverá ser gravada na média da avaliação do aluno. Obs.: considerar um ponto (“.”) como separador decimal. |
Exemplo da passagem de parâmetros por Json:
{ "aluno" : "123456", "disciplinas" : [ { "idTurmaDisciplina" : "123456", "nota" : 1.0 } ] }
Exemplo do retorno do serviço em formato Json:
{ "resultado":"SUCESSO", "log": [ "Mensagem de aviso (opcional)" ] }
Neste caso não houve erro, porém o processo não atendeu umas das validações internas, que é o caso de obrigar todos os diários estarem fechados no momento de realizar o cálculo de média.
Exemplo do retorno do serviço em formato Json caso ocorra erro no processo:
"resultado":"ERRO", "erro": { "operacao":"br.com.edusoft.mentorweb.servico.controller.ServicoExternoAcademicoImplJava.calculaMedia", "valores":"{\"parametro1\":29572 , \"alunoId\":4041475 , \"disciplinaId\":2420 , \"recalculaMediasAlteradasManualmente\":0}", "motivo":"Mensagem de erro" } }