Histórico da Página

...

Dica

Os serviços REST identificarão a base de dados a ser utilizada através da tag DefaultDB, que informa o Alias que será utilizado no acesso. Essa tag deve existir no arquivo de configuração do Host (RM.Host.Service.exe.config ou RM.Host.exe.config):

<add key=”DefaultDB” value=”<ALIAS_DO_BANCO_RM>

A variável <ALIAS_DO_BANCO_RM> deverá ser substituída pelo nome do alias cadastrado para acesso ao banco de dados.

Exemplo:

<?xml version="1.0"?>
<configuration>
<appSettings>
<add key="JobServer3Camadas" value="false" />
<add key="Port" value="12120" />
<add key="ActionsPath" value="C:\totvs\CorporeRM\RM.Net;" />
<add key="LibPath" value="C:\totvs\CorporeRM\RM.Net" />
<add key="EnableDynamicLocalization" value="false" />
<add key="EnableCompression" value="false" />
<add key="LocalizationLanguage" value="pt-BR" />
<add key="HttpPort" value="8051" />
<add key="DefaultDB" value="CorporeRM" />
</appSettings>
<runtime>
<NetFx40_LegacySecurityPolicy enabled="true" />
<generatePublisherEvidence enabled="false" />
</runtime>
<startup useLegacyV2RuntimeActivationPolicy="true">
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0" />
</startup>
</configuration>

A porta 8051 é padrão no sistema e caso seja alterada na tag HttpPort no arquivo de configuração do Host, precisa ser alterada no link acima.

Nota

Para que o sistema carregue corretamente os parâmetros do sistema no momento de utilização do WebService, é necessário que sejam inclusas as informações do contexto: Coligada, Filial, Tipo de curso e Código do Sistema.

Essas informações devem ser separadas pelo caractere ";".

Método ReadRecord

Este método realiza a consulta de uma turma. Algumas informações são obrigatórias e devem ser informadas: o código da coligada, o código da filial, o id do periodo letivo, o código da turma.

...

O XML deve conter os campos CODCOLIGADA, CODFILIAL, IDPERLET e CODTURMA como informações da chave para busca da turma.

Bloco de código

language	xml
title	Exemplo de XML para consulta de uma turma

...

Bloco de código

language	xml
collapse	true

		<tot:ReadRecord>
         <!--Optional:-->
         <tot:DataServerName>EduTurmaData</tot:DataServerName>
         <!--Optional:-->
         <tot:PrimaryKey>1;1;98;Turma B</tot:PrimaryKey>
         <!--Optional:-->
         <tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODTIPOCURSO=3;CODSISTEMA=S;</tot:Contexto>
      </tot:ReadRecord>

Bloco de código

language	xml
title	Exemplo do retorno de consulta da Turma

...

Bloco de código

language	xml
collapse	true

<ReadRecordResult><![CDATA[<EduTurma>
  <STurma>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CODFILIAL>1</CODFILIAL>
    <IDPERLET>98</IDPERLET>
    <CODTURMA>Turma B</CODTURMA>
    <IDHABILITACAOFILIAL>403</IDHABILITACAOFILIAL>
    <NOMERED>ADS-A</NOMERED>
    <NOME>Análise e Desenvolvimento de Sofware - Turma A</NOME>
    <MAXALUNOS>100</MAXALUNOS>
    <DTINICIAL>2018-01-01T00:00:00</DTINICIAL>
    <DTFINAL>2018-12-31T00:00:00</DTFINAL>
    <CODTIPOCURSO>3</CODTIPOCURSO>
    <CODCURSO>ADS</CODCURSO>
    <CODHABILITACAO>1</CODHABILITACAO>
    <CODGRADE>1</CODGRADE>
    <CODPERLET>2018/01</CODPERLET>
    <DTINICIOPLETIVO>2017-01-01T00:00:00</DTINICIOPLETIVO>
    <NOMECURSO>Análise e Desenvolvimento de Software</NOMECURSO>
    <NOMEHABILITACAO>Bacharelado</NOMEHABILITACAO>
    <DESCGRADE>Tecnologia da Informação</DESCGRADE>
    <TURNO>Matutino</TURNO>
    <CONTROLEVAGAS>0</CONTROLEVAGAS>
  </STurma>
  <STURMACOMPL>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CODFILIAL>1</CODFILIAL>
    <IDPERLET>98</IDPERLET>
    <CODTURMA>Turma B</CODTURMA>
  </STURMACOMPL>
</EduTurma>]]></ReadRecordResult>

