Versões comparadas

Chave

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

Visão Geral dos processos WebSevices da Nota/Falta de Etapa

O objetivo deste DataServer é possibilitar a busca, inclusão e alteração de notas/faltas de etapa através de WebService. Tudo o que for realizado, poderá ser visualizado no menu de notas e faltas de etapa no TOTVS Gestão Educacional.

Através do dataserver "EduNotaEtapaData" e por meio dos métodos ReadRecord e SaveRecord, é possível realizar busca, inclusão e manutenção das informações de notas/faltas de etapa no TOTVS Gestão Educacional.

Aviso
Vale lembrar que este dataserver será descontinuado. Para isso pode-se usar o EduAlunoEtapaData.

Se necessário clique aqui para obter ajuda na configuração do Host.

...

Este método realiza a consulta de uma nota de /falta de etapa. Algumas informações são obrigatórias e devem ser informadas: o código da coligada, código da etapa, tipo da etapa, id da turma disciplina e registro acadêmico do aluno.

O sistema irá realizar a consulta da nota/falta de etapa, caso as informações passadas estejam de acordo com alguma nota/falta de etapa já existente no sistema.

Consulta da nota/falta de etapa

Para realizar a consulta de uma nota/falta de etapa, deve ser utilizado a operação de ReadRecord.

...

XML deve conter os campos CODCOLIGADA, CODETAPA, TIPOETAPA, IDTURMADISC e  RA como informações da chave para busca da nota/falta de etapa.

Para realizar a consulta de uma falta, deve-se informar o TIPOETAPA como "F".

Bloco de código
languagexml
titleExemplo de XML para consulta de uma nota/falta de etapa
collapsetrue
		<tot:ReadRecord>
         <!--Optional:-->
         <tot:DataServerName>EduNotaEtapaData</tot:DataServerName>
         <!--Optional:-->
         <tot:PrimaryKey>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/falta de etapa
collapsetrue
<ReadRecordResult><![CDATA[<EduNotaEtapa>
  <SNotaEtapa>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CODETAPA>1</CODETAPA>
    <TIPOETAPA>N</TIPOETAPA>
    <IDTURMADISC>4390</IDTURMADISC>
    <RA>MFA2018</RA>
    <NOTAFALTA>80</NOTAFALTA>
  </SNotaEtapa>
</EduNotaEtapa>]]></ReadRecordResult>

...

Este método realiza a inclusão ou alteração de uma nota/falta de etapa. Algumas informações são obrigatórias e devem ser informadas: o código da coligada, código da etapa, tipo da etapa, id da turma disciplina e registro acadêmico, além dos outros campos que estão configurados como obrigatórios no sistema.

O sistema irá realizar a inclusão de uma nota/falta de etapa, caso as informações passadas não exista na base.

Se houver um registro já existente com as informações informadas na chave, esse será alterado de acordo com os dados passados no arquivo XML.

Inclusão da nota/falta de etapa

Para realizar inclusão de uma nota/falta de etapa, deve ser utilizado a operação de SaveRecord.

Deve ser passado um XML contendo todos os campos que serão cadastrados, como informação, para a nota/falta de etapa.

Se houver um registro já existente com as informações informadas na chave, esse será alterado de acordo com os dados passados.

XML deve conter a tabela SNOTAETAPA com os campos CODCOLIGADA, CODETAPA, TIPOETAPA, IDTURMADISC e  RA como informações da chave para o cadastro da nota/falta de etapa e, também, os campos obrigatórios para seu cadastro.

Para realizar a inclusão de uma falta, deve-se informar o TIPOETAPA como "F".

Bloco de código
languagexml
titleExemplo de XML para inclusão de uma nota/falta de etapa
collapsetrue
<tot:SaveRecord>
         <!--Optional:-->
         <tot:DataServerName>EduNotaEtapaData</tot:DataServerName>
         <!--Optional:-->
         <tot:XML><![CDATA[<EduNotaEtapa>
  <SNotaEtapa>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CODETAPA>1</CODETAPA>
    <TIPOETAPA>N</TIPOETAPA>
    <IDTURMADISC>4390</IDTURMADISC>
    <RA>MFA2018</RA>
    <NOTAFALTA>80</NOTAFALTA>
  </SNotaEtapa>
</EduNotaEtapa>]]></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/falta de etapa
collapsetrue
<SaveRecordResult>1;1;N;4390;MFA2018</SaveRecordResult>

...

Informações

Caso a inclusão seja realizada com sucesso, será mostrado o código da coligada, código da etapa, o tipo da etapa, o id da turma disciplina e o registro acadêmico inserido no item SaveRecordResult.

Alteração da nota/falta de etapa

Para realizar alteração de uma nota/falta de etapa, deve ser utilizado a operação de SaveRecord.

Deve ser passado um XML contendo todos os campos que serão atualizados no cadastro da nota/falta de etapa.

XML deve conter a tabela SNOTAETAPA com os campos CODCOLIGADA, CODETAPA, TIPOETAPA, IDTURMADISC e  RA como informações da chave para o cadastro da nota/falta de etapa e, também, os campos obrigatórios para seu cadastro.

Para realizar a alteração de uma falta, deve-se informar o TIPOETAPA como "F".

Bloco de código
languagexml
titleExemplo de XML para alteração de informações da nota/falta de etapa
collapsetrue
<tot:SaveRecord>
         <!--Optional:-->
         <tot:DataServerName>EduNotaEtapaData</tot:DataServerName>
         <!--Optional:-->
         <tot:XML><![CDATA[<EduNotaEtapa>
  <SNotaEtapa>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CODETAPA>1</CODETAPA>
    <TIPOETAPA>N</TIPOETAPA>
    <IDTURMADISC>4390</IDTURMADISC>
    <RA>MFA2018</RA>
    <NOTAFALTA>70</NOTAFALTA>
  </SNotaEtapa>
</EduNotaEtapa>]]></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/falta de etapa
collapsetrue
<SaveRecordResult>1;8001408</SaveRecordResult>

...