Histórico da Página

...

Integrar o cadastro de Tipos de Entidades Adicional do ERP Microsiga Protheus com o sistema de FrontOffice da agência de viagem. A integração possibilitará que os sistemas se comuniquem através de uma Mensagem Única, utilizando o schema XSD da TotvsMessage AdditionalEntitiesTypesAdditionalEntityType.

Definição da Regra de Negócio

Os sistemas de FrontOffice da agências de viagem irão se comunicar com o ERP Microsiga Protheus para sincronismo das informações entre as respectivas bases de dados. Para isso, se faz necessária a utilização da tecnologia Enterprise Application Integration (EAI).
Essa comunicação utilizará o padrão SOAP para envio e recebimento de arquivos XML, além de seguir um conjunto de regras definidas para o padrão de Mensagem Única da TOTVS. Os dados que serão sincronizados entre os sistemas integrados estarão contidos no arquivo XML, que deverá estar no padrão definido no esquema da Mensagem Única conforme XSD da TotvsMessage AdditionalEntitiesTypesAdditionalEntityType.
Na integração, as mensagens recebidas e enviadas pelo BackOffice serão processadas pelo adapter EAI do respectivo cadastro. O adapter é o responsável por processar essas mensagens e, se estiver configurada, acionar a rotina de integração para inclusão, alteração e/ou exclusão desse cadastro. Por sua vez, essa rotina será responsável por validar e gravar os dados de acordo com a operação que estiver sendo realizada e retornar para o adapter a mensagem de retorno do processamento (êxito ou falha) que, por fim, envia a mensagem de resposta ao sistema requisitante.
A manutenção (inclusão, alteração ou exclusão) de um registro desse cadastro será feita tanto pelo sistema de FrontOffice como pelo BackOffice, replicando os dados mutuamente. Portanto, o sistema de FrontOffice deverá levar em consideração a regra de negócio do cadastro.

...

• No fonte TURI005, deve ser adicionado a diretiva de include para o arquivo FWADAPTEREAI.CH;
• Microsigra Protheus recebe Mensagem Única:
  • Ao receber a mensagem de negócio (BusinessMessage), o EAI verificará se a rotina TURA005 está cadastrada no "Adapter EAI" e se a mesma está configurada para o recebimento de mensagem no método Síncrono. Caso a rotina esteja cadastrada e configurada corretamente, a função IntegDef deverá chamar a rotina TURI005 que fará o tratamento do XML recebido, e efetuar a gravação dos dados;
  • No final do processamento, deverá será enviada a mensagem de resposta (ResponseMessage) ao sistema requisitante com o status do processamento e, no caso de sucesso da operação INSERT, o valor da chave da entidade para atualização do respectivo DE/PARA;
• Microsigra Protheus envia Mensagem Única:
  • Ao ser efetuada uma inclusão, alteração ou exclusão, será disparado um evento que verificará se a rotina TURA005 está cadastrada no "Adapter EAI" e se a mesma está configurada para o envio de mensagem no método Síncrono. Caso a rotina esteja cadastrada e configurada corretamente, a função IntegDef retornará o XML (BusinessMessage) ao EAI, que o enviará a mensagem ao sistema requisitante;
  • Após o sistema requisitante receber e processar a mensagem, deverá enviar a mensagem de resposta (ResponseMessage) ao Microsiga Protheus com o o status do processamento e, no caso de sucesso da operação INSERT, o valor da chave da entidade para atualização do respectivo DE/PARA;
• Depois da alteração do fonte TURA005 e do desenvolvimento do fonte TURI005, acessar o módulo Configurador e cadastrar o adapter através do menu Ambiente -> Schedule -> Adapter E.a.i da seguinte forma:
  • Mensagem única: Sim;
  • Rotina: TURA005;
  • Mensagem: AdditionalEntityType;
  • Descrição: Tipos de Entidade Adicional;
  • Envia: Sim;
  • Recebe: Sim;
  • Método: Síncrono;
  • Operação: Todas;
  • Versão Envio: 1.000;
• A seguir, detalhe dos campos do cadastro de Tipos de Entidades Adicional (tabela G3E) com as respectivas TAGS do TotvsMessage AdditionalEntitiesTypesAdditionalEntityTypes:

...