Páginas filhas
  • FAQ - Utilização de DataServers RM via WebServices

Versões comparadas

Chave

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

...

Expanda o método ReadRecord, e clique duas vezes no Request. Uma template da mensagem a ser enviada ao DataServer é gerada automaticamente, basta preenchermos devidamente os dados. Abaixo estão exemplos das mensagens para salvar e ler os registros no sistema:

 


Informações
iconfalse
titleTemplate da mensagem do ReadRecord (Leitura de Registros):


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tot="http://www.totvs.com/">
  <soapenv:Header/>
  <soapenv:Body>
    <tot:ReadRecord>
      <!--Optional:-->
      <tot:DataServerName>?</tot:DataServerName>
      <!--Optional:-->
      <tot:PrimaryKey>?</tot:PrimaryKey>
      <!--Optional:-->
      <tot:Contexto>?</tot:Contexto>
    </tot:ReadRecord>
</soapenv:Body>
</soapenv:Envelope> 

...

Fique atento: Para toda request solicitada é preciso preencher o usuário e senha, caso contrário a mensagem não poderá ser enviada ao dataserver.

Image Added


Image RemovedImage Added

Como obtenho a estrutura XML da mensagem de ReadRecord a ser enviada ao DataServer RM?

...

Via requisição ReadRecord direto no SoapUI, com os parâmetros preenchidos... 


Informações
iconfalse
titleExemplo de requisição ReadRecord:


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tot="http://www.totvs.com/">
  <soapenv:Header/>
  <soapenv:Body>
    <tot:ReadRecord>
      <!--Optional:-->
      <tot:DataServerName>GlbCalendData</tot:DataServerName>
      <!--Optional:-->
      <tot:PrimaryKey>0000008</tot:PrimaryKey>
      <!--Optional:-->
      <tot:Contexto>CODCOLIGADA=1;CODSISTEMA=G;CODUSUARIO=mestre</tot:Contexto>
    </tot:ReadRecord>
  </soapenv:Body>
</soapenv:Envelope>

...

Informações
iconfalse


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tot="http://www.totvs.com/">

  <soapenv:Header/>
  <soapenv:Body>
    <tot:SaveRecord>
      <!--Optional:–>
      <tot:DataServerName>GlbCalendData</tot:DataServerName>
      <!--Optional:–>
      <tot:XML>
        <![CDATA[
       <GlbCalend>
             <GCalend>
                    <CODIGO>0000008</CODIGO>
                    <NOME>Calendário 2.008</NOME>
             </GCalend>
             <GFeriado>
                    <CODCALENDARIO>0000008</CODCALENDARIO>
                    <DIAFERIADO>2007-02-05T00:00:00</DIAFERIADO>
                    <NOME>Carnaval</NOME>
                    <FERIADO>T</FERIADO>
                    <TIPO>NA</TIPO>
             </GFeriado>
       </GlbCalend>
             ]]>
      </tot:XML>
      <!--Optional:–>
      <tot:Contexto>CODCOLIGADA=1;CODSISTEMA=G;CODUSUARIO=mestre</tot:Contexto>
    </tot:SaveRecord>
</soapenv:Body>
</soapenv:Envelope>

...


Fique atento: Lembrando que se os dados de PK não forem enviados devidamente não será retornado mais do que uma XSD sem o XML necessário à gravação do registro.

...

Informações
iconfalse
title Resposta da requisição do SaveRecord:


 <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Body>
    <SaveRecordResponse xmlns="http://www.totvs.com/">
      <SaveRecordResult>    
1;00002;5
      </SaveRecordResult>
    </SaveRecordResponse>
  </s:Body>
</s:Envelope>

...


É preciso analisar a mensagem para verificar a mensagem para saber se houve a inserção/atualização do registro. Neste campo poderão ser apresentados erros comuns à MDI RM, como violação de chave estrangeria, chave duplicada, etc.

...