Objetivo

Este documento tem por objetivo auxiliar no entendimento dos processos que ocorrem na integração do Datasul com Smart Link.

Processos:

Caso tenha acessado diretamente essa página, leia Integração Datasul x Smart Link para entendimento sobre componentes envolvidos na integração.


Recebimento de mensagens

Reconhecimento de mensagens

  • Smart Link Server.
  • Smart Link Client.
  • Smart Link Client.
  • Datasul.

O recebimento de uma mensagem ocorrerá através da troca de mensagem entre o Smart Link Server e o Smart Link Client, fazendo o uso da estratégia de ACK e NACK, indicando para o Smart Link Server se a mensagem foi reconhecida ou não, deste modo removendo a mensagem da fila.

O reconhecimento de uma mensagem ocorrerá através da troca de mensagem entre o Smart Link Client e o produto Datasul, sendo que essa troca de mensagem é realizada diretamente com o Servidor de Aplicação Progress do ambiente Datasul.

O Smart Link Client realiza validações inicias antes de enviar a mensagem para reconhecimento no produto Datasul.

  • Validação da existência da mensagem.
  • Validação da existência da configuração totvs.appserver.
    • Configuração obrigatória do serviço, utilizada para comunicação com o produto Datasul.
  • Validação da existência do identificador do tenant.
    • Configuração recuperada automaticamente na inicialização do serviço, caso não exista a configuração é um indicativo de falha na inicialização.
  • Ocorrendo alguma inconsistência:
    • A mensagem é encaminhada para DLQ (Dead-Letter Queue).
    • É realizado o envio de mensagem do erro ocorrido para o Smart Link Server.

O produto Datasul realizará suas validações em duas etapas, sendo elas:

  • Validações de responsabilidade Framework:
    • Validação do Schema da mensagem.
    • Validação de integração com TOTVS Apps.
    • Validação de valores requiridos na mensagem.
    • Validação do tipo da mensagem.
    • Validação da audiência da mensagem, caso a mensagem tenha audiência.
    • Validação da existência do objeto de negócio utilizado no reconhecimento da mensagem. Este objeto é desenvolvido pelo segmento responsável pela mensagem. 
  • Validações de responsabilidade Segmentos:
    • Validação do conteúdo da mensagem.

Após as validações serem executadas, e caso não tenha ocorrido inconsistência, será realizado o envio da mensagem para reconhecimento no produto Datasul.

  • Para mensagem reconhecida:
    • É enviada ACK para Smart Link Server.
  • Para mensagem não reconhecida:
    • A mensagem é encaminhada para DLQ (Dead-Letter Queue).
    • É realizado o envio de mensagem do erro ocorrido para o Smart Link Server.

Após as validações serem executadas temos o resultado do reconhecimento da mensagem.


Processamento de mensagens

Geração de mensagens de resposta





Publicação de mensagens



Envio de mensagens



Saneamento de mensagens