...

O XML deve conter a tabela STURMA com os campos CODCOLIGADA, CODFILIAL, IDPERLET e CODTURMA como informações da chave para o cadastro da turma e, também, os campos obrigatórios para seu cadastro.

Bloco de código

language	xml
title	Exemplo de XML para inclusão de uma

...

Bloco de código

language	xmlturma
collapse	true

		<tot:SaveRecord>
        	 <!--Optional:-->
       		<tot:DataServerName>EduTurmaData</tot:DataServerName>
        	<!--Optional:-->
        	<tot:XML><![CDATA[<EduTurma>
	<STurma>
	    <CODCOLIGADA>1</CODCOLIGADA>
	    <CODFILIAL>1</CODFILIAL>
	    <IDPERLET>98</IDPERLET>
	    <CODTURMA>Turma B</CODTURMA>
	    <IDHABILITACAOFILIAL>403</IDHABILITACAOFILIAL>
	    <NOMERED>ADS-A</NOMERED>
	    <NOME>Análise e Desenvolvimento de Sofware - Turma A</NOME>
	    <MAXALUNOS>100</MAXALUNOS>
	    <DTINICIAL>2018-01-01T00:00:00</DTINICIAL>
	    <DTFINAL>2018-12-31T00:00:00</DTFINAL>
	    <CODTIPOCURSO>3</CODTIPOCURSO>
	    <CODCURSO>ADS</CODCURSO>
	    <CODHABILITACAO>1</CODHABILITACAO>
	    <CODGRADE>1</CODGRADE>
	    <CODPERLET>2018/01</CODPERLET>
	    <DTINICIOPLETIVO>2017-01-01T00:00:00</DTINICIOPLETIVO>
	    <NOMECURSO>Análise e Desenvolvimento de Software</NOMECURSO>
	    <NOMEHABILITACAO>Bacharelado</NOMEHABILITACAO>
    	<DESCGRADE>Tecnologia da Informação</DESCGRADE>
	    <TURNO>Matutino</TURNO>
    	<CONTROLEVAGAS>0</CONTROLEVAGAS>
	</STurma>
	<STURMACOMPL>
 	   <CODCOLIGADA>1</CODCOLIGADA>
    	<CODFILIAL>1</CODFILIAL>
 	   <IDPERLET>98</IDPERLET>
  	  <CODTURMA>Turma B</CODTURMA>
  </STURMACOMPL>
</EduTurma>]]></tot:XML>
         <!--Optional:-->
         <tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODTIPOCURSO=3;CODSISTEMA=S;</tot:Contexto>
      </tot:SaveRecord>

Para que o sistema carregue corretamente os parâmetros do sistema, é necessário que sejam inclusas as informações do contexto: Coligada, Filial, Tipo de curso e Código do Sistema.

Essas informações devem ser separadas pelo caractere ";".

Bloco de código

Nota

title
language	xml

	Exemplo do retorno da inclusão da Turma

...

Bloco de código

language	xml
collapse	true

         <SaveRecordResult>1;1;98;Turma B</SaveRecordResult>

...

O XML deve conter a tabela STURMA com os campos CODCOLIGADA, CODFILIAL, IDPERLET e CODTURMA como informações da chave para a atualização do cadastro da turma.

Bloco de código

language	xml
title	Exemplo de XML para alteração de informações da Turma

...

code


language	xml
collapse	true

