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

TOTVS WS Client

Objetivo

O "TOTVS WS Client" tem como objetivo auxiliar a utilização e/ou testar a execução dos Web Service's disponíveis no RM.
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 uso do sistema "TOTVS WS Client" é necessário copiar os arquivos: "TotvsWSClient.exe" e "TotvsWSClient.exe.config" para a pasta RM.Net do seu ambiente configurado.
  Em seguida, basta editar o arquivo "TotvsWSClient.exe.config" alterando as Tag's "Host", "Port" e "WS-Server" para as configurações do ambiente desejado. Conforme exemplo abaixo:

TotvsWSClient.exe.config

<?xml version="1.0"?> <configuration> <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 que podem ser utilizados no TOTVS WS Client, como exemplos abaixo:

Tela da consulta dos dados da visão (READVIEW):
Equivale ao abrir uma visão padrão RM (de um DataServer) que retorna um conjunto de dados, conforme filtros informados nos parâmetros.

XML da consulta dos dados das visões (READVIEW):
Equivale a abrir uma visão padrão RM (de um DataServer) que retorna um conjunto de registros (XML), conforme filtros informados nos parâmetros.
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.

XML da consulta dos dados da edição (READRECORD):
Faz a leitura do DataServer (regra de negócio RM) e 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.

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).

Tela de consulta dos processos executados:
Retorna os dados de todas as execuções de um processo selecionado.
Tela de visualização dos dados do processo:
Exibe os parâmetros de execução do processo selecionado anteriormente.

Tela de consulta do XML dos parâmetros do processo:
Fornece o XML de parâmetros necessários para acionar um processo através do WebService wsProcess.

Tela de consulta da sentença SQL:
Retorna os dados de uma determinada consulta SQL, através dos parâmetros informados.

XML da consulta da sentença SQL:
Exibe o resultado de uma consulta em formato XML.