Histórico da Página

...

Para verificar se o serviço está funcionando basta acessar a página http://bhd0003447:8051/WsPageIndex/, deve ser exibida a página da TOTVS contendo os serviços do WebService do RM.

Image Removed

Caso a a página não esteja disponível é necessário reservar a porta para o usuário executor do serviço do Host.

Produto:

TOTVS Gestão Contábil

Versões:

12.0

Passo a passo:

Objetivo:

O objetivo deste guia é apresentar como expor o e utilizar os WebMethods do WebService utilizado para inclusão e leitura de lançamentos contábeis

Introdução:

O WebService do RM é iniciado em conjunto com o serviço do Host. Quando o Host é inicializado ele cria o serviço do WebService por default na porta 8051, caso o arquivo de configuração do host possua a tag "<add key="HttpPort" value="8051" />" o serviço será criado na porta informada.

Deck of Cards

id	1

Card

id	Verificar o Serviço do WebService
label	Verificar o Serviço do WebService

Aviso

title	Ambientes que utilizam SSL

Ambientes que utilizam SSL

Em ambientes que utilizam SSL o link muda para:

https://<SERVIDOR>:8051/wsPageIndex/Index

Image Removed

Para reservar a porta é necessário executar no prompt de comando uma linha de comando, informando a porta e o usuário executor do serviço do host.

Image Removed

Linha de Comando: netsh http add urlacl url=http://+:8051/ user=NetworkService

Image RemovedImage Removed

Card

id	Alias Default
label	Alias Default

Para configurar o Alias Default é necessário incluir a tag DefaultDB no arquivo de configuração do Host.

Acesse a máquina ou servidor que está executando o serviço.

Vá ao diretório C:\totvs\CorporeRM\RM.Net e edite o arquivo RM.Host.Service.exe.config.

Image Removed

Inclua a tag <add key="DefaultDB" value="CorporeRM" /> dentro da limitação appSettings.

O valor a ser atribuído a tag DefaultDB deve ser idêntica ao nome do alias que aponta para a base de dados utilizada. No nosso exemplo que citamos atribuímos o valor "CorporeRM" ao alias e respectivamente ao DefaultDB.

Bloco de código

language	xml
title	RM.Host.Service.exe.Config

<?xml version="1.0" encoding="utf-8"?>
<configuration>
	<appSettings>
		<add key="JobServer3Camadas" value="false" />
		<add key="Port" value="8050" />
		<add key="ServicesHostName" value="BHD0002773" />
		<add key="ActionsPath" value="C:\totvs\CorporeRM\RM.Net;C:\totvs\CorporeRM\Corpore.Net\Bin" />
		<add key="LibPath" value="C:\totvs\CorporeRM\RM.Net" />
		<add key="EnableDynamicLocalization" value="false" />
		<add key="EnableCompression" value="false" />
		<add key="LocalizationLanguage" value="pt-BR" />
        <add key="DefaultDB" value="CorporeRM" />
	</appSettings>
	<runtime>
		<gcServer enabled="true" />
	</runtime>
</configuration>

Expondo e utilizando o DataServer do TOTVS Gestão Contábil via WebService.

1 - Para configurar WebService no RM.Host.exe e/ou RM.Host.Service.exe seguir os passos dos documentos a seguir:

“http://tdn.totvs.com/display/public/LRM/WebService+RM”

http://tdn.totvs.com/pages/viewpage.action?pageId=89620766.

Os documentos em questão mostraram como expor os serviços do webservice RM. No caso o serviço que nos interessa está exposto no caminho a seguir com o título DataServer: “http://localhost:8051/wsDataServer/MEX?wsdl”. Lembrando que localhost será a máquina onde se encontram os aplicativos RM.Host.exe e/ou RM.Host.Service.exe.

2 - O serviço DataServer possui diversos webmethods mas os principais são para leitura e inserção de registros são:

