Serviço externo padrão MentorWeb - Recalcula médias parciais

Serviço externo do Mentor que realiza o recalculo de médias parciais.
Para saber mais sobre serviços externos .

Nome do serviço externo: recalculaMedia

Para saber como montar a URL de chamada para esse serviço externo, acesse a página referente à execução de serviços externos clicando aqui.

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

Parâmetro	Descrição	Obrigatório	Tipo	Observação
periodoLetivoId	Identificador do período letivo	Condicional	Integer	Obrigatório quando não informado o parametro turmaId ou turdisId. Se informado o período letivo, deve ser informado junto o cursoId
cursoId	Identificador do curso	Condicional	Integer	Obrigatório quando não informado o parametro turmaId ou turdisId. Se informado o curso, deve ser informado junto o periodoLetivoId
turmaId	Identificador da turma	Não	Integer
turdisId	Identificador da turma/disciplina	Não	Integer
avaliacaoId	Identificador da avaliação do critério de avaliação	Não	Integer

Obs.: Um dos parâmetros deve ser informado: turmaId ou turdisId ou periodoLetivoId + cursoId;

2. Exemplo de chamada do Serviço

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

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

{
  "periodoLetivoId": null,
  "cursoId":null,
  "turmaId": null,
  "turdisId" : 667691,
  "avaliacaoId": null
}

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": "Total de turmas/disciplinas/avaliações lidas: 1. Calculadas com sucesso: 1.",
    "resultado": "SUCESSO"
}

Exemplo de Erro - (neste caso, status diferente de 200):

{
    "resultado": "ERRO",
    "erro": {
        "operacao": "br.com.edusoft.mentorweb.servico.controller.ServicoExternoAcademicoImplJava.recalculaMedia",
        "valores": "{\r\n  \"periodoLetivoId\": null,\r\n  \"cursoId\":null,\r\n  \"turmaId\": null,\r\n  \"turdisId\" : 667691,\r\n  \"avaliacaoId\": null\r\n}",
        "motivo": "EduClientLogProcessoException: Nenhuma turma/disciplina/avaliação encontrada para recalcular médias."
    }
}