Linx Webservice Cliente - Manual de Instalação e Configuração

SAVE OFFLINE

Manual de Instalação e Configuração do Webservice Linx Clientes

Data: 05/12/2011 1. Introdução 

O que é Webservice Linx Clientes? Trata-se de um serviço web desenvolvido com o objetivo de importar para o cadastro oficial de clientes dos DMS Linx registros de clientes pessoa física que nascem no Portal Nissan.



Quem deve utilizar esta solução? Concessionárias Nissan.



Como é composta a solução? A solução é composta de dois módulos: - O Webservice; - Monitor para acompanhamento das importações.



Pré-requisitos técnicos para funcionamento: - Sistema operacional: Windows; - Versões suportadas: XP, Vista, Seven, 2003 Server 32-bits (recomendado); - Internet Information Server (IIS); - Conexão com o banco de dados DMS: Oracle, Firebird, SQL Server e Informix; Observação: Para clientes do DMS SISDIA, sugerimos que a instalação deste produto seja feita no servidor onde está instalada a solução NDDigital. Logo, o client do Informix deve estar devidamente instalado e configurado nesta máquina, apontando para o ambiente de produção (SetNet32).



Importante: entre em contato com a Nissan do Brasil para pegar a URL do Portal Nissan, a qual você deverá dar direito de acesso externo (via Internet) à sua rede: - Liberar no proxy e no firewall a URL para entrada de requisições http vindas do servidor Nissan. - Em seguida você deve passar à Nissan do Brasil o IP Externo ou DNS que aponte para o WebService, que está instalado em seu servidor IIS.

2. Instalação do Webservice de Clientes 2.1.

Descompactar o pacote de instalação em um diretório temporária da máquina onde o serviço será instalado;

2.2.

Criar a pasta WsLinxDMS no diretório do IIS (C:\Inetpub) e mover o arquivo nesta pasta;

2.3.

Criar a pasta C:\WsLinxDMS e mover os arquivos abaixo para dentro desta: -

2.4.

WLSConfig.exe TestWSLinxNissan.exe WLSMonitor.exe Clientes_1.0.xsd TiposBasico_1.0.xsd RetornoClientes_1.0.xsd

Acessar o IIS (menu Iniciar, Painel de Controle, Ferramentas Administrativas), e criar o diretório virtual chamado WsLinxDMS utilizando as seguintes configurações: - Alias: WsLinxDMS - Caminho: aponte para o diretório C:\Inetpub\WsLinxDMS - Permitir a opção de executar

2.5.

Se o Windows do servidor for 32-bits, copie os arquivos abaixo na pasta C:\Windows\System32. Caso o servidor seja Windows 64-bits, então copie os arquivos abaixo na pasta C:\Windows\SysWOW64. -

2.6.

msxml5.dll msxml5r.dll midas.dll dbexpoda40.dll dbexpsda40.dll dbexpida40.dll dbxinf.dll

Validação Validação Driver de Driver do Driver do Driver do Driver do

de schema XML de schema XML acesso a banco banco Oracle banco SQL Server banco Firebird banco Informix

Vá no menu Iniciar, Executar, digite o comando cmd e botão OK. Abrirá uma tela de prompt do DOS. Iremos registrar algumas DLL: Para Windows 32-bits: - C:\> regsvr32.exe C:\Windows\System32\msxml5.dll - C:\> regsvr32.exe C:\Windows\System32\midas.dll Para Windows 64-bits: - C:\> regsvr32.exe C:\Windows\SysWOW64\msxml5.dll - C:\> regsvr32.exe C:\Windows\SysWOW64\midas.dll

2.7.

Se necessário, dar permissão de acesso aos arquivos xsd para os usuários do IIS: IUSR_[nome do computador] e IWAN_[nome do computador]

2.8.

Acione o menu Iniciar, Painel de Controle, Ferramentas administrativas e abra o Gerenciador dos Serviços de Informações da Internet (IIS);

2.9.

Clique no item de menu da árvore de itens ao lado esquerdo chamado Extensões de Serviços da Web, conforme figura abaixo. Em seguida ao lado direito verifique o item Todas as Extensões ISAPI Desconhecidas. Ele deve estar com o status Permitido. Se não estiver clique sobre este item e clique no botão .

