Painel

titleColor	#FFFFFF
titleBGColor	#2C004B
title	ASSUNTO

Manual com orientações de instalação e configuração do processo ILSVW. (Integração Elsa, Saga)

Produto	Bravos
Data	04/05/2017
Autor	Distribuição Linx DMS [email protected]

Painel

titleColor	#FFFFFF
titleBGColor	#2C004B
title	ÍNDICE

Índice

Painel

titleColor	#FFFFFF
titleBGColor	#2C004B
title	ABRANGÊNCIA

Esse processo se destina a todas as concessionárias VW que utilizam o Bravos.

Painel

titleColor	#FFFFFF
titleBGColor	#2C004B
title	Requisitos

Requisitos de Hardware/Sistema operacional

As máquinas de integração que ficarão junto a cada BtacBox, atualmente cada DN precisa de sua maquina de integração, devem atender os seguintes requisitos:

Uma máquina dedicada, exclusiva para cada revenda, com sistema operacional Windows 7 SP3 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 DMS-Backbone, através da rede do Cisco;

c. Acesso via rede/internet ao servidor de integração.

O servidor de integração que irá realizar a conexão junto ao banco de dados, deve atender os seguintes requisitos: Uma máquina dedicada (ou servidor compartilhado), com sistema operacional Windows 7 SP3 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.

Cisco/Btacbox

A BtacBox é o hardware responsável pela comunicação entre o sistema de integração VW e o sistema da própria VW na Alemanha. Cada revenda possui uma Cisco, 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 do Cisco.

Estrutura da rede

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.

Cenário 1 - Servidor local

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.

Cenário 2 - Servidor em nuvem

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.

Painel

titleColor	#FFFFFF
titleBGColor	#2C004B
title	Funcionamento

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 tópico Cisco/Btacbox que para executar o ElsaPro em uma estação de trabalho é necessário estar na mesma rede do Cisco, 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 o Cisco. 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

Para realizar o download dos arquivos e programas necessários, basta acessar ao DVI e realizar o download do pacote conforme a versão do seu banco de dados. Link: DVI - Liberações Linx DMS | DMS Automotivo - Automotivo - Linx Share

Painel

titleColor	#FFFFFF
titleBGColor	#2C004B
title	Instalação

Nova instalação - Servidor Integração VW

Extraindo arquivos

Após realizado o download do pacote de sistema de integração VW no DVI, extrair o conteúdo da pasta dentro do zip no diretório C:\VW\, após extraído, crie a pasta C:\VW\Services\ e C:\VW\AtualizaDN.

Instalando Apache

Acessar ao diretório C:\VW\Apache e realizar a instalação do Apache 2.2 (httpd-2.2.25-win32-x86-no_ssl.msi), realizar a instalação padrão, clicando em Next até que a instalação seja finalizada, após isso acessar diretório de configuração do Apache 2.2: C:\Program Files (x86)\Apache Software Foundation\Apache2.2\conf, faça um backup do arquivo httpd.conf, após isso edite o arquivo original e localize as seguintes informações:

Localize a linha contendo o texto #LoadModule isapi_module modules/mod_isapi.so e retire o caractere # do início
Localize a linha que existe a informação LISTEN, altere a informação de Listen 80 para Listen 8080
Ao final do arquivo insira a informação abaixo (certifique-se que a pasta informada na linha Alias /LinxDms "C:\Vw\Services" exista):

Bloco de código

title	httpd.conf

<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>

Após realizado a configuração do Apache, salve o arquivo e reinicie o serviço através do Gerenciador de Tarefas do Windows.

Aviso

title	Atençã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: Acessar ao painel de controle e abrir Programas e recursos.

Passo 2: Selecionar a opção Ativar/Desativar recursos do Windows, com isso será aberto a janela de recursos do Windows.

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.

Após isso copiar o arquivo <ILCLinxCollector.dll>, existe na pasta C:\VW para a pasta C:\VW\Services\, após isso tentar acessar à URL: http://localhost:8080/LinxDms/ILCLinxCollector.dll

Instalando serviço

Criar o diretório C:\VW\AtualizaVW e copiar todo o conteúdo do pacote de instalação para esta pasta.

Renomear o arquivo <Apollo_Exemplo.ini> para <Apollo.ini>, abrir o arquivo e informar o diretório conforme abaixo:

Bloco de código

title	apollo.ini

C:\VW\AtualizaVW

