Árvore de páginas

Versões comparadas

Chave

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


Objetivo


Índice

AvisoCaso tenha acessado diretamente essa página, leia

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

Processos:

  • Recebimento e Reconhecimento de mensagens.
  • Processamento e Geração de mensagens de resposta.
  • Publicação de mensagens.
  • Envio de mensagens.
  • Saneamento de mensagens.
Aviso

Antes de prosseguir certifique-se que já realizou a leitura da página principal

Integração Datasul x Smart Link. Nesta página estão os conceitos principais para entendimento

sobre

correto dos componentes envolvidos na integração.

Recebimento mensagens

Reconhecimento de mensagens

Painel
borderColorlightblue
titleColororange
borderStyledashed
titleComponente envolvidos no processo
  • Smart Link Server.
  • Smart Link Client.
    Aviso

    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 . Neste processo é utilizada a estratégia de ACK e NACK, que é o processo para indicar indicando para o Smart Link Server se a mensagem foi reconhecida ou não, deste modo removendo a mensagem da fila.


    Informações

    O Smart Link Client realiza

    algumas

    validações

    inicias

    iniciais antes de enviar a mensagem para reconhecimento no produto Datasul.

    • Validação
    simples
    • da existência da mensagem
    ;
    • .
    • Validação da existência da configuração totvs.appserver.
      • Configuração obrigatória do serviço que é 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
    • :
      • É realizado o envio de mensagem do erro ocorrido para o Smart Link Server.
      • A mensagem é encaminhada para DLQ (Dead-Letter Queue).

    Após as validações serem executadas com sucesso,

    para reconhecimento/processamento posterior. Também é realizado o envio de mensagem de erro 

    Componentes envolvidos no processo:

      • Smart Link Client.
      • Datasul.
    Processamento de mensagens

    Geração de mensagens de resposta

    Publicação de mensagens

    é 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.
      • É neste momento que o objeto desenvolvido pelo segmento indica se a mensagem é reconhecida.

    Após as validações serem executadas, é retornado o resultado do reconhecimento para o Smart Link Client, e assim seguindo o fluxo para encaminhamento do resultado para o Smart Link Server.

    No produto Datasul, a situação da mensagem será Reconhecida ou Não Reconhecida.

    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)

    Nota

    Acesso restrito aos participantes TOTVS. 

    Para informações sobre o desenvolvimento de um programa de reconhecimento de mensagem acesse a documentação.




    Image Added







    Processamento e Geração de mensagens de resposta

    O processamento 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 agendamento automaticamente ocorre a cada 5 minutos no componente Smart Link Client.
    • Somente as mensagens recebidas e que estejam com a situação Reconhecida ou Reprocessar são aptas para processamento.
    • Para o processamento que ocorre no produto Datasul, é respeitado o usuário e empresa registrado na mensagem recebida.
    • Caso aconteça alguma inconsistência no processo:
      • É realizada a reversão da operação.
      • A situação da mensagem é alterada para Processamento com erro.
    • O processamento é realizado pelo objeto desenvolvido pelo segmento.
      • A geração de uma mensagem de resposta ocorrerá no processamento do objeto desenvolvido pelo segmento.
    • Após a operação ser finalizada com sucesso, as mensagens de resposta ficam aguardando o processo de envio de mensagens. 
    Nota

    Acesso restrito aos participantes TOTVS. 

    Para informações sobre o desenvolvimento de um programa processador e gerador de mensagem de resposta acesse a documentação.

    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)

    Image Added



    Publicação de mensagens


    A publicação de mensagens é o procedimento utilizado pelas rotinas do produto Datasul para a troca de mensagens com a plataforma TOTVS Apps.

    Informações
    • A rotina do Datasul faz o uso de um método para publicação de mensagem, disponibilizado em uma Classe Framework.
    • A mensagem publicada é registrada no produto Datasul, tendo a sua situação Reconhecida.
    • A mensagem registrada aguarda ser enviada, que acontece no processo de envio de mensagens. 
    Nota

    Acesso restrito aos participantes TOTVS. 

    Para informações sobre o desenvolvimento de um programa publicador de mensagem acesse a documentação.

    Image Added



    Envio de mensagens


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

    Informações
    • O processo de envio é solicitado pelo componente Smart Link Client que possui um agendamento interno do serviço
      • É executado automaticamente a cada 5 minutos. 
    • O processo ocorre somente para as mensagens publicadas ou de resposta, e que estejam com a situação Reconhecida ou Reenviar.
      • A situação da mensagem é atualizada para Enviada ou Envio com erro.
    • Este procedimento é a última etapa da troca de mensagens entre os componentes (Datasul e Smart Link Client), deste modo permitindo que a mensagem chegue até ao componente Smart Link ServerTOTVS Apps.
    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)

    Image Added



    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.

    Informações

    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)


    Image Added

    Envio de mensagens

    Saneamento de mensagens