Documentação de software

Essa página está em modo somente de leitura. Você pode visualizar a fonte, mas não alterá-la. Informe-se com o administrador do Wiki, caso você ache que isso está incorreto.
====== Instalação ======

===== Instalação com o "Assistente de Instalação" =====

1 - Execute o arquivo "Setup.exe" referente ao WebService.

{{ :ws:diretorio_instalador.jpg?nolink |}}

2 - O "Assistente de Instalação" será aberto, clique no botão "Avançar >".

{{ :ws:instalador_welcome.jpg?nolink |}}

3 - Na tela de configuração do banco de dados, deverão ser informados a porta de comunicação do web service, o caminho ou alias do banco bem como seu usuário e senha. Logo abaixo, o usuário deverá informar o IP do servidor que possui a base de dados. Se o Web Service for instalado no próprio servidor, o usuário deverá marcar a opção "Servidor Local".

{{ :ws:instalador_bd.jpg?nolink |}}
<note warning>Não use uma Porta que já esteja sendo utilizada por outro serviço ou programa!</note>

Será iniciado um teste de conexão com o banco de dados. Se ocorrer algum erro referente a conexão será exibido a seguinte mensagem:

{{ :ws:instalador_bd_erro_sql.jpg?nolink |}}

Se a conexão com o banco de dados estiver correta, o instalador irá realizar uma verificação para saber se a aplicação está liberada para o cliente. Se
a liberação estiver correta, será exibida a seguinte mensagem:

{{ :ws:instalador_bd_liberacao_sucesso.jpg?nolink |}}

Caso ocorra algum erro no processo de liberação será exibida a seguinte mensagem:

{{ :ws:instalador_bd_liberacao_erro.jpg?nolink |}}