Renomear o arquivo <ConexaoServidor_Exemplo.dat> para <ConexaoServidor.dat>, editar o arquivo e ajustar os parâmetros conforme conexão do banco de dados da revenda (Oracle ou SQL Server):

Bloco de código

title	Banco Oracle - conexaoservidor.dat

[BANCODADOS]=ORACLE
[USUARIO_ORACLE]=CNP
[DATABASE]=AUTO
[PORTA]=INTEGRATIONLAYER:234
[DIRATUALIZACAO]=c:\apollo\arquivo\
[DIRLOG]=c:\temp\
//Porta onde está rodando o VerificaServer
[PORTA_VERIFICADOR]=210
//S->Serviço e A->Aplicação
[INTEGRACAO_VW]=S

Bloco de código

title	Banco SQL Server - conexaoservidor.dat

[BANCODADOS]=SQLSERVER 
[DATABASE]=192.168.3.31:BRAVOS  
[PORTA]=INTEGRATIONLAYER:234
[DIRATUALIZACAO]=c:\apollo\arquivo\
[DIRLOG]=c:\temp\
//Porta onde está rodando o VerificaServer
[PORTA_VERIFICADOR]=210
//S->Serviço e A->Aplicação
[INTEGRACAO_VW]=S

Aviso

title	Porta Integração

Caso o computador também seja um servidor de 3 Camadas, será necessário avaliar se as portas informadas nas tag [PORTA] e [PORTA_VERIFICADOR] estão disponíveis, caso contrário será necessário utilizar uma porta não utilizada por nenhum serviço.

Renomear o arquivo <ConexaoExemplo.dat> para <Conexao.dat>, editar o arquivo para que seja informado o IP do computador serviço de integração:

Bloco de código

title	conexao.dat

[VERSAOEXE]=1.0.0.0
[DIRATUALIZACAO]=C:\Temp\
[BANCODADOS]=DATASNAP
[DATABASE]=127.0.0.1:234

Na pasta C:\VW\AtualizaVW\ executar o programa <AtuILSServer.exe> como administrador, após isso clicar em Instalar/Atualizar. (1) Ajustar/informar os parâmetros da tela conforme as instruções abaixo:

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;
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 C:\VW;
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 C:\VW\Services;
No campo <Tipo Servidor de Aplicação>, selecionar a opção serviço;
No campo <Tipo Serviço Web>, selecionar Apache;
No campo <Script a ser rodado>, selecionar a opção. <AtualizaIntegracaoVWCompleta.exe> (2);
Após isso clicar para continuar (3) e aguardar até a mensagem Instalação / Atualização realizada com sucesso! apareça na barra de progresso;

Aviso

title	Conexão banco de dados

Caso a revenda utilize uma senha de conexão ao banco de dados diferente da senha padrão Linx, é necessário copiar o arquivo senhabd.dat que a revenda utiliza para dentro da pasta C:\VW\Services\.

Nova instalação - Máquina de integração

Configurando o Bravos

Acessar ao Bravos e abrir o menu FábricaVW - Parâmetros aba Geral, informar o número do DN da revenda com 5 dígitos (preencher com 0 a esquerda).

Ir a aba Integrações e preencher os campos conforme abaixo:

No campo "URL abertura ElsaPro", informar: https://grp.cpn.vwg/elsapro/elsaweb/ctr/DP/loadJobFromExternal?DMS_ORDER_ID=:CONTATO&JOB_DATE=:DTA_CONTATO
No campo <Tipo de Integração SAGA/2>, informar qual ambiente que será utilizado (Produção);
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;
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;
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;
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 C:\VW.
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 C:\VW\Services.
No campo <Tipo Serviço Web>, informar o servidor web utilizado: Apache.

Cenário

Após realizado toda a parametrização para o serviço que irá comunicar com o banco de dados é necessário que seja realizado o registro do DN da revenda para que a comunicação se inicie. Neste parte existe um ponto que precisa ser verificado, caso a revenda tenha um servidor local, onde a maquina servidora também é uma uma maquina de integração (cenário 1), basta seguir o procedimento para servidor local, caso a revenda possua o servidor em nuvem (cenário 2) e filiais, basta seguir o tópico servidor remoto.

Informações

title	Comunicação da rede

Para parametrizar a máquina de integração é necessário que ela se comunique com a btacbox.

Servidor Local

Na máquina onde esta instalado o servidor de integração executar o programa <C:\VW\AtualizaVW\AtuILSDN.exe> como administrador, clicar no botão Instalar/Atualizar, na tela que será apresentada informar o número DN da revenda (informar o número do DN com 5 dígitos).

