Produto	:	Framework Versão: 11.80.XX
Processo	:	Web Services
Subprocesso	:
Data da publicação	:	04/11/2014

Objetivo

O

O "TOTVS

Web Service

WS Client" tem como objetivo auxiliar a utilização e/ou testar a execução

de web services

dos Web Service's disponíveis no RM

, e auxiliar a utilização deles através de ferramentas de terceiros

.

Como Configurar

Para que o TOTVS WS Client consiga acessar os WebServices do RM, é necessário que os mesmos estejam ativos e que o DefaultDB esteja configurado. Para saber como configurar o DefaultDB acesse o link: http://tdn.totvs.com/x/sQSqC

Para

utilização

uso do sistema "TOTVS

Web Service", é

WS Client" é necessário copiar os arquivos:

"TotvsWS.Client.dll", "TotvsWSTest

"TotvsWSClient.exe" e "

TotvsWSTest

TotvsWSClient.exe.config"

,

para a pasta RM.

net

Net do seu ambiente configurado.

Logo após

Em seguida, basta editar o

arquivo

arquivo "

TotvsWSTest

TotvsWSClient.exe.config"

, alterando

alterando as Tag'

s

s "Host", "Port"

,

e "WS-Server" para as configurações do ambiente desejado. Conforme

mostra

exemplo abaixo:

TotvsWSTest

TotvsWSClient.exe.config

Bloco de código

language	xml
theme	Eclipse

<?xml version="1.0"?>


<configuration>

<appSettings>
<add


  <appSettings>
 	<add key="Host" value="localhost" />


 	<add key="Port" value="1180" />


 	<add key="EnableCompression" value="False" />


 	<add key="WS-Server" value="http://localhost:8051" />


 	<add key="WS-UserName" value="mestre" />


 	<add key="WS-DataServerName" value="GlbUsuarioData" />


 	<add key="WS-ProcessName" value="GlbAcessoData" />


 	<add key="WS-CodColigadaSQL" value="" />


 	<add key="WS-CodSistemaSQL" value="" />


 </appSettings>


</configuration>

Como Funciona

Existem vários métodos

no Totvs Web Service

que podem ser utilizados no TOTVS WS Client, como

mostra

exemplos abaixo:

Tela da consulta dos dados da visão (READVIEW):

Equivale

a

ao abrir uma visão padrão RM (de um DataServer

específico

)

,

que retorna um conjunto de dados, conforme filtros informados nos parâmetros.

Image Removed

Image Added

XML da consulta dos dados das visões (READVIEW):

Equivale a abrir uma visão padrão RM (de um DataServer

específico

)

,

que retorna um conjunto de registros (XML), conforme filtros informados nos parâmetros.

Image Removed

Image Added

Tela de consulta dos Dados

(READRECORD):

Faz a leitura do DataServer (regra de negócio RM) e

,

retorna os dados de um registro específico.

Image Removed

Image Added

XML da consulta dos dados da edição (READRECORD):

Faz a leitura do DataServer (regra de negócio RM) e

,

Image Removed

retorna o (XML) de um registro específico. Este XML pode ser utilizado para incluir ou editar um registro através do método SaveRecord do web service wsDataServer.

Image Added

Funcionalidade Excluir e Excluir Por Chave (DELETERECORD e DELETERECORDBYKEY):

1) O botão Excluir utiliza o método DELETERECORD, onde é necessário um Dataset para fazer a Leitura do Registro e depois sua exclusão (WsDataClient).

2) O botão Excluir por Chave utiliza a chave primária da tabela do registro para fazer a exclusão, sem a necessidade expressa de um ReadRecord anterior (WsDataClient).