Árvore de páginas


Instruções para realizar a configuração do Monitor EAI2 na arquitetura do Datasul


Objetivo


Esta documentação tem a finalidade de servir como uma guia no momento da configuração do Monitor EAI2 na arquitetura TOMCAT.

Para tanto, abaixo segue as instruções para que o novo monitor seja executado corretamente.





Antes de configurar o Monitor do EAI2, dê uma olhadinha em como criar os Aplicativos Internos e Externos dentro do produto Datasul.

No quadro a seguir você pode acessar a documentação que auxilia na criação de Aplicativos externos bem como a edição do Aplicativo interno.



EAI Aplicativos

Como configurar os Aplicativos no EAI2

Acesse aqui




Acessos ao monitor

Somente determinados usuários possuem acesso ao monitor unificado do EAI.

Para acessar o monitor é necessário um usuário previamente existente no aplicativo interno (ERP). 

Para isso:

  • No produto Datasul é necessário criar um usuário do Tipo EAI;
  • Abra o programa Manutenção de Usuários (SEC000AA);
  • No momento de criação do usuário, selecione a opção EAI.

Termos Comuns

O Monitor EAI foi construído para funcionar independentemente da tecnologia adotada em cada produto TOTVS.

Construído e pensado para a Web, ele apenas precisa de um servidor HTTP para sua instalação.

A partir deste ponto, os seguintes termos serão usados:

  • Aplicativo - Produto integrado;
  • JSON - Java Script Object Notation - o formato de objetos de Javascript (mas não utilizada somente por ele);
  • Aplicativo Interno - Produto no qual o Monitor Unificado está ligado;
  • Aplicativo externo - Produto ao qual o aplicativo interno se integra.


.

VAMOS AO MONITOR!!!



Antes de tudo!



A primeira tarefa a se fazer antes de começar a configurar o monitor, é realizar a conferência das informações dentro do produto DATASUL.

  • Para isso é preciso acessar o programa html.aplicativos-eai e conferir o NOME do Aplicativo interno cadastrado.

Segue exemplo:

  • Na sequência realizar a conferência das propriedades do EAI2 no produto, ou até mesmo a criação dessas propriedades.

Segue exemplo:

IMPORTANTE!

A informação mais importante nesta etapa é conferir o nome do Aplicativo Interno, tanto no programa de cadastro do aplicativo como nas propriedades.

ESSES NOMES DEVEM SER O MESMO


  • Caso esses nomes não sejam os mesmos, quando o monitor for configurado, essas informações irão confundir a configuração e os dados apresentados serão inconsistentes.



Preenchimento dos dados



Ao abrir o monitor deve ser realizado o login com algum usuário válido no Datasul


Acesso ao Monitor



Depois de executar todos os procedimentos, basta realizar o acesso a página principal do Monitor EAI e o mesmo estará pronto para utilização. 




Configuração do arquivo SERVER.XML



Dependendo do servidor WEB que hospeda o monitor de EAI, será necessário ajustar algumas configurações para criação da pasta externa ao pacote padrão do aplicativo. Para saber como proceder este ajuste em servidores de aplicação TOTVS, verifique abaixo:


Procedimentos necessários no servidor de aplicação Tomcat para disponibilizar conteúdo estático (HTML, imagens, etc.) que não esteja necessariamente vinculado em uma aplicação Web Java (.war).

Procedimentos

  1. Se julgar necessário, crie um diretório na máquina que hospeda o servidor Tomcat.
  2. Edite o arquivo server.xml, geralmente situado em <dir_instalação_tomcat>/conf.
  3. Localize a tag <Host> e dentro dela inclua a tag <Context> seguindo o template abaixo:
    <Context path="<caminho usado na URL para a pasta>" docBase="<pasta no servidor>"></Context>
    Em <caminho usado na URL para a pasta>, informe um valor qualquer, por exemplo, "config".
    Em <pasta no servidor>, informe o caminho completo da pasta criada no item 1. Pode-se informar um caminho relativo a pasta bin, por exemplo, "../config", que seria o mesmo que "<dir_instalacao_tomcat>/config".
  4. Salve o arquivo e reinicie o Tomcat.
  5. Coloque o conteúdo que desejar na pasta criada no item 1.

Exemplos

Server.xml após ajuste

<?xml version="1.0" encoding="UTF-8"?>
<Server port="8005" shutdown="SHUTDOWN">
  <Listener className="org.apache.catalina.startup.VersionLoggerListener"/>
  <Listener SSLEngine="on" className="org.apache.catalina.core.AprLifecycleListener"/>
  <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener"/>
  <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener"/>
  <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener"/>
  <GlobalNamingResources>
    <Resource auth="Container" 
              description="User database that can be updated and saved" 
              factory="org.apache.catalina.users.MemoryUserDatabaseFactory" 
              name="UserDatabase" 
              pathname="conf/tomcat-users.xml" 
              type="org.apache.catalina.UserDatabase"/>
  </GlobalNamingResources>

  <Service name="Catalina">
    <Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443"/>

    <Connector port="8009" protocol="AJP/1.3" redirectPort="8443"/>

    <Engine defaultHost="localhost" name="Catalina">
      <Realm className="org.apache.catalina.realm.LockOutRealm">
        <Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase"/>
      </Realm>

      <Host appBase="webapps" autoDeploy="true" name="localhost" startStopThreads="3" unpackWARs="true">
		
		<!--  CONFIGURACAO DO EAI  -->
		<Context docBase="../config_files" path="/config" />

		<!--  CONFIGURACAO DO VALVE -->
        <Valve className="com.totvs.valve.TotvsCorsValve"
            allowHeaders="Content-Type,Accept,Accept-Language,Content-Language,Authorization,tenantId,userId,companyId,authorization,returnformatversion"
            contextsToValidate="/totvs-login,/totvs-rest,/dts,/api,/webexecbo,/totvseai-monitor"
            allowOrigin="http://localhost:8100"
            allowMethods="GET, POST, DELETE, PUT, PATCH, HEAD, OPTIONS"
            allowCredential="true" />
		
	  </Host>
    </Engine>
  </Service>
</Server>

Importante - VALVE

O produto DATASUL não permite requisições para servidores diferentes, para que não ocorram bloqueios das requisições pelo CORS é preciso configurar o Datasul-Valve, também no arquivo server.xml


A tag "Valve" deve estar configurada como o último elemento da tag "Host". Caso exista algum "Header" da request diferente dos informados anteriormente (allowHeaders), estes devem ser incluídos nessa tag.

datasul-valve
<Valve className="com.totvs.valve.TotvsCorsValve"
allowHeaders="Content-Type,Accept,Accept-Language,Content-Language,Authorization,tenantId,userId,companyId,authorization,returnformatversion"
contextsToValidate="/totvs-login,/totvs-rest,/dts,/api,/webexecbo,/totvseai-monitor"
allowOrigin="http://localhost:8100"
allowMethods="GET, POST, DELETE, PUT, PATCH, HEAD, OPTIONS"
allowCredential="true" />






Olá, Boas vindas!

 Numbers Vetores por Vecteezy - Acesse