Í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. Os webservices disponíveis são:
- wsDataServer;
- wsConceito;
- wsProcess;
- wsTotvsMessage;
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.
Informações |
---|
icon | false |
---|
title | PROCEDIMENTOS |
---|
|
Deck of Cards |
---|
| Card |
---|
| 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. |
Card |
---|
| Adicione as seguintes tags no bloco de instruções <appSettings> ... </appSettings>
<add key="DEFAULTDB" value="CorporeRM" /> <add key="HTTPPORT" value="8051" /> Informações |
---|
| 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" /> Aviso |
---|
| 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).
|
|
|
|
Procedimentos
1) 2) Adicione as seguintes tags no bloco de instruções <appSettings> ... </appSettings>
<add key="DEFAULTDB" value="CorporeRM" />
<add key="HTTPPORT" value="8051" />
OBS: No value da tag DefaultDB deve ser informado qual será o Alias, do arquivo Alias.dat que contém a informação da base de dados que será utilizada. No value da tag HTTPPORT deve ser informada qual será a porta a ser utilizada pelo Host para os serviços via WS (geralmente é informado o padrão que é 8051).
3) 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" /> Aviso |
---|
| 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). |
|
Card |
---|
| Abaixo segue um arquivo de exemplo de configuração do Host: |
|
|
Bloco de código |
---|
language | xml |
---|
theme | Eclipse |
---|
title | RM.Host.exe.config |
---|
|
|
|
|
<configuration>
<appSettings>
<add
<configuration>
<appSettings>
<add key="JobServer3Camadas" value="false" /> |
|
|
|
<add
<add key="Port" value="8050" /> |
|
|
|
<add
<add key="ActionsPath" value="C:\ |
|
|
|
totvs1152totvs\CorporeRM\RM.Net;C:\ |
|
|
|
totvs1152totvs\CorporeRM\Corpore.Net\Bin" /> |
|
|
|
<add
<add key="EnableCompression" value="true" /> |
|
|
|
<add
<add key="DEFAULTDB" value="CorporeRM" /> |
|
|
|
<add
<add key="HTTPPORT" value="8051" /> |
|
|
|
<runtime>
<NetFx40_LegacySecurityPolicy
<runtime>
<gcServer enabled="true" /> |
|
|
|
<system.runtime.remoting>
<customErrors mode="Off" />
</system.runtime.remoting>
<startup>
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0" />
</startup>
</configuration>
4) Alterar a conta de autenticação do serviço do RM.Host, no gerenciador de serviços do Windows, para utilizar a conta LOCALSYSTEM ou de um usuário válido na rede, conforme print abaixo:
Image Removed
5) Para Card |
---|
| 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. Image Added Será exibida uma mensagem de que a URL foi reservada com sucesso, conforme print abaixo: Image Added Aviso |
---|
| 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 Image Added
|
Card |
---|
| Para verificar se as configurações estão corretas, informe a URL abaixo no browser (Internet Explorer, Mozilla |
|
|
Firefor<ip hostname HostName da máquina em que o Host está configurado>:<porta |
|
|
que foi na wsPageIndexEAISERVICE/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
Aviso |
---|
|
Para consumir os WebServices, utilize um aplicativo que faça uso do |
Image Removed
OBS: Para consumir os webservices deve utilizar um aplicativo que utilize protocolo Soap nas chamadas. Indicamos o SoapUI. |
Esse software pode ser baixada pelo link abaixo:http://sourceforge.net/projects/soapui/files/