Manual com orientações de instalação e configuração do processo ILSVW.
Produto | Bravos |
|---|---|
Menu | |
Data |
|
Autor | Distribuição Linx DMS |
Área | P&D DMS |
Esse processo se destina a todas as concessionárias VW que utilizam o Bravos.
Requisitos do sistema
As máquinas de integração que ficarão junto a cada BTacBox, devem atender os seguintes requisitos:
1.Uma máquina dedicada, exclusiva para cada revenda, com sistema operacional Windows XP SP2 ou superior, que esteja disponível na rede 24 horas por dia, 7 dias da semana. Esta máquina deve possuir:
a. Mínimo um processador dual core, 2 GB de memória RAM e 100 GB de espaço disponível no disco rígido;
b. Acesso ao DMSBackbone, através da rede do sonicwall;
c. Acesso via rede/internet ao servidor de integração.
O servidor de integração que ficará junto ao banco de dados, deve atender os seguintes requisitos:
2.Uma máquina dedicada (ou servidor compartilhado), com sistema operacional Windows XP SP2 ou superior, que esteja disponível na rede 24 horas por dia, 7 dias da semana. Esta máquina deve possuir:
a. Mínimo um processador dual core, 2 GB de memória RAM e 100 GB de espaço disponível no disco rígido;
b. Acesso ao Banco de dados do sistema BRAVOS, através de uma rede local.
BtacBox
A BtacBox é o hardware responsável pela comunicação entre o sistema de integração VW e o sistema da própria VW. Cada revenda possui uma BtacBox, que fornece acesso a sistemas como o ElsaPro e o SAGA/2. Baseado nisso, para que uma estação de trabalho possa executar o ElsaPro, por exemplo, é necessário que ela esteja na mesma rede da BtacBox.
Foto da BtacBox
Estrutura do sistema
Exemplo do diagrama estrutural – Caso 1
O diagrama abaixo representa a estrutura onde o banco de dados está na mesma rede local de uma das revendas. As demais revendas acessam o banco de dados de forma remota.
Exemplo do diagrama estrutural – Caso 2
O diagrama abaixo representa a estrutura onde o banco de dados está em uma estrutura separada, como por exemplo, um DataCenter. Neste caso, todas as revendas acessam o banco de dados de forma remota.
Comunicação BRAVOS x BtacBox
Em nenhum momento, o BRAVOS faz acesso diretamente a BtacBox. Como pode ser visto nos diagramas acima, todos os processos do BRAVOS comunicam com o banco de dados e o sistema de integração que faz a comunicação entre o banco de dados e as BtacBox.
Porém, é importante ressaltar, que em algumas telas do BRAVOS existe o botão "ElsaPro" (Agenda Oficina, Atendimento Oficina e Manutenção de Ordem de Serviço). Ao clicar sobre esse botão, é aberto o ElsaPro, já passando como parâmetro o atendimento/OS atual. Baseado no que foi citado no capítulo referente ao "BTACBOX 2", que para executar o ElsaPro em uma estação de trabalho é necessário estar na mesma rede da BtacBox, temos como verdadeira a seguinte afirmação:
Para abrir o ElsaPro, clicando no botão "ElsaPro" do sistema BRAVOS, é necessário que o BRAVOS esteja executando na mesma rede da BTacBox.
Nos casos onde o banco de dados não fica localmente na revenda, a solução que existe para essa situação é a utilização do BRAVOS 3 camadas.
Caso o usuário não vá utilizar o botão "ElsaPro", mesmo que esse usuário faça processos que vão integrar com a VW (atendimento oficina, abertura OS, emissão NF, etc.) ele pode utilizar qualquer meio de acesso remoto, como por exemplo o Terminal Server.
Programas/Arquivos necessários
ILSAppForms.exe ou ILServer.exe -> Servidor de aplicação
ServiceMonitor.exe
MonitorILS.exe
ILService.exe
SrvListener.exe
Conexao.dat
ConexaoServidor.dat
dbxora.dll
borlndmm.dll
LDUtils01.dll
midas.dll
dbexpoda40.dll
dbexpsda40.dll
ILCLinxCollector.dll
ILCLinxListnerX.dll
ILCLinxCollector.ini
ILCLinxListnerX.ini
ILConfig.exe
AtualizaIntegracaoVWCompleta.exe
AtualizaIntegracaoVWExpressa.exe
ArquivosDN.dat
ArquivosServer.dat
AtuILSDN.exe
AtuILSServer.exe
Programas externos
httpd-2.2.25-win32-x86-no_ssl.msi (Instalador Apache)
Instalação
Criação das pastas
Criar as pastas \VW e \VW\Services, nas máquinas de integração e no servidor de integração.
Instalação do Servidor Apache
O Apache deve ser instalado nas máquinas de integração e no servidor de integração, conforme descrito nos itens 3.1 e 3.2 deste manual.
Execute os passos a seguir para instalação/ativação do Apache:
Utilizar o instalador do Apache, disponível no pacote de implantação do sistema de integração VW (httpd-2.2.25-win32-x86-no_ssl.msi).
Executar o arquivo de instalação do Apache:
Crie uma pasta no computador onde serão colocadas as dlls para consumo dos serviços da VW (ILCLinxCollector.dll e ILCLinxListnerX.dll). Exemplo: C:\VW\Services;
Após a instalação, acessar a pasta onde foi instalado o Apache e acessar a pasta de configuração.
3. Exemplo: C:\Program Files (x86)\Apache Software Foundation\Apache2.2\conf;
a. Faça uma cópia de segurança do arquivo de configuração <httpd.conf>;
b. Edite o arquivo de configuração com um editor de texto qualquer e altere os dados conforme abaixo:
- Localize a linha contendo o texto #LoadModule isapi_module modules/mod_isapi.so e retire o caractere # do início;
- Altere a linha Listen 80 para Listen 8080;
- Adicione no final do arquivo os comandos abaixo:
<IfModule mod_alias.c>
AddHandler isapi-isa .dll
Alias /LinxDms "C:\Vw\Services"
<Directory "C:\Vw\Services">
Options ExecCGI
AllowOverride None
Order allow,deny
Allow from all
ISAPIReadAheadBuffer 262144
</Directory>
</IfModule>
- Certificar-se de que a pasta informada na linha Alias /LinxDms "C:\Vw\Services" é a mesma criada no item 5.1 deste manual.
Inicie o serviço do Apache pelo Menu Iniciar ou pela Barra de Tarefas do Windows:
Para mais informações referentes à instalação do Apache, acessar o site:
http://httpd.apache.org/docs/2.2/platform/windows.html;
Observação:
Em caso de Windows 7 e versões mais recentes, pode ocorrer erro na inicialização do serviço que pode ser resolvido com os passos abaixo:
Passo 1:
Selecione a opção Programs and Features no Painel de Controle.
Passo 2:
Selecione, ao lado esquerdo, Turn Windows Features on or off. Com isso, aparecerá a janela de Windows Features. Aguarde até as informações serem carregadas.
Passo 3:
Expandir as informações da opção Microsoft .NET Framework 3.5.1, selecionar as opções de HTTP e salvar as alterações.
Copiar o arquivo <ILCLinxCollector.dll> para a pasta do serviço Web (\vw\services), conforme definido na instalação do Apache
Teste se o WebService esta funcionando, através de um navegador, informando o caminho conforme exemplo abaixo:
http://localhost:8080/LinxDms/ILCLinxCollector.dll:
Após o teste, caso a instalação seja em uma máquina de integração, o arquivo <ILCLinxCollector.dll> deve ser excluído. Se a instalação for em um servidor de integração, o arquivo pode ficar na pasta \vw\services.
Nova instalação – Servidor de Integração
1. Entrar no FabricaVW e fazer os passos deste item para todas as revendas que irão integrar com a VW.
Ir em Fábrica VW > Parâmetros> Aba Geral
Informar o número DN da revenda, com 5 dígitos.
Depois entrar na aba Integrações.
a.No campo "URL abertura ElsaPro", informar: https://grp.cpn.vwg/elsapro/elsaweb/ctr/DP/loadJobFromExternal?DMS_ORDER_ID=:CONTATO&JOB_DATE=:DTA_CONTATO
b.No campo <Tipo de Integração SAGA/2>, informar se o sistema está integrando com o SAGA/2 é de produção ou de testes;
c.Nos campos do grupo <Incluir serviço do ElsaPro>, para os serviços incluídos pelo ElsaPro em um atendimento que já tem OS gerada, informe se estes serviços serão incluídos diretamente na OS ou em um Orçamento;
d.Nos campos do grupo <Inclusão de Serviços>, informe os dados necessários para a inclusão de novos serviços vindos dos sistemas VW;
e.No campo <Diretório de atualização dos arquivos por DN>, informar o diretório de onde serão copiados os arquivos de instalação/atualização por DN. Esse diretório tem que ser visível pela máquina de integração e também pelo servidor de integração;
f.No campo <Diretório de programas por DN>, informar o diretório onde ficarão os programas na máquina de integração, por padrão esse diretório é o \VW. Este é o mesmo diretório criado no item 5.1 deste manual;
g.No campo <Diretório de serviços web por DN>, informar o diretório onde ficarão as dlls que serão executadas como serviço web na máquina de integração, por padrão esse diretório é o \VW\Services. Este é o mesmo diretório criado no item 5.1 deste manual;
h.No campo <Tipo Serviço Web>, informar o servidor web utilizado (Apache ou IIS). O recomendado é utilizar o Apache.
2. No servidor de integração, criar a pasta \VWAtualiza e copiar todo o conteúdo do pacote de instalação/atualização para esta pasta;
3. Renomear o arquivo <ConexaoServidor_Exemplo.dat> que está dentro da pasta \VWAtualiza para <ConexaoServidor.dat>. Editar este arquivo e ajustar os seus parâmetros conforme exemplo que segue:
//Tipo do banco de dados (ORACLE ou SQLSERVER)
[BANCODADOS\]=ORACLE
//Nome do banco de dados
//Exemplo Oracle: APOLLO
//Exemplo SQL Server: 192.168.0.1:APOLLO
[DATABASE\]=APOLLO
//Porta onde vai rodar o programa servidor (Esta porta deve ser liberada no firewall, caso a revenda utilize algum). A palavra INTEGRATIONLAYER do exemplo abaixo é fixa, o que pode ser configurado é o número da porta, que no caso abaixo está como 234
[PORTA\]=INTEGRATIONLAYER:234
//Diretório onde será gravado o log do servidor de integração
[DIRLOG\]=c:\temp\
//Usuário de conexão com o banco Oracle
[USUARIO_ORACLE\]=CNP
4. Renomear o arquivo <Conexao_Exemplo.dat> que está dentro da pasta \VWAtualiza para <Conexao.dat>. Editar este arquivo e ajustar os seus parâmetros conforme exemplo que segue:
//Deixar a versão que está
[VERSAOEXE\]=1.0.0.0
//Deixar fixo DATASNAP
[BANCODADOS\]=DATASNAP
//IP:Porta onde está rodando o servidor de integração
[DATABASE\]=192.168.0.2:234 \\
5. Executar o programa <AtuILSServer.exe>, que está dentro da pasta \VWAtualiza, no servidor de integração.
6. Clicar no botão <Instalar/Atualizar>.
7. Ajustar/informar os parâmetros da tela conforme as instruções abaixo:
a. No campo <Pasta de atualização onde serão copiados os arquivos que ficarão junto a BTacBox>, informar o diretório para onde serão copiados os arquivos de instalação/atualização por DN. Será deste diretório que cada DN (máquina de integração) irá buscar os arquivos para instalação/atualização;
b. No campo <Pasta dos programas servidores (mesma rede do servidor de Banco de Dados)>, informar o diretório onde ficarão os programas no servidor de integração, por padrão esse diretório é o \VW;
c. No campo <Pasta dos serviços web servidores (mesma rede do servidor de Banco de Dados)>, informar o diretório onde ficarão as dlls que serão executadas como serviço web no servidor de integração, por padrão esse diretório é o \VW\Services;
d. No campo <Tipo Servidor de Aplicação>, informar se o servidor de aplicação será rodado como uma aplicação (ILSAppForms.exe) ou será um serviço do Windows (ILServer.exe). Essa opção fica a escolha do cliente. Se para o cliente, for importante o fato de ao reiniciar o servidor de integração, que o servidor de aplicação seja iniciado automaticamente, este campo deve ser configurado como serviço. Caso isso não seja importante, o servidor deve ser configurado como aplicação;
e. No campo <Tipo Serviço Web>, informar o servidor web utilizado (Apache ou IIS). O recomendado é utilizar o Apache;
f. No campo <Script a ser rodado>, informar o tipo de script a ser rodado. <AtualizaIntegracaoVWCompleta.exe>, recomendado para novas instalações e <AtualizaIntegracaoVWExpressa.exe>, recomendado para atualizações;
8. Clicar no botão <Continuar> e aguardar até a mensagem "Instalação / Atualização realizada com sucesso!" apareça na barra de progresso.
9. Caso a revenda utilize uma senha para conexão com o banco de dados, diferente da senha padrão, é necessário copiar manualmente o arquivo senhabd.dat que a revenda utiliza para dentro da pasta \VW\Services\.
Nova instalação – Máquina de integração
Na máquina de integração o UAC (Controle de Conta de Usuário) do windows deve ser desabilitado. Como a forma de fazer isso varia de acordo com a versão do windows, caso quem instale tenha alguma dúvida de como fazer isso, basta pesquisar na internet por (desativar UAC windows) incluindo a versão que se queira desativar o controle.
1. Na máquina de integração, criar a pasta \VWAtualiza e copiar todo o conteúdo do pacote de instalação/atualização para esta pasta;
2. Renomear o arquivo <Conexao_Exemplo.dat> que está dentro da pasta \VWAtualiza para <Conexao.dat>. Editar este arquivo e ajustar os seus parâmetros conforme exemplo que segue:
//Deixar a versão que está
[VERSAOEXE\]=1.0.0.0
//Deixar fixo DATASNAP
[BANCODADOS\]=DATASNAP
//IP:Porta onde está rodando o servidor de integração
[DATABASE\]=192.168.0.2:234
3. Executar o programa <AtuILSDN.exe> e clicar no botão <Instalar/Atualizar>;
4. Na tela que pede o DN da revenda, informe o DN da revenda referente à BTacBox, que está sendo comunicada e clique em <OK>;
Caso os serviços de integração não estiverem instalados nesta máquina, os passos abaixo serão solicitados.
Informe o endereço abaixo na tela que segue, substituindo o NNN.NNN.NNN.NNN pelo IP do servidor de integração:
http://NNN.NNN.NNN.NNN:8080/LinxDms/ILCLinxCollector.dll
Informe os campos abaixo conforme segue:
Servidor: IP do servidor de integração.
Porta: Porta de comunicação do servidor de integração. Mesma porta informada no item 5.3, subitem 3, parâmetro PORTA.
Número DN: DN da revenda.
Após clicar em <OK>, a mensagem a seguir deverá ser exibida:
Informe os campos abaixo conforme segue:
Servidor: IP do servidor de integração.
Porta: rta de comunicação do servidor de integração. Mesma porta informada no item 5.3, subitem 3, parâmetro PORTA.
Número DN: DN da revenda.
Após clicar em <OK>, a mensagem abaixo deverá ser exibida:
5. Aguardar até a mensagem "Instalação / Atualização realizada com sucesso!" apareça na barra de progresso.
Configurações
Configuração do DMS-Backbone
O DMS-Backbone é o software que roda na BTacBox. Através do DMS-Backbone é possível configurar alguns itens da BtacBox. No DMS-Backbone, é necessário configurar os serviços da tela abaixo. Para isso, basta fazer login no DMS-Backbone, acessar a opção <Services> e incluir os serviços conforme consta na tela a seguir:
Abaixo estão os serviços da tela acima, para facilitar a operação de cadastro e permitir copiar do pdf e colar no DMS-BackBone.
BusinessPartnerData http://10.193.123.117:8080/LinxDms/ILCLinxListnerX.dll/BusinessPartnerData
Linx BusinessPartnerData
ClaimProcessing http://10.193.123.117:8080/LinxDms/ILCLinxListnerX.dll/claimprocessing
Linx ClaimProcessing
CustomerVehicleData http://10.193.123.117:8080/LinxDms/ILCLinxListnerX.dll/customervehicledata
Linx CustomerVehicleData
ShopData
http://10.193.123.117:8080/LinxDms/ILCLinxListnerX.dll/ShopData
ShopData
SparepartOrder http://10.193.123.117:8080/LinxDms/ILCLinxListnerX.dll/workshoporder
SparepartOrder
WorkshopOrder
http://10.193.123.117:8080/LinxDms/ILCLinxListnerX.dll/workshoporder
Linx WorkshopOrder
Da tela relacionada acima, a única informação que pode ser diferente é o IP que na tela está como 10.193.123.117. Este é o IP da máquina onde o arquivo <ILCLinxListnerX.dll> foi colocado. Este IP precisa ser visível pelo Btac-BOX.
No DMS-BackBone também deve ser ativado o serviço MSH, normalmente disponível na opção MSH-Activation.
Obs.: Tanto na máquina de integração, quanto no servidor de integração a porta 8080 precisa estar liberada no firewall ou o firewall deve estar desativado.
Através do DMS-BackBone é possível testar tantos os serviços disponíveis na BTacBox (serviços VW), quanto o acesso da BtacBox aos serviços do sistema de integração VW (serviços Linx). Esta opção é a "System Test", conforme consta na figura abaixo:
Segue abaixo a lista dos serviços relevantes ao sistema de integração e uma breve descrição do que é cada serviço:
BusinessPartnerData – Serviço de integração Linx responsável por enviar os dados do cliente. Utilizado pelo ElsaPro, Reserve e Etka (disponível no arquivo ILCLinxCollector.dll, serviço web).
ClaimProcessing – Serviço de integração Linx responsável pela comunicação com o SAGA/2, como os serviços de NewClaim e SetClaimStatus (disponível no arquivo ILCLinxCollector.dll, serviço web).
CustomerVehicleData – Serviço de integração Linx responsável por enviar os dados do veículo. Utilizado pelo ElsaPro, Reserve e Etka (disponível no arquivo ILCLinxCollector.dll, serviço web).
ShopData – Serviço de integração Linx responsável por enviar os dados de estoque, preço e locação de peças. Utilizado pelo Etka (disponível no arquivo ILCLinxCollector.dll, serviço web).
WorkshopOrder – Serviço de integração Linx responsável por enviar os dados das OSs e atendimentos oficina. Utilizado pelo ElsaPro, Reserve e Etka (disponível no arquivo ILCLinxCollector.dll, serviço web).
FishInfoBox – Serviço da BtacBox (VW) responsável por receber os dados das OSs e atendimentos oficina referentes a integração com o SAGA/2.
MSH – Serviço da BtacBox (VW) responsável por receber os dados das OSs e atendimentos oficina referentes a integração com o SAGA/2.
OrderServiceCentral – Serviço da BtacBox (VW) responsável por receber os dados das OSs e atendimentos oficina referentes a integração com o ElsaPro.
OrderServiceParts – Serviço da BtacBox (VW) responsável por receber os dados das OSs e atendimentos oficina referentes a integração com o Etka.
Configuração do ILConfig
Logar no ILConfig e ir em Configurações > ListenerN / Sender > WebServices. Cadastrar os seguintes WebServices.
DN Nome Endereço
01861 FishInfoBox -> SubscriptionData http://10.193.123.10:81/FishInfoBox.bb
01861 OrderService -> SubscriptionData http://10.193.123.10:81/OrderServiceCentral.bb
01861 WarrantyProcessing -> ProcessOrder http://10.193.123.10:81/MSH.bb
01861 WarrantyProcessing -> DeleteOrder http://10.193.123.10:81/MSH.bb
01861 WarrantyProcessing -> SetClaimStatus http://10.193.123.10:81/MSH.bb
01861 OrderServiceParts -> SubscriptionData http://10.193.123.10:81/ OrderServiceParts.bb
Observação: Alterar o IP dos endereços acima pelo IP da Btac-BOX. Este cadastro é por DN, ou seja, cada revenda terá o seu conjunto de WebServices.
Importante: As máquinas de integração precisam ter acesso direto a sua respectiva BTacBox, já o servidor de integração não precisa em nenhum momento acessar a BTacBox.
Após cadastrar cada um dos endereços WebServices, selecionar um por um e clicar no botão "Testar". Depois de alguns segundos clicar sobre o botão "Retorno Teste" para verificar o resultado do teste conforme as telas que seguem:
Botão TestarStatus do testeClique neste botão para obter o retorno do teste
Após o retorno do teste, o campo "Teste" deve ficar com a palavra "OK", como está na tela abaixo. Caso o retorno seja a palavra "ERRO", o endereço do WebService e a comunicação entre a máquina de integração do DN e a BTacBox devem ser verificados.
P.S.: Caso o retorno seja a palavra "ERRO", será gravado um arquivo com o xml de retorno na pasta \vw, com o nome RetTesteWebService*.xml, onde o * são as informações de data e hora de gravação.
Status do teste
Acessar <Cadastros > Parâmetros do Serviço> e preencher os campos conforme orientado abaixo:
Gera arquivo Log: Marcar caso queira que seja gravado os arquivos de log.
Diretório de Log: Informar um endereço local para gravação do log. Ex.: c:\temp\
Gera apenas XML dos WebServices: Se estiver marcado, não vai enviar nenhum xml de integração para o BtacBox. Nunca marcar em ambientes de produção.
Strings Indicativas Erro: (colocar entre separadores <>): Informar sempre - <EXCEPTION><ERROR >< ERROR>
Diretório de trabalho: Informar um endereço local para gravação dos arquivos de trabalho. Ex.: c:\temp\trab\
Tempo Listener (em segundos): Informar o intervalo de tempo para o serviço verificar se tem algo para enviar à BtacBox. Tempo sugerido de 10 segundos.
Tempo Refresh Monitor (em segundos): Intervalo de verificação do programa MonitorILS.exe. Tempo sugerido de 15 segundos.
ATENÇÃO: Os caminhos informados nos campos "Diretório de Log" e "Diretório de trabalho" precisam existir na máquina de integração que fica junto a BTacBox.
Nos campos <Enviar ElsaPro>,<Enviar Reserve> e <Enviar Etka> é possível configurar manualmente para enviar ou não as movimentações realizadas no BRAVOS.
Na aba Monitor ListnerX, cadastrar todos os DNs que deverão ser monitorados pelo MonitorILS, informando a url da dll, conforme exemplo que segue (o endereço abaixo se refere ao IP da máquina de integração por DN): http://25.144.104.217:8080/LinxDms/ILCLinxListnerX.dll
Configuração do Etka
Antes de fazer a configuração das estações onde o Etka está instalado, é necessário instalar o Etka webservice nas máquinas de integração e configurá-lo, conforme está descrito no documento etka7_dvd_e.pdf.
Para cada estação que estiver executando o Etka, seguir os passos abaixo:
Entrar na pasta de instalação do Etka pelo Windows Explorer:
C:\Arquivos de programas\EtkaAut\ETKA\VWAU\PROG\
Ou
C:\Program Files (x86)\EtkaAut\ETKA\VWAU\PROG\
Ou
C:\Program Files\EtkaAut\ETKA\VWAU\PROG\
Editar o arquivo EtAdmin.ini e procurar a linha EtkaServiceAdmin. Verificar se está com o valor 1 (como consta abaixo). Se não estiver, alterar para 1:
EtkaServiceAdmin=1
Executar o programa do Etka. Após logar no Etka, clicar no botão <Configurações>.
Depois clicar no botão <Configurações>.
Clicar na guia <Conexões DMS>, marcar os campos <DMSBB>, <Transmitir o texto das peças em letras maiúsculas> e <Multilocatário>. Também preencher os campo <Nome do servidor remoto> (IP_da_BtacBox:81), <No. Do conces.>, <Número do VZ>. Este último campo sempre deve ser preenchido com 998.
Observação: O campo <No. Do conces.> precisa ter 5 dígitos, utilizando zeros à esquerda se for necessário preencher os 5 dígitos.
Clicar na guia <Conexões em Geral> e marcar as opções <Transmitir o texto completo ao DMS>, <Mostrar também o preço do concessionário>, <Assumir número de pedido para Orçamento> e <Assumir número de pedido para Ficha de pedido>.
Clicar na guia <Conexões DMS>, marcar os campos <DMSBB> e <Transmitir o texto das peças em letras maiúsculas> e <Multilocatário>. Também preencher os campo <Nome do servidor remoto>(IP_da_BtacBox:81), <No. Do conces.>, <Número do VZ>. Este último campo sempre deve ser preenchido com 998.
Clicar na guia <Conexões DMS> e logo após no botão <Funções>.
Na tela que segue, informar 998 no campo <NÚMERO DO VZ>, o DN da concessionária no campo <No. Do conces.> e clicar no botão <SALVAR> que fica ao lado destes campos.
Informar o endereço do DMS-BackBone no campo <DMS-BackBone> (IP_da_BtacBox:81) e o IP da máquina onde está rodando o webserver do Etka no campo<ETKA WebServer>. Após isso, clicar nos dois botões <SALVAR> que estão posicionados ao lado destes campos.
Ao clicar no botão <SALVAR> que fica ao lado do campo <ETKA WebServer>, pode ocorrer a mensagem abaixo. Basta ignorar esta mensagem e seguir adiante.
No campo <Número de peça BTAC>, informar o DN da revenda com cinco dígitos antecedidos pelo texto "BRA" e depois clicar sobre o botão <SALVAR> que está ao lado desde campo.
Clique sobre o botão <WORKSHOPORDER: ASSINAR> para testar a comunicação baseada nos parâmetros acima definidos.
Após isso, basta clicar no botão <REGISTRAR E ATIVAR>. Caso seja exibida uma mensagem de erro neste momento, ela poderá ser ignorada. Então, clique no botão <TESTAR> e observe que a mensagem "Conexão estabelecida com sucesso" deverá ser exibida.
Para finalizar, clique no botão <VOLTA>.
DICA: Nesta janela existe um botão que inicia e encerra procedimentos de testes, chamados de MODO DEBUG. Esse botão é apresentado nesta janela com dois nomes, dependendo do status atual: INICIAR MODO DEBUG e ENCERRAR MODO DEBUG. Em condições normais, este botão deve ser mostrado com o nome INICIAR MODO DEBUG, indicando que o modo debug não foi ativado e o Sistema está operando em modo normal. Atenção! A ativação acidental deste botão fará com que várias janelas do tipo "ATENÇÃO" e "Informação" sejam apresentadas em sequência, ao ser utilizado o serviço WOKSHOPORDER (botão WORKSHOPORDER: ASSINAR). Nesse caso, basta clicar no botão, que estará sendo apresentado como ENCERRAR MODO DEBUG, para desativar o MODO DEBUG e voltar ao modo normal de operação, fazendo com que o botão volte a ser apresentado como INICIAR MODO DEBUG.
Para que as informações de preço concessionária, quantidade DMS e local de estoque sejam pegos do BRAVOS, é necessário marcar a opção "PARA" no item "Estoque", conforme aparece na tela abaixo:
Setar esta opção como "PARA"
Atualização
Configuração para atualização
Esse item do manual é válido apenas para instalações já existentes e que foram instaladas manualmente (sem utilizar os processos descritos nos tópicos "NOVA INSTALAÇÃO – SERVIDOR DE INTEGRAÇÃO" e "Nova instalação – Máquina de integração").
1. Abrir o FabricaVW.
Ir em Fábrica VW > Parâmetros, aba Geral
Informar o número DN da revenda, com 5 dígitos.
Depois entrar na aba Integrações.
a. No campo "URL abertura ElsaPro", dependendo de ser a base de produção ou testes:
Produção
https://portal.cpn.vwg/elsapro/elsaweb/ctr/DP/loadJobFromExternal?DMS_ORDER_ID=:CONTATO&JOB_DATE=:DTA_CONTATO
Testes
https://portal.cpn.vwg/elsapro-tr/elsaweb/ctr/DP/loadJobFromExternal?DMS_ORDER_ID=:CONTATO&JOB_DATE=:DTA_CONTATO
a. No campo <Tipo de Integração SAGA/2>, informar se o sistema está integrando com o SAGA/2 é de produção ou de testes;
b. Nos campos do grupo <Inclusão de Serviços>, informe os dados necessários para a inclusão de novos serviços vindos dos sistemas VW;
c. No campo <Diretório de atualização dos arquivos por DN>, informar o diretório de onde serão copiados os arquivos de instalação/atualização por DN. Esse diretório tem que ser visível pela máquina de integração e também pelo servidor de integração;
d. No campo <Diretório de programas por DN>, informar o diretório onde ficarão os programas na máquina de integração, por padrão esse diretório é o \VW. Este é o mesmo diretório criado no item 5.1 deste manual;
e. No campo <Diretório de serviços web por DN>, informar o diretório onde ficarão as dlls que serão executadas como serviço web na máquina de integração, por padrão esse diretório é o \VW\Services. Este é o mesmo diretório criado no item 5.1 deste manual;
f. No campo <Tipo Serviço Web>, informar o servidor web utilizado (Apache ou IIS). O recomendado é utilizar o Apache.
11. Na máquina onde é o servidor de integração, criar a pasta \VWAtualiza e copiar todo o conteúdo do pacote para esta pasta. Para essa mesma pasta, copiar o arquivo <ConexaoServidor.dat> que está na pasta \VW desta mesma máquina;
12. Nas máquinas de integração criar a pasta \VWAtualiza e copiar todo o conteúdo do pacote de instalação/atualização para esta pasta. Para essa mesma pasta, copiar o arquivo conexao.dat que está na pasta \VW desta mesma máquina.
Atualização
Observação: Algumas versões do Windows, como o Windows XP, podem exigir que o serviço <Linx - Serviço Monitor de Integração Volkswagen> seja executado como um serviço de rede. Para isso, é necessário entrar nas propriedades do serviço e, na aba <Logon>, definir um domínio/usuário e senha para o serviço.
Veja abaixo o erro que ocorre nestes casos e a tela para informar o usuário e senha do serviço:
1. Na máquina onde está o servidor de integração, copiar todo o conteúdo do pacote para a pasta \VWAtualiza;
2. Executar o programa <AtuILSServer.exe>;
3. Clicar no botão <Instalar/Atualizar>;
4. Ajustar/informar os parâmetros da tela conforme as instruções abaixo:
a. No campo <Pasta de atualização onde serão copiados os arquivos que ficarão junto a BTacBox>, informar o diretório para onde serão copiados os arquivos de instalação/atualização por DN. Será deste diretório que cada DN (máquina de integração) irá buscar os arquivos para instalação/atualização;
b. No campo <Pasta dos programas servidores (mesma rede do servidor de Banco de Dados)>, informar o diretório onde ficarão os programas no servidor de integração, por padrão esse diretório é o \VW;
c. No campo <Pasta dos serviços web servidores (mesma rede do servidor de Banco de Dados)>, informar o diretório onde ficarão as dlls que serão executadas como serviço web no servidor de integração, por padrão esse diretório é o \VW\Services;
d. No campo <Tipo Servidor de Aplicação>, informar se o servidor de aplicação será rodado como uma aplicação (ILSAppForms.exe) ou será um serviço do Windows (ILServer.exe). Essa opção fica a escolha do cliente. Se para o cliente, for importante o fato de ao reiniciar o servidor de integração, que o servidor de aplicação seja iniciado automaticamente, este campo deve ser configurado como serviço. Caso isso não seja importante, o servidor deve ser configurado como aplicação;
e. No campo <Tipo Serviço Web>, informar o servidor web utilizado (Apache ou IIS). O recomendado é utilizar o Apache;
f. No campo <Script a ser rodado>, informar o tipo de script a ser rodado. <AtualizaIntegracaoVWCompleta.exe>, recomendado para novas instalações e <AtualizaIntegracaoVWExpressa.exe>, recomendado para atualizações.
5. Clicar no botão <Continuar> e aguardar até a mensagem "Instalação / Atualização realizada com sucesso!" apareça na barra de progresso.
Na primeira atualização utilizando esse processo, será necessário efetuar os passos do tópico "Nova instalação – Máquina de integração". Para as próximas atualizações (da segunda em diante), o processo de atualização cliente será executado automaticamente pelo serviço <Linx - Serviço Monitor de Integração Volkswagen>
Exemplos dos arquivos de configuração
Todos os arquivos listados abaixo são criados automaticamente ou manualmente nos processos descritos nos itens referentes ao tópico de instalação. Eles estão relacionados neste item apenas para caráter explicativo.
ILCLinxCollector.ini
[CONEXAO\]
//Tipo do banco de dados (ORACLE ou SQLSERVER)
TIPO=ORACLE
//Nome do banco de dados
//Exemplo Oracle: APOLLO
//Exemplo SQL Server: 192.168.0.1:APOLLO BANCO=APOLLOVW
//Usuário de conexão com o banco de dados USUARIO=CNP
//Quando informado S, grava o monitor SQL das operações realizadas MONITOR=N
//Quando informado S, grava os xmls recebidos na pasta \vw\services\xml
//e também grava todos os eventos no arquivo \vw\services\LogChamadaILS.txt GRAVA_XML=N
ILCLinxListnerX.ini
[CONEXAO\]
//URL onde está instalado o ILCLinxCollector.dll
URL=http://192.168.0.2:8080/LinxDms/ILCLinxCollector.dll
Apollo.ini
//Pasta onde estão os programas (*.exe) instalados c:\VW
ConexaoServidor.dat (ILSAppForms.exe ou ILServer.exe)
//Tipo do banco de dados (ORACLE ou SQLSERVER)
[BANCODADOS\]=ORACLE
//Nome do banco de dados
//Exemplo Oracle: APOLLO
//Exemplo SQL Server: 192.168.0.1:APOLLO
[DATABASE\]=APOLLOVW
//Porta onde vai rodar o programa servidor
[PORTA\]=INTEGRATIONLAYER:234
//Diretório onde será gravado o log do servidor de aplicação
[DIRLOG\]=c:\temp\
//Usuário de conexão com o banco Oracle
[USUARIO_ORACLE\]=CNP
Conexao.dat
//Deixar a versão que está
[VERSAOEXE\]=1.0.0.0
//Deixar fixo DATASNAP
[BANCODADOS\]=DATASNAP
//IP:Porta onde está rodando o servidor de aplicação
[DATABASE\]=192.168.0.2:234
MonitorILS.ini (Este arquivo não é obrigatório, caso ele não exista, o MonitorILS.exe irá monitorar todos os DNs cadastrados na base de dados)
// Configuração de DNs a Monitorar, incluir todos os DNs que deseja monitorar
// O DN 00000 sempre deve ser incluído, pois representa o
// servidor de integração, utilizado por todos os DNs
[DNS_A_MONITORAR\]=01165,01080,01227,00000
Exportação/Importação da configuração
A exportação/importação serve para copiar a configuração entre uma base e outra. Ela também serve como cópia de segurança da configuração do sistema de integração.
Para realizar a exportação da configuração, basta selecionar o processo Exportação, informar o arquivo onde serão gravadas as informações exportadas e clicar no botão <Executa>.
Para realizar a importação da configuração, existem mais opções disponíveis. Abaixo está detalhado o que cada uma faz:
Excluir registros existentes: Se for selecionado <Sim>, os registros referentes a configuração, existentes na base serão excluídos e os importados serão incluídos. Se for selecionado <Não>, os registros referentes a configuração, existentes na base serão mantidos e a importação irá alterar os registros existentes e incluir os novos.
Expressa: Se marcada, irá importar apenas as configurações dos processos de envio/recebimento e gatilhos do banco de dados. Esta opção é muito utilizada para atualização da configuração dos processos. Dados como o cadastro dos webservices e a configuração do banco de dados na manutenção dos processos, não serão importados.
Cria Gatilhos: Esta opção, quando marcada, logo após realizar a importação, já cria os gatilhos da integração no banco de dados. Desmarque esta opção caso a exportação do arquivo tenha sido feita em uma base de dados com um sistema diferente da que esta sendo importada (ex.: Exportação: Oracle > Importação: SQL Server). Se esta opção não for marcada, após a importação será necessário entrar em Cadastros > Gatilhos BD e clicar no botão <Atualiza BD>.
Monitor de serviços (MonitorILS)
Monitora os serviços de integração e identifica se os mesmos estão funcionando. Segue a explicação de cada serviço.
Servidor de Integração (ILServer/ILSAppForms): Servidor de Integração (um por base de dados)
Serviço de Integração por Tabela de Comandos: Serviço de envio
Serviço Listener para Integração VW: Listener do serviço consumido
Serviço de Monitoramento da Integração (Listener): Listener para envio
Pela MonitorILS é possível verificar se os serviços estão rodando corretamente e se não existe nenhum conflito de versão. Para verificar isso, deve-se verificar as seguintes colunas:
Status: Indica se os programas de integração estão rodando corretamente. Os valores que poderão aparecer são: (verde) Ativo e (vermelho) Parado.
Versão: Indica a versão dos programas de integração que estão rodando.
Status Versão: Indica se a versão dos programas de integração é compatível com as configurações de gatilhos e objetos do banco de dados. Os valores que poderão aparecer são: (verde) Versão válida, (vermelho) Programa desatualizado e (amarelo) Banco desatualizado.
Status Versão BRAVOS: Indica se a versão do sistema de integração é compatível com a versão do BRAVOS. Os valores que poderão aparecer são: (verde) Versão válida, (vermelho) BRAVOS desatualizado e (amarelo) Integração desatualizada.
VerificaServer
Caso a revenda queira utilizar o VerificaServer para melhorar a estabilidade do servidor de integração e também tornar auto gerenciável o processo de reinicialização diária do servidor, basta seguir os passos indicados a seguir.
1. Copie o arquivo VerificaServer.exe para a mesma pasta onde já está o servidor 3 camadas. (ILSAppForms.exe/ILServer.exe);
2. Edite o arquivo ConexaoServidor.dat e inclua a linha abaixo.
[PORTA_VERIFICADOR\]=210
Obs.: Onde está o número 210, deve ser colocada a porta que será responsável pela comunicação entre os servidores 3 camadas e o verificador. Esta porta não pode ser utilizada por nenhum outro aplicativo da máquina. A comunicação que será feita será unicamente na própria máquina, não será realizado nenhum tipo de comunicação de rede nesta porta.
a. Caso a revenda utilize a integração como Serviço, também deve ser incluída a linha abaixo no arquivo ConexaoServidor.dat.
[INTEGRACAO_VW\]=S
3. Abra o prompt do MS-DOS como administrador e entre na pasta onde estão os servidores 3 camadas. Após isso, execute o comando abaixo:
VereficaServer /install
4. Entre nos serviços do Windows e inicie o serviço "Verifica Server 3 Camadas".
Funcionamento
1. Lerá o arquivo ConexaoServidor.dat e verificará se o servidor configurado neste arquivo não estiver iniciado. Caso isso ocorra, o próprio verificador irá iniciar o servidor;
2. Irá monitorar a atividade do servidor configurado e caso este pare de funcionar, ele mesmo fará a reinicialização do servidor;
3. Caso algum servidor for encerrado, o serviço irá iniciá-lo novamente depois de algum tempo;
4. Reinicializará o servidor entre 02:00 e 02:30 da manhã, fazendo com que a memória utilizada pelos mesmos seja restaurada.
Observações Importantes
Os tópicos abaixo só precisam ser observados caso a revenda utilize o servidor de integração como aplicação (ILSAppForms.exe).
1. É necessário que exista uma sessão do Windows iniciada (login efetuado) para que o mesmo possa ser executado. Então, mesmo que o serviço do verificador esteja configurado para iniciar automaticamente, será necessário efetuar o login no Windows para que o verificador inicie o servidor;
2. Na máquina onde estiver rodando o servidor de integração e o verificador, deverá ter uma e somente uma sessão do Windows iniciada. Isso se faz necessário pelo fato do verificador não ter como identificar em que sessão o servidor deverá ser iniciado. Ou seja, essa máquina não pode ser utilizada como servidor de Terminal Server e nem ter sessões concorrentes;
3. Uma vez que o verificador estiver configurado para iniciar automaticamente nos serviços do Windows, basta que o responsável pelo TI faça o login na máquina servidora para que o servidor de integração seja iniciado, não será mais necessário iniciar o servidor manualmente. Detalhe, a inicialização do servidor pode demorar até 10 minutos depois do login.
Observações Gerais
1. Em algumas telas do BRAVOS (Agendamento Oficina, Atendimento Oficina e Manutenção de OS) existe o botão "ElsaPro". Este botão abre o navegador web padrão, executando o ElsaPro, já posicionado na O.S. selecionada no BRAVOS. Para que seja possível utilizar este botão, o Bravos tem que estar rodando na mesma rede onde está a BTac-Box. Se não é este o caso da revenda, então deve-se configurar o Bravos 3 camadas;
1. Para realizar as integrações, o BRAVOS não precisa ter acesso a BTacBox. Todo o processo de integração é feito pelo sistema de integração, lendo os dados diretamente da base de dados e comunicando com a BTacBox, conforme estrutura explicada no capítulo referente à estrutura do sistema.
Em caso de dúvidas sobre o conteúdo deste documento, entre em contato com o Suporte Nacional, através do site cliente.linx.com.br.