Após seguir as parametrizações iniciais, será exibido em tela um campo para informar o endereço do servidor web, informar o endereço IP do Servidor de integração VW.

Em seguida será exibido duas telas conforme abaixo, nela informe novamente o IP do computador que é o Servidor de integração VW, neste ponto está sendo instalado o serviço de comunicação e o monitor de integração.

Aviso

title	Porta

Caso tenha configurado a porta diferente, devido à existir um servidor de 3 camadas na mesma máquina, deve ser informada porta parametrizada no arquivo C:\VW\ConexaoServidor.dat

Aguardar até a mensagem Instalação / Atualização realizada com sucesso! apareça na barra de progresso, partiremos agora para a configuração da DMS-Backbone

Servidor remoto

No servidor que se encontra na nuvem, zipar a pasta C:\VW e extrair no computador que será a maquina de integração VW e executar o programa <C:\VW\AtualizaVW\AtuILSDN.exe> como administrador, clicar no botão Instalar/Atualizar, na tela que será apresentada informar o número DN da revenda (informar o número do DN com 5 dígitos).

Após seguir as parametrizações iniciais, será exibido em tela um campo para informar o endereço do servidor web, informar o endereço IP do Servidor de integração VW que se encontra na nuvem.

Em seguida será exibido duas telas conforme abaixo, nela informe novamente o IP do computador que é o Servidor de integração VW que se encontra na nuvem, neste ponto está sendo instalado o serviço de comunicação e o monitor de integração.

Aviso

title	Porta

Caso tenha configurado a porta diferente, devido à existir um servidor de 3 camadas na mesma máquina, deve ser informada porta parametrizada no arquivo C:\VW\ConexaoServidor.dat

Aguardar até a mensagem Instalação / Atualização realizada com sucesso! apareça na barra de progresso, partiremos agora para a configuração da DMS-Backbone

Configurando DMS-Backbone

O DMS-Backbone é o software que roda na BtacBox, através deste programa é necessário configurar alguns itens do equipamento, seguindo a documentação da Volkswagen (IT MASS 12, disponível no Portal Rede VW).

Para acessar ao DMS-Backbone é necessário anotar o endereço IP que é exibido no visor da btacbox, abrir o navegador e informar http://IP-BTAC:81, a senha padrão do equipamento é dms-BB4, após acessado ao sistema, buscar no menu lateral Services (1), para apontar os serviços de configuração para a maquina de integração do DN configurado. Caso ja exista o serviço informado para um IP, basta clicar no nome do serviço do quadro (2) e alterar IP no quadro inferior (3).

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.

ServiceName	Target Adress	Description
BusinessPartnerData	http://IP_MAQUINA_INTEGRACAO:8080/LinxDms/ILCLinxListnerX.dll/BusinessPartnerData	Linx BusinessPartnerData
ClaimProcessing	http://IP_MAQUINA_INTEGRACAO:8080/LinxDms/ILCLinxListnerX.dll/ClaimProcessing	Linx ClaimProcessing
CustomerVehicleData	http://IP_MAQUINA_INTEGRACAO:8080/LinxDms/ILCLinxListnerX.dll/CustomerVehicleData	Linx CustomerVehicleData
ShopData	http://IP_MAQUINA_INTEGRACAO:8080/LinxDms/ILCLinxListnerX.dll/ShopData	Linx ShopData
SparepartOrder	http://IP_MAQUINA_INTEGRACAO:8080/LinxDms/ILCLinxListnerX.dll/SparepartOrder	Linx SparepartOrder
WorkshopOrder	http://IP_MAQUINA_INTEGRACAO:8080/LinxDms/ILCLinxListnerX.dll/WorkshopOrder	Linx WorkshopOrder

Após configuração dos serviços é necessário verificar se o MSH está ativo. Para isso basta acessar ao menu MSH-Activation.

Informações

title	MSH

Caso não exista o número do DN da revenda registrado, verificar o procedimento de ativação no documento disponível no Portal Rede VW - Download - IT_MASS_12, qualquer dúvida sobre a ativação desta funcionalidade, precisa ser verificado junto a Volkswagen.

Após realizado a configuração dos serviços e MSH, acessar ao menu System test clicar no botão Run All tests, que se encontra no final da página, e aguardar a finalização.

Aviso

title	Firewall

Tanto na máquina de integração, quanto no servidor de integração a porta 8080 precisa estar liberada no firewall da revenda e/ou o firewall Windows deve estar desativado.

Informações

title	Serviços Btac

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

