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:

Image Removed

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

Segue exemplo:

Image Removed

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

WIZARD

Podem ser encontrados na pasta do Tomcat: <Pasta_Datasul>/<Pasta_Tomcat>/webapps/totvseai-monitor.

•  Acesse o endereço http://<servidor>:<porta>/totvseai-monitor/index.html, onde <servidor> é endereço da máquina onde o Datasul está instalado e <porta> é a porta de instalação do produto (por exemplo: 8080).

A tela do wizard abaixo será apresentada para a configuração do arquivo monitor-url-list.json.

lembrando que este arquivo deve ser copiado para a pasta config situada dentro da pasta relativa ao monitor, conforme indicado no quadro acima

Image Removed

Preenchimento dos dados

Nesta tela deve ser informado o servidor HTTP e a porta REST do ambiente desejado (neste caso, 8080).

• É preciso informar usuário e senha para conectar na URL, e clicar no botão Carregar.

Image Removed

• Quando o monitor é acionado em um ambiente limpo, os dados iniciais do configurador serão obtidos a partir URL informada no campo URL Serviço Monitor. 

• A partir daí, a tela de configuração é preenchida com as informações faltantes, como a lista dos aplicativos externos. Depois disso, é possível ajustar as informações sugeridas como, por exemplo, as URLs de serviços do monitor dos aplicativos externos listados.

• Realize o download do arquivo de configuração, conforme indicado na barra inferior do wizard.
• Quando o monitor já está configurado, o wizard mostra os dados constantes no arquivo monitor-url-list.json. É possível alterar informações como usuário e senha, bem como os dados de conexão com os aplicativos externos (URL, usuário e senha).

Arquivo JSON

O arquivo baixado deve ser copiado para o diretório \totvseai-monitor\config no servidor Datasul, mantendo, impreterivelmente, o nome de monitor-url-list.json. 

Caso seja necessário colocar o arquivo de configuração em outra pasta, consulte a seção, Alteração do local do Arquivo ao final deste documento.

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. Observação: O login deve ser realizado de acordo com o conteúdo informado nos campos Usuário e Senha da tela do Wizard.

Image Removed

Sobre o arquivo de configuração (monitor-url-list.json)

O arquivo monitor-url-list.json, situado na pasta config, é fundamental para o correto funcionamento do monitor. Nele estarão contidos todos os aplicativos referenciados numa integração, sejam internos ou externos. Um aplicativo é descrito através de um JSON contendo os seguintes atributos:

Nome do Aplicativo: Este nome, no Datasul, é composto pelo nome do environment utilizado (em upper case), seguido de @ e DATASUL. Para os demais produtos, usar, depois do @ PROTHEUS, LOGIX ou RM, conforme aplicação.
O nome será um atributo do tipo Objeto JSON, que por sua vez, conterá os seguintes atributos:

1. monitorURL: Deve seguir o mesmo endereço HTTP utilizado no produto

2. isActive: Deve existir e ter valor igual a true somente para o aplicativo interno onde o monitor estiver embarcado.

3. userCode: Usuário necessário para acessar os serviços de monitoramento do aplicativo interno (deve estar em base64).

4. password: Senha necessária para acessar os serviços de monitoramento do aplicativo interno (deve estar em base64).

5. externalApps: Atributo do tipo array de caracteres, contendo o identificador do aplicativo. Por exemplo: APP_LOGIX@LOGIX.

Os demais aplicativos devem ser referenciados usando as orientações acima. Abaixo, um exemplo de configuração do arquivo, onde um DATASUL com um environment de nome APP_INTERNO, no grupo de , comunica-se com um LOGIX com environment de nome APP_EXTERNO_1:

Exemplo de configuração do arquivo monitor-url-list.json

{
    "APP_INTERNO@DATASUL" : {

                 "monitorURL": "http://localhost:8080",
        "isActive" : "true",
        "userCode" : "j50dkke3=",
        "password" : "j068k2jo=", 
        "externalApps" : ["APP_EXTERNO_1@LOGIX"]
    },
    "APP_EXTERNO_1@LOGIX" : {
        "userCode" : "Uj3O9=",
        "password" : "THi3L3=",
        "externalApps" : ["APP_EXTERNO@DATASUL"]
    }
}

Alteração do local do arquivo

Há situações onde o local padrão do arquivo monitor-url-list.json (/totvseai-monitor/config) não é a mais conveniente. Alguns exemplos são:

• Ambientes de teste do monitor, onde a atualização do pacote é frequente.

• Necessidade de compartilhar o arquivo sem ter que expor toda a pasta de fontes do monitor.

Por conta disso, é possível alterar o local padrão realizando ajuste do arquivo totvs-app.constant.js, situado na pasta totvseai-monitor/js. Neste arquivo, deve-se ajustar o valor da propriedade (ou variável) EXTERNAL_APPS_URL para apontar para um novo local, o qual deve estar visível como um endereço WEB.

Por exemplo: supondo que o monitor esteja hospedado no servidor http://localhost:8080, e que a nova localização do arquivo seja uma pasta chamada ...\<diretório_tomcat>\config, o arquivo de configuração deve estar acessível pelo navegador de internet usando o endereço http://localhost:8080/config/monitor-url-list.json. 

Logo, a variável deve ser alterada para:

<?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>

<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" />

Monitor EAI2