ÍNDICE

Linx DMS Services


O Linx DMS Servicesé um serviço WebService que faz a interação do Linx DMS/BRAVOS existente com a aplicação do tablet ou do site. Ele faz as interações com os sistemas e com o banco de dados, assegurando que as informações e operações realizadas no tablet ou no site sejam consistentes.
Aplicação: A aplicação é a funcionalidade que é executada no tablet ou no site, onde acontece a interação do usuário.
Todas as funcionalidades que rodam na aplicação se comunicam com o serviço, que por sua vez, faz a devida comunicação com o Linx DMS/BRAVOS.
Esta solução tem como objetivo o aprimoramento e inovação dos processos das concessionárias de veículos. É uma ferramenta robusta e pode ser utilizada pelos clientes da Linx que já possuem os pré-requisitos mínimos.

Pré-requisitos


O serviço do Linx DMS Services roda dentro do Internet Information Services (IIS), da Microsoft ou no APACHE.
A estação servidora precisa atender os seguintes requisitos, para execução do serviço:

  • IIS 6.1 ou superior (Quando for utilizar o IIS)
  • Microsoft .NET Framework 4.0 ou superior
  • Importante: As orientações contidas neste manual referem-se ao sistema operacional no idioma português. Se o seu estiver em inglês, vão existir diferenças nas nomenclaturas. Se não encontrar um serviço mencionado em português, tente no idioma do seu sistema operacional.


Passos para Instalação


Para a instalação do Linx DMS Services você deve passar pelos seguintes passos:
*Clique no passo para ver mais detalhes.
Este passo só é necessário no caso de instalação do BRAVOS Mobile

Passo 1: Instalação do IIS



Para instalar o IIS, acesse o painel de controle do Windows.

Figura 1: Tela do Painel de Controle 


Na guia "Programas e Recursos", selecione a seguinte opção:

"Ativar ou desativar recursos do Windows". 

Selecione as opções conforme segue:
Obs.: Para nova instalação marcar TODAS as opções de SERVIÇOS DE INFORMAÇÃO DA INTERNET. 


Figura 2: Tela de Instalação do IIS


Se o IIS já estiver instalado, é muito importante verificar se as opções abaixo estão marcadas. 



Figura 3: Tela de Instalação do IIS




É obrigatório que estejam para que o serviço funcione.
Ao clicar em "OK", aguarde até que a instalação seja concluída. 

Passo 2: Configuração do IIS


Para acessar as configurações do IIS, acesse o Painel de Controle do Windows. 


Figura 4: Tela do Painel de Controle 


Na guia "Sistema e Segurança", selecione a opção "Ferramentas Administrativas".
Acesse o programa "Gerenciador do Serviços de Informações da Internet (IIS)".



Figura 5: Tela do Painel de Controle


O primeiro passo é verificar se o ".NET Framework 4.0" (ou superior) está instalado adequadamente.
Para consultar, clique em "Pools de Aplicativos".



Figura 6: Tela de Configuração do IIS


No exemplo acima, é possível identificar que a versão 4.0 está instalada no servidor.
Caso a versão do Windows seja 64 bits, é necessário habilitar a execução de arquivos 32 bits.
Para habilitar, acesse, na guia de Ações, do Pool de Aplicativos, a opção <Definir Padrões do Pool de Aplicativos...>



Figura 7: Tela de Configuração do IIS


Na opção "Habilitar Aplicativos de 32 Bits", altere para "True", conforme indicado abaixo:



Figura 8: Tela de Configuração do IIS

Agora, vamos verificar se o website está associado ao pool correto. 

Selecione o Default Web Site:



Figura 9: Tela de Configuração do IIS


Selecione a opção "Configurações Básicas":


Figura 10: Tela de Configuração do IIS


Clique em "Selecionar..."



Figura 11: Tela de Configuração do IIS


Selecione a opção "ASP.NET v4.0", conforme indicado abaixo:



Figura 12: Tela de Configuração do IIS


Agora vamos criar um novo aplicativo dentro do IIS.
Para criar, selecione, com o botão direito do mouse, o "Default Web Site", e clique em "Adicionar Diretório Virtual...".


Figura 13: Tela de Configuração do IIS


Preencha conforme exemplo abaixo:



Figura 14: Tela de Configuração do IIS


Clique em <Conectar como...> e informe um usuário Administrador.
Preencha a senha e confirme a senha.
Após, clique em <Testar Configurações> para verificar se a configuração é válida:



Figura 15: Tela de Configuração do IIS


Os módulos CGI e ISAPI precisam estar habilitados, para que a camada de conexão com o banco seja executada.

Para habilitar, acesse a opção "Mapeamentos de Manipulador" no IIS:



Figura 16: Tela de Configuração do IIS



Ao acessar os mapeamentos, é possível configurar quais estão aptos para execução.


Figura 17: Tela de Configuração do IIS


Se os módulos estiverem na guia "Desabilitada", é necessário habilitá-los.
Para habilitar, selecione o módulo CGI ou ISAPI, e clique em "Editar Permissões de Recurso..."



Figura 18: Tela de Configuração do IIS


Marque a opção "Executar", e cliquem em "Ok".



Figura 19: Tela de Configuração do IIS


Neste momento é preciso instalar o Linx DMS Services e, em seguida, será finalizada a configuração IIS.


Passo 3: Instalação do Linx DMS Services


Antes de tudo faça o download do pacote do Linx DMS Mobile ou BRAVOS Mobile no DVI da Linx, confome o seu sistema DMS. Nestes pacotes contêm todos os arquivos necessários para instalação/atualização e manuais. Ao acessar o DVI, após o login, siga o seguinte caminho:
Área de Arquivos Linx > Versão do Sistema – Versão APL > Linx DMS Mobile

Neste local você encontra a última versão do Linx DMS Mobile e BRAVOS Mobile. Basta fazer o download do arquivo compactado.


Observação: Para descompactar utilize o programa 7zip ou WinRar. O programa WInzip não funcionará para este caso.
Você terá acesso à seguinte estrutura de pastas:


Linx DMS:



Figura 20: Tela de Estrutura do Pacote


BRAVOS Mobile:



Figura 21: Tela de Estrutura do Pacote


Observação: Você necessitará deste pacote em diversos momentos durante a instalação. Mantenho-o numa pasta de fácil acesso.
Feito isso, para instalar o serviço Linx DMS Service, é preciso executar o instalador "LinxDMSServices.exe", localizado na pasta LinxDMSServices contida no pacote baixado, no servidor de aplicação Windows. Durante a instalação do serviço IIS, ele sofrerá uma pausa que será reiniciado logo após.



Figura 22: LinxDMSServices.exe


Este instalador deve ser executado no servidor Windows onde está o IIS. Para realizar a instalação, basta seguir selecionando a opção <Next ou Avançar>, conforme idioma do Windows. Caso o usuário tenha feito a instalação padrão do IIS, o instalador indicará que a instalação deve ser realizada na pasta <C:\Inetpub\>. O serviço apontará automaticamente para a pasta inserida neste momento, veja as telas a seguir:



Figura 23: Linx DMS Services – Programa de Instalação




Figura 24: Linx DMS Services – Programa de Instalação


Após a instalação do serviço, será aberta automaticamente a tela referente às configurações do WebService:


Figura 25: Linx DMS Services – Programa de Instalação



Figura 26: Linx DMS Services – Programa de Instalação



Figura 27: Linx DMS Services – Programa de Instalação



Figura 28: Linx DMS Services – Programa de Instalação


Este mesmo programa poderá ser acessado novamente através do caminho <Iniciar > Programas > Linx DMS Services > Configurações do Serviço>. Neste programa é possível parametrizar os dados do Linx DMS/BRAVOS, a conexão com o banco de dados e outros parâmetros das funcionalidades da aplicação.

