Histórico da Página

...

1. Visão Geral
2. Exemplo de utilização
3. Tela de Download do Pacote do Web Service
   - Pacote
   
4. Armazenamento dos Arquivos do Web Service
5. Tela de Configuração do IIS
   
6. Tela de Configuração do Arquivo Web.Config
7. Tela de Configuração do Arquivo ServidoresOracle.Json
8. Tabelas utilizadas

01. VISÃO GERAL

Esta documentação tem o intuito de auxiliar ao usuário (TI) a configurar um web service no servidor, desde a etapa de configuração dos arquivos, download do pacote WS Web Service e configuração do site através do IIS.

...

Há situações em que um web service pára de responder as requisições, por questões de falta de arquivos, desconfigurações da rota do IIS, dentre outros, ou há a necessidade de se configurar o WS Web Service na implantação do TOTVS Moda PDV. Entretanto, há servidores WS que são manutenidos pelo TI da empresa/cliente ao qual, precisa de informações sobre estas configurações e onde são publicados os arquivos do "VirtualWebService", para conferências de funcionalidade ou até mesmo para que se possam instalá-lo na implantação.

OBS.: Para realizar esse procedimento o usuário deverá ter acesso ao servidor.

03. 

...

DOWNLOAD DO PACOTE DE WEB SERVICE

Download do Pacote VirtualWebService Através do FTP

Imagem 3.1 - Caminho para Download download dos Arquivos arquivos do Web Service.

Imagem 3.2 - Caminho para Download download dos Arquivos arquivos do Web Service.

Imagem 3.3 - Arquivo para Download download do Web Service.

04. 

...

ARMAZENAMENTO DOS ARQUIVOS DO WEB SERVICE - PACOTE

Com o arquivo ".ZIP" baixado do FTP, descompactá-lo na pasta "inetpub" do servidor. Usualmente esta pasta é criada na unidade C:\ embora, há quem prefira manter as publicações na unidade D:\ como podemos verificar na imagem abaixo.

Image Added

Imagem 4.1 - Pasta inetpub - Windows Explorer.

Feito isso, dentro desta pasta deverá conter a pasta "VirtualWebService" e os respectivos arquivos descompactados, conforme imagem abaixo:

Image Added

Imagem 4.2 - Pasta VirtualWebService proveniente do arquivo ".ZIP" - Windows Explorer.

05. CONFIGURAÇÃO DO IIS

Para acionar a tela de configuração do IIS basta executar o comando "inetmgr" (WINDOWS + R) e pressionar a tecla ENTER em seguida.

Image Added

Imagem 5.1 - Executar do Windows.

Ao abrir o Internet Information Services (ISS) Manager, selecionar o "Start Page" onde o nome da máquina está relacionado. Feito isso, na opção "Sites" clicar com o botão direito e utilizar a opção "Add Website...", conforme imagem abaixo.

Image Added

Imagem 5.2 - Internet Information Services (ISS) Manager - Add Website.

Na tela de configuração do Website, deve-se relacionar um nome ao site, como por exemplo VirtualWebService. Além disso, na opção "Physical path" deve-se selecionar a pasta do VirtualWebService descompactado na etapa 04 desta configuração. No campo "IP address" informar o IP externo (através do CMD é possível utilizar o comando IPCONFIG/ALL para descobrir o IP externo) da máquina e informar uma porta que posteriormente será utilizada na configuração da aplicação, como pode exemplo no TOTVS Moda PDV. Preenchido os campos, basta pressionar em OK para confirmar.

Image Added

Imagem 5.3 - Add Website.

Para testar se a configuração realizada está correta, basta clicar em cima do site criado, no caso VirtualWebService, e acionar o browser, conforme demonstrado na imagem a seguir. Obs.: Caso não esteja rodando esse site, verifique na opção "Manage Website", logo acima do destaque, se está com o "Start" em execução, senão, basta clicar em "Stop" e depois em "Start" novamente.

Image Added

Imagem 5.4 - Browser Website - Teste de conectividade com o site criado.

Feito isso, irá abrir o browser com a seguinte aplicação ASP.NET rodando.

Image Added

Imagem 5.5 - Aplicação ASP.NET iniciada corretamente.

...

06. CONFIGURAÇÃO DO ARQUIVO WEB.CONFIG

Abra o arquivo "Web.config" contido na pasta "D:\inetpub\VirtualWebService\", encontre a tag "connectionStrings" e preencha as informações referentes ao servidor do banco de dados, conforme podemos observar na imagem abaixo.

Os dados que devem ser preenchidos são:

• HOST (IP do BD do servidor);
• PORT (Porta do BD do servido);
• SERVICE_NAME (nome do banco);

Image Added

Imagem 6.1 - Arquivo Web.config de dados.

07. CONFIGURAÇÃO DO ARQUIVO SERVIDORESORACLE.JSON

Abra o arquivo "ServidoresOracle.json" contido na pasta "D:\inetpub\VirtualWebService\" e inclua as informações das bases de dados que podem ser acessadas neste ambiente, seguindo o exemplo das bases que já estão pré-configuradas. As informações podem ser obtidas no TNSNAMES.ORA, que por sua vez pode ser encontrado no caminho "C:\Oracle\product\'versão do Oracle'\cliente_1\NETWORK\ADMIN\)".

Image Added

Imagem 7.1 - Arquivo "ServidoresOracle.json".

...

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>

...