Páginas filhas
  • ER_PCREQ-9642_Mensageria TOTVS - Mudanças no businessContent

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Correção de erros e alteração da entidade exemplo Protheus

...

As equipes responsáveis pelos produtos Totvs deverão desenvolver serviços (webServices) para expor as estruturas (schemas) de seus objetos de negócios, afim de que possam ser chamados externamente. Esses schemas deverão estar no formato de xsd;

Isso permitirá com que os produtos possam enviar dados no formato de xml (BusinessContent) contendo informações já no formato nativo dos objetos de negócio (sem necessidade de transformação).

...

  • Origem da mensagem:
    • O aplicativo do ERP chama o EAI(ERP) passando as seguintes informações:
      • Nome da mensagem (mensagem única ou mensagem nativa);
        • Deve ser adicionado no início do nome da mensagem o “nome do ERP” separado por “/”.
          •  Ex: Protheus/SA1MATA010, sendo:
            • Protheus -> nome do ERP;
            • SA1 MATA010 -> nome do objeto de negócio;
      • Versão da mensagem (somente em caso de mensagens únicas);
      • Xml dos dados no formato do ERP.
    • O EAI(ERP) inclui a mensagem na fila;
    • O EAI(ERP) recupera a mensagem da fila;
    • O EAI(ERP) cria a mensagem TotvsMessage (incluindo na tag “BusinessContent” o xml recebido com os dados no formato nativos do ERP);
    • O EAI(ERP) envia para o WebServices EAI(Vertical) a mensagem no formato “TotvsMessage”;

  • Destino da mensagem:
    • O EAI (vertical) inclui a mensagem na fila;
    • O EAI(Vertical) recupera a mensagem da fila;
    • O EAI(Vertical) recupera a primeira parte do nome da mensagem (até a posição da barra “/”) recuperando com isso o nome do ERP. Se o mesmo emparelhar com o nome do ERP em questão, trata-se de um receptor ERP. Caso contrário, trata-se de um vertical;
    • O EAI(vertical) solicita os seguintes serviços do seguimento vertical:
      • Execução do serviço de transformação da mensagem (formato nativo do ERP) para o formato nativo do segmento vertical;
      • Execução do objeto de negócio do segmento mapeado com o nome do objeto de negócio enviado pelo ERP;
      • Atualização dos valores de De/Para contendo informações das chaves de origem/destino;
        • Deve ser localizado na própria mensagem de origem os valores das chaves;
      • Retorno para o EAI(vertical) um xml contendo os dados atuais após a execução do objeto de negócio;

        Informações

        A partir de agora, os EAI’s não serão mais responsáveis em transformar mensagens e controlar informações de De/para. Esses serviços serão de responsabilidade dos diversos seguimentos.

        Informações

        Serviços genéricos poderão ser disponibilizados no EAI para facilitar o trabalho dos segmentos.

...

  • Origem da mensagem:
    • O segmento vertical chama o EAI(vertical) passando as seguintes informações:
      • Nome da mensagem (mensagem única ou mensagem nativa);
        • Deve ser adicionado no início do nome da mensagem o “nome do ERP” que receberá a mensagem separado por “/”.
          •  Ex: Protheus/SA1MATA010, sendo:
            • Protheus -> nome do ERP;
            • SA1 MATA010 -> nome do objeto de negócio;
      • Versão da mensagem (somente em caso de mensagem única);
      • Versão da mensagem (em caso de mensagem única);
      • Xml dos dados do vertical (no exemplo em questão, trata-se do formato nativo do segmento vertical).
    • O EAI(vertical) inclui a mensagem na fila;
    • O EAI(vertical) recupera a mensagem da fila;
    • O EAI(vertical) solicita os seguintes serviços do seguimento vertical:
      • Serviço de transformação da mensagem (do formato nativo do vertical) para o formato nativo do ERP;
    • O EAI(vertical) cria a mensagem TotvsMessage (incluindo na tag <BusinessContent> o xml recebido do segmento com os dados no formato ERP);
    • O EAI(vertical) envia para o WebServices EAI(ERP) a mensagem no formato <TotvsMessage>

  • Destino da mensagem:
    • O EAI (ERP) inclui a mensagem na fila;
    • O EAI(ERP) recupera a mensagem da fila;
    • O EAI(ERP) recupera a primeira parte do nome da mensagem (até a posição da barra “/”) recuperando com isso o nome do ERP. Se o mesmo emparelhar com o nome do ERP em questão, trata-se de um receptor ERP. Caso contrário, trata-se de um vertical;
    • O EAI(ERP) solicita os seguintes serviços do seguimento vertical:
      • Execução do objeto de negócio para processamento da mensagem. As informações de leitura dos dados recém criados pelo objeto de negócio deverão ser retornadas.
    • O EAI(ERP) cria a mensagem de resposta “ResponseMessage” e retorna para a origem;

...