Blog do Aprovador



Desenvolvimento   |   ERP

Como habilitar os webservices do Totvs RM

customizacao   ·   integracao   ·   rm   ·   totvs   ·   totvs-rm   ·   webservices Marcelo, 06/12/2017

O RM é um dos melhores produtos da Totvs para se trabalhar com integração, pois, com ele é possível executar via webservice, praticamente qualquer funcionalidade do sistema. Isto facilita muito a vida dos programadores e fornecedores terceiros porque simplifica a tarefa de executar processos internos ou acessar objetos de negócio do produto. Entretanto, mesmo com tantos benefícios, os webservices do Totvs RM vem por padrão desabilitados. Saiba aqui como ativá-los!

Como ativar?

A notícia boa é que ativar os webservices é muito simples e você pode fazer isto via IIS ou via Host do RM. Aqui, nós trataremos apenas a utilização via Host do RM. Antes de qualquer coisa, você precisa se certificar que tenha acesso de administrador ao servidor e permissão de escrita no diretório de instalação do RM. O processo todo é feito em dois passos, mas atenção, é necessário reiniciar o Host do RM no final.

1) Defina os parâmetros do webservice

Para definir os parametros do webservice, abra os arquivos RM.Host.exe.config e RM.Host.Service.exe.config no seu editor de texto favorito e em seguida, dentro da tag appSettings, insira os seguintes parâmetros:

<add key="defaultdb" value="CorporeRM" />
<add key="httpport" value="8051" />

O parâmetro defaultdb é o alias utilizado para o banco, geralmente "CorporeRM" e o httpport é a porta onde o webservice será executado pelo Host. Existem alguns outros parâmetros adicionais que tratarei no final do post, no bloco de dicas.

2) Adicione o endereço do webservice

Para adicionar a URL e porta do webservice, abra o promt command e execute o seguinte comando:

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

Este comando irá reservar uma url e a porta 8051 para o usuário NetworkService, para que o Host do RM consiga prover os webservices neste servidor na porta configurada. O parâmetro + da url é um coringa que libera o acesso para qualquer que seja o nome ou ip do servidor.

Valide se deu tudo certo

Por fim, reinicie o host do RM e, em seu navegador favorito, acesse o endereço:

http://SEUSERVIDOR:PORTA/wsPageIndex

Se for exibida uma tela com a lista de todos os webservices do Totvs RM é porque deu tudo certo!

Dicas

Acesso externo

Caso você precise expor os webservices do Totvs RM para acesso externo, adicione nos arquivos de configuração a seguinte tag:

<add key="ServicesHostName" value="ip externo OU nome externo" />.

Mas atenção, muito cuidado ao expor publicamente o webservice. Embora o acesso seja sempre autenticado, é extremamente recomendado uma análise detalhada dos aspectos de segurança envolvidos.

Separador decimal

Caso você esteja utilizando o webservice WsDataServer, é muito importante adicionar aos arquivos de configuração a tag:

<add key="WebServiceCulture" value="Invariant" />

Este parâmetro com o valor Invariant vai definir que o separador decimal de todas as operações do webservice será sempre ponto ., independente da cultura definida no sistema operacional.

Como utilizar

O Totvs RM utiliza o padrão SOAP em todas as chamadas, ou seja, para construir integrações ou acessar dados, você precisará de um cliente que tenha suporte ao protocolo SOAP. Um dos clientes mais populares e utilizados para desenvolvimento e testes é o SoapUI, acesse este link para baixar.

Mudar endereço e porta

Se você precisar mudar a url ou porta do webservice, atualize os valores da tag httpport nos arquivos de configuração. Em seguida, remova a acl para a url/porta atual e defina uma outra regra para a nova url/porta. Para remover:

netsh http delete urlacl url=http://+:8051/ user=NetworkService

Consultar todas as acls do servidor:

netsh http show urlacl


Conclusão

Este é apenas o primeiro passo para começar a utilizar todo o potencial de integração do Totvs RM. Continuaremos a escrever artigos sobre como consumir os webservices, melhores práticas e guias mais detalhados. Não deixe de acompanhar o nosso blog!

Links de documentação




profile2.png
Artigo por:

Marcelo Camargos

O Marcelo é um dos fundadores do Aprovador e o seu objetivo principal é sempre levar a melhor experiência de atendimento e produto para os clientes do Aprovador.


Compartilhe se você gostou!


Leia também:









📩 Receba novidades por e-mail




📖 TÓPICOS

Produto

Desenvolvimento

Atualizações

Dia a dia

SaaS

ERP

Produtividade

Totvs Datasul



📁 SÉRIES

Guia de aprovações de compras no Totvs Datasul

Esta é uma série especial de posts detalhando o funcionamento e parametrização das aprovações no processo de compras do Totvs Datasul.



😎 MAIS POPULARES

Como utilizar todo o potencial do clientlog no Progress OpenEdge.

24/11/2017

O Aprovador agora fala Inglês!.

13/11/2017

Talvez você não precise dessa customização.

01/10/2017

ROI e métricas intangíveis em projetos de TI

27/05/2016


* Datasul, RM e TOTVS são produtos e marcas registradas de propriedade da TOTVS S.A. Logotipos TOTVS, Datasul e RM são de propriedade da TOTVS S.A.