Visão Geral dos processos WebSevices de
...
Notas de Avaliação
O objetivo deste DataServer é possibilitar a busca, inclusão e alteração de notas de avaliação através de WebService. Tudo o que for realizado, poderá ser visualizado no menu de notas e faltas de avaliação no TOTVS Gestão Educacional.
...
Caso o usuário informado na autenticação, não possua permissão ao menu, o processo não poderá ser executado.
O caminho da permissão, para que o usuário realize o processo, é: Matrícula e Avaliação | Mais | Digitação por Aluno | Notas de Avaliação ou Matrícula e Avaliação | Notas de Avaliação.
Método ReadRecord
Este método realiza a consulta de uma nota de avaliação. Algumas informações são obrigatórias e devem ser informadas: o código da coligada, código da etapa, código da avaliação, tipo da etapa, id da turma disciplina e registro acadêmico do aluno.
...
Bloco de código |
---|
language | xml |
---|
title | Exemplo de XML para consulta de uma nota de etapaavaliação |
---|
collapse | true |
---|
|
<tot:ReadRecord>
<!--Optional:-->
<tot:DataServerName>EduAlunoProvaData</tot:DataServerName>
<!--Optional:-->
<tot:PrimaryKey>1;1;1;N;4390;MFA2018</tot:PrimaryKey>
<!--Optional:-->
<tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODTIPOCURSO=1</tot:Contexto>
</tot:ReadRecord>
|
Bloco de código |
---|
language | xml |
---|
title | Exemplo do retorno de consulta da nota de etapaavaliação |
---|
collapse | true |
---|
|
<ReadRecordResult><![CDATA[<EduNotas>
<SNotas>
<CODCOLIGADA>1</CODCOLIGADA>
<CODPROVA>1</CODPROVA>
<CODETAPA>1</CODETAPA>
<TIPOETAPA>N</TIPOETAPA>
<IDTURMADISC>4390</IDTURMADISC>
<RA>MFA2018</RA>
<NOTA>50</NOTA>
<NUMACERTOS>0</NUMACERTOS>
<NUMDIARIO>2</NUMDIARIO>
<MEDIA>70</MEDIA>
<VALOR>100</VALOR>
<DESCPROVA>Avaliação</DESCPROVA>
<DISPONIVELALUNOS>N</DISPONIVELALUNOS>
<NOME>Márcia Francisca Alves</NOME>
<NOMECIVIL>Márcia Francisca Alves</NOMECIVIL>
<RANOTAS>MFA2018</RANOTAS>
<NOTAETAPA>80</NOTAETAPA>
<IDGRUPONOTAS>0</IDGRUPONOTAS>
<NOTASFALTASWEB>S</NOTASFALTASWEB>
<DIBLOQNOTAFALTA>N</DIBLOQNOTAFALTA>
<DESCRICAO>Matriculado</DESCRICAO>
<MEDIAETAPA>70</MEDIAETAPA>
<DTINICIODIGITACAO>2018-01-01T00:00:00</DTINICIODIGITACAO>
<DTLIMITEDIGITACAO>2018-12-31T00:00:00</DTLIMITEDIGITACAO>
<DATAATUAL>2018-05-14T13:44:35</DATAATUAL>
<CODPESSOA>45627</CODPESSOA>
<IDHABILITACAOFILIAL>406</IDHABILITACAOFILIAL>
<_x0031__x0020_-_x0020_Notas>80</_x0031__x0020_-_x0020_Notas>
<TotalNotas>80</TotalNotas>
<TotalFaltas>0</TotalFaltas>
</SNotas>
</EduNotas>]]></ReadRecordResult>
|
...
Este método realiza a inclusão ou alteração de uma nota de avaliação. Algumas informações são obrigatórias e devem ser informadas: o código da coligada, o código da prova, o código da etapa, o tipo da etapa, o id turma disciplina e o registro acadêmico, além dos outros campos que estão configurados como obrigatórios no sistema.
...
Bloco de código |
---|
language | xml |
---|
title | Exemplo de XML para inclusão de uma nota de etapaavaliação |
---|
collapse | true |
---|
|
<tot:SaveRecord>
<!--Optional:-->
<tot:DataServerName>EduAlunoProva</tot:DataServerName>
<!--Optional:-->
<tot:XML><![CDATA[<EduNotas>
<SNotas>
<CODCOLIGADA>1</CODCOLIGADA>
<CODPROVA>1</CODPROVA>
<CODETAPA>1</CODETAPA>
<TIPOETAPA>N</TIPOETAPA>
<IDTURMADISC>4390</IDTURMADISC>
<RA>MFA2018</RA>
<NOTA>50</NOTA>
<NUMACERTOS>0</NUMACERTOS>
<NUMDIARIO>2</NUMDIARIO>
<MEDIA>70</MEDIA>
<VALOR>100</VALOR>
<DESCPROVA>Avaliação</DESCPROVA>
<DISPONIVELALUNOS>N</DISPONIVELALUNOS>
<NOME>Márcia Francisca Alves</NOME>
<NOMECIVIL>Márcia Francisca Alves</NOMECIVIL>
<RANOTAS>MFA2018</RANOTAS>
<NOTAETAPA>80</NOTAETAPA>
<IDGRUPONOTAS>0</IDGRUPONOTAS>
<NOTASFALTASWEB>S</NOTASFALTASWEB>
<DIBLOQNOTAFALTA>N</DIBLOQNOTAFALTA>
<DESCRICAO>Matriculado</DESCRICAO>
<MEDIAETAPA>70</MEDIAETAPA>
<DTINICIODIGITACAO>2018-01-01T00:00:00</DTINICIODIGITACAO>
<DTLIMITEDIGITACAO>2018-12-31T00:00:00</DTLIMITEDIGITACAO>
<DATAATUAL>2018-05-14T13:44:35</DATAATUAL>
<CODPESSOA>45627</CODPESSOA>
<IDHABILITACAOFILIAL>406</IDHABILITACAOFILIAL>
<_x0031__x0020_-_x0020_Notas>80</_x0031__x0020_-_x0020_Notas>
<TotalNotas>80</TotalNotas>
<TotalFaltas>0</TotalFaltas>
</SNotas>
</EduNotas>]]></tot:XML>
<!--Optional:-->
<tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODTIPOCURSO=1</tot:Contexto>
</tot:SaveRecord>
|
Bloco de código |
---|
language | xml |
---|
title | Exemplo do retorno da inclusão da nota de etapaavaliação |
---|
collapse | true |
---|
|
<SaveRecordResult>1;1;1;N;4390;MFA2018</SaveRecordResult>
|
...
Bloco de código |
---|
language | xml |
---|
title | Exemplo de XML para alteração de informações da nota de etapaavaliação |
---|
collapse | true |
---|
|
<tot:SaveRecord>
<!--Optional:-->
<tot:DataServerName>EduAlunoProvaData</tot:DataServerName>
<!--Optional:-->
<tot:XML><![CDATA[<EduNotas>
<SNotas>
<CODCOLIGADA>1</CODCOLIGADA>
<CODPROVA>1</CODPROVA>
<CODETAPA>1</CODETAPA>
<TIPOETAPA>N</TIPOETAPA>
<IDTURMADISC>4390</IDTURMADISC>
<RA>MFA2018</RA>
<NOTA>50</NOTA>
<NUMACERTOS>0</NUMACERTOS>
<NUMDIARIO>2</NUMDIARIO>
<MEDIA>70</MEDIA>
<VALOR>100</VALOR>
<DESCPROVA>Avaliação</DESCPROVA>
<DISPONIVELALUNOS>N</DISPONIVELALUNOS>
<NOME>Márcia Francisca Alves</NOME>
<NOMECIVIL>Márcia Francisca Alves</NOMECIVIL>
<RANOTAS>MFA2018</RANOTAS>
<NOTAETAPA>80</NOTAETAPA>
<IDGRUPONOTAS>0</IDGRUPONOTAS>
<NOTASFALTASWEB>S</NOTASFALTASWEB>
<DIBLOQNOTAFALTA>N</DIBLOQNOTAFALTA>
<DESCRICAO>Matriculado</DESCRICAO>
<MEDIAETAPA>70</MEDIAETAPA>
<DTINICIODIGITACAO>2018-01-01T00:00:00</DTINICIODIGITACAO>
<DTLIMITEDIGITACAO>2018-12-31T00:00:00</DTLIMITEDIGITACAO>
<DATAATUAL>2018-05-14T13:44:35</DATAATUAL>
<CODPESSOA>45627</CODPESSOA>
<IDHABILITACAOFILIAL>406</IDHABILITACAOFILIAL>
<_x0031__x0020_-_x0020_Notas>80</_x0031__x0020_-_x0020_Notas>
<TotalNotas>80</TotalNotas>
<TotalFaltas>0</TotalFaltas>
</SNotas>
</EduNotas>]]></tot:XML>
<!--Optional:-->
<tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODTIPOCURSO=1</tot:Contexto>
</tot:SaveRecord>
|
Bloco de código |
---|
language | xml |
---|
title | Exemplo do retorno da alteração do cadastro da nota de etapaavaliação |
---|
collapse | true |
---|
|
<SaveRecordResult>1;1;1;N;4390;MFA2018</SaveRecordResult>
|
...