Integração Consultors x Etka

1. Objetivo
Orientar aos usuários do sistema Consultor's, na configuração e preparação do sistema para integração com COMBox ETKA – CatálogoEletrônico da Concessionária VW.


2. O que a integração faz?
1º) stock-information - No Etka ao consultar os detalhes de uma peça, o serviço Combox Etka faz uma chamada ao serviço CGI que retora: quantidade em estoque; o Preço; a descrição da peça; a localização (escaninho).

2°) order-create / order-append - No Etka ao criar um orçamento e adicionar peças no orçamento e acionar o botão transmitir, o serviço Combox Etka faz uma chamada ao serviço CGI que: cadastra novo orçamento no consultor's com as mesmas peças do orçamento do Etka e retorna os dados do orçamento para o Etka.

3°) order-list - No Etka ao executar o comando order-list o serviço Combox Etka faz uma chamada ao serviço CGI que: retorna para o Etka uma lista com todos os orçamentos em aberto cadastrados no consultor's.

4°) order-get - No Etka ao executar o comando order-get o serviço Combox Etka faz uma chamada ao serviço CGI que: retorna os dados de um orçamento específico.

3 Configuração e parametrização na CGI:
3.1) Pré-Requisitos: ter o Pacific instalado e o serviço App configurado. O serviço App deve ser sem autenticação SpringSecurity. Por padrão é configurado desta forma.

3.2) Configurar o serviço no Pacific.
Observação: As imagens abaixo ilustram uma instalação do Pacific no IP: 192.168.200.20, na sua empresa pode ser outro IP.

3.2.1) Login


3.2.2) Acessar a instância do Pacific correspondente ao APP.


3.2.2) Acessar o WebTransport no APP.


3.2.3) Configurar o WebTransport no APP.

Informar valor para os campos [ Handler Class: cgietka ] [ Handler URL: /cgietka/ ].

Handler Class: deve-se informar o nome da classe: cgietka.cls
Handler URL: é o endereço onde o serviço vai responder. Neste exemplo o serviço vai responder em http://192.168.200.20:8610/web/cgietka.

http://192.168.200.20 - é o servidor onde está instalado o Pacific.
8610 - é a porta da instância App do Pacific.
/web/cgietka é o endereço final onde responde o serviço. Este valor é padrão, sempre igual.

3.2.4) Fazer o cópia da classe para o diretório apropriado no Pacific.

Copiar o arquivo: cgietka.cls.
Exemplo, Da Pasta: ?:\progress\api\webhandler\ Para a pasta: \\192.168.200.20\wrk116\app\webapps\ROOT\WEB-INF\openedge\

\\192.168.200.20 - servidor Pacific.
\wrk116 - diretório de trabalho do Progresss.
\app - nome da instância do Pacific.
\webapps\ROOT\WEB-INF\openedge\ - Este valor é padrão, sempre igual.

3.2.5) Verificar se o serviço está funcionando corretamente. Ao acessar no navegador o endereço do serviço deve mostrar o mesmo conteúdo da imagem abaixo. Se mostrar algo diferente algo foi parametrizado errado.
Caso algum problema ocorra, consultar o log o App é uma boa prática. Exemplo da localização: \\192.168.200.20\wrk116\app\logs\app.agent.log.

4) Configuração do COMBox e Etka
Observação: O COMBox e o Etka devem estar previamente instalado para a realização da configuração. Caso não tenha os softwares instalados de entrar em contato com etka@oic.com.br.

4.1) Para configuração do Combox e Etka segue manual fornecido pela OIC. Arquivo:Config etka combox.pdf.

4.2) Próximo passo da configuração.

4.3) Próximo passo da configuração.

4.4) Próximo passo da configuração.

5) Interface de integração
5.1) Interface de integração fornecido pela OIC. Arquivo:Layout.pdf.

6) Logs
Os arquivos de log podem ajudar a identificar problemas inesperados.

No serviço da CGI, os arquivos de log ficam no seguinte diretório: \\<servidor>\wrk116\<agente Pacific>\logs
Arquivos: app.agent.log e cgietka-2019-05-16.txt

No serviço COMBox, os arquivos de log ficam no seguinte diretório: C:\Program Files (x86)\COMbox-Connector\log Arquivos: combox-connector.log