3. Teste para saber se o procedimento de instalação do WebService está correto 3.1.

Abrir o browser Internet Explorer;

3.2.

Acessar a URL: http://localhost/WsLinxDMS/WLSServer.dll e verificar a página abaixo é carregada:

Atenção: se o sistema operacional da sua máquina é 64-bits e ao invés da página acima ser exibida, apareceu uma página com o erro: "%1 is not a valid Win32 application”, significa que você precisa realizar mais alguns procedimentos que permitam seu IIS (Internet Information Server) executar aplicações 32-bits. Seguem os passos: 3.3.

Realizar o download do Microsoft .NET Framework Version 2.0 Redistributable Package (x64) no desktop (área de trabalho) do servidor onde o WebService está instalado, através da url: http://www.microsoft.com/download/en/details.aspx?displayl ang=en&id=6523

3.4.

Execute o programa NetFx64.exe. demorar alguns minutos.

Essa

atualização

pode

3.5.

Após a instalação do pacote NetFx64.exe, clique em Iniciar, em Executar, digite cmd e clique em OK.

3.6.

Digite no prompt do DOS, o seguinte comando para habilitar o modo de 32 bits: cscript %SYSTEMDRIVE%\inetpub\adminscripts\adsutil.vbs SET W3SVC/AppPools/Enable32bitAppOnWin64 1 Tecle para que o comando seja executado.

3.7.

Digite o seguinte comando para instalar a versão do ASP.NET 2.0 (32 bits) e instalar os mapas de script na raiz do IIS e em: %SYSTEMROOT%\Microsoft.NET\Framework\v2.0.50727\aspnet_reg iis.exe -i Tecle para que o comando seja executado.

3.8.

Certifique-se de que o status do ASP.NET versão 2.0.50727 (32 bits) esteja definido para Permitido na lista Extensão de Serviço Web no Gerenciador dos Serviços de Informações da Internet (menu Iniciar, Painel de Controle, Ferramentas Administrativas).

4. Configuração do WebService Linx DMS 4.1.

Execute o programa C:\WsLinxDMS\WLSConfig.exe. Aparecerá a janela abaixo, para realização das configurações de acesso a banco de dados e permissão de acesso ao webservice:

4.2.

Banco de dados Nesta sessão tratamos dos dados necessários para que o serviço se conecte ao banco de dados do DMS. - Tipo: Selecione o banco do DMS - Host: este campo só será habilitado, caso o tipo de banco de dados for ou . No caso do banco Informix, no campo deve ser informado o nome da instância de produção. Exemplo: ol_standard - Database: Informe o nome da base de dados do DMS - Usuário: Informe o usuário de acesso ao banco de dados - Senha: Informe a senha do usuário de acesso ao banco de dados

4.3.

Permissão de acesso Nesta sessão cada concessionário criará os dados abaixo que deverão ser passados à Nissan do Brasil, para que possa parametrizá-los no Portal Nissan. Trata-se de dados que garantirão a segurança da integração, uma vez que o WebService utilizará esses parâmetros para checar a requisição de cliente enviada pelo Portal Nissan. - Usuário: Crie um nome de usuário que o portal deverá usar para acessar seu WebService; - Senha: Crie a senha de acesso do usuário de acesso ao WebService; - Chave de acesso: sugerimos que coloque seu dealer number como chave, mas você pode informar outro dado se quiser.

5.

Testando dentro da sua rede se o WebService está respondendo 5.1.

Na pasta C:\WsLinxDMS execute o programa TestWSLinxNissan.exe, o qual foi feito para simular o envio de clientes do Portal Nissan ao DMS. A seguinte tela se abrirá:

No campo você não precisa mexer, visto que o nome do servidor está localhost, o que significa que este programa deve ser executado na mesma máquina onde o WebService está instalado. Para o campo copie XML abaixo e cole neste campo: userpas swordkeyaccessFilipe NévolaF 650522078081111F1987-0909Aveni daUm180apt 3Centro12395000< Municipio>São PauloSP12 [email protected]< /Contato>

