Versões comparadas

Chave

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

Assunto

Produto:

TOTVS Educacional

Versões:

12.1.17

Observações:

WebService

Dica

Como configura o WebService e Obter as chaves primarias.

Como Expor os Web Services do RM através do Host (recomendado)

Utilizando o TOTVS WS Client - Ferramenta para auxiliar a utilização dos Web Services providos pelo TBC

Dica

Após configurar o ambiente acessar o link abaixo e validar a conexão

http://localhost:8051/wsPageIndex/

Onde Localhost deve ser igual ao servidor onde o WebService foi configurado

Ao acessar o Link a tela abaixo deve ser exibida

Image Added

Painel

Clicar na Opção DataServer

Link a ser exibido

http://localhost:8051/wsDataServer/MEX?wsdl


Testar o link de processo no Soap Ui

Dica

 Para consumir os WebServices, utilize um aplicativo que faça uso do protocolo Soap nas chamadas. Indicamos o SoapUI.

 Para baixar o software, Clique aqui

Criando XML base para cadastro de candidatos

Acesse o aplicativo SoapUi (Disponível na web gratuitamente http://www.soapui.org/)

Solicite um novo projeto e informe:

- O nome do projeto

- O link WSDL copiado anteriormente na configuração do WS RM

Image Added

Será criado um projeto com as opções do print abaixo, onde deverão ser definidas as propriedades listadas:

- Name = Nome da Janela/página do ReadRecord para o projeto

- Encoding = UTF-8

Username = Usuário do sistema RM

Password = Senha do usuário do sistema RM

Localizar o Projeto Criado "Inscrição Processo Seletivo"

RM_IwsSataServer

Image Added

Localizar 

ReadRecord - Request 1

Clicar com Botão direito Rename

 Image Added


Clicar duas vezes no Item criado.e a tela abaixo será exibida

Image Added


Dê um duplo clique em Inscrição Candidato, em seguida será aberto uma janela. Informe nas tags abaixo, os valores:

É de suma importância que todas as tags abaixo estejam corretamente configuradas.

- “<tot:DataServerName>”  EduPSInscricaoAreaOfertadaData

<tot:PrimaryKey>”  COLIGADA;IDPS;NUMEROINSCRICAO (ex.: 1;173;1)

- “<tot:Contexto>”  CODCOLIGADA=1,CODFILIAL=1,CODUSUARIO=mestre,CODSISTEMA=S (dados do contexto)

Image Added

Autenticar usuario

Clicar em Auth

Image Added


Clicar em Authorization alterar de No Authorization para Add Ner Authorization...

Image Added

Selecionar aOpção Basic

Image Added


Utilizar um usuario com autorização de gravar candidatos (Neste caso optamos por utilizar o usuario mestre, mas pode ser criardo um usuario com permissões necessarias para o cadastro de um candidato no EXE.)

Image Added

Clique no ícone “Submit” (Play) conforme demonstra o print acima. Neste momento, o sistema irá gerar o XML do candidato pesquisado, sendo este a base para a criação de novos XML’s de Cadastro de candidato via SoapUI ou WebService.

Image Added

Obs.: O Arquivo tem início no marcador “<![CDATA[” e final no marcador “]]>”. Entre estes marcadores está o XML do candidato pesquisado, que servirá como base para os candidatos que serão incluídos a partir do WebService.

Exemplo

Dica

XML gerado.

<![CDATA[<EduPSInscricaoAreaOfertada>
<SPSInscricaoAreaOfertada>
<CODCOLIGADA>1</CODCOLIGADA>
<IDPS>173</IDPS>
<CODPESSOA>12936</CODPESSOA>
<NUMEROINSCRICAO>1</NUMEROINSCRICAO>
<IDFORMAINSCRICAO>159</IDFORMAINSCRICAO>
<DATAINSCRICAO>2017-12-19T11:21:38</DATAINSCRICAO>
<VALORINSCRICAO>0.0000</VALORINSCRICAO>
<VALORDESCONTO>0.0000</VALORDESCONTO>
<UTILIZANOTAENEM>F</UTILIZANOTAENEM>
<NUMEROCARTAORESPOSTA>1</NUMEROCARTAORESPOSTA>
<CODMUNICIPIO>06200</CODMUNICIPIO>
<CODETDMUNICIPIO>MG</CODETDMUNICIPIO>
<ENEMNUMINSCRICAO />
<STATUS>1</STATUS>
<TREINEIRO>F</TREINEIRO>
<DEFAUDITIVA>F</DEFAUDITIVA>
<DEFVISUAL>F</DEFVISUAL>
<DEFFISICA>F</DEFFISICA>
<DEFMULTIPLA>F</DEFMULTIPLA>
<DEFOUTRAS>F</DEFOUTRAS>
<DEFMOTIVOOUTRAS />
<CODCOLIGADAQS>0</CODCOLIGADAQS>
<CODPROVAQS />
<IDQS>0</IDQS>
<CANHOTO>F</CANHOTO>
<SENHA>01r0tN2N1y</SENHA>
<NOMECANDIDATO>Candidato Processo Seletivo</NOMECANDIDATO>
<STATUSLAN>10</STATUSLAN>
<IDCAMPUS>2</IDCAMPUS>
<COTAFEDERAL>F</COTAFEDERAL>
<COTAFEDERALENSINOPUBLICO>F</COTAFEDERALENSINOPUBLICO>
<COTAFEDERALRENDA>F</COTAFEDERALRENDA>
<COTAFEDERALCORACA>F</COTAFEDERALCORACA>
<USANOVOPORTAL>F</USANOVOPORTAL>
<IDCAMPUS1>2</IDCAMPUS1>
<CODFILIAL>1</CODFILIAL>
<IDBOLETO />
</SPSInscricaoAreaOfertada>
<SPSOpcaoInscrito>
<CODCOLIGADA>1</CODCOLIGADA>
<IDPS>173</IDPS>
<CODPESSOA>12936</CODPESSOA>
<NUMEROINSCRICAO>1</NUMEROINSCRICAO>
<IDAREAINTERESSE>33</IDAREAINTERESSE>
<NUMEROOPCAO>1</NUMEROOPCAO>
<NOME>Tecnologia em Redes</NOME>
<STATUS>0</STATUS>
<NUMEROVAGAS>10</NUMEROVAGAS>
</SPSOpcaoInscrito>
<SPSIdiomaInscrito>
<CODCOLIGADA>1</CODCOLIGADA>
<IDPS>173</IDPS>
<CODPESSOA>12936</CODPESSOA>
<NUMEROINSCRICAO>1</NUMEROINSCRICAO>
<IDAREAINTERESSE>33</IDAREAINTERESSE>
<CODIDIOMA>1</CODIDIOMA>
<NOME>Português</NOME>
</SPSIdiomaInscrito>
<SPSInscAreaOfertaCompl>
<CODCOLIGADA>1</CODCOLIGADA>
<IDPS>173</IDPS>
<NUMEROINSCRICAO>1</NUMEROINSCRICAO>
<CODPESSOA>12936</CODPESSOA>
<VICTOR>F</VICTOR>
<CC>T</CC>
<DD>T</DD>
</SPSInscAreaOfertaCompl>
</EduPSInscricaoAreaOfertada>]]>

Alterar o XML para o cadastro do novo usuário

Selecione o conteúdo do XML

Image Added

copie para algum editor de texto (Notepad, Notepad++, etc).

Image Added

Em seguida altere os dados para o cadastro do novo Candidato.

Obs.: Devemos nos atentar aos seguintes pontos:

  1. Todos os campos <NUMEROINSCRICAO> deverão ser preenchidos com o valor "-1" para que o sistema dê sequência as inscrições que já estão cadastradas.
  2. O campo <NUMEROCARTAORESPOSTA> não deve conter nenhum valor, para que o sistema dê sequência as inscrições que já estão cadastradas.
  3.  Os campos <CODMUNICIPIO> e <CODETDMUNICIPIO> são de preenchimento obrigatório, no entanto, se os mesmos não estiverem presentes no XML o candidato não será inscrito.

Aviso

Lembre-se!

Na versão 12.1.10 todos os campos <NUMEROINSCRICAO> não deveram conter nenhum valor, igualmente ao campo <NUMEROCARTAORESPOSTA>.