Histórico da Página

Introdução

O Web Service wsConsultaSQL é responsável pela execução de consultas sql do sistema

Como funciona

Estão expostos no wsConsultaSQL alguns serviços, onde para consumi-los é necessário enviar através de uma requisição um envelope SOAP, passando os parâmetros de cada serviço.

Serviços Disponíveis

Expandir

title	RealizarConsultaSQL

Serviço responsável por executar consultas sql do sistema

Deck of Cards

id	1

Card

label	Request

Os parâmetros solicitado pelo RealizarConsultaSQL são:

codSentenca tipo String

codColigada tipo Int

codSistema tipo String

parameters tipo Stringcontext

tipo String (a partir das versões 12.1.31.xxx. 12.1.32.xxx, 12.1.33.xxx e 12.1.34)

Bloco de código

language	xml
title	Request

 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tot="http://www.totvs.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <tot:RealizarConsultaSQL>
         <!--Optional:-->
         <tot:codSentenca>wsExemplo</tot:codSentenca>
         <!--Optional:-->
         <tot:codColigada>1</tot:codColigada>
         <!--Optional:-->
         <tot:codSistema>G</tot:codSistema>
         <!--Optional:-->
         <tot:parameters>CODUSUARIO=MESTRE</tot:parameters>
         <!--Optional:-->
         <tot:context>CODCOLIGADA=1</tot:context>
      </tot:RealizarConsultaSQL>
   </soapenv:Body>
</soapenv:Envelope>

warningA partir das versões 12.1.31.xxx. 12.1.32.xxx,

Card

label	Response

Bloco de código

language	xml
title	Response

 <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <RealizarConsultaSQLResponse xmlns="http://www.totvs.com/">
         <RealizarConsultaSQLResult><![CDATA[<NewDataSet>
  <Resultado>
    <CODUSUARIO>mestre</CODUSUARIO>
    <NOME>Usuário Mestre</NOME>
    <STATUS>1</STATUS>
    <DATAINICIO>1997-01-01T00:00:00</DATAINICIO>
    <SENHA>oaEGFhDF</SENHA>
    <CONTROLE>27621</CONTROLE>
    <ULTIMACOLIGADA>1</ULTIMACOLIGADA>
    <CODACESSO>Acesso02</CODACESSO>
    <DTAEXPSENHA>2014-05-08T00:00:00</DTAEXPSENHA>
    <OBRIGAALTERARSENHA>F</OBRIGAALTERARSENHA>
    <NUMLOGININVALIDO>0</NUMLOGININVALIDO>
    <EMAIL>[email protected]</EMAIL>
    <ACESSONET>T</ACESSONET>
    <DATAULTIMOACESSO>2015-07-14T13:48:54.417</DATAULTIMOACESSO>
    <CODUSUARIOREDE>matheus.sena</CODUSUARIOREDE>
    <DOMINIOREDE>BH01</DOMINIOREDE>
    <DATAULTIMOACESSOVALIDO>2015-07-14T13:48:54.44</DATAULTIMOACESSOVALIDO>
    <RECMODIFIEDBY>mestre</RECMODIFIEDBY>
    <RECMODIFIEDON>2015-07-14T13:48:54</RECMODIFIEDON>
    <USERID>5ddcc1c2-94b4-4974-8ed3-99aeb3dee5cf</USERID>
  </Resultado>
</NewDataSet>]]></RealizarConsultaSQLResult>
      </RealizarConsultaSQLResponse>
   </s:Body>
</s:Envelope>

title	Context

12.1.33.xxx e 12.1.34 será obrigatório o preenchimento do contexto para as sentenças SQL cadastradas na Coligada Global (coligada zero) para fins de segurança de perfil/usuário. Caso o mesmo não seja informado será exibida uma mensagem de validação. Bloco de código<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <s:Fault> <faultcode xmlns:a="http://schemas.microsoft.com/net/2005/12/windowscommunicationfoundation/dispatcher">a:InternalServiceFault</faultcode> <faultstring xml:lang="pt-BR">Para executar consultas sql pertencentes a Coligada Global (Coligada 0), deve-se informar também uma Coligada válida para o Contexto de Execução. Exemplo: '<tot:context>CODCOLIGADA=1</tot:context>'</faultstring> </s:Fault> </s:Body> </s:Envelope>

Para utilização dos Web Services através do aplicativo "Totvs Web Service Test", clique aqui.

Informações

title	Para maiores informações:

@FRAMEWORK

Canais de Atendimento

Chamado: Através do Portal TOTVS - www.suporte.totvs.com.br

Telefônico: 4003-0015 Escolhendo as opções 2-2-3-9-5 (Framework) ou 2-2-3-9-4 (BI)

Produto	Framework
Versão	11.82.XX
Processo	Web Services
Subprocesso	Utilizando o Web Service wsConsultaSQL

Status do Documento:	Finalizado
Data:	14/07/2015
Versão:	11.82.XX
Versão Anterior:	11.82.XX
Autores:	Diego Henrique Pener Fábio Augusto Amaral Melo Nunes Welbert Marques Silva Wesley Avelino De Carvalho

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 6

Nova versão 7

Chave

Introdução

Como funciona

Serviços Disponíveis