Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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.

...

Expandir
titleÍndice

Índice
minLevel2

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
languagexml
titleExemplo de XML para consulta de uma nota de etapaavaliação
collapsetrue
	<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
languagexml
titleExemplo do retorno de consulta da nota de etapaavaliação
collapsetrue
<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
languagexml
titleExemplo de XML para inclusão de uma nota de etapaavaliação
collapsetrue
<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
languagexml
titleExemplo do retorno da inclusão da nota de etapaavaliação
collapsetrue
<SaveRecordResult>1;1;1;N;4390;MFA2018</SaveRecordResult>

...

Bloco de código
languagexml
titleExemplo de XML para alteração de informações da nota de etapaavaliação
collapsetrue
<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
languagexml
titleExemplo do retorno da alteração do cadastro da nota de etapaavaliação
collapsetrue
<SaveRecordResult>1;1;1;N;4390;MFA2018</SaveRecordResult>

...