Acessar à maquina de integração da revenda abrir o programa C:\VW\ILConfig.exe, acessar ao menu Configurações > ListenerN / Sender > WebServices, cadastrar os seguintes WebServices, onde o número do DN possui 5 dígitos, conforme exemplo abaixo.

Informações

title	Cadastro de WebServices

Observação: Alterar o IP dos endereços 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.

Serviço	DN	URL
AliveTest	0XXXX	http://IP_BTACBOX:81/OrderServiceCentral.bb
FishInfoBox -> AliveTest	0XXXX	http://IP_BTACBOX:81/FishInfoBox.bb
FishInfoBox -> SubscriptionData	0XXXX	http://IP_BTACBOX:81/FishInfoBox.bb
OrderService -> AliveTest	0XXXX	http://IP_BTACBOX:81/OrderServiceCentral.bb
OrderService -> SubscriptionData	0XXXX	http://IP_BTACBOX:81/OrderServiceCentral.bb
WarrantyProcessing -> ProcessOrder	0XXXX	http://IP_BTACBOX:81/MSH.bb
WarrantyProcessing -> SetClaimStatus	0XXXX	http://IP_BTACBOX:81/MSH.bb
WarrantyProcessing -> DeleteOrder	0XXXX	http://IP_BTACBOX:81/MSH.bb
OrderServiceParts -> SubscriptionData	0XXXX	http://IP_BTACBOX:81/OrderServiceParts.bb

Aviso

title	IP Btacbox

Caso o IP da btacbox não seja fixo, o IP muda a cada vez que o equipamento é reiniciado, é necessário acionar a Disal solicitando definir um IP fixo no equipamento. Contato: [email protected]

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, a coluna Teste deve ficar com a palavra OK, Caso o retorno seja a palavra ERRO (será gravado um arquivo com o xml de retorno na pasta C:\VW, com o nome RetTesteWebService*.xml, onde o * são as informações de data e hora de gravação), o endereço do WebService e a comunicação entre a máquina de integração do DN e a BtacBox devem ser verificados.

Acessar ao menu Cadastro - 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://IP_MAQUINA_INTEGRACAO:8080/LinxDms/ILCLinxListnerX.dll

Configurando o ETKA

Para realizar a configuração do ETKA basta seguir a documentação: [ETKA] Integração Bravos x ETKA, onde tudo referente a esta integração será tratada nela.

Painel

titleColor	#FFFFFF
titleBGColor	#2C004B
title	Atualização

Atualização Integração VW

Será explicado agora como realizar a atualização dos serviços de Integração VW, para caso realize a troca de versão ou sanar algum problema, esse item do manual é válido apenas para instalações já existentes. Para isso realizar acesso ao menu Fábrica VW - Parâmetros aba Integrações, nesta tela verificar o diretório de atualização configurado.

Informações

title	Atenção

Se possuir apenas 1 revenda e possua o servidor local, pode ser informado C:\VW\AtualizaDN, caso esteja na nuvem ou possua mais de uma revenda é recomendável que compartilhe no servidor de integração o diretório C:\VW\AtualizaDN, é necessário que seja acessível por todas as máquinas de integração.

Na maquina servidora de integração, criar o diretório C:\VW\AtualizaDN e extrair o pacote que será atualizado, copiar o arquivo C:\VW\ConexaoServidor.dat para a pasta C:\VW\AtualizaVW, em seguida executar o programa AtuILSServer.exe como administrador clicar em Instalar/Atualizar e selecionar a opção AtualizaIntegracaoVWExpressa.exe. Aguardar até a mensagem Instalação / Atualização realizada com sucesso! apareça na barra de progresso.

Aviso

title	Atualização Máquina de Integração

Caso seja realizado a configuração de um diretório compartilhado no servidor de integração, pode ser necessário que nas máquinas de integração o serviço Linx - Serviço Monitor de Integração Volkswagen seja configurado um usuário e senha, para isso basta abrir os serviços do Windows, localizar o serviço e abrir as propriedades e ir na aba logon e informar o usuário e senha do usuário que consegue realizar acesso à pasta compartilhada no servidor de integração, após isso aplicar e iniciar o serviço.

Painel

titleColor	#FFFFFF
titleBGColor	#2C004B
title	Exportação/Importação

Exportação/Importação da configuração

A exportação/importação serve para copiar a configuração entre um banco de dados e outro. 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 acessar ao C:\VW\ILConfig.exe, realizar login, acessar ao menu Geral - Importação/Exportação da configuração. selecionar o processo desejado:

