Versões comparadas

Chave

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

Evolução da Arquitetura da Integração com Protheus

Visando oferecer uma melhor usabilidade na integração por mensagens EAI, as mensagens associadas ao ciclo de vida de um lançamento financeiro no RM (inclusão, alteração, cancelamento, baixa, cancelamento da baixa, acordo, e cancelamento do acordo), passam a dispor de um novo modelo de integração.

Esta evolução no momento se aplica exclusivamente aos lançamentos gerados pelo Educacional, e a habilitação da funcionalidade está sendo feita de forma progressiva e controlada, para apenas alguns clientes.


Como funciona

Como exemplo, considere a inclusão de um novo lançamento financeiro gerado a partir do Educacional. Durante os procedimentos de registro da inclusão do lançamento, a mensagem que seria gerada ao Protheus não é executada, em seu lugar ocorre a gravação de um registro no banco de dados com o conteúdo da mensagem. Assim, após consolidada toda a atualização do banco de dados no RM, esta mensagem registrada no banco de dados é resgatada, e então enviada ao Protheus. 

O envio da mensagem ocorre a partir de um dado consistentemente gravado no RM. Se ao enviar a mensagem ao Protheus, o procedimento de inclusão for executado com sucesso no Protheus, a mensagem é removida do banco de dados. Por outro lado, se ao enviar a mensagem ao Protheus, este reportar algum problema, a mensagem fica pendente no banco de dados. Estando a mensagem pendente, o(s) lançamento(s) relacionado(s) ficam em estado de inconsistência, e ficará(ao) impedido(s) de ser(em) submetido(s) a outros processos do RM, tais como baixa e o acordo.


Mensagens Pendentes

Se houver algum incidente que impeça o envio das mensagens EAI para o Protheus, as mensagens pendentes poderão ser observadas na visão de monitoramento das mensagens EAI, disponível através do menu "Utilitários | Mensagem EAI". Uma vez que a causa do problema na comunicação seja solucionada, as mensagens poderão ser selecionadas, e enviadas através do processo "Reenviar Mensagem".

Image Added


Image Added

Ao solicitar a edição da mensagem EAI pendente, será apresentado detalhamento da mensagem, com a mensagem de erro gerada pelo EAI, e o detalhamento do conteúdo da mensagem na aba "Metadados" em formato XML.


Reenvio de Mensagem

Uma mensagem pode existir de forma autônoma, ou como parte de um agrupamento (grupo de mensagem). Ao selecionar uma ou mais mensagens da visão e solicitar o reenvio, o sistema irá identificar os respectivos grupos de mensagens associados àquelas mensagens, ordenará estes grupos por ordem cronológica de execução, e irá disparar cada uma das mensagens destes grupos que estejam com status "Pendente" ou "Falha". 

Esta execução avançará de mensagem em mensagem em cada grupo, até que todas tenham sido enviadas, ou até que ocorra o primeiro erro. Esta medida é importante porque em alguns casos, existe dependência entre as mensagens, como exemplo, existe um processo do Educacional que modifica o lançamento financeiro, e em seguida efetuar a respectiva baixa. Neste cenário, se houver impedimento para a modificação do lançamento, a mensagem de baixa deve aguardar a correção do impedimento.



Expandir
titleManutenção de Lançamentos

O processo de inclusão, alteração e cancelamento de lançamentos financeiros, integrados ao Protheus no contexto desta nova arquitetura dispõe de alguns mecanismos visando facilitar a correção de eventuais problemas.

Ao proceder a inclusão de novo lançamento, se houver algum problema para o envio da mensagem, este será marcado como pendente de envio de mensagem EAI, e permanecerá bloqueado para execução de outros processos (ex.: baixa, acordo, etc.).

Se o lançamento foi incluído no RM, mas ainda não foi integrado ao Protheus, este poderá ser editado, ou cancelado. Se editado neste contexto, ocorrerá a substituição da mensagem EAI pendente por uma nova modificada, que será submetida a uma nova tentativa de envio. Se cancelado neste contexto, ocorrerá apenas a remoção da mensagem EAI pendente, procedendo o processo de cancelamento no RM sem a obrigação de primeiro enviar a mensagem de inclusão.

Se o lançamento foi incluído no RM e este foi corretamente integrado ao Protheus, ao editar este lançamento, este será modificado no RM e uma mensagem de alteração será enviada ao Protheus. Ocorrendo algum impedimento para alteração deste lançamento no Protheus, o lançamento ficará bloqueado para outros processos, inclusive para cancelamento.

Expandir
titleBaixa de Lançamentos

Ao proceder a baixa de um lançamento, este será validado da não existência de bloqueio para o envio de mensagem EAI devido a alguma mensagem EAI anterior ainda pendente de envio. Não existindo impedimento, a mensagem EAI é colocada em fila de processamento. 

Ao proceder o cancelamento da baixa de um lançamento é avaliado se a mensagem EAI de baixa foi enviada, e processada com sucesso pelo Protheus. Caso a baixa não tenha sido integrada ao Protheus devido a algum incidente, esta baixa poderá ser cancelada no RM sem o envio de mensagem EAI no Protheus.

Expandir
titleAcordo de Lançamentos

Ao proceder o acordo de um lançamento, este será validado de não existência de bloqueio para o envio de mensagem EAI devido a alguma mensagem EAI anterior ainda pendente de envio. Não existindo impedimento, a mensagem EAI é colocada na fila de processamento.

Ao proceder o cancelamento de acordo de um lançamento é avaliado se a mensagem de acordo foi enviada, e processada com sucesso pelo Protheus. Caso o acordo não tenha sido integrado ao Protheus devido a algum incidente, este acordo poderá ser cancelado no RM sem o envio de mensagem EAI no Protheus

A visão de monitoramento das mensagens EAI tem como objetivo exibir informações sobre as mensagens que não foram integradas com sucesso e também a possibilidade de reenviar a mensagem para o EAI através do menu Processos da visão. Quando reestabelecida a conexão do RM com EAI a mensagem poderá ser reenviada e removida da fila de envio.

Image Removed

Reenviar Mensagem

Image Removed

...

.