Objetivo

Este documento tem por objetivo auxiliar no entendimento dos processos que ocorrem no Smart Link Client implementado no produto Datasul.

  • Recebimento de mensagens;
  • Reconhecimento de mensagens;
  • Processamento de mensagens;
  • Geração de mensagens de resposta;
  • Publicação de mensagens;
  • Envio de mensagens;
  • Saneamento de mensagens;



Caso tenha acessado diretamente essa página, leia Integração Datasul x Smart Link.





Recebimento de mensagens

Reconhecimento de mensagens

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.
  • 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 com sucesso, ocorrem as a

  • é realizado o envio da mensagem para reconhecimento no produto Datasul.
  • Mensagem reconhecida:
    • É enviada ACK para Smart Link Server.
  • 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

É o procedimento para realizar o envio das mensagens registradas no produto Datasul. 

  • O processo ocorre somente para as mensagens publicadas ou de resposta, e que estejam com a situação Reconhecida ou Reenviar.

O processo de envio é solicitado pelo componente Smart Link Client, que possui um agendamento interno do serviço que é executado automaticamente a cada 5 minutos. 


Para acompanhamento das mensagens Publicadas ou de Resposta utilize o programa  Gerenciador de Mensagens do Smart Link (html.smart-link-manager)


Saneamento de mensagens

É o procedimento que ocorre visando eliminar registros de mensagens que atingiram um período de histórico, e contenham alguma das situações permitidas para eliminação.

  • Situações de mensagens permitidas para eliminação: 
    • Finalizada.
    • Não reconhecida.
    • Abandonada.
  • Período de histórico padrão:
    • 90 dias.
    • Internamente as mensagens são registradas por Data e Tempo.

O processo de saneamento é solicitado pelo componente Smart Link Client, que possui um agendamento interno do serviço que é executado automaticamente a cada 5 minutos. A execução do saneamento ocorre no produto Datasul.

Para mais informações sobre situações das mensagens acesse a documentação do programa  Gerenciador de Mensagens do Smart Link (html.smart-link-manager)