Passo 4: Configurações finais do IIS


IMPORTANTE
Os arquivos ".dll", referentes aos módulos contratados, precisam estar na lista de módulos permitidos do IIS.
Para efeito de manual criamos o termo "NOME_DA_DLL_DO_PACOTE.dll" onde o "NOME_DA_DLL_DO_PACOTE.dll" varia de acordo as regras abaixo:
Para Linx DMS Mobile / BRAVOS Mobile use LinxDmsMobile.dll
Para Pesquisa de Caixa VW use WSPesquisaCaixaVW.dll
Para o caso de possuir os dois módulos, as duas dlls devem estar permitidas no IIS.
Na tela inicial do IIS, clique duas vezes sobre a opção "Restrições de ISAPI e CGI".


Figura 29: Tela de Configuração do IIS



No canto superior direito da tela, clique na opção "Adicionar".



Figura 30: Tela de Configuração do IIS


Selecione o arquivo "NOME_DA_DLL_DO_PACOTE.dll", conforme a tela abaixo.
(Exemplo: C:\Inetpub\Services\WSFeedVW.dll)



Figura 31: Tela de Configuração do IIS


Ainda na tela de Restrições do ISAPI e CGI, clique em "Editar Configurações e Recurso...".



Figura 32: Tela de Configuração do IIS


Marque as duas opções conforme exemplo abaixo:



Figura 33: Tela de Configuração do IIS


Passo 5: Configuração do Banco de dados


A configuração do Banco de Dados deve ser:



Figura 34: Linx DMS Services – Programa de Instalação


  • Tipo: Oracle ou SQL Server;
  • Host: Caso o banco de dados seja SQL Server, preencha com o IP do servidor;
  • Database: Nome da base no Banco de Dados;
  • Usuário: Usuário do banco (usuário padrão);
  • Senha: Senha do usuário;
  • DMS:Linx DMS.
  • Log Ativo: Marque esta opção para ativar o log das requisições. Ela pode ser utilizada caso encontre alguma dificuldade na operação. O serviço gera um log dentro do diretório C:\inetpub\services, com o nome de arquivo logAAAAMMDD.txt, onde <AAAAMMDD> é a data atual no formato ANO/MÊS/DIA. Envie o arquivo gerado em caso de atendimento no suporte.
  • Armazenamento das imagens de veículos: As soluções mobile da Linx (Linx DMS Mobile e BRAVOS Mobile) permitem bater fotos com os dispositivos. Configure o diretório de destino das imagens gravadas.

Com essas configurações preenchidas, é possível testar a conexão clicando no botão .
A próxima parte das configurações diz respeito às funcionalidades das aplicações, onde deverá ser configurado conforme cada aplicação.
Depois que todos os campos foram preenchidos e configurados, basta clicar no botão <OK>.
Depois do programa de configurações fechado, será aberto o programa Gerenciador de Licenças Mobile. Por hora, feche este programa. A gestão de licenças será feita posteriormente somente se for utilizado o módulo Linx DMS Mobile ou BRAVOS Mobile.
De volta ao instalador, finalize-o clicando no botão <Finalizar>.
Para terminar, reinicie o Windows para que as novas configurações sejam carregadas corretamente. 

Passo 6: Configurações específicas do BRAVOS Mobile


Se o produto a ser instalado é o BRAVOS Mobile, você deve seguir mais estas duas etapas:


1 - Configurações do IIS específicas para utilização do aplicativo "BRAVOS Mobile":

Acessar o item <Default Web Site>.



Figura 37: Tela de Configuração do IIS


Clicar, no lado direito da tela, na opção <Configurações Básicas>.



Figura 38: Tela de Configuração do IIS


Anotar o nome do campo "Pool de Aplicativos".
No caso acima, é o "DefaultAppPool".
Acessar a guia "Pool de Aplicativos":