4 - Na tela de  [[instalacao_web_service#configurar_e-mail|Configuração do e-mail]], o usuário deverá preencher com as informações do servidor de SMTP e clicar no botão "Avançar".

{{ :ws:instalador_email.jpg?nolink |}}

<note important>Algumas aplicações não possuem a funcionalidade do envio de e-mail, assim seu instalador não irá exibir esta tela.</note>

5 - Na tela de "Endereço da API" o usuário deverá preencher a URL da API.

{{ :ws:instalador_api.jpg?nolink |}}

6 - Nesta tela o usuário deverá escolher um caminho para instalação do WebService.

{{ :ws:instalador_pasta.jpg?nolink |}}

7 - Nesta tela é exibido o local de destino do WebService. Se estiver tudo certo clique em "instalar".

{{ :ws:instalador_instalar.jpg?nolink |}}

8 - No final do processo o "Assistente de Instalação" irá realizar a instalação do serviço.

{{ :ws:instalador_servico_sucess.jpg?nolink |}}

Se a Porta de comunicação do WebService já esteja sendo utilizada por um outro serviço ou programa, o serviço será instalado, porém não será possível iniciá-lo. O usuário deverá reinstalar o WebService, mas definindo uma Porta que não esteja sendo usada.

{{ :ws:instalador_port_used.jpg?nolink |}}

9 - Clique em "Concluir" para encerrar o "Assistente de Instalação".

{{ :ws:instalador_concluir.jpg?nolink |}}
===== Instalação sem o "Assistente de Instalação" =====

1 - Navegue até o diretório raiz da instalação do Intellicash.

{{ ::ws:diretorio-raiz.jpg?nolink |}}

2 - Crie um novo diretório com o nome do serviço.

{{ ::ws:diretorio-servico.jpg?nolink |}}

3 - Copie o executavél do serviço e a DLL "dbxfb" para o novo diretório.

{{ ::ws:copia-arquivos.jpg?nolink |}}

4 - Abra o prompt de comando e digite o comando "C:\caminho do executavel /install"

{{ ::ws:instalar-servico.jpg?nolink |}}

5 - Será exibida uma mensagem confirmando que o serviço foi instalado com sucesso.

{{ ::ws:sucesso-instalar-servico.jpg?nolink |}}

6 - Localize o serviço instalado e o inicie.

{{ ::ws:iniciar-servico.jpg?nolink |}}

7 - Após iniciar o serviço, será criado um arquivo com a extensão ".ini" com o mesmo nome do executável. Este arquivo apresenta a seguinte estrutura:

<html>
  <table>
    <tr>
      <td>Campo</td>
      <td>Descrição</td>
      <td>Valor</td>
    </tr>
    <tr>
      <td>Port</td>
      <td>Porta para acesso ao serviço (Qualquer porta pode ser utilizada, desde que não esteja sendo utilizada por outros serviços. ). </td>
      <td>8086(Intelligroup), 8085 (Cotação)</td>
    </tr>
    <tr>
      <td>Path</td>
      <td>Caminho do arquivo de banco de dados.</td>
      <td>Padrão (INTELLISTORE3)</td>
    </tr>
    <tr>
      <td>Pwd</td>
      <td>Senha do banco de dados.</td>
      <td>Padrão (masterkey)</td>
    </tr>
    <tr>
      <td>UserName</td>
      <td>Usuário do banco de dados.</td>
      <td>Padrão (SYSDBA)</td>
    </tr>
    <tr>
      <td>ServerIP</td>
      <td>Endereço do Servidor do Cliente</td>
      <td>IP do Servidor</td>
    </tr>
  </table>
</html>
====== Testes ======
===Ping===
Para saber se o servidor do cliente está online se utiliza o comando ping. Abra o Prompt de Comando e digite ping, o endereço do servidor do cliente e pressione enter.
{{ :ws:ping-02.jpg?nolink |}}

Será enviados pequenos pacotes de dados ao servidor. Repare que é exibido o tamanho do pacote e o tempo que demorou para obter resposta do servidor.
{{ :ws:ping-03.jpg?nolink |}}

Na Estatísticas do Ping. É informado quantos pacotes foram enviados, quantos pacotes recebidos e quantos foram perdidos, depois é demonstrado quanto houve de perda em porcentagem.
{{ :ws:ping-04.jpg?nolink |}}

Neste exemplo podemos concluir que este servidor está online. Houve resposta do servidor dos pacotes enviados e na Estatíscas do Ping houve 0% de perda.

Neste outro caso a estatísticas do Ping retornou que também houve 0% de perda, mas perceba que no envio de pacotes foi retornado: Host de destino inacessível. Isto significa que o servidor **NÃO** está online.
{{ :ws:ping-01.jpg?nolink |}}

Neste caso não foi obtido Resposta e na Estatíscas do Ping houve 100% perda. Logo este servidor **NÃO** está online.
{{ :ws:ping-05.jpg?nolink |}}

===Telnet===
Abra o prompt de comando e digite: telnet endereço do servidor e porta.
{{ :ws:telnet-01.jpg?nolink |}}

Se for exibido uma tela vazia e com o endereço do servidor no titulo da janela significa que o serviço está funcionando.
{{ :ws:telnet-02.jpg?nolink |}}

Caso o Telnet não consiga conectar na porta será exibido a informação que não possivel abrir conexão com o Host.
{{ :ws:telnet-03.jpg?nolink |}}

===Acesso ao Serviço através do browser===
Abra seu navegador de preferência e digite: endereço do servidor, dois pontos e a porta.
{{ :ws:browser-01.jpg?nolink |}}

Se o serviço estiver certo será exibido uma página em branco e no título da aba será o endereço do servidor e a porta.
{{ :ws:browser-03.jpg?nolink |}}

Se não for possível realizar a conexão será exibido falha ao carregamento da página.
{{ :ws:browser-02.jpg?nolink |}}

ou

{{ :ws:browser-04.jpg?nolink |}}
====== Portas ======
<html>
  <table>
    <thead>
      <tr>
        <th>Aplicação</th>
        <th>Porta Padrão</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td>Cotação Online</td>
        <td>8087</td>
      </tr>
      <tr>
        <td>Ecomerce</td>
        <td>8089</td>
      </tr>
      <tr>
        <td>IntelliGroup</td>
        <td>8086</td>
      </tr>
      <tr>
        <td>Liberação</td>
        <td>8085</td>
      </tr>
      <tr>
        <td>Venda Assistida</td>
        <td>8088</td>
      </tr>
    </tbody>
  </table>
</html>

====== Configurar E-mail ======

Na instalação do serviço do **Cotação Online** é pedido as configurações de e-mail. O e-mail configurado irá enviar notificações para os usuários cadastrados e também para o estabelecimento que foi instalado o serviço do **Cotação Online**. Não há necessidade de acessár o e-mail de configuração do serviço, pois sua única função é disparar notificações.

<note important>No Intellicash configure o e-mail padrão da empresa para um e-mail de uso do estabelecimento para receber as notificações.</note>

É recomendado que crie um e-mail (Gmail da Google) específico para o **Cotação Online**. O padrão do E-mail é: __cotacao.(número do CNPJ do Estabelecimento)@gmail.com__ e a senha sendo o CNPJ do Estabelecimento.

Exemplo: cotacao.01234567890123@gmail.com

<html>
  <body>
    <table>
      <thead>
        <tr>
          <th>Configuração</th>
          <th>Valor</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td>Porta</td>
          <td>465</td>
        </tr>
        <tr>
          <td>Host</td>
          <td>smtp.gmail.com</td>
        </tr>
        <tr>
          <td>Nome</td>
          <td>Supermecado X</td>
        </tr>
        <tr>
          <td>Usuário</td>
          <td>cotacao.(número do CNPJ do Estabelecimento)@gmail.com</td>
        </tr>
        <tr>
          <td>Senha</td>
          <td>CNPJ do Estabelecimento *A senha deve estar na base64</td>
        </tr>
        <tr>
          <td>Exige autenticação</td>
          <td>Sim</td>
        </tr>
      </tbody>
    </table>
  </body>
</html>

No arquivo .ini ficará assim:

<html>
  <body>
    <p>[Mail]</p>
    <p>  
      Port=465<br>
      Host=smtp.gmail.com<br>
      Name=Supermercado X<br>
      UserName=cotacao.(número do CNPJ do Estabelecimento)@gmail.com<br>
      Pwd=**********<br>
      Auth=1
    </p>
  </body
</html>

<note important>É necessário a ativar o acesso das aplicações no Gmail.</note>
====== Ativar acesso no E-mail do Gmail ======

Após criar o E-mail no Gmail é necessário ativar o acesso de aplicações na configuração de Conta da Google.

Abra o e-mail criado e clique no botão {{:ws:config-email-bota-menu.jpg?nolink|}} e depois clique em **Conta**, conforme demonstra a figura abaixo.

{{ :ws:config-email-menu-configuracao.jpg?nolink |}}

Clique em **Segurança**, conforme demonstra a figura abaixo.

{{ :ws:config-email-configuracao-seguranca.jpg?nolink |}}

Localize **Acesso a app menos seguro** e depois clique em **Ativar acesso (não recomendado)**, conforme demonstra a figura abaixo.

{{ :ws:config-email-configuracao-permitir-acesso.jpg?nolink |}}

Clique no botão {{:ws:config-email-bota-ativar.jpg?nolink|}} para perimitir o acesso, conforme demonstra a figura abaixo.

{{ :ws:config-email-configuracao-ativar-acesso.jpg?nolink |}}

Feche as configurações do e-mail.

{{ :ws:config-email-configuracao-acesso-ativado.jpg?nolink |}}
Documentação de software

Ferramentas do usuário

Ferramentas do site

Ferramentas da página
