Linha RM

Atalhos

Páginas filhas
  • Processo Seletivo Terceirizado (WebService)

Visão Geral dos processos WebSevices de Processo Seletivo Terceirizado

O objetivo deste DataServer é possibilitar a busca, inclusão e alteração candidatos através de WebService no Processo Seletivo Terceirizado. Tudo o que for realizado, poderá ser visualizado na visão de candidatos e matrículas do processo seletivo terceirizado no TOTVS Gestão Educacional.

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

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


Método ReadView

Este método realiza a consulta de uma lista de candidatos. Algumas informações são obrigatórias e devem ser informadas: o código da coligada e o código do processo selecido.

O sistema irá realizar a consulta da lista de candidatos.

Consulta de uma lista de candidatos

Para realizar a consulta de uma lista de candidatos, deve ser utilizado a operação de ReadView.

Deve ser passado um XML contendo todos os campos de filtro.

O XML deve conter os campos SCANDIDATOPROCSEL.CODCOLIGADA e SCANDIDATOPROCSEL.IDPROCSEL como informações da filtro para busca da lista.

Exemplo de XML para consulta de uma lista de candidatos 
<tot:ReadView>
         <!--Optional:-->
         <tot:DataServerName>EduCandidatoProcSelData</tot:DataServerName>
         <!--Optional:-->
         <tot:Filtro>SCANDIDATOPROCSEL.CODCOLIGADA = 1 AND SCANDIDATOPROCSEL.IDPROCSEL = 8</tot:Filtro>
         <!--Optional:-->
         <tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODSISTEMA=S;CODTIPOCURSO=1</tot:Contexto>
 </tot:ReadView>
Exemplo de retorno da lista de candidatos 
<ReadViewResult><![CDATA[<NewDataSet>
  <SCANDIDATOPROCSEL>
    <CODCOLIGADA>1</CODCOLIGADA>
    <IDPROCSEL>8</IDPROCSEL>
    <NUMEROINSCPROCSEL>1</NUMEROINSCPROCSEL>
    <NOME>Aluno Proc Terceirizado Um</NOME>
    <DATANASC>1987-07-30T00:00:00</DATANASC>
    <CIDADENASC>Belo Horizonte</CIDADENASC>
    <UFNASC>MG</UFNASC>
    <PAI>Pai Proc Terceirizado Um</PAI>
    <MAE>Mãe Proc Terceirizado Um</MAE>
    <RA>ES-00213</RA>
    <DATAMATRICULA>2018-04-04T00:00:00</DATAMATRICULA>
    <DATANASCPAI>1951-07-30T00:00:00</DATANASCPAI>
    <DATANASCMAE>1951-07-30T00:00:00</DATANASCMAE>
    <CIDADENASCPAI>Belo Horizonte</CIDADENASCPAI>
    <CIDADENASCMAE>Belo Horizonte</CIDADENASCMAE>
    <UFNASCPAI>MG</UFNASCPAI>
    <UFNASCMAE>MG</UFNASCMAE>
  </SCANDIDATOPROCSEL>
  <SCANDIDATOPROCSEL>
    <CODCOLIGADA>1</CODCOLIGADA>
    <IDPROCSEL>8</IDPROCSEL>
    <NUMEROINSCPROCSEL>2</NUMEROINSCPROCSEL>
    <NOME>Aluno Proc Terceirizado Dois</NOME>
    <DATANASC>1987-07-29T00:00:00</DATANASC>
    <CIDADENASC>Belo Horizonte</CIDADENASC>
    <UFNASC>MG</UFNASC>
    <PAI>Pai Proc Terceirizado Dois</PAI>
    <MAE>Mãe Proc Terceirizado Dois</MAE>
    <RA>ES-00212</RA>
    <DATAMATRICULA>2018-04-04T00:00:00</DATAMATRICULA>
    <DATANASCPAI>1951-07-30T00:00:00</DATANASCPAI>
    <DATANASCMAE>1951-07-30T00:00:00</DATANASCMAE>
    <CIDADENASCPAI>Belo Horizonte</CIDADENASCPAI>
    <CIDADENASCMAE>Belo Horizonte</CIDADENASCMAE>
    <UFNASCPAI>MG</UFNASCPAI>
    <UFNASCMAE>MG</UFNASCMAE>
  </SCANDIDATOPROCSEL>
  <SOPCAOCANDIDATO>
    <CODCOLIGADA>1</CODCOLIGADA>
    <IDPROCSEL>8</IDPROCSEL>
    <NUMEROINSCPROCSEL>1</NUMEROINSCPROCSEL>
    <IDPERLET>23</IDPERLET>
    <CODCURSO>1</CODCURSO>
    <OPCAO>1</OPCAO>
    <PONTUACAO>100.0000</PONTUACAO>
    <CLASSIFICACAO>1</CLASSIFICACAO>
    <IDHABILITACAOFILIAL>9</IDHABILITACAOFILIAL>
    <CURSO>Teste</CURSO>
    <CODPROCSEL>ProcTeste0001</CODPROCSEL>
    <CODPERLET>2018/1</CODPERLET>
    <MATRICULAPROVISORIA>S</MATRICULAPROVISORIA>
  </SOPCAOCANDIDATO>
  <SOPCAOCANDIDATO>
    <CODCOLIGADA>1</CODCOLIGADA>
    <IDPROCSEL>8</IDPROCSEL>
    <NUMEROINSCPROCSEL>2</NUMEROINSCPROCSEL>
    <IDPERLET>23</IDPERLET>
    <CODCURSO>1</CODCURSO>
    <OPCAO>1</OPCAO>
    <PONTUACAO>100.0000</PONTUACAO>
    <CLASSIFICACAO>2</CLASSIFICACAO>
    <IDHABILITACAOFILIAL>9</IDHABILITACAOFILIAL>
    <CURSO>Teste</CURSO>
    <CODPROCSEL>ProcTeste0001</CODPROCSEL>
    <CODPERLET>2018/1</CODPERLET>
    <MATRICULAPROVISORIA>S</MATRICULAPROVISORIA>
  </SOPCAOCANDIDATO>
</NewDataSet>]]></ReadViewResult>

