• A Confluence está sendo executada atualmente com todos os plugins que não são do sistema desabilitados. Pode haver perda de algumas funcionalidades



Introdução


    O Web Service wsDataServer é o responsável pela manipulação dos dados do sistema

Como funciona


   Estão expostos no wsDataServer 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.

Atenção

Aviso importante!

O wsDataServer foi concebido com uma inconsistência onde os separadores decimais dos campos retornado pelos métodos ReadRecord e ReadView não são compatíveis com os separadores esperados ao salvar registros utilizando o método SaveRecord. Isso acontece por que existe uma divergência de cultura (País/Região) entre os métodos.

Pelo fato de já existirem vários cliente utilizando o wsDataServer com este comportamento, optamos por não alterá-lo para não quebrar a compatibilidade. Então criamos formas de padronizar a cultura, consequentemente os separadores, utilizando parâmetros no arquivo de configuração do HOST.

Desta forma sugerimos que novas implementações com o wsDataServer utilize a opção "Invariant" como cultura, pois estamos trabalhando para que gradativamente tudo esteja padronizado, e esta opção será adotada.

Veja como configurar e saber mais sobre o assunto através do link abaixo:

Separadores decimais nos Web Services do RM

Serviços Disponíveis


Serviço responsável por retornar o esquema XSD do DataServer passado como parâmetro.

Serviço responsável por retornar o esquema XSD do DataServer passado como parâmetro.

Serviço responsável por retornar se o DataServer passado como parâmetro é válido.

Serviço responsável por efetuar a leitura do DataServer e retornar um XML contendo registros de acordo com a chave primária e o contexto informado

Serviço responsável por efetuar a leitura do DataServer e retornar um XML contendo registros de acordo com a chave primária, contexto e e-mail informado.

Serviço responsável por efetuar a leitura do DataServer e retornar um XML contendo registros de acordo com o contexto e o filtro informado.

Serviço responsável por efetuar a leitura do DataServer e retornar um XML contendo registros de acordo com o contexto,filtro e e-mail informado.

Serviço responsável por efetuar alterações de registros do DataServer de acordo com o XML informado.

ATENÇÃO:

Se a Tag de algum campo for informada sem conteúdo, a informação será anulada ou preenchida em branco.

Mais informações para os Parâmetros de Contexto

Exclusão de registros Associados

Para se remover todos registros associados ao dado mestre do wsDataServer deve-se enviar uma tag vazia com o nome do registro. Não enviar nenhum registro associado não causará a exclusão destes registros.

(Ex.: No Data Server GlbUsuarioData o registro 'GUSUARIO' pode ter relação com várias 'GUSRPERFIL'. Para remover os dados de perfil 'GUSRPERFIL' associados deve-se enviar xml com os campos chave do registro <GUSUARIO> e o tag vazio<GUSRPERFIL/> j')

Serviço responsável por efetuar alterações de registros do DataServer de acordo com o XML e Email informado. 


Formato dos parâmetros na Tag de contexto

Para o correto funcionamento da sua requisição, remova todos os espaços em branco do conteúdo da tag de Contexto.

O valor de cada parâmetro deve ser informado sem espaço ou caractere especial, como vírgula, aspas e etc.

Formato esperado
<tot:Contexto>CODCOLIGADA=1;CODUSUARIO=mestre;CODSISTEMA=F</tot:Contexto>

Exemplo de formato inválido

Formato inválido
<tot:Contexto>CODCOLIGADA = 1;CODUSUARIO="mestre";CODSISTEMA='F'</tot:Contexto>



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


Para maiores informações:

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 wsDataServer

Status do Documento:Finalizado
Data:30/06/2015
Versão:11.82.XX
Versão Anterior:11.82.XX
Autores: