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ã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
    labelProcesso - 02)

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


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

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

    Informações
    Aviso
    iconfalse
    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

    ).

     

     

    Procedimentos

     

    1)  2

    )

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

    .

    .. </appSettings> 


    <add key="

    DEFAULTDB

    ServicesHostName" value="

    CorporeRM

    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="

    HTTPPORT

    WebServiceCulture" value="

    8051

    Invariant" />

    Aviso
    iconfalse

    (aviso)   

    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)     

          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)

              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>/EAISERVICE/

    wsPageIndex

    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/

     

     




    Informações
    titlePara maiores informações:


    Consulte o WikiHelp TOTVS

    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