Linha Datasul

Árvore de páginas

Versões comparadas

Versão antiga 40

changes.mady.by.user Simon Flock Schiesl Ferreira

Gravado em

comparado com

Nova versão 41

changes.mady.by.user Simon Flock Schiesl Ferreira

Gravado em

Chave

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





Objetivo

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

Informações
titleProcessos
  • 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;



Nota

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

Recebimento de mensagens

Nota
  • Para acompanhamento das mensagens utilize o programa  Gerenciador de Mensagens do Smart Link (html.smart-link-manager), sendo especificamente para troca de mensagens entre os componentes Datasul e Smart Link Client.
  • O acompanhamento completo da troca de mensagens abrangendo os componentes TOTVS Apps e Smart Link Server é por meio de ferramentas administrativas em nuvem TOTVS, que possui acesso restrito.





Recebimento e 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.


Informações

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.

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 ACKpara 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.



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.

Informações

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 ACKpara 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.

    O resultado é registrado no produto Datasul e pode ser acompanhando utilizando o programa Gerenciador de Mensagens do Smart Link (html.smart-link-manager).

    O resultado também é retornando para o Smart Link Client, deste modo dando continuidade no processo de recebimento de mensagem.

    Image Modified


    Processamento de mensagens

    Geração de mensagens de resposta



    Publicação de mensagens

    A publicação de mensagens é o procedimento utilizado pelas rotinas do produto Datasul, deste modo conseguindo realizar troca de mensagens com 


    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. 
    Nota
    • O processo ocorre somente para as mensagens publicadas ou de resposta, e que estejam com a situação Reconhecida ou Reenviar.
    • Este procedimento é a ultima etapa dos componentes (Datasul e Smart Link Client) para troca de mensagens, deste modo permitindo que a mensagem chegue até o componente TOTVS Apps, plataforma de aplicações TOTVS.
    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.
    • Enviada (Somente para mensagem Publicada)

    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.

    Nota

    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)