Objetivo

...

Este documento tem a finalidade de repassar em detalhes a instalação e configuração do EAI Logix através do Wizard de instalação.

Wizard de Instalação do EAI

...

O Wizard de instalação possui o objetivo de configurar o EAI Logix, como o Aplicativo Hospedeiro, suas transações, Webservice para envio e recebimento de mensagens. Para que o wizard funcione corretamente, o TOTVSProfile.pro ou LogixProfile.pro (dependendo da sua versão do Logix) não deverá possuir a TAG  “eai.hostapplication”.

Executando o wizard do EAI através do programa EAI10000

...

Para iniciar o processo, deverá ser executado o programa EAI10000 onde aparecerá a tela inicial do Wizard de Instalação. Antes de selecionar a opção “Avançar”, deverá ser lido todas as mensagem de tela, pois para configurar o EAI em “Load Balance” (caso necessite saber mais sobre a configuração Load Balance acesse a página "Configuração em um cenário com Load Balance"), é necessário a configuração de um novo Application Server, dedicado ao recebimento de mensagens.

Cadastrando as configurações gerais do EAI Logix

...

Nessa tela serão apresentadas as configurações gerais do Aplicativo Hospedeiro, como seu nome identificador, código de empresa e usuário e se o debug do EAI estará ativo ou não.

...

Debug: Chave que indicará se o debug do EAI será mostrado no console ou não.

Configurando webservice

...

Nessa tela, estarão as informações pertinentes à configuração do WebService, não só do EAI, mas como do Logix em geral. Inicialmente a tela será carregada com as informações que estão configuradas no arquivo TotvsAppServer.ini do ambiente executado.

...

Caso seja necessário entender cada propriedade referente ao webservices neste arquivo, o usuário poderá acessar este link Informações do Webservice referente as propriedades.

Configurando e validando XSD

...

Inicialmente a tela será carregada com o campo de “Validação” com o valor “Desativada”.

...

Nota: Todos os XSDs utilizados na integração deverão estar nessa pasta conforme a configuração. Por exemplo: caso seja configurado para validar apenas o envio, só os XSDs das mensagens de envio.

Salvando configurações do EAI

...

Após a configuração da validação do XSD, o wizard irá processar as informações configurada pelo usuário e irá salvar essas configurações no arquivo TotvsProfile.pro ou LogixProfile.pro e na tabela eai_aplicativo

...

Caso seja necessário entender cada propriedade referente ao EAI neste arquivo de profile, o usuário poderá acessar este link Informações de Profile referente as propriedades.

Manutenção das configurações do EAI Logix

...

Carregamento das transações do Host Application

...

A configuração do EAI Logix passa pela carga das transações habilitadas no Host Application. Esta carga ocorre no programa EAI10000, conforme procedimento abaixo:
   a) Executar o programa EAI10000, situado no menu Logix em Administração Logix -> Controle Geral -> Cadastros -> EAI -> EAI1000 – Console EAI.

...

NOTA: A tela será bloqueada para outros usuários, a partir do momento em que o usuário selecionar a opção Modificar. Retornará ao normal quando houver uma confirmação ou cancelamento da transação. Esse é um comportamento comum do metadados, para não permitir que vários usuários modifiquem ao mesmo tempo.

Cadastramento de External Applications

...

Após a carga das transações no Host Application e antes da definição dos contextos e das rotas de envio, é necessário cadastrar os aplicativos externos (External Applications) com os quais o aplicativo hospedeiro irá se comunicar via EAI.

...

NOTA: A tela será bloqueada para outros usuários, a partir do momento em que o usuário selecionar uma das opções: Incluir, Modificar, Copiar e Excluir. Retornará ao normal quando houver uma confirmação ou cancelamento da transação. Esse é um comportamento comum do metadados, para não permitir que vários usuários modifiquem ao mesmo tempo.

Utilizando contextos 

...

Para acessar configuração referente a contextos no EAI Logix, basta acessar a seguinte página: 2. Utilizando Contextos no EAI Logix

Configuração de rotas de envio

...

Por fim, é necessário definir as rotas para envio das mensagens aos aplicativos externos, o que é feito na tela do Host Application.

...

NOTA: A tela será bloqueada para outros usuários, a partir do momento em que o usuário selecionar a opção Modificar. Retornará ao normal quando houver uma confirmação ou cancelamento da transação. Esse é um comportamento comum do metadados, para não permitir que vários usuários modifiquem ao mesmo tempo.

Envio e recebimento de mensagens

...

O envio e recebimento de mensagens depende da alteração das respectivas regras de negócio no Logix para chamar os adapters do EAI. Caso já existam no RPO os programas alterados e os respectivos adapters, basta executar as rotinas relacionadas para efetuar a geração e o envio das mensagens.

Consulta de mensagens enviadas e recebidas

...

Para consultar mensagens enviadas a partir do host application, ou mensagens recebidas de aplicativos externos, pode-se usar o EAI10000, item Monitoramento.

...

Conforme mostrado na imagem acima, é possível consultar todas as mensagens trafegadas de uma vez (item Geral), ou de acordo com o sentido (Entrada ou Saída) e status de processamento (Recebidas ou Enviadas).
Através do botão Pesquisar, é possível fornecer os filtros necessários para selecionar as mensagens desejadas.
Ao clicar em uma das mensagens mostradas, na parte inferior do painel é possível consultar o conteúdo (XML) da mensagem, as mudanças de status que a mensagem sofreu (Log) e os desdobramentos ocorridos durante o seu processamento (Histórico).

Informações Técnicas EAI Logix

...

Informações de Profile

...

Para verificar se todas as informações foram instaladas corretamente, inicialmente é verificado o arquivo Totvsprofile.pro do ambiente. Segue uma tabela abaixo com as informações que devem ser conflitadas:

Informações do Webservice

...

Os campos do WebService deverão estar no arquivo TotvsAppServer.ini conforme a tabela abaixo:

Informações salvas em tabela

...

Será salvo, durante a instalação, informações a respeito do aplicativo host, o que está sendo configurado, em duas tabelas: “eai_aplicativo” que mostrará informações gerais que o aplicativo utilizará durante a troca de mensagem; a outra é a “eai_aplicativo_transacao” onde possuirá informações referentes aos adapters e transações que o aplicativo host possui em seu RPO. 

...