Visão Geral dos processos WebSevices de Curso

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

Através do DataServer "EduCursoData" 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 Curso 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 Curso. Algumas informações são obrigatórias e devem ser informadas: o código da coligada e o código do Curso.

O sistema irá realizar a consulta de um Curso, caso as informações passadas estejam de acordo com algum curso já existente no sistema.

Consulta do Curso

Para realizar a consulta de um Curso, 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, o mesmo terá suas informações exibidas através de um XML.

O XML deve conter os campos CODCOLIGADA e CODCURSO como informações da chave para busca de Curso.

	<tot:ReadRecord>
         <!--Optional:-->
         <tot:DataServerName>EduCursoData</tot:DataServerName>
         <!--Optional:-->
         <tot:PrimaryKey>1;12-1</tot:PrimaryKey>
         <!--Optional:-->
         <tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODTIPOCURSO=1;CODSISTEMA=S</tot:Contexto>
      </tot:ReadRecord>

<ReadRecordResponse xmlns="http://www.totvs.com/">
         <ReadRecordResult><![CDATA[<EduCurso>
  <SCurso>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CODCURSO>12-1</CODCURSO>
    <NOME>ENGENHARIA DE AUTOMAÇÃO</NOME>
    <CODTIPOCURSO>1</CODTIPOCURSO>
    <CURPRESDIST>P</CURPRESDIST>
  </SCurso>
  <SCURSOCOMPL>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CODCURSO>12-1</CODCURSO>
  </SCURSOCOMPL>
</EduCurso>]]></ReadRecordResult>

<ReadRecordResult>&lt;EduCursoData /></ReadRecordResult>

Método SaveRecord

Este método realiza a inclusão ou alteração de um Curso. Algumas informações são obrigatórias e devem ser informadas: o código da coligada, o código da filial e o codtipocurso, além dos outros campos que estão configurados como obrigatórios no sistema.

O sistema irá realizar a inclusão de um Curso, caso o código informado não exista na base.

Se o código do Curso 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 Curso que se deseja alterar.

Inclusão de Curso

Para realizar inclusão de um Curso, 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 Curso

Caso o código do Curso informado não exista, será incluído um novo Curso. Caso contrário, o mesmo terá suas informações atualizadas.

O XML deve conter a tabela SCURSO com os campos CODCOLIGADA e o CODCURSO como informações da chave para o cadastro de Curso, também os campos obrigatórios para seu cadastro.

		<tot:SaveRecord>
         <!--Optional:-->
         <tot:DataServerName>EduCursoData</tot:DataServerName>
         <!--Optional:-->
         <tot:XML><![CDATA[<EduCurso>
  <SCurso>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CODCURSO>3-12</CODCURSO>
    <NOME>ENGENHARIA_EXCLUIR- Automação</NOME>
    <DECRETO xml:space="preserve"> </DECRETO>
    <DESCRICAO xml:space="preserve"> </DESCRICAO>
    <CODTIPOCURSO>1</CODTIPOCURSO>
  </SCurso>
  <SCURSOCOMPL>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CODCURSO>3-12</CODCURSO>
  </SCURSOCOMPL>
</EduCurso>]]></tot:XML>
         <!--Optional:-->
         <tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODTIPOCURSO=1;CODSISTEMA=S</tot:Contexto>
      </tot:SaveRecord>

<SaveRecordResult>1;3-12</SaveRecordResult>

Alteração de Curso

Para realizar alteração de um Curso, deve ser utilizado a operação de SaveRecord.

Deve ser passado um XML contendo todos os campos que serão atualizados no cadastro de Curso;

O XML deve conter a tabela SCURSO com os campos CODCOLIGADA e CODCURSO como informações da chave para a atualização do cadastro de curso.

<tot:SaveRecord>
         <!--Optional:-->
         <tot:DataServerName>EduCursoData</tot:DataServerName>
         <!--Optional:-->
         <tot:XML><![CDATA[<EduCurso>
  <SCurso>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CODCURSO>3-13</CODCURSO>
    <NOME>ENGENHARIA PRODUÇÃO</NOME>
    <DECRETO xml:space="preserve"> </DECRETO>
    <DESCRICAO xml:space="preserve"> </DESCRICAO>
    <CODTIPOCURSO>1</CODTIPOCURSO>
  </SCurso>
  <SCURSOCOMPL>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CODCURSO>3-13</CODCURSO>
  </SCURSOCOMPL>
</EduCurso>]]></tot:XML>
         <!--Optional:-->
         <tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODTIPOCURSO=1;CODSISTEMA=S</tot:Contexto>
      </tot:SaveRecord>

<SaveRecordResult>1;3-13</SaveRecordResult>

Método DeleteRecord

Este método realiza a exclusão de um Curso. Algumas informações são obrigatórias e devem ser informadas: o código da coligada, o codigo do curso e os outros campos que estão configurados como obrigatórios no sistema.

O sistema irá realizar a exclusão de um Curso caso encontre o registro.

Exclusão de Curso

Para realizar exclusão de um  Curso, deve ser utilizado a operação de DeleteRecord.

Deve ser passado um XML contendo todos os campos que fazem parte do registro de Curso.

O XML deve conter a tabela SCURSO com os campos CODCOLIGADA e CODCURSO como informações da chave para o cadastro de Curso e, também os campos obrigatórios para seu cadastro.

		<tot:DeleteRecord>
         <!--Optional:-->
         <tot:DataServerName>EduCursoData</tot:DataServerName>
         <!--Optional:-->
         <tot:XML><![CDATA[<EduCurso>
  <SCurso>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CODCURSO>3-4</CODCURSO>
    <CODESCOLA>1</CODESCOLA>
    <CODAREA>1</CODAREA>
    <NOME>VET_01(Excluir)_AUTOMAÇÃO</NOME>
    <COMPLEMENTO>VETERINARIA_NOTURNO</COMPLEMENTO>
    <CODCURINEP>555</CODCURINEP>
    <CODTIPOCURSO>1</CODTIPOCURSO>
    <CFGMATRICULA>666</CFGMATRICULA>
    <CAPES>1</CAPES>
    <CURPRESDIST>P</CURPRESDIST>
    <CODMODALIDADECURSO>1</CODMODALIDADECURSO>
    <MASCARATURMA>#####</MASCARATURMA>
  </SCurso>
  <SCURSOCOMPL>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CODCURSO>3-4</CODCURSO>
  </SCURSOCOMPL>
</EduCurso>]]></tot:XML>

 <DeleteRecordResult>Exclusão de registro(s) realizado com sucesso</DeleteRecordResult>