2.1 - ReadView -> Responsável por retornar os registros com base no filtro passado. Esse webmethod retorna os dados das tabelas CLANCAMENTO e CPARTIDA. O xml abaixo faz com que o webservice retorne o lançamento e suas partidas da coligada 1 e lançamento 2897 utilizando o DataServer CtbLanData “<tot:DataServerName>CtbLanData</tot:DataServerName>”.

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

<soapenv:Header/>

<soapenv:Body>

<tot:ReadView>

<tot:DataServerName>CtbLanData</tot:DataServerName>

<tot:Filtro>clancamento.codcoligada=1 and clancamento.idlancamento=2897</tot:Filtro>

<tot:Contexto>codcoligada=1</tot:Contexto>

</tot:ReadView>

</soapenv:Body>

</soapenv:Envelope>

2.2 - ReadRecord -> Responsável por retornar um registro de forma detalhada com base na chave passada “<tot:PrimaryKey>1;0;12</tot:PrimaryKey>” (CODCOLIGADA; CODLOTE; IDLANCAMENTO). Este webmethod retorna o lançamento, partida(s), rateio(s) e campo(s) complementares. O xml abaixo faz com que o webmethod retorne o lançamento e sua(s) partida(s), rateio(s) e campo(s) complementares da coligada 1, lote zero e lançamento 12 utilizando o DataServer CtbLanData “<tot:DataServerName>CtbLanData</tot:DataServerName>”.

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

<soapenv:Header/>

<soapenv:Body>

<tot:ReadRecord>

<tot:DataServerName>CtbLanData</tot:DataServerName>

<tot:PrimaryKey>1;0;12</tot:PrimaryKey>

<tot:Contexto>codcoligada=1</tot:Contexto>

</tot:ReadRecord>

</soapenv:Body>

</soapenv:Envelope>

2.3 - SaveRecord -> Responsável por salvar um registro. Este webmethod salva o lançamento contábil com sua(s) partida(s), rateio(s) e campo(s) complementares. Lembrando que só o lançamento e partida são obrigatórios para serem salvos. Abaixo o xml de exemplo mostrando como salvar um lançamento contábil que possui duas partidas, dois rateios (um para cada partida) e os campos complementares (um para cada partida). Rateios e campos complementares podem ser mais de um por partida.

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

<soapenv:Header/>

<soapenv:Body>

<tot:SaveRecord>

<tot:DataServerName>CtbLanData</tot:DataServerName>

<tot:XML>

<![CDATA[

<DESCRICAO>Lançamento da data 15/10/2010</DESCRICAO>

<ORIGEM_HISTORICO>0</ORIGEM_HISTORICO>

</CLANCAMENTO>

<USUARIO>charles</USUARIO>

<USUARIOALTER>charles</USUARIOALTER>

<USUARIOINTEGRACAO>Walquiria</USUARIOINTEGRACAO>

</CPARTIDA>

<USUARIO>charles</USUARIO>

<USUARIOALTER>charles</USUARIOALTER>

<USUARIOINTEGRACAO>Walquiria</USUARIOINTEGRACAO>

</CPARTIDA>

</CRATEIOLCCREDITO>

</CRATEIOLCDEBITO>

</CLCOMPL>

</CLCOMPL>

</CtbLan>

]]>

</tot:XML>

<tot:Contexto>codcoligada=1</tot:Contexto>

</tot:SaveRecord>

</soapenv:Body>

</soapenv:Envelope>

3 - Utilizando uma ferramenta como por exemplo o “SoapUI” é possível visualizar de forma fácil os webmethods disponíveis no serviço “http://localhost:8051/wsDataServer/MEX?wsdl”. Com esta ferramenta pode ser feito testes para inserir e ler os registros.

Informações

title	Atenção

Para que estas configurações entrem em vigor será necessário reiniciar o serviço do Host.

Após reiniciar o serviço basta verificar o serviço do WebService, se o DEFAULTDB estará configurado com o alias informado.

Image Removed

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 1

Nova versão 2

Chave