Páginas filhas
  • Como Expor os Web Services do RM através do Host (recomendado)

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice:


       

Índice
exclude.*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
iconfalse
titlePROCEDIMENTOS
Deck of Cards
idProcedimentos
Card
labelProcesso - 01)

 Edite           Edite o arquivo RM.Host.Service.exe.config e RM.Host.exe.config, que está estão na pasta <diretório de instalação do RM>\RM.Net:

Image Removed

 

Procedimentos

 

1)      Edite o arquivo


Image Added

Para configurar as tags pelo RM.Host.

Service.exe.config e RM.Host

ServiceManager.exe

.config, que está na pasta <diretório de instalação do RM>\RM.Net:

, acesse o link.

Card
labelProcesso - 02)

          Adicione

Image Removed

2)      Adicione

as seguintes tags no bloco de

instruções

instruções <appSettings> ... </appSettings>

 


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

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

Informações
iconfalse

 

OBS: No

(informação)          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

Na tag HTTPPORT

deve ser informada qual será

informe a porta

a ser

utilizada pelo Host para os serviços via WS (

geralmente

Geralmente é informado o padrão

que é 8051).

8051).


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

Aviso
iconfalse

(aviso)          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
iconfalse

(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
labelProcesso - 03)

          

3)     

Abaixo segue um arquivo de exemplo de configuração do Host:


Bloco de código
languagexml
themeEclipse
titleRM.Host.exe.config
 
<?xml version="1.0"?>

<configuration>

               <appSettings>

                               <add

<configuration>
   <appSettings>
        <add key="JobServer3Camadas" value="false" />
                               <add

        <add key="Port" value="8050" />
                               <add

        <add key="ActionsPath" value="C:\
totvs1152
totvs\CorporeRM\RM.Net;C:\
totvs1152
totvs\CorporeRM\Corpore.Net\Bin" />
                               <add

        <add key="EnableCompression" value="true" />
                               <add

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

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

   </appSettings>

               <runtime>

                               <NetFx40_LegacySecurityPolicy

   <runtime>
        <gcServer enabled="true" />
              

   </runtime>

               <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

</configuration>
Card
labelProcesso - 04)

         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
iconfalse

(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
labelProcesso - 05)

          Para verificar se as configurações estão corretas, informe a URL abaixo no browser (Internet Explorer, Mozilla

Firefor

Firefox, etc):

http://

<ip

<IP ou

hostname

HostName da máquina em que o Host está configurado>:<porta

que foi

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


Image Added


Informações
iconfalse

(informação)          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,

na

tag HTTPPORT>/

wsPageIndex

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


Aviso
iconfalse

         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:

         Para baixar o software, Clique aqui

http://sourceforge.net/projects/soapui/files/

 

 




Consulte o WikiHelp TOTVS
Informações
titlePara maiores informações:


Image Removed COMUNIDADE  @TBC e Microsoft Dynamics CRM

 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).

 



Informações
iconfalse
Informações
iconfalse

Produto: Framework - Conector

Informações
iconfalse

Versão: 11.50.XX e Superiores

Informações
iconfalse

Processo: Expor Web Services através do Host

Informações
iconfalse
Informações
iconfalse

Status: Construção

Informações
iconfalse

Data:  

Informações
iconfalse

Autores:

Douglas Maxwell de Oliveira

Fábio Augusto Amaral Melo Nunes

Usuário desconhecido (michel.almeida)

Karina Dos Santos Costa

Stella Gleyse Macedo Vilaca

Wesley Avelino De Carvalho