Método ReadRecord

Este método realiza a consulta de um candidato. Algumas informações são obrigatórias e devem ser informadas: o código da coligada, o código do processo seletivo e o número da inscrição.

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


Consulta de Candidatos

Para realizar a consulta de um candidato, 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, IDPROCSEL e o NUMEROINSCPROCSEL como informações da chave para busca do candidato.


Exemplo de XML para consulta de um Candidato 
		<tot:ReadRecord>
         <!--Optional:-->
         <tot:DataServerName>EduCandidatoProcSelData</tot:DataServerName>
         <!--Optional:-->
         <tot:PrimaryKey>1;8;1</tot:PrimaryKey>
         <!--Optional:-->
         <tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODSISTEMA=S;CODTIPOCURSO=1</tot:Contexto>
      </tot:ReadRecord>
Exemplo do retorno de consulta de um Candidato 
<ReadRecordResult><![CDATA[<EduCandidatoProcSel >
  <SCANDIDATOPROCSEL>
    <CODCOLIGADA>1</CODCOLIGADA>
    <IDPROCSEL>8</IDPROCSEL>
    <NUMEROINSCPROCSEL>1</NUMEROINSCPROCSEL>
    <NOME>Aluno Proc Terceirizado Um</NOME>
    <DATANASC>1987-07-30T00:00:00</DATANASC>
    <CIDADENASC>Belo Horizonte</CIDADENASC>
    <UFNASC>MG</UFNASC>
    <PAI>Pai Proc Terceirizado Um</PAI>
    <MAE>Mãe Proc Terceirizado Um</MAE>
    <RA>ES-00213</RA>
    <DATAMATRICULA>2018-04-04T00:00:00</DATAMATRICULA>
    <DATANASCPAI>1951-07-30T00:00:00</DATANASCPAI>
    <DATANASCMAE>1951-07-30T00:00:00</DATANASCMAE>
    <CIDADENASCPAI>Belo Horizonte</CIDADENASCPAI>
    <CIDADENASCMAE>Belo Horizonte</CIDADENASCMAE>
    <UFNASCPAI>MG</UFNASCPAI>
    <UFNASCMAE>MG</UFNASCMAE>
  </SCANDIDATOPROCSEL>
  <SOPCAOCANDIDATO>
    <CODCOLIGADA>1</CODCOLIGADA>
    <IDPERLET>23</IDPERLET>
    <IDPROCSEL>8</IDPROCSEL>
    <NUMEROINSCPROCSEL>1</NUMEROINSCPROCSEL>
    <CODCURSO>1</CODCURSO>
    <OPCAO>1</OPCAO>
    <PONTUACAO>100.0000</PONTUACAO>
    <CLASSIFICACAO>1</CLASSIFICACAO>
    <IDHABILITACAOFILIAL>9</IDHABILITACAOFILIAL>
    <CURSO>Teste</CURSO>
    <CODPROCSEL>ProcTeste0001</CODPROCSEL>
    <CODPERLET>2018/1</CODPERLET>
    <MATRICULAPROVISORIA>S</MATRICULAPROVISORIA>
  </SOPCAOCANDIDATO>
</EduCandidatoProcSel>]]></ReadRecordResult>
Exemplo do retorno sem registros 
<ReadRecordResult>&lt;EduCandidatoProcSel  /></ReadRecordResult>

Método SaveRecord

Este método realiza a inclusão ou alteração de um candidato.

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

Inclusão de Candidato

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

Caso os dados informados não existam, será incluído um novo candidato. Caso contrário, o mesmo terá suas informações atualizadas.

O XML deve conter a tabela SCANDIDATOPROCSEL  e SOPCAOCANDIDATO com os campos CODCOLIGADA, IDPROCSEL e NUMEROINSCPROCSEL como informações da chave para o cadastro de candidatos.

Exemplo de XML para inclusão de um Candidato 
<tot:SaveRecord>
         <!--Optional:-->
         <tot:DataServerName>EduCandidatoProcSelData</tot:DataServerName>
         <!--Optional:-->
         <tot:XML><![CDATA[<EduCandidatoProcSel >
  <SCANDIDATOPROCSEL>
    <CODCOLIGADA>1</CODCOLIGADA>
    <IDPROCSEL>8</IDPROCSEL>
    <NUMEROINSCPROCSEL>3</NUMEROINSCPROCSEL>
    <NOME>Aluno Proc Terceirizado Três</NOME>
    <DATANASC>1987-07-30T00:00:00</DATANASC>
    <CIDADENASC>Belo Horizonte</CIDADENASC>
    <UFNASC>MG</UFNASC>
    <PAI>Pai Proc Terceirizado Três</PAI>
    <MAE>Mãe Proc Terceirizado Três</MAE>
    <DATANASCPAI>1951-07-30T00:00:00</DATANASCPAI>
    <DATANASCMAE>1951-07-30T00:00:00</DATANASCMAE>
    <CIDADENASCPAI>Belo Horizonte</CIDADENASCPAI>
    <CIDADENASCMAE>Belo Horizonte</CIDADENASCMAE>
    <UFNASCPAI>MG</UFNASCPAI>
    <UFNASCMAE>MG</UFNASCMAE>
  </SCANDIDATOPROCSEL>
  <SOPCAOCANDIDATO>
    <CODCOLIGADA>1</CODCOLIGADA>
    <IDPERLET>23</IDPERLET>
    <IDPROCSEL>8</IDPROCSEL>
    <NUMEROINSCPROCSEL>3</NUMEROINSCPROCSEL>
    <CODCURSO>1</CODCURSO>
    <OPCAO>1</OPCAO>
    <PONTUACAO>100.0000</PONTUACAO>
    <CLASSIFICACAO>1</CLASSIFICACAO>
    <IDHABILITACAOFILIAL>9</IDHABILITACAOFILIAL>
    <CURSO>Teste</CURSO>
    <CODPROCSEL>ProcTeste0001</CODPROCSEL>
    <CODPERLET>2018/1</CODPERLET>
    <MATRICULAPROVISORIA>S</MATRICULAPROVISORIA>
  </SOPCAOCANDIDATO>
</EduCandidatoProcSel>]]></tot:XML>
         <!--Optional:-->
         <tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODSISTEMA=S</tot:Contexto>
      </tot:SaveRecord>
Exemplo do retorno da inclusão de um Candidato 
<SaveRecordResult>1;8;3</SaveRecordResult>


Caso a inclusão seja realizada com sucesso, será mostrado o código da coligada, o código do processo seletivo e o número de inscrição inserido no item SaveRecordResult.

Alteração de um Candidato

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

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

O XML deve conter a tabela SCANDIDATOPROCSEL  e SOPCAOCANDIDATO com os campos CODCOLIGADA, IDPROCSEL e NUMEROINSCPROCSEL como informações da chave para o cadastro de candidatos.

Exemplo de XML para alteração de informações de um Candidato 
      <tot:SaveRecord>
         <!--Optional:-->
         <tot:DataServerName>EduCandidatoProcSelData</tot:DataServerName>
         <!--Optional:-->
         <tot:XML><![CDATA[<EduCandidatoProcSel >
<SCANDIDATOPROCSEL>
    <CODCOLIGADA>1</CODCOLIGADA>
    <IDPROCSEL>8</IDPROCSEL>
    <NUMEROINSCPROCSEL>3</NUMEROINSCPROCSEL>
    <NOME>Aluno Proc Terceirizado Três</NOME>
    <DATANASC>1987-07-30T00:00:00</DATANASC>
    <CIDADENASC>Belo Horizonte</CIDADENASC>
    <UFNASC>MG</UFNASC>
    <PAI>Pai Proc Terceirizado Três</PAI>
    <MAE>Mãe Proc Terceirizado Três</MAE>
    <DATANASCPAI>1951-07-30T00:00:00</DATANASCPAI>
    <DATANASCMAE>1951-07-30T00:00:00</DATANASCMAE>
    <CIDADENASCPAI>Belo Horizonte</CIDADENASCPAI>
    <CIDADENASCMAE>Belo Horizonte</CIDADENASCMAE>
    <UFNASCPAI>MG</UFNASCPAI>
    <UFNASCMAE>MG</UFNASCMAE>
  </SCANDIDATOPROCSEL>
  <SOPCAOCANDIDATO>
    <CODCOLIGADA>1</CODCOLIGADA>
    <IDPERLET>23</IDPERLET>
    <IDPROCSEL>8</IDPROCSEL>
    <NUMEROINSCPROCSEL>3</NUMEROINSCPROCSEL>
    <CODCURSO>1</CODCURSO>
    <OPCAO>1</OPCAO>
    <PONTUACAO>100.0000</PONTUACAO>
    <CLASSIFICACAO>1</CLASSIFICACAO>
    <IDHABILITACAOFILIAL>9</IDHABILITACAOFILIAL>
    <CURSO>Teste</CURSO>
    <CODPROCSEL>ProcTeste0001</CODPROCSEL>
    <CODPERLET>2018/1</CODPERLET>
    <MATRICULAPROVISORIA>S</MATRICULAPROVISORIA>
  </SOPCAOCANDIDATO>
</EduCandidatoProcSel>]]></tot:XML>
         <!--Optional:-->
         <tot:Contexto>CODCOLIGADA=1;CODFILIAL=1;CODSISTEMA=S</tot:Contexto>
      </tot:SaveRecord>
Exemplo do retorno da alteração do cadastro de um Candidato 
<SaveRecordResult>1;8;3</SaveRecordResult>

Caso a inclusão seja realizada com sucesso, será mostrado o código da coligada, o código do processo seletivo e o número de inscrição inserido no item SaveRecordResult.