Em seguida você deve substituir no XML os parâmetros: - user pelo nome do usuário que você criou no passo 4.3; - password pela senha criada no passo 4.3; - keyaccess pela chave de acesso que você criou no passo 4.3. Logo, ficará assim:

5.2.

Próximo passo agora é clicar no botão e verificar no campo se a mensagem do protocolo retornado aparece assim: 001 Informação recebida com sucesso! F 65052207808 010 Cadastro do cliente atualizado.

Se este protocolo apareceu pra você, significa que a instalação do WebService foi bem sucedida. Caso contrário reveja todos os passos do manual.

6. Instalação do monitor de clientes do Portal Nissan

gerenciamento C:\WsLinxDMS

de e

recepção localize

de o

dados

de

6.1.

Vá até a pasta WSMonitor.exe;

executável

6.2.

Clique com o botão direito sobre este arquivo e selecione a opção Copiar;

6.3.

Agora vá até o desktop (área de trabalho) da máquina, clique com o botão direito e selecione a opção Colar atalho

6.4.

A partir do atalho dê um duplo clique no ícone para abrir o monitor

6.5.

Será carrega a tela a seguir:

6.6.

Vá até o menu Consulta, Andamento dos serviços e a seguinte tela aparecerá:

Nesta tela são exibidos todos os registros de clientes que foram exportados do Portal Nissan para o DMS. Existe a coluna , a qual indica se o registro foi recebido e ainda não importado para dentro do DMS ou a o status de erro (quando a linha ficar vermelha), significando que a rotina do DMS tentou importar os dados do cliente, porém, por algum erro de consistência o mesmo não pode ser efetivado no cadastro oficial do DMS. No caso de erro no registro, você pode clicar com o botão direito sobre o cliente e aparecerão duas opções: - Excluir cadastro: usado quando você quer excluir registro para voltar ao Portal e corrigir algum dado para reimportá-lo; - Alterar situação: usado quando alguma inconsistência apontada na coluna está relacionada a algum parâmetro do DMS que necessita ser configurado para que o registro possa ser importado com sucesso. Está ação volta o registro do cliente para a situação “Pendente de Importação” e, portanto, a rotina automática o reimportará para efetivar o registro no DMS. Observação: note que na barra de ferramentas dessa tela, o monitor está configurado para atualizar a situação dos registros de 5 em 5 segundos. Quando um registro de cliente for importado com sucesso para dentro do DMS, o mesmo sairá do monitor, significando que a importação executou com sucesso.

7.

Ativação de Crontab para DMS SISDIA (a partir da versão 04.45) 7.1.

Entre no servidor de aplicação SISDIA via putty usando o usuário root;

7.2.

Vá até o diretório /root/bin e edite o arquivo Run_NSDF.sh 7.2.1. Procure pelo comando INFORMIXSERVER=ol_oficial e substitua a variável ol_oficial pelo nome da sua instância de produção. Exemplo: INFORMIXSERVER=ol_standard 7.2.2. Procure pelo comentário ## Necessaria para o RH-EL ES Versao 4. Algumas linhas abaixo, você encontrará o comando cd /sisdia/oficial, o qual deverá ser substituído por: cd + o caminho do diretório de produção do SISDIA Exemplo: ## Necessaria para o RH-EL ES Versao 4 cd /ext/sisdia 7.2.3. Salve as alterações realizadas no arquivo Run_NSDF.sh e o feche.

7.3.

Execute no prompt do Linux o comando crontab –e

7.4.

Será exibida uma lista com comandos de crontab. Vá até o final do arquivo e acrescente a seguinte linha:

0-59/15 * * * * sh /root/bin/Run_NSDF.sh >/tmp/Run_NSDF1.log 2>Run_NSDF2.log

7.5.

Salve o arquivo de crontab e saia do mesmo. Agora o programa de importação automática do SISDIA (NSDF3000) está pronto para executar de 15 em 15 minutos. Sem este procedimento os registros de clientes recebidos pelo WebService não serão importados para o SISDIA.