Índice:
Objetivo:
Este documento tem por objetivo demonstrar qual é o procedimento para configurar o Host para disponibilizar os WebServices responsáveis pela integração de aplicativos de terceiros com o RM.
Introdução:
Cada WebServices possui os seus métodos. O WebService indicado para consulta de cadastro e inclusão/alteração/exclusão de um cadastro é o wsDataServer. Já o indicado para executar um processo (faturar movimento, cancelar movimento, cancelar lançamento, etc) é o wsProcess.
PROCEDIMENTOS
Edite o arquivo RM.Host.Service.exe.config e RM.Host.exe.config, que estão na pasta <diretório de instalação do RM>\RM.Net:
Para configurar as tags pelo RM.Host.ServiceManager.exe, acesse o link.
Adicione as seguintes tags no bloco de instruções <appSettings> ... </appSettings>
<add key="DEFAULTDB" value="CorporeRM" />
<add key="HTTPPORT" value="8051" />
No value da tag DefaultDB deve ser informado o Alias, do arquivo Alias.dat que contém a base de dados que será utilizada. 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 Web Services 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.
Ex.: Quando utilizado por exemplo o método WsDataServer, o separador decimal é o mesmo da cultura definida no sistema operacional, entretando esta configuração de leitura pode ser alterada quando utilizada a tag "WebServiceCulture" no arquivo .config do host (RM.Host.exe.config ou RM.Host.Service.exe.config).
Abaixo segue um arquivo de exemplo de configuração do Host:
RM.Host.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>
Configuração necessária para reservar a porta:
Executar o comando netsh http add urlacl url=http://+:8051/ user=NetworkService no prompt de comando do Windows.
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 da padrão, deve-se executar o comando netsh para a(s) porta(s) desejada(s).
Caso deseje utilizar uma porta diferente da padrão, deve-se alterar o valor da chave HTTPPORT presente no arquivo Web.config
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
Ex:
http://servidor.com:8051/wsPageIndex
http://servidor.com:8051/wsDataServer
http://servidor.com:8051/wsReport
Ex. WSDL:
http://localhost:8051/wsReport/MEX?wsdl
http://servidor.com:8051/wsDataServer/MEX?wsdl
Para a integração de mensagem única, o link a ser utilizado para comunicação com o o RM deve ser composto por:
http://<IP ou HostName da máquina em que o Host está configurado>:<porta informada no arquivo de configuração do host, tag HTTPPORT>/EAISERVICE/IConWSEAIService
Ex.: http://10.31.8.140:8051/EAISERVICE/IConWSEAIService
Em ambientes MuiltTenancy, veja os detalhes de configuração e utilização aqui: https://tdn.totvs.com/x/9XwcEQ
Para maiores informações:
Canais de Atendimento:
Chamado: Através do Portal Totvs www.suporte.totvs.com.br
Telefônico: 4003-0015 Escolhendo as opções 2 – (Software), 2 – (Suporte Técnico), 3 – (RM), 9 – (Demais Áreas), 2 – (CRM), 3 - (Vendas e CRM) e 3 – (Microsoft CRM).
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas