Column

width	2

EAI (do inglês Enterprise Application Integration) é uma referência aos meios computacionais e aos princípios de arquitetura de sistemas utilizados no processo de Integração de Aplicações Corporativas. Os procedimentos e ferramentas de EAI viabilizam a interação entre sistemas corporativos heterogêneos por meio da utilização de serviços.

Objetivo do documento

Ampliar o conhecimento sobre o tema integrações

Conhecer as tecnologias envolvidas

Conhecer o padrão TOTVS para integrações

draw.io Diagram
border false
viewerToolbar true
fitWindow false
diagramName Conteudo
simpleViewer true
links auto
tbstyle top
lbox true
diagramWidth 1331
revision 2
O que tem aqui?

Conceitos gerais de integração

Definição de EAI
Por que integrar?
Formas de integração
Elementos de uma integração

Tecnologias

XML/SOAP
JSON/REST

Mensagem Padronizada

Termos e conceitos
Anatomia de uma mensagem

draw.io Diagram
border false
viewerToolbar true
fitWindow false
diagramName Inicio
simpleViewer true
links auto
tbstyle top
lbox true
diagramWidth 1331
revision 2
Vamos Começar

Definição de EAI

Painel

borderColor	grey
borderWidth	3
borderStyle	dashed

Definição de EAI

Expandir

title	Clique para saber...

Enterprise Application Integration

É uma referência aos meios computacionais e aos princípios de arquitetura de sistemas utilizados no processo de Integração de Aplicações Corporativas.

https://pt.wikipedia.org/wiki/EAI

Tem com objetivo alcançar a interoperabilidade e a organização do fluxo de informações entre aplicações heterogêneas

garantir a comunicação entre as diferentes aplicações que constituem o sistema de informação da empresa, incluindo clientes, parceiros ou fornecedores.

o projeto EAI envolve a implementação de uma arquitetura em que as diferentes aplicações se comuniquem entre si

isso implica no desenvolvimento de conectores (middleware) para a interface das aplicações que utilizam protocolos de comunicações diferentes (geralmente proprietários).

Por que Integrar?

Painel

borderColor	grey
borderWidth	3
borderStyle	dashed

Por que Integrar?

Expandir

title	Clique para saber...

Os objetivos da arquitetura do EAI são:

Integração de aplicações, sistemas de informação e processos de negócio de uma empresa;
Integração com aplicações internas e externas da empresa que servem de suporte ao processo de negócio da mesma, como por exemplo processo financeiro, RH, dentre outros;
Conjunto de ferramentas de análise e monitoramento de processos e mensagens em tempo real.

Alguns conceitos

Painel

borderColor	grey
borderWidth	3
borderStyle	dashed

Alguns conceitos

Formas de Integração - Modos de Comunicação

Expandir

title	Clique para saber...

Formas de Integração - Modos de Comunicação

Painel

borderColor	grey
borderWidth	2
borderStyle	dashed

SÍNCRONO

Na integração síncrona, o programa de origem envia a mensagem e só prossegue a execução ao obter o retorno da mesma.

Painel

borderColor	grey
borderWidth	2
borderStyle	dashed

ASSÍNCRONO

Na integração assíncrona, o sistema envia a mensagem, e em seguida deposita a mensagem na fila, retornando OK para o sistema.

Enquanto esse procedimento é efetuado, o programa em questão continua sendo executado. A mensagem enviada permanece na fila aguardando seu processamento.

Elementos de uma Integração

Expandir

title	Cique para saber...

Elementos de uma Integração

Componente	Descrição	Exemplo
Sistemas	Refere-se aos sistemas que trocarão informações entre si	Aplicações do módulo de CRM trocando informações com o módulo de faturamento
Dados	Conjunto de dados (layouts de arquivos) que serão trafegados pela arquitetura durante a troca de dados entre os sistemas	XML ou Texto
Interface	Forma de enviar receber dados entre os sistemas	Web services, adaptadores
Comunicação	Tipo de comunicação a ser utilizada durante a troca de informações entre os sistemas	Síncrona ou assíncrona

Integração EAI2

Painel

borderColor	grey
borderWidth	3
borderStyle	dashed

Integração EAI2

Fluxos de Comunicação

Expandir

title	Clique para saber...

Fluxos de Comunicação

O EAI2 deve permitir que uma mesma instância do aplicativo hospedeiro (Datasul 11 ou superior) possa se integrar com vários aplicativos diferentes, denominados denominados External Applications. Esta capacidade implica na existência de regras de roteamento que irão definir quais mensagens devem ser encaminhadas para cada aplicativo.

Portanto, a regra de roteamento levará em consideração APENAS o fluxo de troca de mensagens entre o host application e os external applications, DESCARTANTO qualquer possibilidade de troca de mensagens diretas entre as external applications.

Componentes da Integração - JOINVILLE

Expandir

title	Clique para saber...

Componentes da Integração - JOINVILLE

draw.io Diagram

border	false
viewerToolbar	true

fitWindow	false
diagramName	componentes
simpleViewer	false
links	auto
tbstyle	top
lbox	true
diagramWidth	1071
revision	34

Endereço WSDL -

JBOSS |

TOMCAT

Endereço WSDL - JBOSS | TOMCATInformacao

Expandir

title	Clique para saber...

O endereço WSDL

é distinta para as duas arquiteturas e seguem os formatos

segue o formato abaixo:

Card documentos

Informações

icon	false

http://[server]:[port]/

eai2-

totvseai/public/ws/EAIService?

wsdl Em

wsdl

Em que:

eai2-ws: é o contexto EAIService: é o endpoint

Titulo

WSDL JBOSS

totvseai/public/ws: é o

Informações

icon	false

http://[server]:[port]/eai2-ws/EAIService?wsdl

Em que:

eai2-ws: é o contexto

EAIService: é o endpoint

Para a arquitetura JBOSS ainda existe as dependências de webservices e, os mesmos podem ser acessados via JBOSSWS, utilizando esse endereço:

Nota

http://[server]:[port]/jbossws/services

Neste endereço estão contidas todas as conexões via Webservices na arquitetura JBOSS, inclusive a conexão RPC quando a integração EAI2 for entre duas aplicações Datasul.

Card documentos

Informacao	http://[server]:[port]/<b>totvseai/public/ws/EAIService?wsdl</b><br><br>Em que:<br><b>totvseai/public/ws:</b> é o contexto<br><b>EAIService:</b> é o endpoint
Titulo	WSDL TOMCAT

Informações

icon	false

http://[server]:[port]/totvseai/public/ws/EAIService?wsdl

Em que:

totvseai/public/ws: é o contexto

EAIService: é o endpoint

Na arquitetura TOMCAT, não existe a dependência com webservices, por esse motivo a URL do WSDL para essa arquitetura é fixa.

Também existe a URL para RPC, quando for necessário integrar com outra aplicação Datasul. Neste caso o endpoint da URL também segue o mesmo padrão de sufixo utilizado no JBOSSa seguir:

Informações

icon	false

http://[server]:[port]/totvseai/public/ws/EAIServiceRPC?wsdl

Tecnologias envolvidas na Integração

Expandir

title	Clique para saber...

Tecnologias envolvidas na Integração

XML/SOAP

JSON/REST

MÉTODOS (Verbos) HTTP REST

draw.io Diagram

border	false
viewerToolbar	true
fitWindow	false
diagramName	httpRest
simpleViewer	false
width	1100
links	auto
tbstyle	top
lbox	true
diagramWidth	1049
revision	3

draw.io Diagram
border false
viewerToolbar true
fitWindow false
diagramName mensagem
simpleViewer true
links auto
tbstyle top
lbox true
diagramWidth 1331
revision 2
O que são e como são as Mensagens

Painel

borderColor	white
bgColor	#B0E0E6
borderWidth	2
borderStyle	dashed

Mensagem Padronizada (antes conhecida como mensagem única) é o modelo de dados em que todos os produtos da TOTVS devem trabalhar durante troca de informações. Seu objetivo é evitar o processo de transformação de mensagens, fazendo assim com que a mensagem, após definida, torne-se padrão independente de produtos.

Painel

borderColor	white
bgColor	#B0E0E6
borderWidth	2
borderStyle	dashed

Com o modelo de mensagem apresentado, também se torna uniforme seu tratamento pelos produtos, principalmente no que diz respeito à capacidade de rastreamento, pois em seu conteúdo é possível identificar a origem e o tipo.

Painel

borderColor	white
bgColor	#B0E0E6
borderWidth	2
borderStyle	dashed

Além disso, a mensagem única estabelece alguns padrões que devem ser seguidos por todos os produtos que participam de integrações. Esses padrões, por exemplo, definem tipos de mensagens suportadas e informações obrigatórias que farão parte do conteúdo de cada mensagem. Porém, a composição dessas mensagens será definida em conjunto com especialistas de negócio e não faz parte do escopo deste documento.

A mensagem padronizada é a solução para tornar mais fácil a integração dos vários sistemas adquiridos pela TOTVS.

Expandir

title	Clique para saber...

Painel

borderColor	white
bgColor	#D3D3D3
borderWidth	2
borderStyle	dashed

Uma vez que os produtos TOTVS terão um “idioma” comum para troca de informações, será possível conectar diretamente com vários produtos ao mesmo tempo, trocando informações, sem a necessidade do TOTVS ESB.

No tráfego da integração existem 3 tipos de mensagens, cada uma com uma finalidade.

Expandir

title	Clique para saber...

Painel

borderColor	white
bgColor	#D3D3D3
borderWidth	2
borderStyle	dashed

O padrão de mensagem TOTVS.

draw.io Diagram

border	false
viewerToolbar	true
fitWindow	false
diagramName	Copy of tipoMensagem
simpleViewer	false
width	600
links	auto
tbstyle	top
lbox	true
diagramWidth	516
revision	1

draw.io Diagram
border false
viewerToolbar true
fitWindow false
diagramName TiposDeEntrega
simpleViewer true
links auto
tbstyle top
lbox true
diagramWidth 1331
revision 2
Comunicação - Tipos de Entrega

Painel

borderColor	white
bgColor	#B0E0E6
borderWidth	2
borderStyle	dashed

Tipos de Entrega (Delivery Type) é a denominação pela qual é referenciado o tipo de comunicação entre os aplicativos. Em determinados modelos de dados, o programa necessita de uma resposta imediata do aplicativo externo. Já em outras vezes, o modelo não necessita de uma resposta ou não naquele determinado momento, economizando o tempo que o programa aguarda durante troca de mensagens.

Síncrono

Sync: o processamento da mensagem do tipo síncrono acontece no momento da execução, ou seja, o aplicativo interno aguarda a resposta do aplicativo externo para continuar a execução.

Síncrono

Expandir

title	Clique para saber...

Painel

borderColor	white
bgColor	#D3D3D3
borderWidth	2
borderStyle	dashed

Normalmente, mas não necessariamente, utiliza-se essa funcionalidade quando são necessárias mais informações no retorno, como dados complementares aos enviados.

draw.io Diagram

border	false
viewerToolbar	true
fitWindow	false
diagramName	envioSync
simpleViewer	false
links	auto
tbstyle	top
lbox	true
diagramWidth	669
revision	1

Assíncrono

Async: quando enviada uma mensagem do tipo assíncrono, o aplicativo interno não aguarda uma resposta do aplicativo externo para continuar a execução.

Assíncrono

Expandir

title	Clique para saber...

Painel

borderColor	white
bgColor	#D3D3D3
borderWidth	2
borderStyle	dashed

O destino recebe a mensagem e coloca em uma fila junto com outras mensagens assíncronas. Posteriormente, o processamento delas é efetuado na ordem em que chegaram. Ou seja, caso a origem necessite de retorno, será feito em um momento futuro e não durante a execução do programa. É comum o uso dessas mensagens para replicação de cadastros simples, onde não envolve processamento complexo.

draw.io Diagram

border	false
viewerToolbar	true
fitWindow	false
diagramName	envioASSync
simpleViewer	false
links	auto
tbstyle	top
lbox	true
diagramWidth	669
revision	3

draw.io Diagram
border false
viewerToolbar true
fitWindow false
diagramName AnatomiaMsg
simpleViewer true
links auto
tbstyle top
lbox true
diagramWidth 1331
revision 2
Anatomia da Mensagem

BUSINESS MESSAGE

A estrutura da Mensagem de Negócio está dividida em 3 partes.

BUSINESS MESSAGE

Painel

borderColor	white
bgColor	lightgrey
borderStyle	dashed

Uma mensagem do tipo BusinessMessage são aquelas que iniciam qualquer processo de troca de mensagens entre os aplicativos.

Sempre que um aplicativo A quiser enviar ou solicitar informações do aplicativo B, ele enviará uma BusinessMessage que será processada pelo aplicativo destinatário.

Expandir

title	Clique para saber...

Cabeçalho da mensagem: contem informações sobre a mensagem sendo trafegada, como seu identificador único, data em que foi gerada, transação ao qual se refere, entre outras.

Cabeçalho da transação: onde é definido qual o tipo da mensagem de negócio, que pode ser do tipo EVENT ou do tipo REQUEST.

Conteúdo de negócio: Uma BusinessMessage, seja do tipo Event quanto do tipo Request, tem seu atributo Content definido no schema da mensagem padronizada TOTVS. Isso fica a cargo das Áreas de Negócio, conforme a demanda das integrações.

Na imagem abaixo pode-se verificar um exemplo da anatomia de uma Business Message:

draw.io Diagram

border	false
viewerToolbar	true
fitWindow	false
diagramName	Anatomia1
simpleViewer	false
width	800
links	auto
tbstyle	top
lbox	true
diagramWidth	1345
revision	2

RESPONSE MESSAGE

A estrutura da Mensagem de Resposta está dividida em 4 partes.

RESPONSE MESSAGE

Painel

borderColor	white
bgColor	lightgrey
borderStyle	dashed

Uma ResponseMessage representa o resultado do processamento de uma BusinessMessage pelo aplicativo que a recebeu e o seu conteúdo pode variar de acordo com o tipo de mensagem e com o resultado do processamento.

Todas as respostas geradas por uma BusinessMessage devem ser associadas à mensagem original e mantidas pelo aplicativo-origem, como forma de rastrear quem processou aquela mensagem e qual o resultado do processamento.

A mensagem de resposta contém informações sobre o resultado do processamento de uma BusinessMessage.

Expandir

title	Clique para saber...

Cabeçalho da mensagem: contem informações sobre a mensagem sendo trafegada, como seu identificador único, data em que foi gerada, transação ao qual se refere, entre outras.

ReceivedMessage: Segmento com informações sobre a mensagem original (BusinessMessage) que deu origem a esta resposta.

SentBy: Indica qual foi a instancia que gerou a mensagem original
UUID: Identificador universal da mensagem de origem

ProcessingInformation: Segmento com informações sobre o resultado do processamento

ProcessedOn: Timestamp de quando a mensagem foi processada pelo destino
Status: Situação final do processamento (ok ou error)
Details: Lista de mensagens (erro ou aviso) retornadas no processamento.

ReturnContent: informações de negócio retornadas no processamento

Informações

icon	false

Como se define o ReturnContent?

Da mesma forma que o atributo Content de uma BusinessMessage, o atributo ReturnContent de uma ResponseMessage é definido no schema da mensagem padronizada.

Na imagem abaixo pode-se verificar um exemplo da anatomia de uma Response Message:

draw.io Diagram

border	false
viewerToolbar	true
fitWindow	false
diagramName	Anatomia2
simpleViewer	false
width	800
links	auto
tbstyle	top
lbox	true
diagramWidth	1214
revision	3

RECEIPT MESSAGE

A estrutura da Mensagem de Recebida está dividida em 2 partes.

RECEIPT MESSAGE

Painel

borderColor	white
bgColor	lightgrey
borderStyle	dashed

Uma ReceiptMessage representa a confirmação de recebimento de uma BusinessMessage pelo aplicativo destino.

Diferente da ResponseMessage, uma ReceiptMessage não irá conter qualquer informação relevante sobre o processamento da mensagem, uma vez que se entende que, se o aplicativo destino retornou um Receipt, ele não processou a mensagem naquele momento (comunicação assíncrona).

Quando a mensagem for processada pelo aplicativo-destino, uma mensagem de resposta (ResponseMessage) será gerada e encaminhada ao aplicativo que originou a BusinessMessage..

Expandir

title	Clique para saber...

As informações contidas nas mensagens de recibo são genéricas e focam especificamente nos dados de recebimento da mensagem.

Onde:

ReceivedMessage: Segmento com informações sobre a mensagem original (BusinessMessage) que deu origem a esta resposta.

SentBy: Indica qual foi a instancia que gerou a mensagem original
UUID: Identificador universal da mensagem de origem

ReceiptData: Segmento com informações sobre o recebimento da mensagem

ReceivedOn: Timestamp do recebimento da mensagem.

Quando uma BusinessMessage é recebida e for síncrona, ela deverá ser processada imediatamente e gerará como resposta uma ResponseMessage.

Quando uma BusinessMessage é recebida e for assíncrona, será gerada como resposta, no momento da recepção uma ReceiptMessage, e posteriormente quando for processada será enviada uma ResponseMessage para esta mensagem.

Na imagem abaixo pode-se verificar um exemplo da anatomia de uma Receipt Message:

draw.io Diagram

border	false
viewerToolbar	true
fitWindow	false
diagramName	Anatomia3
simpleViewer	false
width	900
links	auto
tbstyle	top
lbox	true
diagramWidth	1381
revision	5

Fluxo de criação da mensagem padronizada

Para tornar oficial uma Mensagem padronizada é preciso passar por algumas fases de homologação. Abaixo segue o fluxo para que isso aconteça.

Fluxo de criação da mensagempadronizada

Expandir

title	Clique para saber...

draw.io Diagram

border	false
viewerToolbar	true
fitWindow	false
diagramName	cunstrucao
simpleViewer	true
links	auto
tbstyle	top
lbox	true
diagramWidth	1331
revision	3

Como configurar o Monitor EAI2 no DTS4THF

Page Banner

image	https://tdn.totvs.com/download/thumbnails/549501254/monitor.png?api=v2&nonce=1640787090167
actionTitle	Acesse aqui
actionUrl	https://tdn.totvs.com/pages/releaseview.action?pageId=652838494
button-link	https://tdn.totvs.com/x/WbRqIQ
button-text	Acesse
description	Configurações para o Monitor do EAI2 no DTS4THF
title	Monitor EAI2!!!

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 135

Nova versão Atual

Chave

Objetivo do documento

Ampliar o conhecimento sobre o tema integrações

Conhecer as tecnologias envolvidas

Conhecer o padrão TOTVS para integrações

draw.io DiagramborderfalseviewerToolbartruefitWindowfalsediagramNameConteudosimpleViewertruelinksautotbstyletoplboxtruediagramWidth1331revision2O que tem aqui?

Conceitos gerais de integração

Tecnologias

Mensagem Padronizada

draw.io DiagramborderfalseviewerToolbartruefitWindowfalsediagramNameIniciosimpleViewertruelinksautotbstyletoplboxtruediagramWidth1331revision2Vamos Começar

Definição de EAI

Definição de EAI

Enterprise Application Integration

Por que Integrar?

Por que Integrar?

Integração de aplicações, sistemas de informação e processos de negócio de uma empresa;

Integração com aplicações internas e externas da empresa que servem de suporte ao processo de negócio da mesma, como por exemplo processo financeiro, RH, dentre outros;

Conjunto de ferramentas de análise e monitoramento de processos e mensagens em tempo real.

Alguns conceitos

Alguns conceitos

Formas de Integração - Modos de Comunicação

Formas de Integração - Modos de Comunicação

Elementos de uma Integração

Integração EAI2

Integração EAI2

Fluxos de Comunicação

Fluxos de Comunicação

Componentes da Integração - JOINVILLE

Componentes da Integração - JOINVILLE

Endereço WSDL -

TOMCAT

O endereço WSDL

segue o formato abaixo:

http://[server]:[port]/

totvseai/public/ws/EAIService?

wsdl

http://[server]:[port]/totvseai/public/ws/EAIServiceRPC?wsdl

Tecnologias envolvidas na Integração

Tecnologias envolvidas na Integração

XML/SOAP

JSON/REST

MÉTODOS (Verbos) HTTP REST

draw.io DiagramborderfalseviewerToolbartruefitWindowfalsediagramNamemensagemsimpleViewertruelinksautotbstyletoplboxtruediagramWidth1331revision2O que são e como são as Mensagens

A mensagem padronizada é a solução para tornar mais fácil a integração dos vários sistemas adquiridos pela TOTVS.

Uma vez que os produtos TOTVS terão um “idioma” comum para troca de informações, será possível conectar diretamente com vários produtos ao mesmo tempo, trocando informações, sem a necessidade do TOTVS ESB.

No tráfego da integração existem 3 tipos de mensagens, cada uma com uma finalidade.

O padrão de mensagem TOTVS.

draw.io DiagramborderfalseviewerToolbartruefitWindowfalsediagramNameTiposDeEntregasimpleViewertruelinksautotbstyletoplboxtruediagramWidth1331revision2Comunicação - Tipos de Entrega

Síncrono

Síncrono

Normalmente, mas não necessariamente, utiliza-se essa funcionalidade quando são necessárias mais informações no retorno, como dados complementares aos enviados.

Assíncrono

Assíncrono

draw.io DiagramborderfalseviewerToolbartruefitWindowfalsediagramNameAnatomiaMsgsimpleViewertruelinksautotbstyletoplboxtruediagramWidth1331revision2Anatomia da Mensagem

BUSINESS MESSAGE

BUSINESS MESSAGE

RESPONSE MESSAGE

RESPONSE MESSAGE

RECEIPT MESSAGE

RECEIPT MESSAGE

Fluxo de criação da mensagem padronizada

Fluxo de criação da mensagempadronizada

Como configurar o Monitor EAI2 no DTS4THF

draw.io Diagram
border false
viewerToolbar true
fitWindow false
diagramName Conteudo
simpleViewer true
links auto
tbstyle top
lbox true
diagramWidth 1331
revision 2
O que tem aqui?

draw.io Diagram
border false
viewerToolbar true
fitWindow false
diagramName Inicio
simpleViewer true
links auto
tbstyle top
lbox true
diagramWidth 1331
revision 2
Vamos Começar

draw.io Diagram
border false
viewerToolbar true
fitWindow false
diagramName mensagem
simpleViewer true
links auto
tbstyle top
lbox true
diagramWidth 1331
revision 2
O que são e como são as Mensagens

draw.io Diagram
border false
viewerToolbar true
fitWindow false
diagramName TiposDeEntrega
simpleViewer true
links auto
tbstyle top
lbox true
diagramWidth 1331
revision 2
Comunicação - Tipos de Entrega

draw.io Diagram
border false
viewerToolbar true
fitWindow false
diagramName AnatomiaMsg
simpleViewer true
links auto
tbstyle top
lbox true
diagramWidth 1331
revision 2
Anatomia da Mensagem