Gravação de nota de avaliação parcial

Este tópico lista as características do WebService Json de gravação das notas de alunos em uma determinada avaliação.
Este método deverá ser chamado para gravar as notas de alunos para uma determinada avaliação.
Em caso de algum erro ocorrer, no retorno (detalhe) é enviada uma lista com os alunos inconsistentes. Em alguns casos, não é necessário interromper o processo de gravação de notas, retornando os alunos inconsistentes somente para notificação, porém, deve-se analisar a tabela de retornos pra verificar se as notas foram gravadas ou não.

Nome do método: gravaNotaAvaliacaoParcialParaAlunos

Parâmetros para chamada do WebService

Atributos retornados do WebService para o chamador

Possíveis retornos para o chamador do WebService

Exemplo de chamada do WebService

URL: http://IP:PORTA/APLICACAO/rest/ICorujaACA/gravaNotaAvaliacaoParcialParaAlunos

Atenção: No cabeçalho da requisição http deverá ser enviado o parâmetro token. Esse parâmetro deverá conter a chave de token cadastrada no MentorWeb. Hoje esta chave já é utilizada.

Exemplo da passagem de parâmetros por Json:

{
    "tipoIntegracao":"LMS",
    "idAvaliacao":54133,
    "codigoIntegracaoAvaliacao":"",
    "listAlunoNota":[
        {
            "idAluno":null,
            "codigoIntegracaoAluno":"230",
            "nota":"7.7"
        },
        {
            "idAluno":11868,
            "codigoIntegracaoAluno":"",
            "nota":"IMP"
        },
        {
            "idAluno":94667,
            "codigoIntegracaoAluno":"",
            "nota":"10"
        },
        {
            "idAluno":87558,
            "codigoIntegracaoAluno":"",
            "nota":"9"
        },
        {
            "idAluno":94597,
            "codigoIntegracaoAluno":"",
            "nota":"8"
        }
    ]
}

Exemplo do retorno do WebService Json:

{
    "codigoRetornoIntegracao":"ICA_00000",
    "descricaoRetornoIntegracao":"Sucesso.",
    "observacaoRetornoIntegracao":null,
    "idAvaliacao":54133,
    "codigoIntegracaoAvaliacao":"123",
    "listAlunoNotaComInconsistencia":null
}

Quando o valor do atributo codigoRetornoIntegracao é diferente de ICA_00000 e ICA_00800, significa que ocorreu algum erro no WebService e não foi possível realizar a gravação das notas.
Para identificar melhor o erro, deve-se analisar a lista de alunos inconsistentes retornadas no atributo listAlunoNotaComInconsistencia que conterá todos os alunos que estão inconsistentes. Deve-se consultar o código retornado no atributo descrito acima na documentação, e ainda observar os atributos descricaoRetornoIntegracao e observacaoRetornoIntegracao que conterão maiores detalhes sobre o ocorrido.
O código de retorno ICA_00800 indica que o registro atual não foi gravado, porém, não interferiu no processo e os demais registros foram gravados com sucesso. Segue abaixo um exemplo de erro retornado, onde uma das notas foi informada com valor inválido, interrompendo todo o processo:

{
    "codigoRetornoIntegracao":"ICA_00407",
    "descricaoRetornoIntegracao":"Nota inválida",
    "observacaoRetornoIntegracao":"Foi informada alguma nota inválida, e o processo foi interrompido. Nenhuma nota foi gravada, por favor, analise o retorno dos detalhes pra verificar quais as notas que estão incorretas, e realize a correção.",
    "idAvaliacao":54133,
    "codigoIntegracaoAvaliacao":"123",
    "listAlunoNotaComInconsistencia":[
        {
            "codigoRetornoIntegracao":"ICA_00407",
            "descricaoRetornoIntegracao":"Nota inválida",
            "observacaoRetornoIntegracao":"Nota não informada ou não está no formato numérico. Se é utilizada a digitação por conceito, não foi encontrado a nota respectiva ao conceito informado.",
            "idAluno":null,
            "codigoIntegracaoAluno":"230",
            "nota":"vinte"
        }
    ]
}

Exemplo de chamada do WebService na linguagem PHP

<?php
 
$curl = curl_init();
 
curl_setopt_array($curl, array(
    CURLOPT_PORT => "8080",
    CURLOPT_URL => "http://localhost:8080/ICoruja/rest/ICorujaACA/gravaNotaAvaliacaoParcialParaAlunos",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => '{"tipoIntegracao":"LMS","idAvaliacao":54133,"codigoIntegracaoAvaliacao":"","listAlunoNota":[{"idAluno":null,"codigoIntegracaoAluno":"230","nota":"7.7"},{"idAluno":11868,"codigoIntegracaoAluno":"","nota":"IMP"},{"idAluno":94667,"codigoIntegracaoAluno":"","nota":"10"},{"idAluno":87558,"codigoIntegracaoAluno":"","nota":"9"},{"idAluno":94597,"codigoIntegracaoAluno":"","nota":"8"}]}',
    CURLOPT_HTTPHEADER => array(
        "cache-control: no-cache",
        "content-type: application/json",
        "postman-token: 74e6008c-0675-fb7c-87d0-23adcbeddd9a",
        "token: 49gcd881cr2158g971849z1faze755x7"
    )
));
 
$response = curl_exec($curl);
$err      = curl_error($curl);
 
curl_close($curl);
 
if ($err) {
    echo "cURL Error #:" . $err;
} else {
    echo $response;
}
 
?>

Caso ocorra um erro parecido com o erro abaixo, a requisição não chegou até o método que realiza a gravação das notas das avaliações, muito provavelmente por conta de ter sido passado um parâmetro inválido, ou seja, geralmente uma String onde esperava-se um Inteiro.

{"central":false,"causaRaiz":{"causaRaizMsg":"RESTEASY003320: Failed processing arguments of
 org.jboss.resteasy.spi.metadata.ResourceMethod@3341b456","causaRaizStackTrace".........}

Ainda há dúvidas? Se você preferir retire suas dúvidas com o nosso suporte, clique aqui e abra um chamado para atendimento.

Voltar