Cross Segmentos - Backoffice RM - Integração - WebServices - Como Habilitar Webservice via RM Host

Tempo aproximado para leitura: 00:05:30 min

Dúvida
Como Habilitar Webservice via RM Host?

Ambiente
Cross Segmentos - Backoffice RM - Integração - Todas as versões.

Solução
Além dos detalhes a seguir, para facilitar as configurações criamos dois How To dedicado a essa operação:

 - Configuração para disponibilização de WebService e API:



Etapas:
Segue abaixo o passo a passo de como configurar o webservices no Host:
1. Edite os arquivos RM.Host.Service.exe.config e RM.Host.exe.config, que estão na pasta <diretório de instalação do RM>\RM.Net:

2. Adicione as seguintes tags no bloco de instruções <appSettings> ... </appSettings>

<add key="DEFAULTDB" value="CorporeRM" />

No value da tag DefaultDB deve ser informado o Alias, do arquivo Alias.dat que contém a base de dados que será utilizada.

<add key="HTTPPORT" value="8051" />

Na tag HttpPort informe a porta utilizada pelo Host para os serviços via WS (Geralmente é informado o padrão 8051).

<add key="ServicesHostName" value="DNS da instituição" />

Para expor os WebServices para acesso externo, torna-se necessária a inclusão da tag ServicesHostName, onde seu valor deverá ser o DNS ou IP Público da instituição.

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

A tag WebServiceCulture é utilizada para alterar a cultura de leitura e conversão dos dados recebidos pelo WebService.

Veja um arquivo de exemplo de configuração do Host:
RM.Host.Service.exe.config

<?xml version="1.0"?>
<configuration>
 <appSettings>
  <add key="JobServer3Camadas" value="false" />
  <add key="Port" value="8050" />
  <add key="ActionsPath" value="C:\totvs\CorporeRM\RM.Net;C:\totvs\CorporeRM\Corpore.Net\Bin" />
  <add key="EnableCompression" value="true" />
  <add key="DEFAULTDB" value="CorporeRM" />
  <add key="HTTPPORT" value="8051" />
 </appSettings>
 <runtime>
  <gcServer enabled="true" />
 </runtime>
</configuration>

teste

3. Execute prompt de comando do Windows como Administrador e efetue o comando:

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

 

Será exibida uma mensagem de que a URL foi reservada com sucesso, conforme print abaixo:

 

 

Neste exemplo a porta utilizada é a 8051. Caso deseje adicionar mais serviços do Host com outras portas ou a porta utilizada seja diferente dá padrão, deve-se executar o comando netsh para a(s) porta(s) desejada(s).

Para validar as portas já reservadas em seu ambiente, utilize o comando abaixo:

netsh http show urlacl

4. Para verificar se as configurações estão corretas, informe a URL abaixo no browser (Internet Explorer, Mozilla Firefox, etc):

http://<IP ou HostName da máquina em que o HOST está configurado>:<porta informada no arquivo de configuração do host, tag HTTPPORT>/wsPageIndex
Exemplo:

http://servidor.com:8051/wsPageIndex

http://servidor.com:8051/wsdataserver

http://servidor.com:8051/wsReports

Exemplo WSDL:

http://localhost:8051/wsReport/MEX?wsdl

http://servidor.com:8051/wsDataServer/MES?wsdl

 

Importante
Para consumir os WebServices, utilize um aplicativo que faça o uso do protocolo SOAP nas chamadas. Um exemplo de ferramenta é a SoapUI.

Segue mais um How To sobre com exemplos de consumo em SOAP, REST e RESTFul, de forma simples: