Mudanças entre as edições de "Integração Consultors x Etka"

De Wiki CGI Software de Gestão
Ir para: navegação, pesquisa
 
(15 edições intermediárias de 2 usuários não apresentadas)
Linha 3: Linha 3:
 
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.
 
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.
 
<br><br><br>
 
<br><br><br>
 
 
'''2. O que a integração faz?'''
 
'''2. O que a integração faz?'''
 
<br>
 
<br>
Linha 9: Linha 8:
 
<br><br>
 
<br><br>
 
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.
 
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.
<br><br><
+
<br><br>
 
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.
 
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.
 
<br><br>
 
<br><br>
 
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.
 
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.
 
<br><br><br>
 
<br><br><br>
 
 
'''3 Configuração e parametrização na CGI:'''
 
'''3 Configuração e parametrização na CGI:'''
 
<br>
 
<br>
 
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.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.
 
<br><br>
 
<br><br>
3.2) Configurar o serviço no Pacific.<br>  
+
3.2) Configurar o serviço no Pacific.
 +
<br>
 
''Observação: As imagens abaixo ilustram uma instalação do Pacific no IP: 192.168.200.20, na sua empresa pode ser outro IP.''<br><br>
 
''Observação: As imagens abaixo ilustram uma instalação do Pacific no IP: 192.168.200.20, na sua empresa pode ser outro IP.''<br><br>
 
3.2.1) Login<br>
 
3.2.1) Login<br>
Linha 31: Linha 30:
 
<br><br>
 
<br><br>
 
3.2.3) Configurar o WebTransport no APP.
 
3.2.3) Configurar o WebTransport no APP.
<br><br>
+
<br>
 
Informar valor para os campos [ '''Handler Class''': ''cgietka'' ] [ '''Handler URL''': ''/cgietka/'' ].
 
Informar valor para os campos [ '''Handler Class''': ''cgietka'' ] [ '''Handler URL''': ''/cgietka/'' ].
 
<br><br>
 
<br><br>
Handler Class: deve-se informar o nome da classe: cgietka.cls<br>
+
'''Handler Class''': deve-se informar o nome da classe: cgietka.r<br>
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.
+
'''Handler URL''': endereço onde o serviço vai responder. Neste exemplo o serviço vai responder em http://192.168.200.20:8610/web/cgietka.
<br><br>
+
http://192.168.200.20 - é o servidor onde está instalado o Pacific.<br>
+
8610 - é a porta da instância App do Pacific.<br>
+
'''/web/cgietka''' é o endereço final onde responde o serviço. Este valor é padrão, sempre igual.
+
 
<br><br>
 
<br><br>
 +
'''http://192.168.200.20''': é o servidor onde está instalado o Pacific.<br>
 +
'''8610''': porta da instância App do Pacific.<br>
 +
'''/web/cgietka''': endereço final onde responde o serviço. Este valor é padrão, sempre igual.
 +
<br>
 
[[Arquivo:cgietka03.png]]
 
[[Arquivo:cgietka03.png]]
 
<br><br>
 
<br><br>
 
 
3.2.4) Fazer o cópia da classe para o diretório apropriado no Pacific.
 
3.2.4) Fazer o cópia da classe para o diretório apropriado no Pacific.
<br><br>
+
<br>
Copiar o arquivo: ''cgietka.cls''.<br>
+
Copiar o arquivo: ''cgietka.r''.<br>
 
Exemplo, '''Da Pasta:''' ''?:\progress\api\webhandler\'' '''Para a pasta:''' ''\\192.168.200.20\wrk116\app\webapps\ROOT\WEB-INF\openedge\''
 
Exemplo, '''Da Pasta:''' ''?:\progress\api\webhandler\'' '''Para a pasta:''' ''\\192.168.200.20\wrk116\app\webapps\ROOT\WEB-INF\openedge\''
 
<br><br>
 
<br><br>
\\192.168.200.20 - servidor Pacific.<br>
+
'''\\192.168.200.20''': servidor Pacific.<br>
\wrk116 - diretório de trabalho do Progresss.<br>
+
'''\wrk116''': diretório de trabalho do Progresss.<br>
\app - nome do broaker do Pacific.<br>
+
'''\app''': nome da instância do Pacific.<br>
\webapps\ROOT\WEB-INF\openedge\ - Este valor é padrão, sempre igual.
+
'''\webapps\ROOT\WEB-INF\openedge\''': Este valor é padrão, sempre igual.
 
<br><br>
 
<br><br>
 
 
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.<br>
 
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.<br>
 
''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.''<br>
 
''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.''<br>
 
[[Arquivo:cgietka20.png]]
 
[[Arquivo:cgietka20.png]]
<br><br><br>
+
<br><br>
 +
3.2.6) Configuração no Consultor's:
 +
<br>
 +
Para preparar o Consultor's para a integração acesse no nenu: ''Integrações -> Etka -> Parametrização''. Ao abrir o programa ''edi305d'' realize a parametrização.<br>
 +
[[Arquivo:cgietka21.png]]<br>
 +
A leitura dos orçamentos: <br>
 +
- Situação Abertos,<br>
 +
- Prazo para listar: 2 dias,<br>
 +
- Série: série configurada,<br>
 +
- Validade: maior que o dia atual.
  
'''4) Configuração do COMBox e Etka'''
+
<br><br><br>
 +
3.2.7) Gerando orçamento sem itens:
 
<br>
 
<br>
 +
O cadastramento de orçamentos zerados (sem itens) pode ser gerado através do programa ''edi304d'' e pode ser encontrado no menu: ''Gerar Orçamento Zerado''.<br>
 +
[[Arquivo:cgietka22.png]]
 +
<br><br><br>
 +
'''4) Configuração do COMBox e Etka'''<br>
 
''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.''<br><br>
 
''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.''<br><br>
 
+
4.1) Para configuração do Combox e Etka segue manual fornecido pela OIC. [[Arquivo:config_etka_combox.pdf|miniaturadaimagem|Manual Configuração Etka Combox]].
Para configuração do Combox e Etka segue manual fornecido pela OIC. [[Arquivo:config_etka_combox.pdf|miniaturadaimagem|Manual Configuração Etka Combox]].<br>
+
<br><br>
 
+
4.2) Próximo passo da configuração.<br>
 
+
[[Arquivo:cgietka25.png]]
 
+
<br><br>
Atualize o menu do sistema, pelo menu:<br>
+
4.3) Próximo passo da configuração.<br>
Outros > Atualização do Menu. No caminho, direcione para o diretório ??\progress\implanta, clique em ok egerar em tela.
+
[[Arquivo:cgietka30.png]]
<br>Após a atualização, feche o sistema e abra-o novamente.
+
<br><br>
<br>  
+
4.4) Próximo passo da configuração.<br>
Pelo menu geral acesse: Integrações > Concessionárias > Volkswagem > Configuração Etka.
+
[[Arquivo:cgietka40.png]]
<br><br>  
+
<br><br><br>
[[Arquivo:Etka1..png | 700px]]
+
'''5) Interface de integração'''
<br><br>  
+
<br>
Abrindo este programa, acesse o botão Parâmetros.
+
5.1) Interface de integração fornecido pela OIC. [[Arquivo:Layout.pdf|miniaturadaimagem|Layout]].
<br><br>  
+
<br><br><br>
[[Arquivo:Etka2..png ]]
+
'''6) Logs'''
<br><br>  
+
<br><br>
Na opção '''Atalho ETKA:''' informe o caminho do executável do programa.
+
Os arquivos de log podem ajudar a identificar problemas inesperados.<br><br>
<br>'''Arquivo  INI: ''' informe  o  caminho  do  .ini  (pode  ser  localizado  clicando  com  o  botão  direito  –  propriedades  do  ETKApara obter essa informação. <br>'''Porta:'''  informe  o  número  da  porta  de  comunicação. O  número  da  porta  informado  deve  ser  o  mesmo  númeroinformado no catalogo eletrônico ETKA, na tela INI – EDITOR.<br>Abrir o ETKA para realização de algumas configurações.<br>Clicar no ícone INI - EDITOR<br> <br> [[Arquivo:Etka3..png | 700px]]<br> <br> <ul><li> Clicar na opção Conexões DMS.<li> Marcar  a  opção  XDTI  e  preencher  as  opções  conforme  figura  abaixo.  T ambém  é  necessário  acionar  obotão Criar , para que seja criada uma Licença XDTI para o sistema.  Após acionar o botão Salvar .</ul><br> <br> [[Arquivo:Etka4..png | 700px]]<br> Na guia COMUNICAÇÕES, clicar na opção Conexões em geral.<br>Marcar as opções conforme figura abaixo e Salvar .<br> <br> [[Arquivo:Etka5..png | 700px]]<br> <br> <br>Concluída  desta  configuração, o  Consultor's  esta  pronto  trocar  informações  com  o  catalogo  eletrônico  Etkafazendo a integração entre os dois sistemas.<br>No  Consultor's  a  integração  pode  ser  feita  pelos  seguintes  programas: ofi020d2 - Requisição de Peças, est023c –Consulta  de  Mercadorias  e  pec001d3  –  Itens  do  Pedido  de  Compra.  Estes  programas  executam  a  central  decomunicação dom o ETKA a partir do botão localizado na parte de baixo da tela, conforme figura abaixo. <br> <br> [[Arquivo:Etka6..png | 700px]]<br> <br> Com  a  tela  do  Consultor's  (etka  –  Central  de  Comunicação  com  Etka)  aberta,  vá  até  o  catálogo  eletrônico  ETKA,crie  uma  ficha  de material,  adicione  peças  e acione  o  botão Transmitir ,  logo  após  esta  ação,  as  peças  da  ficha  dematerial  do  catálogo  eletrônico  ETKA  serão  transmitidas  para  a  tela  do  Consultor's,  conforme  exemplo  mostradonas próximas duas figuras. <br> <br> [[Arquivo:Etka7..png | 700px]]<br> <br> Após acionar o botão de transmissão as peças serão carregadas para o programa do Consultor's. <br> <br> [[Arquivo:Etka8..png | 700px]]<br> <br> Agora  acione  o  botão  exportar  para  levar  as  peças  para  o  programa  do  Consultor's  que  executou  a  tela  etka  –Central de Comunicação com Etka.
+
No serviço da CGI, os arquivos de log ficam no seguinte diretório: \\<servidor>\wrk116\<agente Pacific>\logs <br>
 
+
Arquivos: app.agent.log e cgietka-2019-05-16.txt
 +
<br><br>
 +
No serviço COMBox, os arquivos de log ficam no seguinte diretório: C:\Program Files (x86)\COMbox-Connector\log
 +
Arquivos: combox-connector.log
 +
<br><br>
 
[[Category:Consultor's]]
 
[[Category:Consultor's]]

Edição atual tal como às 12h10min de 13 de setembro de 2019

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

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

3.2.2) Acessar o WebTransport no APP.
Cgietka02.png

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.r
Handler URL: 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: porta da instância App do Pacific.
/web/cgietka: endereço final onde responde o serviço. Este valor é padrão, sempre igual.
Cgietka03.png

3.2.4) Fazer o cópia da classe para o diretório apropriado no Pacific.
Copiar o arquivo: cgietka.r.
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.
Cgietka20.png

3.2.6) Configuração no Consultor's:
Para preparar o Consultor's para a integração acesse no nenu: Integrações -> Etka -> Parametrização. Ao abrir o programa edi305d realize a parametrização.
Cgietka21.png
A leitura dos orçamentos:
- Situação Abertos,
- Prazo para listar: 2 dias,
- Série: série configurada,
- Validade: maior que o dia atual.




3.2.7) Gerando orçamento sem itens:
O cadastramento de orçamentos zerados (sem itens) pode ser gerado através do programa edi304d e pode ser encontrado no menu: Gerar Orçamento Zerado.
Cgietka22.png


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

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

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


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