Í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":
![](/download/attachments/415707993/image2018-9-21_11-39-50.png?version=1&modificationDate=1537541692147&api=v2)
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":
![](/download/attachments/415707993/image2018-9-21_11-42-13.png?version=1&modificationDate=1537541692117&api=v2)
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...":
![](/download/attachments/415707993/image2018-9-21_11-46-33.png?version=1&modificationDate=1537541692047&api=v2)
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:
![](/download/attachments/415707993/image2018-9-21_11-50-12.png?version=1&modificationDate=1537541692003&api=v2)
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:
![](/download/attachments/415707993/image2018-9-21_11-51-49.png?version=1&modificationDate=1537541691967&api=v2)
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 RM | Web.config |
---|
12.1.17 | |
12.1.22 | |
12.1.27 | Web.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ção | O quê configura? |
---|
JobServer3Camadas | Informa se a aplicação está trabalhando em 3 camadas |
Port | Informa em que porta Host e Client se comunicarão. |
Host | Informa 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) |
ActionsPath | Caminho onde estão as actions utilizadas no sistema |
LibPath | Diretório onde estão as dlls da lib |
DBAlias | Banco de dados para qualquer operação que possa vir a ser realizada pelo Web Service |
LibRMNET | Diretório onde estão as dlls da lib |
UserRM | Usuário a ser utilizado pelas operações do Web Service |
PassRM | Senha encriptada do Usuário a ser utilizado pelas operações do Web Service |
targetFramework | Versão RM | Versão Framework |
---|
12.1.17 | 4.5.2 | 12.1.22 | 4.7 | 12.1.27 | 4.7.2 |
|
Informações |
---|
|
As tags ActionsPath, LibPath e LibRMNET, se ambiente N camadas, realizar a configuração dessas tags para o diretório do servidor que possui a Biblioteca RM instalado, caso não tenha instalo no servidor local.
Ex (configuração local): <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;" /> |
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.