Visão Geral dos processos WebSevices de Professores
O objetivo deste DataServer é possibilitar a busca, inclusão, alteração e exclusão de professores através de WebService. Tudo o que for realizado, poderá ser visualizado no cadastro de professores no TOTVS Gestão Educacional.
Através do dataserver "EduProfessorData" e por meio dos métodos ReadRecord, SaveRecord e DeleteRecord, é possível realizar busca, inclusão, manutenção e exclusão das informações de professores no TOTVS Gestão Educacional.
Se necessário clique aqui para obter ajuda na configuração do Host.
Método ReadRecord
Este método realiza a consulta de um professor. Algumas informações são obrigatórias e devem ser informadas: o código da coligada e o código de professor.
O sistema irá realizar a consulta de professor, caso as informações passadas estejam de acordo com algum professor já existente no sistema.
Consulta de professor
Para realizar a consulta de um professor, deve ser utilizado a operação de ReadRecord.
Deve ser passado um XML contendo todos os campos de chave primária.
Caso a chave informada não retorne registro, o resultado será o nome do DataSet. Caso contrário, a mesma terá suas informações exibidas através de um XML.
O XML deve conter os campos CODCOLIGADA e CODPROF como informações da chave para busca do professor.
<tot:ReadRecord>
<!--Optional:-->
<tot:DataServerName>EduProfessorData</tot:DataServerName>
<!--Optional:-->
<tot:PrimaryKey>1;43</tot:PrimaryKey>
<!--Optional:-->
<tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODTIPOCURSO=3;CODSISTEMA=S;</tot:Contexto>
</tot:ReadRecord>
<ReadRecordResult><![CDATA[<EduProfessor>
<SProfessor>
<CODCOLIGADA>1</CODCOLIGADA>
<CHAPA>003154</CHAPA>
<CODPROF>43</CODPROF>
<CODPESSOA>619</CODPESSOA>
<CODTITULACAO>2</CODTITULACAO>
<CODIGO>619</CODIGO>
<NOME>RODRIGO BRUME</NOME>
<DTNASCIMENTO>1980-03-27T00:00:00</DTNASCIMENTO>
<SEXO>M</SEXO>
<NACIONALIDADE>10</NACIONALIDADE>
<GRAUINSTRUCAO>7</GRAUINSTRUCAO>
<RUA>RUA EUGENIO WOLTER</RUA>
<BAIRRO>COSTA E SILVA</BAIRRO>
<ESTADO>SC</ESTADO>
<CIDADE>Joinville</CIDADE>
<CEP>89217440</CEP>
<CPF>10392880652</CPF>
<IDIMAGEM>3578</IDIMAGEM>
<TELEFONE1>33333333333</TELEFONE1>
<TELEFONE2>33333333333</TELEFONE2>
<CARTIDENTIDADE>23.226.110-6</CARTIDENTIDADE>
<ORGEMISSORIDENT>SSP/SC</ORGEMISSORIDENT>
<DTEMISSAOIDENT>1996-11-22T00:00:00</DTEMISSAOIDENT>
<TITULOELEITOR>325300660167</TITULOELEITOR>
<ZONATITELEITOR>19</ZONATITELEITOR>
<SECAOTITELEITOR>104</SECAOTITELEITOR>
<CARTEIRATRAB>0459838724</CARTEIRATRAB>
<SERIECARTTRAB>0030</SERIECARTTRAB>
<NIT>0</NIT>
<CERTIFRESERV>00000000000</CERTIFRESERV>
<NATURALIDADE>Joinville</NATURALIDADE>
<ESTADONATAL>SC</ESTADONATAL>
<CONJUGEBRASIL>0</CONJUGEBRASIL>
<NATURALIZADO>0</NATURALIZADO>
<FILHOSBRASIL>0</FILHOSBRASIL>
<NROFILHOSBRASIL>0</NROFILHOSBRASIL>
<EMAIL>[email protected]</EMAIL>
<INVESTTREINANT>0</INVESTTREINANT>
<DEFICIENTEFISICO>0</DEFICIENTEFISICO>
<CODUSUARIO>003154</CODUSUARIO>
<CODFILIAL>0</CODFILIAL>
<CODTIPOCURSO>0</CODTIPOCURSO>
<NOMEFUNCAO>Professor Assistente AS1D</NOMEFUNCAO>
<DTTITELEITOR>1998-01-30T00:00:00</DTTITELEITOR>
<DTEXPCML>1998-11-01T00:00:00</DTEXPCML>
<EXPED>16 CSM</EXPED>
<SITMILITAR>Alistado</SITMILITAR>
<DEFICIENTEFALA>0</DEFICIENTEFALA>
<DEFICIENTEVISUAL>0</DEFICIENTEVISUAL>
<DEFICIENTEAUDITIVO>0</DEFICIENTEAUDITIVO>
<DEFICIENTEMENTAL>0</DEFICIENTEMENTAL>
<USERID>61b33186-9463-4b1c-a3bd-3a11747a519e</USERID>
<BRPDH>0</BRPDH>
<FUMANTE>0</FUMANTE>
<AJUSTATAMANHOFOTO>0</AJUSTATAMANHOFOTO>
<DATAAPROVACAOCURR>2013-08-01T00:00:00</DATAAPROVACAOCURR>
<ESTADOROW>0</ESTADOROW>
<ROWVALIDA>0</ROWVALIDA>
<ALUNO>1</ALUNO>
<PROFESSOR>1</PROFESSOR>
<CANDIDATO>0</CANDIDATO>
<USUARIOBIBLIOS>0</USUARIOBIBLIOS>
<FUNCIONARIO>0</FUNCIONARIO>
<EXFUNCIONARIO>0</EXFUNCIONARIO>
<DEFICIENTEINTELECTUAL>0</DEFICIENTEINTELECTUAL>
<FALECIDO>0</FALECIDO>
<FIADOR_SGI>0</FIADOR_SGI>
<CONJUGE_SGI>0</CONJUGE_SGI>
<DEFICIENTEMOBREDUZIDA>0</DEFICIENTEMOBREDUZIDA>
<RECCREATEDBY>mestre</RECCREATEDBY>
<RECCREATEDON>2016-09-19T09:49:07</RECCREATEDON>
<RECMODIFIEDBY>mestre</RECMODIFIEDBY>
<RECMODIFIEDON>2018-03-12T08:28:05</RECMODIFIEDON>
</SProfessor>
<SProfessorCompl>
<CODCOLIGADA>1</CODCOLIGADA>
<CODPROF>43</CODPROF>
</SProfessorCompl>
</EduProfessor>]]></ReadRecordResult>
<ReadRecordResult><EduProfessor /></ReadRecordResult>
Método SaveRecord
Este método realiza a inclusão ou alteração de um professor. Algumas informações são obrigatórias e devem ser informadas: o código da coligada e o código do professor, além dos outros campos que estão configurados como obrigatórios no sistema.
O sistema irá realizar a inclusão de um professor, caso o código informado não exista na base.
Se o código do professor existir na coligada informada, essa terá as informações alteradas de acordo com o que será passado no arquivo XML.
Observação: Caso sejam passadas para o dataserver informações para campos complementares, devem ser utilizados os mesmos códigos obrigatórios para que o sistema consiga entender que se referem ao professor que se deseja alterar.
Inclusão de professor
Para realizar inclusão de um professor, 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 o professor.
Caso o código e professor informado não exista, será incluído um novo professor. Caso contrário, o mesmo terá suas informações atualizadas.
O XML deve conter a tabela SPROFESSOR com os campos CODCOLIGADA e CODPROF como informações da chave para o cadastro de professor e, também, os campos obrigatórios para seu cadastro.
<tot:SaveRecord>
<!--Optional:-->
<tot:DataServerName>EduProfessorData</tot:DataServerName>
<!--Optional:-->
<tot:XML><![CDATA[<EduProfessor>
<SProfessor>
<CODCOLIGADA>1</CODCOLIGADA>
<CHAPA>003154</CHAPA>
<CODPROF>43</CODPROF>
<CODPESSOA>619</CODPESSOA>
<CODTITULACAO>2</CODTITULACAO>
<CODIGO>619</CODIGO>
<NOME>RODRIGO BRUME</NOME>
<DTNASCIMENTO>1980-03-27T00:00:00</DTNASCIMENTO>
<SEXO>M</SEXO>
<NACIONALIDADE>10</NACIONALIDADE>
<GRAUINSTRUCAO>7</GRAUINSTRUCAO>
<RUA>RUA EUGENIO WOLTER</RUA>
<BAIRRO>COSTA E SILVA</BAIRRO>
<ESTADO>SC</ESTADO>
<CIDADE>Joinville</CIDADE>
<CEP>89217440</CEP>
<CPF>10392880652</CPF>
<IDIMAGEM>3578</IDIMAGEM>
<TELEFONE1>33333333333</TELEFONE1>
<TELEFONE2>33333333333</TELEFONE2>
<CARTIDENTIDADE>23.226.110-6</CARTIDENTIDADE>
<ORGEMISSORIDENT>SSP/SC</ORGEMISSORIDENT>
<DTEMISSAOIDENT>1996-11-22T00:00:00</DTEMISSAOIDENT>
<TITULOELEITOR>325300660167</TITULOELEITOR>
<ZONATITELEITOR>19</ZONATITELEITOR>
<SECAOTITELEITOR>104</SECAOTITELEITOR>
<CARTEIRATRAB>0459838724</CARTEIRATRAB>
<SERIECARTTRAB>0030</SERIECARTTRAB>
<NIT>0</NIT>
<CERTIFRESERV>00000000000</CERTIFRESERV>
<NATURALIDADE>Joinville</NATURALIDADE>
<ESTADONATAL>SC</ESTADONATAL>
<CONJUGEBRASIL>0</CONJUGEBRASIL>
<NATURALIZADO>0</NATURALIZADO>
<FILHOSBRASIL>0</FILHOSBRASIL>
<NROFILHOSBRASIL>0</NROFILHOSBRASIL>
<EMAIL>[email protected]</EMAIL>
<INVESTTREINANT>0</INVESTTREINANT>
<DEFICIENTEFISICO>0</DEFICIENTEFISICO>
<CODUSUARIO>003154</CODUSUARIO>
<CODFILIAL>0</CODFILIAL>
<CODTIPOCURSO>0</CODTIPOCURSO>
<NOMEFUNCAO>Professor Assistente AS1D</NOMEFUNCAO>
<DTTITELEITOR>1998-01-30T00:00:00</DTTITELEITOR>
<DTEXPCML>1998-11-01T00:00:00</DTEXPCML>
<EXPED>16 CSM</EXPED>
<SITMILITAR>Alistado</SITMILITAR>
<DEFICIENTEFALA>0</DEFICIENTEFALA>
<DEFICIENTEVISUAL>0</DEFICIENTEVISUAL>
<DEFICIENTEAUDITIVO>0</DEFICIENTEAUDITIVO>
<DEFICIENTEMENTAL>0</DEFICIENTEMENTAL>
<USERID>61b33186-9463-4b1c-a3bd-3a11747a519e</USERID>
<BRPDH>0</BRPDH>
<FUMANTE>0</FUMANTE>
<AJUSTATAMANHOFOTO>0</AJUSTATAMANHOFOTO>
<DATAAPROVACAOCURR>2013-08-01T00:00:00</DATAAPROVACAOCURR>
<ESTADOROW>0</ESTADOROW>
<ROWVALIDA>0</ROWVALIDA>
<ALUNO>1</ALUNO>
<PROFESSOR>1</PROFESSOR>
<CANDIDATO>0</CANDIDATO>
<USUARIOBIBLIOS>0</USUARIOBIBLIOS>
<FUNCIONARIO>0</FUNCIONARIO>
<EXFUNCIONARIO>0</EXFUNCIONARIO>
<DEFICIENTEINTELECTUAL>0</DEFICIENTEINTELECTUAL>
<FALECIDO>0</FALECIDO>
<FIADOR_SGI>0</FIADOR_SGI>
<CONJUGE_SGI>0</CONJUGE_SGI>
<DEFICIENTEMOBREDUZIDA>0</DEFICIENTEMOBREDUZIDA>
<RECCREATEDBY>mestre</RECCREATEDBY>
<RECCREATEDON>2016-09-19T09:49:07</RECCREATEDON>
<RECMODIFIEDBY>mestre</RECMODIFIEDBY>
<RECMODIFIEDON>2018-03-12T08:28:05</RECMODIFIEDON>
</SProfessor>
<SProfessorCompl>
<CODCOLIGADA>1</CODCOLIGADA>
<CODPROF>43</CODPROF>
</SProfessorCompl>
</EduProfessor>]]></tot:XML>
<!--Optional:-->
<tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODTIPOCURSO=3;CODSISTEMA=S;</tot:Contexto>
</tot:SaveRecord>
>
<SaveRecordResult>1;43</SaveRecordResult>
Alteração de professor
Para realizar alteração de um professor, deve ser utilizado a operação de SaveRecord.
Deve ser passado um XML contendo todos os campos que serão atualizados no cadastro de professor.
O XML deve conter a tabela SPROFESSOR com os campos CODCOLIGADA e CODPROF como informações da chave para a atualização do cadastro de professor.
<tot:SaveRecord>
<!--Optional:-->
<tot:DataServerName>EduProfessorData</tot:DataServerName>
<!--Optional:-->
<tot:XML><![CDATA[<EduProfessor>
<SProfessor>
<CODCOLIGADA>1</CODCOLIGADA>
<CHAPA>003154</CHAPA>
<CODPROF>43</CODPROF>
<CODPESSOA>619</CODPESSOA>
<CODTITULACAO>2</CODTITULACAO>
<CODIGO>619</CODIGO>
<NOME>RODRIGO BRUME</NOME>
<DTNASCIMENTO>1980-03-27T00:00:00</DTNASCIMENTO>
<SEXO>M</SEXO>
<NACIONALIDADE>10</NACIONALIDADE>
<GRAUINSTRUCAO>7</GRAUINSTRUCAO>
<RUA>RUA EUGENIO WOLTER</RUA>
<BAIRRO>COSTA E SILVA</BAIRRO>
<ESTADO>SC</ESTADO>
<CIDADE>Joinville</CIDADE>
<CEP>89217440</CEP>
<CPF>10392880652</CPF>
<IDIMAGEM>3578</IDIMAGEM>
<TELEFONE1>33333333333</TELEFONE1>
<TELEFONE2>33333333333</TELEFONE2>
<CARTIDENTIDADE>23.226.110-6</CARTIDENTIDADE>
<ORGEMISSORIDENT>SSP/SC</ORGEMISSORIDENT>
<DTEMISSAOIDENT>1996-11-22T00:00:00</DTEMISSAOIDENT>
<TITULOELEITOR>325300660167</TITULOELEITOR>
<ZONATITELEITOR>19</ZONATITELEITOR>
<SECAOTITELEITOR>104</SECAOTITELEITOR>
<CARTEIRATRAB>0459838724</CARTEIRATRAB>
<SERIECARTTRAB>0030</SERIECARTTRAB>
<NIT>0</NIT>
<CERTIFRESERV>00000000000</CERTIFRESERV>
<NATURALIDADE>Joinville</NATURALIDADE>
<ESTADONATAL>SC</ESTADONATAL>
<CONJUGEBRASIL>0</CONJUGEBRASIL>
<NATURALIZADO>0</NATURALIZADO>
<FILHOSBRASIL>0</FILHOSBRASIL>
<NROFILHOSBRASIL>0</NROFILHOSBRASIL>
<EMAIL></EMAIL>
<INVESTTREINANT>0</INVESTTREINANT>
<DEFICIENTEFISICO>0</DEFICIENTEFISICO>
<CODUSUARIO>003154</CODUSUARIO>
<CODFILIAL>0</CODFILIAL>
<CODTIPOCURSO>0</CODTIPOCURSO>
<NOMEFUNCAO>Professor Assistente AS1D</NOMEFUNCAO>
<DTTITELEITOR>1998-01-30T00:00:00</DTTITELEITOR>
<DTEXPCML>1998-11-01T00:00:00</DTEXPCML>
<EXPED>16 CSM</EXPED>
<SITMILITAR>Alistado</SITMILITAR>
<DEFICIENTEFALA>0</DEFICIENTEFALA>
<DEFICIENTEVISUAL>0</DEFICIENTEVISUAL>
<DEFICIENTEAUDITIVO>0</DEFICIENTEAUDITIVO>
<DEFICIENTEMENTAL>0</DEFICIENTEMENTAL>
<USERID>61b33186-9463-4b1c-a3bd-3a11747a519e</USERID>
<BRPDH>0</BRPDH>
<FUMANTE>0</FUMANTE>
<AJUSTATAMANHOFOTO>0</AJUSTATAMANHOFOTO>
<DATAAPROVACAOCURR>2013-08-01T00:00:00</DATAAPROVACAOCURR>
<ESTADOROW>0</ESTADOROW>
<ROWVALIDA>0</ROWVALIDA>
<ALUNO>1</ALUNO>
<PROFESSOR>1</PROFESSOR>
<CANDIDATO>0</CANDIDATO>
<USUARIOBIBLIOS>0</USUARIOBIBLIOS>
<FUNCIONARIO>0</FUNCIONARIO>
<EXFUNCIONARIO>0</EXFUNCIONARIO>
<DEFICIENTEINTELECTUAL>0</DEFICIENTEINTELECTUAL>
<FALECIDO>0</FALECIDO>
<FIADOR_SGI>0</FIADOR_SGI>
<CONJUGE_SGI>0</CONJUGE_SGI>
<DEFICIENTEMOBREDUZIDA>0</DEFICIENTEMOBREDUZIDA>
<RECCREATEDBY>mestre</RECCREATEDBY>
<RECCREATEDON>2016-09-19T09:49:07</RECCREATEDON>
<RECMODIFIEDBY>mestre</RECMODIFIEDBY>
<RECMODIFIEDON>2018-03-12T08:28:05</RECMODIFIEDON>
</SProfessor>
<SProfessorCompl>
<CODCOLIGADA>1</CODCOLIGADA>
<CODPROF>43</CODPROF>
</SProfessorCompl>
</EduProfessor>]]></tot:XML>
<!--Optional:-->
<tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODTIPOCURSO=3;CODSISTEMA=S;</tot:Contexto>
</tot:SaveRecord>
<SaveRecordResult>1;43</SaveRecordResult>
Método DeleteRecord
Este método realiza a exclusão de um professor. Algumas informações são obrigatórias e devem ser informadas: o código da coligada e o código do professor, além dos outros campos que estão configurados como obrigatórios no sistema.
O sistema irá realizar a exclusão de um professor caso encontre o registro.
Exclusão de professor
Para realizar exclusão de um professor, deve ser utilizado a operação de DeleteRecord.
Deve ser passado um XML contendo todos os campos que fazem parte do registro de professor.
O XML deve conter a tabela SPROFESSOR com os campos CODCOLIGADA e CODPROF como informações da chave para o cadastro de professor e, também, os campos obrigatórios para seu cadastro.
<tot:DeleteRecord>
<!--Optional:-->
<tot:DataServerName>EduProfessorData</tot:DataServerName>
<!--Optional:-->
<tot:XML><![CDATA[<EduProfessor>
<SProfessor>
<CODCOLIGADA>1</CODCOLIGADA>
<CHAPA>003154</CHAPA>
<CODPROF>43</CODPROF>
<CODPESSOA>619</CODPESSOA>
<CODTITULACAO>2</CODTITULACAO>
<CODIGO>619</CODIGO>
<NOME>RODRIGO BRUME</NOME>
<DTNASCIMENTO>1980-03-27T00:00:00</DTNASCIMENTO>
<SEXO>M</SEXO>
<NACIONALIDADE>10</NACIONALIDADE>
<GRAUINSTRUCAO>7</GRAUINSTRUCAO>
<RUA>RUA EUGENIO WOLTER</RUA>
<BAIRRO>COSTA E SILVA</BAIRRO>
<ESTADO>SC</ESTADO>
<CIDADE>Joinville</CIDADE>
<CEP>89217440</CEP>
<CPF>10392880652</CPF>
<IDIMAGEM>3578</IDIMAGEM>
<TELEFONE1>33333333333</TELEFONE1>
<TELEFONE2>33333333333</TELEFONE2>
<CARTIDENTIDADE>23.226.110-6</CARTIDENTIDADE>
<ORGEMISSORIDENT>SSP/SC</ORGEMISSORIDENT>
<DTEMISSAOIDENT>1996-11-22T00:00:00</DTEMISSAOIDENT>
<TITULOELEITOR>325300660167</TITULOELEITOR>
<ZONATITELEITOR>19</ZONATITELEITOR>
<SECAOTITELEITOR>104</SECAOTITELEITOR>
<CARTEIRATRAB>0459838724</CARTEIRATRAB>
<SERIECARTTRAB>0030</SERIECARTTRAB>
<NIT>0</NIT>
<CERTIFRESERV>00000000000</CERTIFRESERV>
<NATURALIDADE>Joinville</NATURALIDADE>
<ESTADONATAL>SC</ESTADONATAL>
<CONJUGEBRASIL>0</CONJUGEBRASIL>
<NATURALIZADO>0</NATURALIZADO>
<FILHOSBRASIL>0</FILHOSBRASIL>
<NROFILHOSBRASIL>0</NROFILHOSBRASIL>
<EMAIL>[email protected]</EMAIL>
<INVESTTREINANT>0</INVESTTREINANT>
<DEFICIENTEFISICO>0</DEFICIENTEFISICO>
<CODUSUARIO>003154</CODUSUARIO>
<CODFILIAL>0</CODFILIAL>
<CODTIPOCURSO>0</CODTIPOCURSO>
<NOMEFUNCAO>Professor Assistente AS1D</NOMEFUNCAO>
<DTTITELEITOR>1998-01-30T00:00:00</DTTITELEITOR>
<DTEXPCML>1998-11-01T00:00:00</DTEXPCML>
<EXPED>16 CSM</EXPED>
<SITMILITAR>Alistado</SITMILITAR>
<DEFICIENTEFALA>0</DEFICIENTEFALA>
<DEFICIENTEVISUAL>0</DEFICIENTEVISUAL>
<DEFICIENTEAUDITIVO>0</DEFICIENTEAUDITIVO>
<DEFICIENTEMENTAL>0</DEFICIENTEMENTAL>
<USERID>61b33186-9463-4b1c-a3bd-3a11747a519e</USERID>
<BRPDH>0</BRPDH>
<FUMANTE>0</FUMANTE>
<AJUSTATAMANHOFOTO>0</AJUSTATAMANHOFOTO>
<DATAAPROVACAOCURR>2013-08-01T00:00:00</DATAAPROVACAOCURR>
<ESTADOROW>0</ESTADOROW>
<ROWVALIDA>0</ROWVALIDA>
<ALUNO>1</ALUNO>
<PROFESSOR>1</PROFESSOR>
<CANDIDATO>0</CANDIDATO>
<USUARIOBIBLIOS>0</USUARIOBIBLIOS>
<FUNCIONARIO>0</FUNCIONARIO>
<EXFUNCIONARIO>0</EXFUNCIONARIO>
<DEFICIENTEINTELECTUAL>0</DEFICIENTEINTELECTUAL>
<FALECIDO>0</FALECIDO>
<FIADOR_SGI>0</FIADOR_SGI>
<CONJUGE_SGI>0</CONJUGE_SGI>
<DEFICIENTEMOBREDUZIDA>0</DEFICIENTEMOBREDUZIDA>
<RECCREATEDBY>mestre</RECCREATEDBY>
<RECCREATEDON>2016-09-19T09:49:07</RECCREATEDON>
<RECMODIFIEDBY>mestre</RECMODIFIEDBY>
<RECMODIFIEDON>2018-03-12T08:28:05</RECMODIFIEDON>
</SProfessor>
<SProfessorCompl>
<CODCOLIGADA>1</CODCOLIGADA>
<CODPROF>43</CODPROF>
</SProfessorCompl>
</EduProfessor>]]></tot:XML>
<!--Optional:-->
<tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODTIPOCURSO=3;CODSISTEMA=S;</tot:Contexto>
</tot:DeleteRecord>
<DeleteRecordResult>Exclusão de registro(s) realizado com sucesso</DeleteRecordResult>