<tot:SaveRecord>
         <!--Optional:-->
         <tot:DataServerName>EduTurmaData</tot:DataServerName>
         <!--Optional:-->
         <tot:XML><![CDATA[<EduTurma>
  <STurma>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CODFILIAL>1</CODFILIAL>
    <IDPERLET>98</IDPERLET>
    <CODTURMA>Turma B</CODTURMA>
    <IDHABILITACAOFILIAL>403</IDHABILITACAOFILIAL>
    <NOMERED>ADS-A</NOMERED>
    <NOME>Análise e Desenvolvimento de Sofware - Turma A</NOME>
    <MAXALUNOS>99</MAXALUNOS>
    <DTINICIAL>2018-01-01T00:00:00</DTINICIAL>
    <DTFINAL>2018-12-31T00:00:00</DTFINAL>
    <CODTIPOCURSO>3</CODTIPOCURSO>
    <CODCURSO>ADS</CODCURSO>
    <CODHABILITACAO>1</CODHABILITACAO>
    <CODGRADE>1</CODGRADE>
    <CODPERLET>2018/01</CODPERLET>
    <DTINICIOPLETIVO>2017-01-01T00:00:00</DTINICIOPLETIVO>
    <NOMECURSO>Análise e Desenvolvimento de Software</NOMECURSO>
    <NOMEHABILITACAO>Bacharelado</NOMEHABILITACAO>
    <DESCGRADE>Tecnologia da Informação</DESCGRADE>
    <TURNO>Matutino</TURNO>
    <CONTROLEVAGAS>0</CONTROLEVAGAS>
  </STurma>
  <STURMACOMPL>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CODFILIAL>1</CODFILIAL>
    <IDPERLET>98</IDPERLET>
    <CODTURMA>Turma B</CODTURMA>
  </STURMACOMPL>
</EduTurma>]]></tot:XML>
         <!--Optional:-->
         <tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODTIPOCURSO=3;CODSISTEMA=S;</tot:Contexto>
      </tot:SaveRecord>

Bloco de código

language	xml
title	Exemplo do retorno da alteração do cadastro da Turma

...

code


language	xml
collapse	true

         <SaveRecordResult>1;1;98;Turma B</SaveRecordResult>

...

O XML deve conter a tabela STURMA com os campos CODCOLIGADA, CODFILIAL, IDPERLET e CODTURMA como informações da chave para o cadastro da turma e, também, os campos obrigatórios para seu cadastro.

Bloco de código

language	xml
title	Exemplo de XML para consulta de uma turma

...

Bloco de código

language	xml
collapse	true

		<tot:ReadRecord>
         <!--Optional:-->
         <tot:DataServerName>EduTurmaData</tot:DataServerName>
         <!--Optional:-->
         <tot:PrimaryKey>1;1;98;Turma B</tot:PrimaryKey>
         <!--Optional:-->
         <tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODTIPOCURSO=3;CODSISTEMA=S;</tot:Contexto>
      </tot:ReadRecord>

Bloco de código

language	xml
title	Exemplo do retorno de consulta da Turma

...

Bloco de código

language	xml
collapse	true

<ReadRecordResult><![CDATA[<EduTurma>
  <STurma>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CODFILIAL>1</CODFILIAL>
    <IDPERLET>98</IDPERLET>
    <CODTURMA>Turma B</CODTURMA>
    <IDHABILITACAOFILIAL>403</IDHABILITACAOFILIAL>
    <NOMERED>ADS-A</NOMERED>
    <NOME>Análise e Desenvolvimento de Sofware - Turma A</NOME>
    <MAXALUNOS>100</MAXALUNOS>
    <DTINICIAL>2018-01-01T00:00:00</DTINICIAL>
    <DTFINAL>2018-12-31T00:00:00</DTFINAL>
    <CODTIPOCURSO>3</CODTIPOCURSO>
    <CODCURSO>ADS</CODCURSO>
    <CODHABILITACAO>1</CODHABILITACAO>
    <CODGRADE>1</CODGRADE>
    <CODPERLET>2018/01</CODPERLET>
    <DTINICIOPLETIVO>2017-01-01T00:00:00</DTINICIOPLETIVO>
    <NOMECURSO>Análise e Desenvolvimento de Software</NOMECURSO>
    <NOMEHABILITACAO>Bacharelado</NOMEHABILITACAO>
    <DESCGRADE>Tecnologia da Informação</DESCGRADE>
    <TURNO>Matutino</TURNO>
    <CONTROLEVAGAS>0</CONTROLEVAGAS>
  </STurma>
  <STURMACOMPL>
    <CODCOLIGADA>1</CODCOLIGADA>
    <CODFILIAL>1</CODFILIAL>
    <IDPERLET>98</IDPERLET>
    <CODTURMA>Turma B</CODTURMA>
  </STURMACOMPL>
</EduTurma>]]></ReadRecordResult>

...

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 6

Nova versão 7

Chave

Método ReadRecord