|
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
Definição de EAI
Enterprise Application Integration
|
Por que Integrar?
|
Alguns conceitos
Formas de Integração - Modos de Comunicação
|
Elementos de uma Integração
|
Integração EAI2
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 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
|
Tecnologias envolvidas na Integração
XML/SOAP
JSON/REST
MÉTODOS (Verbos) HTTP REST
|
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. |
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. |
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.
|
No tráfego da integração existem 3 tipos de mensagens, cada uma com uma finalidade.
|
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.
|
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.
|
BUSINESS MESSAGE
A estrutura da Mensagem de Negócio está dividida em 3 partes.
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:
|
RESPONSE MESSAGE
A estrutura da Mensagem de Resposta está dividida em 4 partes.
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.
ProcessingInformation: Segmento com informações sobre o resultado do processamento
ReturnContent: informações de negócio retornadas no processamento
Na imagem abaixo pode-se verificar um exemplo da anatomia de uma Response Message:
|
RECEIPT MESSAGE
A estrutura da Mensagem de Recebida está dividida em 2 partes.
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.
ReceiptData: Segmento com informações sobre o 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:
|
Fluxo de criação da mensagem padronizada
|
<!DOCTYPE html>
<head>
<meta name="viewport" content="width=device-width, initial-scale=1">
<style>
* {box-sizing: border-box}
body {font-family: "Lato", sans-serif;}
/* Style the tab */
.tab {
float: left;
border: 1px solid #ccc;
background-color: #f1f1f1;
width: 30%;
height: 300px;
}
/* Style the buttons inside the tab */
.tab button {
display: block;
background-color: inherit;
color: black;
padding: 22px 16px;
width: 100%;
border: none;
outline: none;
text-align: left;
cursor: pointer;
transition: 0.3s;
font-size: 17px;
}
/* Change background color of buttons on hover */
.tab button:hover {
background-color: #ddd;
}
/* Create an active/current "tab button" class */
.tab button.active {
background-color: #ccc;
}
/* Style the tab content */
.tabcontent {
float: left;
padding: 0px 12px;
border: 1px solid #ccc;
width: 70%;
border-left: none;
height: 300px;
}
</style>
</head>
<body>
<h2>Vertical Tabs</h2>
<p>Click on the buttons inside the tabbed menu:</p>
<div class="tab">
<button class="tablinks" onclick="openCity(event, 'London')" id="defaultOpen">London</button>
<button class="tablinks" onclick="openCity(event, 'Paris')">Paris</button>
<button class="tablinks" onclick="openCity(event, 'Tokyo')">Tokyo</button>
</div>
<div id="London" class="tabcontent">
<h3>London</h3>
<p>London is the capital city of England.</p>
</div>
<div id="Paris" class="tabcontent">
<h3>Paris</h3>
<p>Paris is the capital of France.</p>
</div>
<div id="Tokyo" class="tabcontent">
<h3>Tokyo</h3>
<p>Tokyo is the capital of Japan.</p>
</div>
<script>
function openCity(evt, cityName) {
var i, tabcontent, tablinks;
tabcontent = document.getElementsByClassName("tabcontent");
for (i = 0; i < tabcontent.length; i++) {
tabcontent[i].style.display = "none";
}
tablinks = document.getElementsByClassName("tablinks");
for (i = 0; i < tablinks.length; i++) {
tablinks[i].className = tablinks[i].className.replace(" active", "");
}
document.getElementById(cityName).style.display = "block";
evt.currentTarget.className += " active";
}
// Get the element with id="defaultOpen" and click on it
document.getElementById("defaultOpen").click();
</script>
</body>
|