Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

CONFIGURAÇÃO DAS INTEGRAÇÕES (TMSAI80 - SIGATMS) 

Nesta rotina, apenas um cadastro ativo poderá ser cadastrado, para cada tipo de integração.

Avaliar se o campo ATIVO = SIM para configuração a ser criada/alterada.

Além disso, atenção a cada sequencia de dados inseridos na ABA HERE, tabela de Grid (DNM) - há a opção "Bloqueado ? " - que indica se o registro está bloqueado ou não, podendo assim criar ou não um  histórico das sequencias criadas.

Image Added


DETALHAMENTO DOS CAMPOS DE INTEGRAÇÃO HERE

  1. Sequência - Indica a sequência da configuração. 

  2. Client ID -  Indica o ID do Client para conexão.

  3. Client Secre -  Indica a senha para conexão do client.

  4. Tenant -  Indica o tenant para conexão.

  5. URL Token - Indica a URL para conexão e busca do Token da Here.

  6. URL HERE - Indica a URL para conexão com a Here.

  7. Usuário -  Indica o usuário de conexão.   

  8. Senha -  Indica a senha para conexão do client.

  9. Token - Indica a chave do token para acesso ao sistema externo.  

  10. Data Token -  Indica a data de busca do token.  

  11. Hora Token - Indica a hora de busca do token.   

  12. Vencto Token - Indica o tempo de expiração do token.



  13. Cod Fonte  -  Indica o código da fonte de integração.  

  14. Descr Fonte - Exibe a descrição da fonte de integração. 

  15. Bloqueado? -  Campo do Protheus que indica se o registro está bloqueado ou não.

  16. Sequenciamento Automático - Este campo determina se o envio à Here será de forma automática após a criação da programação de carregamento.

  17. Viagem Automática  - Este campo determina se, após o retorno do sequenciamento da Here e de sua atualização no Protheus, a efetivação da programação de carregamento será executada de forma automática.

  18.  Gera Planejamento Automático  -  Este campo determina se após o cadastro do planejamento, a geração do histórico de integração será executada de forma automática.

  19. Envia Planejamento Automaticamente - Este campo determina se após a geração do histórico de integrações, o planejamento será enviado de forma automática à Here.

  20. Tipo de Planejamento  - Este campo determina se o envio do planejamento será enviado de forma: 1-Síncrona ou 2-Assíncrona. A diferenciação está somente na quantidade de registros de documentos, veículos e perfis que serão enviados. Estas quantidades devem ser configuradas nos campos de quantidades máxima de registros.

  21. URL Síncrono   - Este campo determina o EndPoint para envio do JSon de planejamento de forma síncrona.

  22. URL Assíncrono - Este campo determina o EndPoint para envio do JSon de planejamento de forma assíncrona.

  23. Localização do MapaEste campo determina o local no Protheus onde se encontra o arquivo o arquivo em Java Script (HereMap.HTML).

  24. Quantidade Viagens Mapa  - Este campo determina quantas programações de carregamento serão exibidas simultaneamente no mapa.

  25. Quantidade Máxima Documentos - Este campo determina o limite máximo de documentos para envio de forma síncrona.

  26. Quantidade Máxima de Veículos - Este campo determina o limite máximo de veículos para envio de forma síncrona.

  27. Quantidade Máxima de Perfis -  Este campo determina o limite máximo de perfis dos veículos para envio de forma síncrona.

  28. e 29. Código Registro Documento e Descrição Registros de Documento -  Campos para localização da quantidade de documentos que serão enviados à Here, o sistema faz uso destes campos de código e descrição dos registros de documentos de acordo com o layout configurado.

...

     32 e 33. Código Registro Perfis e Descrição Registros de Perfis - Campos para localização da quantidade de perfis de veículos que serão enviados à Here, o sistema faz uso destes campos de código e descrição dos registros de perfis de acordo com o layout configurado.

TESTAR INTEGRAÇÕES / TOKEN

Ao término do cadastro dos dados/informações na rotina Configuração das Integrações (TMSAI80 - SIGATMS)ou na alteração de dados, utilizando a opção/botão Outras Ações é disponibilizado a opção de Teste Token.

Informações
titleImportante:

(aviso) Caso existam diversas integrações cadastradas, ou seja, mais de uma aba preenchida com dados de cada integração (Checklist, Coleta Entrega, Portal Logístico, etc), para solicitação de teste token, será necessário clicar na aba da integração e na sequência no Grid da qual se deseja realizar a requisição/consulta.

Desta forma:

Para teste token Here, clicar aba Here, posicionar em um dos campos do grid (tabela DNM) - acionar a opção/botão Outras Ações é disponibilizado a opção de Teste Token.

Para teste token Coleta Entrega clicar aba Coleta Entrega, posicionar em um dos campos do grid (tabela DN1) - acionar a opção/botão Outras Ações é disponibilizado a opção de Teste Token.

Já para teste token Portal Logístico clicar aba Portal Logístico, posicionar em um dos campos do grid (tabela DND) - acionar a opção/botão Outras Ações é disponibilizado a opção de Teste Token.

E assim por diante em qualquer aba referente a Configuração de Integrações.

image2022-11-17_17-48-7.pngImage Modified

...

No caso de retorno positivo uma mensagem com hash do token será apresentada (exemplo imagem abaixo).

Image Modified

No caso de

...

 divergência, inconsistência, ou erro no retorno, um help/alerta será apresentado.

Aviso
titleDiferença entre URL's

  A URL de token indica a URL para  geração do token/validação.

 A URL do APP indica a URL para base das APis.

É importante saber que mesmo com a configuração incorreta da URL de APP, estando a configuração de URL de TOKEN correta o retorno ocorrerá normalmente nesta rotina, contudo se a URL de APP não estiver adequada ocorrerão falhas na integração.



06. TABELAS UTILIZADAS

  • DD9 - Conf Integr TMS x Here   
  • DF8  - Programação de Carregamento   
  • DN0 - Configuração das Integrações  
  • DN1 - Config Integr Coleta/Entrega  
  • DN2 - Tipos de Registro             
  • DN3 - Layout dos Registros  
  • DN4 - Relacionamento entre Registros
  • DN5 - Histórico de Integrações      
  • DN6 - Fontes de Integração        
  • DNB - Herança ID Externo
  • DNC - Cabeçalho do Histórico
  • DNM - Conf Integr TMS x Here        
  • DNO -  Subprocesso da Fonte          
  • DNP - Cabeçalho do Planejamento     
  • DNR - Veículos do Planejamento  

...