Versões comparadas

Chave

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

...

Para iniciar o processo, deve-se executar o programa EAI10000 onde aparecerá a tela inicial do Wizard de Instalação. Antes de selecionar a opção “Avançar”, deve-se ler 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 Load Balance"), é necessário a configuração de um novo Application Server, dedicado ao recebimento de mensagens.

Image Modified

Cadastrando as configurações gerais do EAI Logix

...

Data Horário de Verão: O intervalo do horário de verão será gravado na propriedade logix.summertime.server no arquivo de profile do Logix "totvsprofile ou logixprofile". O valor padrão deste campo será o "01/01/0001-01/01/0001", caso não tenha nenhum valor já contido nesta propriedade. Se apresentar algum valor diferente de "01/01/0001-01/01/0001" é porque esta propriedade já está habilitada e configurada, então não há necessidade de altera-lá. Também pode haver um outro cenário onde client do Logix está em um fuso horário diferente do servidor de aplicação, então deve ser utilizado o programa log00079 para configurar o intervalo de horário de verão por unidade federativa, para o que o monitor faça a compensação do fuso horário corretamente na apresentação das mensagens. 

Image Modified

Observação: Caso já exista uma configuração do EAI2 no ambiente, basta abrir o arquivo de profile do logix e verificar se as propriedades logix.timezone.server e logix.summertime.server estão habilitadas e parametrizadas corretamente. Outra possibilidade é acessar o monitor do EAI o EAI10000, acessar o menu de parametrização e gerais, e analisar como estão as propriedades conforme a tela abaixo. Se o fuso horário for parametrizado no client pelo programa log00179 e o intervalo de data do horário verão for parametrizado no programa log00079, o EAI2 irá desconsiderar as propriedades do server e passará a utilizar a parametrização informada deste dois programas para a compensação do fuso horário.

Image Modified

Configurando webservice

...

Trace: Quando este campo estiver habilitado mostrará toda execução do EAI no recebimento de mensagem pelo webservice. Essas informações serão apresentadas no console do appserver do Logix.

Image Modified

Após configurado o webservice, o arquivo TotvsAppServer.ini terá as seguintes configurações.

...

Estas pastas estarão dentro da hierarquia do rootpath, caso contrário os arquivos xsds de validação não serão encontrados, gerando erro.

Image Modified

Salvando configurações do EAI

...

Após a tela de validação de XSD, o wizard processará as informações configuradas e atualizará o arquivo de profile do Logix com algumas informações. Também será populada a tabela eai_aplicativo com as informações do aplicativo hospedeiro, e serão carregados os adapters do aplicativo hospedeiro que estão disponíveis no RPO do Logix.  

Image Modified

Image Modified

Image Modified

Image Modified

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

...

   b) Selecionar o item Host Application(Aplicativo Hospedeiro), conforme imagem abaixo: 

Image Modified

   c) O nome apresentado no campo Hospedeiro deverá ser o mesmo nome informado no wizard cadastro de inicialização geral do EAI, que também será gravado na chave eai.hostapplication do arquivo totvsprofile.pro.

   d) Tendo informações do host application validada, basta clicar no botão Modificar e responder "Sim" à pergunta "Deseja recarregar os dados?", conforme a tela abaixo:

Image Modified

   e) O grid será preenchido com todas as transações que possuam adapters compilados no RPO do ambiente. Clique em confirmar para salvar as alterações. A partir daí, é possível definir o Modo Habilitado, contexto e as rotas de envio de cada transação.

...

   a) Selecionar o item External Apps no menu do EAI10000.

Image Modified

   b) Clicar no botão Incluir e em seguida no botão Configurar, ao lado do campo Aplicativo.

Image Modified

   c) Clicar no botão Pesquisar ao lado do campo Classe Canal e selecionar a classe do canal correspondente ao produto que se queira comunicar. Se o seu produto for o Logix e o produto de destino das mensagens foi Datasul, deverá selecionar a classe de destino, ou seja, EAIChannelDatasul.

Image Modified   

   d) Informar as propriedades da classe no grid, conforme abaixo:
      a. URL: Endereço do web service do aplicativo externo que será a porta de entrada para as mensagens enviadas pelo aplicativo hospedeiro, no formato “http://<servidor>:<porta>/<caminho web service>?wsdl”.

...

      d. Textformat: Informe um dos valores a seguir: 0 - Não altera o conteúdo, 1 - remove caracteres especiais e acentos, 2 - transforma caracteres especiais e acentos em "HTML Entities" (por exemplo: á -> &aacute;).

Image Modified

   e) Ao clicar em Confirmar, o aplicativo hospedeiro entrará em contato com o aplicativo externo usando uma transação especial chamada Whois para obter a lista de transações que estão disponíveis. Caso o processo ocorra com sucesso, as transações serão mostradas na tela de aplicativos externos conforme abaixo.

Image Modified

   f) Clique em Confirmar para salvar o aplicativo externo e suas respectivas transações.

...

Clique no item Host Application, selecione Modificar e, para a transação desejada, clique no botão da coluna Rotas.

Image Modified

Na tela que se abre, selecione o aplicativo externo para o qual a mensagem será enviada e confirme.

Image Modified

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.

...

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

Image Modified

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).

Image Modified

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:

Nome do Campo

Valor Pré-configurado

Tela do Wizard

Campo do Wizard

Valores da legenda

eai.configprovider

EAIConfigProviderLogix

-

-

-

eai.hostapplication

-

Config. Gerais

Nome do Aplicativo

-

eai.companyid

-

Config. Gerais

Empresa

-

eai.userid

-

Config. Gerais

Usuário

-

eai.debug

-

Config. Gerais

Debug

0 – Desativado

1 – Ativado

eai.xsdvalid

-

Validação XSD

Validação

0 – Desativado

1 – Entrada

2 – Saída

3 – Ambos

eai.xsdpath

-

Validação XSD

Caminho do XSD

-

logix.timezone.server-Config. GeraisFuso horário do Servidor-
logix.summertime.server-Config. GeraisIntervalo de data do horário de Verão-

Informações do Webservice

...

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

Seção

Chave

Tela do Wizard

Campo do Wizard

Legenda

Valor Pré-Configurado

HTTP

Enable

-

-

-

1

HTTP

Port

Webservice

Porta

-

-

HTTP

Path

Webservice

Local do SmatClient

-

-

WEBSERVICES

Enable

-

-

-

1

WEBSERVICES

Environment

Webservice

Ambiente

 

 



WEBSERVICES

Conout

Webservice

Conout

0 – Desativado

1 – Ativado

0

WEBSERVICES

Trace

Webservice

Trace

0 – Desativado

1 – Ativado

0

WEBSERVICES

NameSpace

-

-

-

http://www.totvs.com

WEBSERVICES

URLLocation

-

-

-

http://localhost: + PORTA

WEBSERVICES

Logix

-

-

-

1

Informações salvas em tabela

...

       AND aplicativo = <NOME_APLICATIVO>

Resultado:

Image Modified

Pode-se fazer uma consulta na tabela “eai_aplicativo_transacao” com a seguinte QUERY SQL:

...

      AND aplicativo = <NOME_APLICATIVO>

Resultado:

Image Modified