clicando na opção Exportação:informar o diretório e nome do arquivo onde serão gravadas as informações e clicar no botão executa.
clicando na opção importação:selecionar o arquivo à ser importado e clicar no botão executa.

Informações

title	Informações

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.

Painel

titleColor	#FFFFFF
titleBGColor	#2C004B
title	Monitor

Monitor de Serviços de Integração (MonitorILS.exe)

Monitora os serviços de integração e identifica se os mesmos estão em execução. Pelo 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.

Informações

title	Selecionar DNs

Para selecionar os DNs que serão exibidos no monitor, basta abrir o arquivo C:\VW\MonitorILS.ini e informar os DN desejados.

Painel

titleColor	#FFFFFF
titleBGColor	#2C004B
title	VerificaServer

VerificaServer

O VerificaServer.exe é utilizado para melhorar a estabilidade do servidor de integração e também tornar auto gerenciável o processo de reinicialização diária do serviço: Linx - Servidor de Aplicação Camada de Integração Volkswagen, para realizar a configuração, basta seguir a documentação: Integração VW | VerificaServer

Painel

titleColor	#FFFFFF
titleBGColor	#2C004B
title	Dúvidas

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.

ANTIGO - NADA ALTERADO

Painel

titleColor	#FFFFFF
titleBGColor	#2C004B
title	APLICAÇÃO

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.

BtacBoxA 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.

Image Removed
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.

Image Removed
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.

Image RemovedComunicaçã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áriosILSAppForms.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:

Image Removed

Image Removed 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:

Image Removed

Image Removed 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:

Image Removed Selecione a opção Programs and Features no Painel de Controle. Passo 2:

Image Removed 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:

Image Removed 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:^{Image Removed}

Image Removed 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

Image Removed 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.

Image Removed

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;

Image Removed

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>;

Image Removed 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

Image Removed 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.

Image Removed Após clicar em <OK>, a mensagem a seguir deverá ser exibida:

Image Removed 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.

Image Removed Após clicar em <OK>, a mensagem abaixo deverá ser exibida:

Image Removed

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:

Image Removed 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^{Image Removed}
Linx BusinessPartnerData ClaimProcessing http://10.193.123.117:8080/LinxDms/ILCLinxListnerX.dll/claimprocessing^{Image Removed}
Linx ClaimProcessing CustomerVehicleData http://10.193.123.117:8080/LinxDms/ILCLinxListnerX.dll/customervehicledata^{Image Removed}
Linx CustomerVehicleDataShopData
http://10.193.123.117:8080/LinxDms/ILCLinxListnerX.dll/ShopData
ShopData SparepartOrder http://10.193.123.117:8080/LinxDms/ILCLinxListnerX.dll/workshoporder^{Image Removed}
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:

Image Removed

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:

Image Removed

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.

Image Removed 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.

Image Removed 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

Image Removed

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>.

Image Removed Depois clicar no botão <Configurações>.

Image Removed 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.

Image Removed
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>.

Image Removed 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.

Image Removed 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>.

Image Removed 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:

Image Removed
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

Image Removed 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.

Image Removed

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:

Image Removed

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.

Image Removed

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>.

Image Removed 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>.

Image Removed

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

Image Removed 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.

Painel

titleColor	#FFFFFF
titleBGColor	#2C004B
title	DÚVIDAS

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.

Atalhos

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 4

Nova versão 5

Chave

Requisitos de Hardware/Sistema operacional

Cisco/Btacbox

Estrutura da rede

Cenário 1 - Servidor local

Cenário 2 - Servidor em nuvem

Programas/Arquivos necessários

Nova instalação - Servidor Integração VW

Extraindo arquivos

Instalando Apache

Instalando serviço

Nova instalação - Máquina de integração

Configurando o Bravos

Cenário

Servidor Local

Servidor remoto

Configurando DMS-Backbone

Configuração do ILConfig

Configurando o ETKA

Atualização Integração VW

Exportação/Importação da configuração

Monitor de Serviços de Integração (MonitorILS.exe)

VerificaServer

ANTIGO - NADA ALTERADO

Requisitos do sistema

Exemplo do diagrama estrutural – Caso 1

Instalação

Criação das pastas

Instalação do Servidor Apache

Nova instalação – Servidor de Integração

Configuração do DMS-Backbone

Configuração do ILConfig

Configuração do Etka

Atualização

Exportação/Importação da configuração

Monitor de serviços (MonitorILS)

VerificaServer

Observações Gerais