Figura 39: Tela de Configuração do IIS


Localizar o pool identificado no passo anterior, e clicar em "Configurações Avançadas":



Figura 40: Tela de Configuração do IIS


Alterar a propriedade "Identidade" para "Local System", conforme indicado abaixo:



Figura 41: Tela de Configuração do IIS

2 - Configurações extras para utilização do PPSo através do BRAVOS Mobile


  • O pré-requisito é que o PPSo já tenha sido configurado no BRAVOS, e a comunicação esteja funcionando;
  • O arquivo "LinxPPSO.dll", contindo na pasta de instalação do BRAVOS no servidor, deve ser copiada para a pasta "C:\Windows\SysWOW64" ou "C:\Windows\System32" (de acordo com o sistema operacional) da máquina onde está sendo instalado o serviço, e ela sempre deverá ser atualizada com a última atualização disponível;
  • Com a utilização da consulta PPSo através do BRAVOS Mobile, será gravado um log na pasta "C:\inetpub\services".


Passo 7: Testes do serviço


Para verificar se a camada de conexão com o banco de dados está em funcionamento, abra o navegador, e informe a seguinte url:
1 – Linx DMS Service:
http://localhost/services/LinxDMSMobile.dll
Exemplo: 


Figura 35: Tela de Teste do Serviço


Se todas as configurações estiverem corretas, a mensagem acima será apresentada.
Uma vez que a camada de conexão com o banco estiver ativa, o Linx DMS Service estará pronto para uso.


2 – Pesquisa Caixa VW:
http://localhost/Services/WSPesquisaCaixaVW.dll

Se todas as configurações estiverem corretas, a mensagem abaixo será apresentada.


Figura 36: Tela de Estrutura do Pacote


Obs.: Verificar a Porta usada no IIS para fazer o teste de acesso ao caminho (se a Porta for diferente de 80, deve informar a respectiva porta no caminho. Por exemplo: http://localhost:8080/Services/WSPesquisaCaixaVW.dll ).

FAQ de erros do IIS



Figura 42: Tela de Erro de configuração do IIS


Caso a mensagem seja: Atributo não reconhecido "targetFramework", é porque o pool não está configurado para a versão 4.0.
Revise neste documento como ajustar a versão para a 4.0.


Figura 43: Tela de Erro de configuração do IIS


Caso a mensagem seja "Could not load file or assembly...", é porque o IIS não está configurado para aceitar módulos 32 bits.
Verifique nesta documentação como realizar esta configuração.



Figura 44: Tela de Erro de configuração do IIS


No exemplo acima, o arquivo ".dll", exemplo: LinxDmsMobile.dll, não está na lista de arquivos permitidos para execução.
Consulte este documento para permitir módulos CGI não especificados.

Caso o sistema tente realizar o download do arquivo ".dll", exemplo: LinxDmsMobile.dll, é porque os módulos CGI e ISAPI não estão ativos.



Figura 45: Tela de Erro de configuração do IIS


Consulte esta documentação para verificar como habilitá-los.
Caso já exista o APACHE rodando no servidor, ou outro serviço que esteja utilizando a porta 80, é possível alterar a porta do IIS.
Para alterar a porta, acesse, no console de gerenciamento do IIS, a opção "Associações":



Figura 46: Tela de configuração do IIS


Altere para a porta desejada:



Figura 47: Tela de configuração do IIS



Após o ajuste, reinicie o serviço para aplicar a mudança.



Figura 48: Tela de configuração do IIS


A causa deste problema é que o "ASP.NET" não está completamente instalado no servidor.
Para corrigir este problema, acesse o prompt de comando, em modo administrador, e execute o seguinte comando:
Em servidores 64 bits:
%windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -i
Em servidores 32 bits:
%windir%\Microsoft.NET\Framework\v4.0.21006\aspnet_regiis.exe -i