Cadastro de avaliação parcial

Este tópico lista as características do WebService Json de cadastro de avaliação parcial. Este método deverá ser chamado para realizar o cadastro de avaliações parciais em um determinado tipo de nota da turma/disciplina.

Nome do método: cadastraAvaliacaoParcial(…)

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/cadastraAvaliacaoParcial

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:

{
    "codigoUnidade":9,
    "idTurmaDisciplina":null,
    "codigoIntegracaoTdi":"250",
    "idTipoNota":42,
    "idAvaliacao":null,
    "codigoIntegracaoAvaliacao":1,
    "descricao":"Prova de Álgebra",
    "sigla":"PA1",
    "conteudo":"Álgebra Básica",
    "obrigatorioParaCalculo":1,
    "data":"08/07/2017"
}

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/cadastraAvaliacaoParcial",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => '{"codigoUnidade":9,"idTurmaDisciplina":null,"codigoIntegracaoTurmaDisciplina":"250","idTipoNota":42,"idAvaliacao":null, "codigoIntegracaoAvaliacao":1,"descricao":"Prova de Álgebra","sigla":"PA1","conteudo":"Álgebra Básica","obrigatorioParaCalculo":1,"data":"08/07/2017"}',
    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;
}
 
?> 

Exemplo do retorno do WebService Json:

{
  "codigoRetornoIntegracao": "ICA_00000",
  "descricaoRetornoIntegracao": "Sucesso.",
  "observacaoRetornoIntegracao": null,
  "idAvaliacao":3450
}

Quando o valor do atributo codigoRetornoIntegracao é diferente de ICA_00000, significa que ocorreu algum erro no WebService e não foi possível montar o retorno completo.
Para identificar melhor o erro, pode-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.
Segue abaixo um exemplo de erro retornado:

{
  "codigoRetornoIntegracao": "ICA_00400",
  "descricaoRetornoIntegracao": "Parâmetros inválidos",
  "observacaoRetornoIntegracao": "É obrigatório informar o código de integração da avaliação.",
  "idAvaliacao":null
}

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

Voltar