Índice


       

Objetivo


Orientar o usuário quanto à configuração do Web Service.

Convertendo diretório virtual para Aplicativo


Após a execução do instalador do Web service, enviado em conjunto com o pacote de instalação da customização, é necessário a configuração do mesmo no IIS para que possa ser utilizado.


Para isso, vamos abrir o IIS e acessar o web service instalado, através da árvore no menu à esquerda, em Sites → Default Web Site → pasta com o nome do WS. No exemplo da imagem abaixo, iremos configurar o "wsEducarBrasil":



Inicialmente, o web service é instalado como Diretório Virtual, mas precisamos convertê-lo para Aplicativo para que possa ser utilizado corretamente. Para isso, basta clicar com o botão direito do mouse na pasta com o nome do web service (no exemplo, wsEducarBrasil) e selecionar a opção "Converter para Aplicativo":



Será aberta uma nova janela com o título "Adicionar Aplicativo". Precisamos verificar o Pool de aplicativos selecionado, para isso, devemos clicar no botão "Selecionar...":



Será aberta uma janela com a lista de Pool de Aplicativos. Poderão existir diversos pools, mas o importante é que a versão do .Net Framework seja a 4.0 (geralmente a versão vem indicada no nome, como Net.4.0 ou ASP.NET v4.0). Para isso, devemos escolher na lista e verificar a versão no campo logo abaixo:



Após selecionar o pool, basta clicar em OK e depois confirmar novamente na tela Adicionar Aplicativo. O web service será convertido em aplicativo e estará disponível para uso:


Alterando o arquivo Web.Config


Caso seja a primeira instalação da customização, será necessário incluir o arquivo "Web.config" no diretório gerado pelo processo de instalação. Para tal, realizar o download do arquivo "Web.config" corresponde a sua versão do RM.


Versão do RMWeb.config
12.1.17
12.1.22
12.1.27Web.zip
12.1.32Web.zip
12.1.2302Web.zip


 Logo após, certifique-se de alterar as tags abaixo com as configurações correspondente ao ambiente em que será instalada a customização.


Chave de ConfiguraçãoO quê configura?
JobServer3CamadasInforma se a aplicação está trabalhando em 3 camadas
PortInforma em que porta Host e Client se comunicarão.
HostInforma a localização do Host. Aceita:
- IPs (Ex: 10.31.8.91)
- Nome da máquina (não recomendável pois acrescenta o overhead de ir ao DNS)
ActionsPathCaminho onde estão as actions utilizadas no sistema
LibPathDiretório onde estão as dlls da Lib*
DBAliasBanco de dados para qualquer operação que possa vir a ser realizada pelo Web Service
LibRMNETDiretório onde estão as dlls da Lib*
UserRMUsuário a ser utilizado pelas operações do Web Service 
PassRMSenha encriptada do Usuário a ser utilizado pelas operações do Web Service
targetFramework
 Versão RM Versão Framework
12.1.174.5.2
12.1.224.7
12.1.274.7.2
12.1.324.7.2
12.1.23024.8



Atenção


* O caminho deverá referenciar onde se encontra as Dll's da a Biblioteca RM ou do Portal, levando como referencia sempre a customização instalada.

Em ambientes N Camadas as Tags ActionsPath, LibPath e LibRMNET devem ser configuradas para o diretório do servidor que possuir a Biblioteca RM ou Portal instalado(a). (Caso não tenha no servidor local)

Ex (configuração local) - Biblioteca RM:

<add key="ActionsPath" value="C:\TOTVS\CorporeRM\RM.Net;" />
<add key="LibPath" value="C:\TOTVS\CorporeRM\RM.Net;" />
<add key="LibRMNET" value="C:\TOTVS\CorporeRM\RM.Net;" />

Ex (configuração local) - Portal:

<add key="ActionsPath" value="C:\TOTVS\CorporeRM\Corpore.Net\Bin;" />
<add key="LibPath" value="C:\TOTVS\CorporeRM\Corpore.Net\Bin;" />
<add key="LibRMNET" value="C:\TOTVS\CorporeRM\Corpore.Net\Bin;" />


Caso tenha alguma dúvida com relação aos valores a serem informados, você poderá consultar os valores das tags acima no arquivo Web.config que se encontra em "C:\totvs\CorporeRM\Corpore.Net". Basta executar uma buscar com as palavras chaves "Host", "Port" e "DBAlias" ao abrir o arquivo informado.     


Uma vez configurado o arquivo de Web.config não é necessário refazer os passos citados acima a cada nova atualização da customização. Porém, ao realizar a primeira instalação no ambiente de produção os passos deverão ser realizados novamente.

Permissão Usuário IIS


Foi identificado em alguns casos quando realizado a chamada ou requisição da API em ambiente configurado do IIS que o mesmo apresenta a seguinte mensagem de erro <code>"555 - Erro interno do servidor. Erro ao executar o WebMethod: xxxxxxxx. Erro ao conectar no RM. - Erro ao inicializar RMSBroker: The type initializer for 'RM.Lib.Monitoring.Tracklog.RMSTracklog' threw an exception.\nObject reference not set to an instance of an object."},"error":"data error"</code>

Este erro está relacionando pela não permissão total (Controle Total) da pasta de instalação do projeto da API para o usuário do IIS. Para não apresentação desta mensagem ou não ser apresentado outras inconsistências relacionando a permissão é necessário a alteração do mesmo. Segue como alterar permissão:


Produto: Customizações

Versão: 11.80 ou Superiores

Data: